vbProArcade v1.0 Flash Games Development
 

vbProArcade v1.0 Flash Games Development Thread

This thread is intended to provide support for those who wish to find new games for their Arcades, or wish to assist in the development of new games for vbProArcade, or wish to modify existing, open-source Flash games for use with vbProArcade.

Note to vbulletin.org moderators: I could not find an appropriate place for this thread, other than the Beta Hacks forum, so here it is. If you feel this should be moved somewhere else, by all means do so. An additional reason I posted it here was because, to my knowledge, only registered users can view this thread, which may contain hack code at one point or another.

For the hack itself, you will need to see this thread. The Flash Development thread that you see here is just that, and should only be for the discussion of creating/modifying games to work with vbProArcade. Any discussion of or support for the hack itself will be conducted in the other thread.

For documentation on how to modify a game to work with vbProArcade, please see the vbProArcade documentation, which will always be contained in this post. I will try and update this post whenever I update the documentation itself.

A list of current games can you find in the second post.

Before you modify ANY game's source or post it here, you must MAKE SURE that you have the author's permission to modify and redistribute the code, compiled or otherwise.

As games are modified and posted, I will update this post to list them, so that people running vbProArcade may find and install them more easily.

Here is the most current list of games that work with vbProArcade, along with the original person that modified the code:

• Breakout - futureal
• Pacman - futureal
• Snake - futureal
• Space Invaders - futureal
• Tetris - futureal
  
• Simon Says - Dark Jim
• Hexxagon - Dark Jim
• Roulette - Dark Jim
  
• Word Drop - lynda
  
• Xtreme Snake - Silenced Soul
  
• xBreakout - Link14716
• Plasma v2 - Link14716
  
• Asteroids - Shad
  
• X-Ball - DigitalDesktops
• Pong - DigitalDesktops
• Witch Hunt - DigitalDesktops
• Alien Attack - DigitalDesktops
• Star Flight - DigitalDesktops
• Plasmanaut - DigitalDesktops
• Plasmanaut (With Sound) - DigitalDesktops
  
• TIE Fighter - dstruct2k
• Pong - dstruct2k
  
• Ping Pong - The Wedge
• X-Mas Boarding - The Wedge
  
• Kart Racer - EvilLS1
• Kart Racer - 3 Life Version - EvilLS1
• Wall-Ball - EvilLS1
• Funky Pong - EvilLS1
• Funky Pong - With Submit Button - EvilLS1
• Squid Hunter - EvilLS1 (originally modified by Jakor Sevel)
• Pong-Solo - EvilLS1
• Poker - EvilLS1
• Blackjack - EvilLS1
• Pinball - EvilLS1
  
• Save Us! - Jakor Sevel
• The Simpsons Shooter - Jakor Sevel
• Cheetah Racing - Jakor Sevel
• 777 - Jakor Sevel
• Slot Machine - Jakor Sevel
  
• Alien Invasion - Spinal
• Breakout 2 - Spinal
• Breakout 2 - SpeedUp Version - Spinal
• Pigy Trap - Spinal
• Star Flight - Spinal
• MASA Slot Machine - Spinal
• Freestyle - Spinal
• XC - Spinal
• Zapper - Spinal
• Snow Paul - Spinal
• Snowboarding Santa - Spinal
• Paladin - Spinal
• Shooter - Spinal
• X-Ball - SpeedUp Version - Spinal
• Revenge - Spinal
• Press - Spinal
• Gioco Muro - Italian - Spinal
• Gioco Muro - English - Spinal
• Giocospaziale - Italian - Spinal
• Giocospaziale - English - Spinal
• Egg - Spinal
• Moonskate - Spinal
• Rogue's Gallery - Spinal
• R-Shot 3 - Spinal
• R-Shot - Spinal
• Scatting Game - Spinal
• Stab the Pumpkin - Spinal
• Moreno - Spinal
  
