September 23, 2020, 11:07:33 PM

SMF Arcade Info


SMF Arcade v2.6.1 [Official Release]


Introduction
SMF Arcade adds an arcade section to your forum where users can play games.
You must uninstall any previous versions of the Arcade prior to updating this modification.

Supported SMF Versions
This version supports the most recent SMF 2.0.X & SMF 2.1.X branches.

Recommended Minimal Requirements
OS minimum recommended versions: Ubuntu 18, Centos 7
HTTP Server: Apache 2.4 using PHP 7.1
Extensions: curl, mbstring, zlib
Optional RAR compression support: RAR (command-line tool) and UNRAR (PECL RarArchive class) packages for Linux
Forum software/versions: SMF 2.0.17 or SMF 2.1.0
Hypertext Transfer Protocol Secure (HTTPS) ~ HTTP over TLS or HTTP over SSL

Supported game save types:
  • HTML5 v1 (requires specific SMF Arcade save code)
  • HTML5 v2 (IBP HTML5 / PHP Quick Arcade save codes)
  • HTML5 v3 (PHPBB -> JV-Arcade / RA Arcade HTML5 save codes)
  • IBProArcade v1 / v2 / v3 / v3.2 (flash)
  • vBulletin v3Arcade (flash)
  • PHPBB (flash)
  • MochiAds are supported with external module
  • SMF v1 / v2 (flash)
  • General flash games are supported without score support
  • General HTML5 games are supported without score support

Games
You can view this link for information regarding games for this arcade system: GAME RESOURCE LIST

Notes
Mod-Security should be disabled for the HTML5/JQuery upload script to function properly which is recommended for large sized game archives.
The default script can be used instead if necessary but may require adjustment to php.ini to facilitate large sized game archives.

Features:
  • Arena for users to challenge other users
  • Category Champions as well as Arcade Champions
  • Daily challenge
  • Sort games
  • Installs tar, tar.gz, zip and rar game files
  • Admin settings for added features
  • Notifications for high scores and tournament matches
  • Responsive/mobile support
  • Users can Report game errors
  • Download game option
  • Post new game to forum
  • Alternate game templates available
  • Option to allow auto adjustment of improper save types
  • Allows other mods to use hooks containing score or match information
  • Ability to add custom skins & lists via database entries

Arcade Hooks

integrate_arcade_match
  • Called from: ArcadeGame.php, just after arena match data has been saved.
  • Purpose: Allows you to use the arena score data variables (read only).
  • Accepts: 1 function name.
  • Sends: $id_match, $user_info['id'], $matchInfo['current_round'], $submit_info['score'], $submit_info['duration'], $submit_info['end_time']
    • $id_match - match id number
    • $user_info['id'] - user id of submitted score
    • $matchInfo['current_round'] - round number
    • $submit_info['score'] - game score
    • $submit_info['duration'] - length of time game was played
    • $submit_info['end_time'] - when the score was submitted


integrate_arcade_score
  • Called from: ArcadeGame.php, just after a game score has been saved.
  • Purpose: Allows you to use the game score data variables (read only).
  • Accepts: 1 function name.
  • Sends: $context['game'], $member, $score
    • $context['game'] - array of game data
    • $member - array of member data (id, name, ip)
    • $score - array of score data (score, duration, endTime)


integrate_arcade_guest
  • Called from: ArcadeGame.php, just after a guest game score has been saved.
  • Purpose: Allows you to use the game score data variables (read only).
  • Accepts: 1 function name.
  • Sends: $context['game'], $submit_info['score']
    • $context['game'] - array of game data
    • $submit_info['score'] - game score


Example usage for the above hooks:
add_integration_function('integrate_arcade_match', 'modName_arcade_match');
add_integration_function('integrate_arcade_score', 'modName_arcade_score');
add_integration_function('integrate_arcade_guest', 'modName_arcade_guest');


For future reference regarding Arcade hooks and useful functions, please use this link:
Arcade Hooks & Functions

Reporting Bugs
Please report bugs to the Official Support Thread!
This helps make this modification better!

Note:
Pretty URL's modification for SMF is not recommended as it may cause compatibility issues with SMF Arcade due to URL manipulation.
If you use that SMF mod & require support to get the arcade working properly, you should ask the current Pretty URL's developer.

Copyright (c) 2004 - 2012, Niko Pahajoki
Copyright (c) 2015 - 2020, Chen Zhen
Current support provided by Chen Zhen @ web-develop.ca
SMF Arcade License: BSD 2

Beta / RC  Testers:
Skhilled, Bigguy, Legionaire, Origon, Hero, Vince, Ronald, Lesmond

Many thanks to our beta testers and all those that provide feedback to help improve this modification package.