• Ameriman carshooting - NuclioN
• Solitaire - NuclioN
• PokerX - NuclioN
• Eggs - NuclioN
• Starchaser - NuclioN
• SlotX - NuclioN
  
• Jewels - Da`Nacho

Note that some games may (eventually) have multiple versions as people modify them to suit their needs. For example, I know that there are already a few different versions of vbTetris floating around.

vbProArcade v1.0 Beta 2 Documentation

/////////////////////////////////
// vbProArcade v1.0 Beta 2 //
// The Extended Documentation! //
// v1b2.030105 //
// by futureal //
////////////////////////////////


Introduction
------------

vbProArcade is a PHP script designed to provide an interface between the vBulletin Instant Community and Macromedia Flash-produced games. vbProArcade is made freely available via vbulletin.org to licensed vBulletin owners ONLY, and should not be redistributed or modified in any other way without the express written consent of the author.


Installation
------------

There are multiple steps required to making vbProArcade work with your vBulletin installation. They are:

- uploading the vbProArcade files
- uploading the arcade game files
- modifying your SQL database with the vbProArcade tables and settings
- modifying (hacking) the vBulletin PHP code
- installing (and possibly editing) the vbProArcade templates

The majority of these instructions are contained in a separate file (vbproarcade-install.txt). This file is meant as more of an explanaton of vbProArcade's features and how to use them effectively, as well as a revision log and other information from the author.

Note that this is an EXTENSIVE hack and will require some time and effort to get to work correctly. As a word of warning, there have been sites where vbProArcade would not work, for whatever reason. While I hope that your site is not one of them, I cannot guarantee that this will work everywhere. Still, I will make every effort to continually update the code to get it working in as many environments as possible.


Games and How to Modify Them
----------------------------

vbProArcade interfaces with Macromedia Flash games that have been specially modified to work with it. To modify a Flash game to work with vbProArcade, you will need access to the game's source code (usually a .FLA file). Just having the pre-compiled .SWF file will NOT work.

This is the block of code that needs to be added to a Flash Game to make it compatible with vbProArcade:

-----

// set up vars to return
vpaver = "100B2";
scorevariable = score;
action = "gameover";
game = gamename;
score_loc = location + "/proarcade.php";

// this needs to match the Admin CP value
// and should be between 0 and 31
hashoffset = 5;

// do security shuffle to return newhash
subhash1 = gamehash.substr(0,hashoffset);
subhash2 = gamehash.substr(hashoffset);
newhash = subhash2.concat(subhash1);

// redirect back to vbProArcade
getURL (score_loc, "_self", "POST");

-----

There are a couple of things to pay attention to here. First, "scorevariable" MUST match whatever you set the score variable to be in the Admin Control Panel in vBulletin. In this case, "scorevariable" would correspond to "$scorevariable" in the CP. Second, "hashoffset" MUST match the hash offset defined for the game in the Admin Control Panel in vBulletin. This value needs to be between 0 and 31, since the MD5 hash is a 32-character string. If these values do not match, you game will always return a Security Violation after exiting.

When you add a game to the arcade, you must give the arcade the HTML code associated with the Flash file, which should look something like this (this is the default code for Tetris):

-----

<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,0,0" width="550" height="380">
<param name="movie" value="$vpa_gameurl?location=$vpa_bburl&gamename=$ game&gamehash=$gamehash&s=$session[sessionhash]&username=$username&highscore=$highscore&bbtitle=$ bbtitle">
<param name="quality" value="high">
<param name=bgcolor value="#576375">
<embed src="$vpa_gameurl" pluginspage="http://www.macromedia.com/go/getflashplayer" type="application/x-shockwave-flash" width="550" height="380">
</embed></object>

-----

Note the variables that can be used in this process:

$vpa_gameurl - The Path to the Arcade Games on your Server
$vpa_bburl - The Path to your Forum on your Server
$game - Game's Text Identifier
$gamehash - Game Security Hash (will not return scores correctly without this)
$session[sessionhash] - vBulletin Session Data (should pass this for non-cookied users)
$username - User who is Playing
$highscore - Current High Score for this Game
$bbtitle - Title of your Forums

Not all games will support all of these, but if you are creating (or modifying) a game to work with vbProArcade, you might make use of some of these variables to "spice it up" a bit.

The rest of the code should remain the same from game to game and does not need to be specially modified. If you are wondering about the security features, see the section on security further down in this documentation.

Also note that before modifying any games you find, please make sure that you have the author's permission, *especially* if you intend to redistribute the file after it has been modified.


Templates
---------

vbProArcade is a completely templated-out hack, meaning that it is remarkably easy to change the look of your Arcade without having to edit the PHP code itself. The downside of this is that there are a bunch of templates to install and manage. Here is a list of the templates that come with vbProArcade, and where each one is used:

- vbproarcade_arcade - Main Arcade Page
- vbproarcade_arcadebit - Main Arcade Page - "Bit" to Display Each Game on the Main Page
- vbproarcade_arcade_gamedesc_icon - Main Arcade Page - Game Description (with Game Icon)
- vbproarcade_arcade_gamedesc_noicon - Main Arcade Page - Game Description (without Game Icon)
- vbproarcade_arcade_gamename_icon - Main Arcade Page - Game Name (with Game Icon)
- vbproarcade_arcade_gamename_noicon - Main Arcade Page - Game Name (without Game Icon)
- vbproarcade_arcade_gamescorecell - Main Arcade Page - Mini-Scoreboard Game Score Cell
- vbproarcade_arcade_gamescorecellbit - Main Arcade Page - Mini-Scoreboard Game Score Cell "Bit"
- vbproarcade_arcade_userscore_guest - Main Arcade Page - Score Message for a Guest
- vbproarcade_arcade_userscore_king - Main Arcade Page - Score Message for the Champion
- vbproarcade_arcade_userscore_notking - Main Arcade Page - Score Message for Normal Players
- vbproarcade_arcade_userscore_notplayed - Main Arcade Page - Score Message for Users who Have Not Played
- vbproarcade_errormessage - Arcade Message - Template
- vbproarcade_gameover - Game Over Template
- vbproarcade_playgame - Game Screen Template
- vbproarcade_scorebit - Game Scoreboard - Score "Bit"
- vbproarcade_scoreboard - Game Scoreboard
- vbproarcade_scoreboard_gamelinkbit - Game Scoreboard - Game Links (at bottom of pages) "Bit"
- vbproarcade_scoreboard_gamelinks - Game Scoreboard - Game Links (at bottom of pages)
- vbproarcade_scoreboard_userstats - Game Scoreboard - User Statistics
- vbproarcade_topscoreboard - Game Top Scoreboard
- vbproarcade_userdetail - User Detail Main Page
- vbproarcade_userdetail_gamecell - User Detail Game Cell

As it stands, there are 23 templates in use in vbProArcade Beta 2. As the code is optimized further, this number *should* go down; however, as new features are added, new templates may be necessary. I know that maintaining this many is a heavy workload for an administrator, but it seems to be the best way to allow for customization, so I am sticking with it (for now).


Arcade Tables
-------------

There are five tables that make up vbProArcade:

arcadeconfig - Stores the Arcade Configuration
arcadegames - Stores the Arcade Games' Configuration
arcadescoregroups - Defines Groups of Scores (not fully implemented)
arcadescores - Stores the Top Scores for each Game
arcadetopscores - Stores the Scores for each Game

To see the individual layouts of each table, you can execute a "desc tablename;" query from the MySQL command line.



Score Table Structure and Security
----------------------------------

One of the major problems with Beta 1 of vbProArcade was a lack of security. This has been addressed (somewhat) in Beta 2 by a rather large modification of the way scores are stored and handled.

First of all, the arcadescores table (which stores the regular scores themselves) now looks like this:

int(10) unsigned scoreid unique score identifier
int(10) unsigned scoregroup group the score belongs to
varchar(50) game game's textual identifier

int(11) begintime timestamp for game start
int(11) endtime timestamp for game end

varchar(50) gamehash md5 encrypted identifier
tinyint(1) valid see if score is valid (0 invalid, 1 valid)

int(10) unsigned userid userid of player
varchar(50) username username of player

int(11) score user's score
varchar(70) comment user's comment

When a user chooses to play a game, the database creates an invalid score entry containing that user's name and ID, the current UNIX timestamp, and an MD5 hash of some encrypted value. The hash, along with any other interesting information, is passed into the Flash game.

When a Flash game exits, it redirects the user to the "Game Over" screen, and passes along the hash with the other data. The Arcade then queries the database, looking for the most recent entry for that particular user, checking to see if the game matches, the hash matches, and that the time is greater than the recorded time. If everything checks out, the score is recorded as a valid score, and the user is prompted to enter a comment.

When the user clicks "Submit" on the comment screen, a new, random MD5 hash is generated and stored alongside the score in the database, which is then passed along with the form data, and re-checked against the database. This will prevent users from "brute-forcing" the Arcade to record a new comment for a given score, as was possible in Beta 1.

On top of the MD5 security, the server is recording the entry and exit timestamps of each game, which cannot be altered by user input at all. An astute administrator should be able to determine whether or not a game was completed in a reasonable amount of time or not, thus giving him or her yet another method of weeding out fake scores, should they arise.

Another new feature of the score table is "Score Grouping." Although this is not yet implemented, it will allow the Administrator to define sets of scores for a given time period. This could be used for daily, weekly, or monthly scoreboards, for example, or perhaps for a tournament or some other form of grouping.

Obviously, this system is not foolproof, since a cheater could (for example) still wait the requisite amount of time for a game and use a hex-editor to change memory locations. Still, this is a good start, and should prevent all of the "address bar cheating" that we saw with Beta 1.


History
-------

Release History (so far):

8/31/02 - vbProArcade Beta 1 Released
9/13/02 - vbProArcade Beta 1.03 Released
1/05/03 - vbProArcade Beta 2 Released


Revision History:

Beta 2:

- Fixed Top Score Board bug
- Fixed Champions System to Correctly Integrate with postbit
- Added Icons to Champions System
- Added Template Support to Champions System
- Added Usergroup Access Control to Admin CP
- Added Mini Scoreboards to Main Arcade Page
- Changed Score Tables to use UNIX timestamps
- Changed Score Tables for additional security
- Added Score Grouping for future expansion
- Added Customizable Icons for User Detail Pages
- Added User Scoreboards for Individual Games
- Added User Statistics Pages
- Removed/Cleaned Up Some Old Templates
- Added Simple Score Editor Framework (for future expansion)
- Added Ability to Reset Scores

Beta 1.03:

- Fixed PHP Safe Mode bug
- Fixed Top Score Board Division by Zero error
- Fixed Undefined Function Call in online.php
- Fixed URL Redirection Problems

Beta 1:

- Initial Release
- Basic Arcade/Scoreboard Functionality


Conclusion
----------

Although I certainly *hope* that vbProArcade will work flawlessly on your forums, I am sure that as time goes on people will run across small bugs and problems that need to be corrected. I will make every effort to make myself available for support, though I urge you to exercise patience, as I have a very, very busy schedule.

I plan to continue to work on vbProArcade for the foreseeable future, including porting it over to vBulletin v3.0 when it is released to the public.

Should anybody feel ambitious, Paypal donations are always graciously accepted, and any money received in this manner will go directly towards the upkeep and maintenence of my two websites. To donate, go to www.paypal.com and use my futureal@rctech.net email address. Note that donations are not at all required for support purposes!

Any support questions should be directed to the vbProArcade thread on www.vbulletin.org, though my email addresses are available should they become necessary.

Thanks for using vbProArcade!


- Shane (futureal)

futureal@rctech.net
futureal@shadowsofnamek.com

<font size="5">vbProArcade Flash Game: Breakout</font>

This is the game Breakout, which originally was released as part of vbProArcade v1.0 Beta 1.

Version:

For all intents and purposes, this should be considered v1.0 of Breakout, and referred to as such.

Compatibility:

- vbProArcade Beta 2
- vbProArcade Beta 1

Original Credits:

TBD

Other Information:

Nothing at this time.

vbProArcade Flash Game: Pacman

This is the game Pacman, which originally was released as part of vbProArcade v1.0 Beta 1.

Version:

For all intents and purposes, this should be considered v1.0 of Pacman, and referred to as such.

Compatibility:

- vbProArcade Beta 2
- vbProArcade Beta 1

Original Credits:

Paul Neave, http://www.neave.com/webgames/

Other Information:

Nothing at this time.

vbProArcade Flash Game: Snake

This is the game Snake, which originally was released as part of vbProArcade v1.0 Beta 1.

Version:

For all intents and purposes, this should be considered v1.0 of Snake, and referred to as such.

Compatibility:

- vbProArcade Beta 2
- vbProArcade Beta 1

Original Credits:

Paul Neave, http://www.neave.com/webgames/

Other Information:

Nothing at this time.

vbProArcade Flash Game: Space Invaders

This is the game Space Invaders, which originally was released as part of vbProArcade v1.0 Beta 1.

Version:

For all intents and purposes, this should be considered v1.0 of Space Invaders, and referred to as such.

Compatibility:

- vbProArcade Beta 2
- vbProArcade Beta 1

Original Credits:

Paul Neave, http://www.neave.com/webgames/

Other Information:

Nothing at this time.

<font size="5">vbProArcade Flash Game: Tetris</font>

This is the game Tetris, which originally was released as part of vbProArcade v1.0 Beta 1.

Version:

For all intents and purposes, this should be considered v1.0 of Tetris, and referred to as such.

Compatibility:

- vbProArcade Beta 2
- vbProArcade Beta 1

Original Credits:

Original Author: unknown
vBTetris Modifications: john.eovie

Other Information:

Nothing at this time.

Super! Thanks for releasing them! :)

Funny, this looks an awful lot like the Tetris Flash file which I modded...

Give me a break, man.

Not only are the modifications for this hack significantly different from the ones in your original hack, I have continued (and will continue) to give you credit in every source file I've released for vbProArcade, since the very beginning, without any prompting from you or anybody else.

What more do you want?

Unless you actually wrote the vbTetris game, I don't think I've missed crediting you at all. The security and dynamic redirection ActionScript was written by myself. If you did, in fact, write the game, then it's my error, and I will correct it.

Looks nice futureal :p

Is there an option to now edit the scoreboards?

- miSt

The original version of Tetris was pretty rough, as I'm sure you'll remember - it had a lot of extra things that I took out, I redid all of the buttons (remember it there used to be a tacky "Start!" round thing bottom left), changed all of the colours and generally made it look a lot better. I also added the introduction (with $bbtitle and the forum tetris block.)

I know it's not brilliant, and sorry I couldn't make it any better - but I'm pretty useless at flash, and I put a hell of a lot of effort into it. (Although I'm sure to someone better it would have taken them a few minutes.)

well ok glad we got that out of the way , now on with the topic of this thread maybe ?

Edit: Heh, I was thinking of Beta 1.03 :paranoid:

Now, maybe somebody will actually make some more games. :)

I was unaware that there were any differences (other than score returning) between the original vbTetris and the version contained in your hack. I don't think I ever saw the release of it before it made its way into your hack.

I will add that credit to the source file and the distribution archive.

My post here was meant more as "who originally modified each file to work with vbProArcade" and not so much "who wrote or otherwise worked on the game." It is just so I/we can keep track of who has provided what game for everybody to use.

I hope so. I have had a lot of people send me emails or PMs with source files or locations of source files containing other potential games. I haven't had much time to look at them but I hope that others will take the initiative to modify some of the stuff that is out there, or -- better yet -- even create some cool games just for the vBulletin community.

any way a frogger game could be added? just asking

Find a .fla for Frogger and modify the file as futureal said, and yea. ;)

Futureal I was just wondering about the Tetris game, who originally create this? Would he be the originally creator of the game? http://www.gauss2001.com/red.htm

Yeah, thats the one. I remember it from the vbflash player thread.

Okay cool thanks :)

Thank you so much for your efforts to enhance security, futureal. :)

As you can see from my posts in the other thread on vBProArcade, address bar cheating was a huge problem on my forum. Hopefully Beta 2.0 will alieviate that some.

[high]* Da`Nacho goes off to find some flash games...[/high]

I really wish I knew how to edit flash files because that donkey kong game would be sweet to play. :( Hint, hint.

Well I'm sure if you post a link to the .fla files to the games that might be worry doing I'm sure someone will get to it.

Card games would be sweet like multi-player echure

I'll probably be making a game for the arcade, its gonna be based on a game a friend of mine is making, probably wont interest anyone else, and I doubt i'll finish it anyways, if I get anywhere I'll let you know.

I would really appriciate it if somebody could please make "Simon" compatible with vB Pro Arcade, I would really appriciate it. I have attached a ZIP with the .fla file in it. Thanks. :)

Man, I really need more games for our arcade :P :)

vbProArcade Flash Game: Simon Says

Version:

1.0 I guess.

Compatibility:

- vbProArcade Beta 2
- vbProArcade Beta 1 (Not tested but most likely)

Original Credits:

Paul Neave, http://www.neave.com/webgames/

Other Information:

Included in the zip is the source (.fla) file ,the executable (.swf) file and a crappy image I made to use in the main arcade screen. I did not modify the game but a member on my forums did. You can use the gold crown to appear in the postbit for it. It's not used in there yet and I didn't feel like making one.

Installation
1. Upload the file simon.swf to your games directory.

2. Execute the following query:

Come on people let's look for more games. I searched a lot already but only found source files of crappy games. :/ I would like a pinball game for example.

Dark Jim, edit the begining of your query to:

So if it is not the 6th game, it will work. ;)

Thanks. :)

I'll start looking hard and heavy as well Jim , surely with a few of us looking we can find some.

Ditto on the pinball game, I think it could be a great game to keep high scores on, I'll try to find one too...

Tried adding it to Afterblur with the query you gave, DJ, and was returned a whole list of errors. Before I start listing them here, has anyone else been successful with adding this game?

yep works perfect for me but I added all the game info threw the add game feature in the control panel instead of running a query.

what I did , instead of running a mysql query was this:

1. save game icon to desktop
2. save crown icon to desktop
3. upload simon.swf to your games folder
4. go to the arcade admin panel and click on add game and enter the following information :

Game Identifier : simon
Game Title : Simon Says
Game Description : * describe it in your own words *
- browse to the champion icon on desktop
Champion text for Simon Says : Simon Says Champion
Champion text color : #FF0000
- browse to game icon on desktop
Filename : simon.swf
Game Hash Offset : 5
Score Return Variable : $simonscore

and then HTML Code For Game :

and click add ;)

be sure you enable the game and enable the champion icon and champion text if you're wanting to use that

w00t! Simon is up and running on my forum! :D

I'm about to install Flash and stuff on my dev machine, so if you guys spot any good games and can get hold of the source, post them here and I'll take a shot at modding them (after attempting to get permission from the author of course). I'm sure if I can't someone else here can... let's get some good choices for our arcades folks! :D