Register Members List Search Today's Posts Mark Forums Read

Mod Options
RPG Integration Hack /w Battle (BETA) Details »
RPG Integration Hack /w Battle (BETA)
Mod Version: 1.00, by Bitsys (Member) Bitsys is offline
Developer Last Online: Aug 2007 I like it Show Printable Version Email this Page

This modification is in the archives.
vB Version: 2.2.x Rating: (7 votes - 3.86 average) Installs: 278
Released: 06 Dec 2002 Last Update: Never Downloads: 122
Not Supported Is in Beta Stage  

RPG Integration Hack BETA by Bitsys
(vBulletin versions 2.2.6?, 2.2.7, 2.2.8, 2.2.9, and 2.3.0)

This hack combines several RPG hacks into one and adds a battle hack. The hacks included in this hack are:

In addition to re-releasing thse hacks, I have added features to all of them (or else there would be no point in re-releasing).
  • The RPG hacks are now all editable via the admin control panel.
  • The itemshop has been somewhat optimized and some fixes are included that reduce queries in showthread.php and itemshop.php . Also, Lesane's Store Hack has been integrated with the Itemshop. This can be toggled in the admin cp.

This means that the RPG hacks are database driven and have been partially integrated with the Itemshop. This was necessary in order to make a battle hack, which is also included.

Since most people are familiar with the RPG and Itemshop hacks, I will give a brief description of the Battle hack. If you want more information about either of the other two hacks, then refer to their original posts or download the .zip file and read the "readme.txt". If you are a visual learner, then you can scroll down to the second post in this thread, which contains the pictures of all of these hacks.

Battle Features:
  • The battle format is turn-based.
  • HP, AP, PP, and MA are automatically deducted based on what action a user takes, the damage dealt to an opponent, etc.
  • Opponents in battle can use spells, one-handed weapons, two-handed weapons, shields, potions, or their fists.
  • A battle is over when a combatant dies, retreats, or there is a draw. Battles can also be ended via the admin control panel.
  • A wager can be set on a battle. Whoever wins the battle recieves the amount of money as specified in the wager. Outside bets are not supported yet.
  • Battles can be either public or private, as determined by the admin control panel. If private, battles require a password and battles can not be browsed. If public, then any user can view any battle, but only the original combatants can fight.
  • The results of a battle can be posted into a designated "Battle" forum, as specified in the admin control panel.
  • Inactive battles can be pruned.

Getting started with the battle hack:
  • In order to get items to disply in the item shop, you must select which items go with which RPG Type in the "Edit Item Type" Menu of the admin cp.
  • In order to assign which weapon categories do what kind of damage in battle, you must go to the "Edit Category" link located in the "Edit Items" menu of the admin cp. Select a Battle type for the category and save changes.
  • In order to do damage to your opponent when in battle, you must assign the amount of damage each weapon does in the "Edit Items" menu of the admin cp. The default damage is set to 0. The same principle goes for armor, potions, spells, shields, etc.
Please refer to the screenshots or "readme.txt" for more information.

Why is this a BETA hack?

I have tested the installation of this hack on vBulletin versions 2.2.7, 2.2.8, 2.2.9, and 2.3.0. However, because of the scale of this hack, there is plenty of room for errors. Therefore I am making the following disclaimer while this hack is in the BETA stage:

  • Do not install this hack on a production board. Please keep this hack, while in the BETA stage, to a test board. The reason for not installing this on a production board is that I cannot provide upgrade instructions for going from one version of the beta hack to the next version of the beta hack. Also, this hack does not have an un-install script yet. So please remember, if you decide to install this on a production board, you are doing so at your own risk.
  • Do not apply this hack if you already have ANY of the included hacks installed. Please refer to the list at the top to see if you have any of the conflicting hacks installed. Since I am asking that you install this on a test board right now, this should not be a problem since you can re-install a fresh copy of vBulletin in under 5 minutes, as a test board of course.
  • There is currently no upgrade script for installing this over any of the included hacks. I will make one when this beta is completed.
  • If you choose to install the postbit features, then an additional query will be added to showthread.php. This query is a SELECT COUNT(*) query and adds around .001 seconds to the page generation. If you don't like the idea of adding an additional query to showthread.php, then you have the option of not installing that part of the hack. See the install file for more information.


The beta of this hack is free. The full/final release will also be free.

All installation instructions and credits are included in the attachment. If you find a bug or have problems, feel free to post them here and I will try to fix them. Please read the included readme file if you have questions. If you can't find the answer, then post your question here and I will answer it.

All hacks included in this hack have been re-released with permission of their original creators.

Screenshots are in the second post of this thread.


Installation instructions are included in the .zip file.


If you are having trouble and need some help, please refer to the help documentation included in the .zip file. It is located in the "extra" directory.

If you need help and you have already installed the hack, make sure you check the RPG Manual link in the admin cp. Also, make sure you read the FAQ included with the manual.

See if you are experiencing one of the following symptoms:
  • All of my users are being labeled as "Guest" in the postbit template.
  • No posts are showing up.
  • None of the RPG variables will display in the postbit. The element/gender/class images are broken.
  • I get database errors when I go to showthread.php

If you are experiencing one or more of the above problems, then your showthread.php file was not edited correctly by the installer. This problem usually occurs on boards with other hacks installed that modify the queries in showthread.php. Please go to and follow the instructions there.

The following add-ons are not included in the default installation. You must apply these add-ons after you have installed the hack successfully.

Member profile add-on
This add-on let's you display the user's RPG Stats in their member profile. See the .zip file for the add-on. It is located in the "Member Profile Add-on" directory.

Auto-update stats after posting
This add-on automatically updates the user's stats after they make a post, instead of having to click on the update stats button in the user cp. This add-on involves 2 file edits. The add-on is located at

Donation Queue by Darkwaltz4
Moderate all Donations. See Who is Donating to Who. All Donations go through Admins or Mods. The add-on is located at

Battle Background Midi System by Darkwaltz4
Full control over the music that plays during your battles! The add-on is located at

Randomized First Turn Addon by Moreliator
"The following code gives the challenger a 33% chance to start the battle and the challenged person a 66% chance. Works quite well. I also included instructions on how to display "Determining..." on the battle.php browse page, that way people won't decline a challenge if they see they aren't going first. ". The add-on is located at

Lock RPG Options at a Specified Level Addon by Moreliator
This addon allows you to lock all users' RPG options in their USER CP when they reach a certain level. This add-on is located at

Personal Shop Items Have Battle Bonuses by Triade
The original personal shop, allows to have an item the don't do nothing in battle. With this add-on, you can build items with bonus in battle (the bonus is in the attack now). This add-on is located at

Challengable Option by Darkwaltz4
Allows users to set themselves against recieving battle challenges. This add-on can be found at

Contact Info:
Email: bitsys AT mail DOT com
PM me for a faster response. I prefer PMs.

Update 09/04/03 @ 1:46pm

Battle debug messages were accidentally left on.
Minor shield bug was fixed in battlefight.php (Thanks Telchar).

Re-upload battleupdate.php and battlefight.php.

The new .zip file is located at the bottom of this post.

Finally, here is the .zip file (v0.68c):

Download Now

Only licensed members can download files, Click Here for more information.

Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
Old 06 Dec 2002, 07:34
zajako's Avatar
zajako zajako is offline
Join Date: Jan 2002
Real name: James Covey
Nice hack. And i thank you for askign permission about my hacks being used. You are truely a responcible hacker Just don't drink and hack It does not work well
Reply With Quote
Old 06 Dec 2002, 07:52
Goldknight's Avatar
Goldknight Goldknight is offline
Join Date: Aug 2002
Originally posted by zajako
Nice hack. And i thank you for askign permission about my hacks being used. You are truely a responcible hacker Just don't drink and hack It does not work well
Now all leave is.. YOUR hack Thats one I kept wait and eyes on your thread daily =P
Reply With Quote
Old 06 Dec 2002, 08:33
jjdog2 jjdog2 is offline
Join Date: Jul 2002
nice hack... I install and I did have a few problems, I would rather discuss it on AIM so I will add you to my list and PM you when I see ya on
Reply With Quote
Old 06 Dec 2002, 09:27
Ninth Dimension's Avatar
Ninth Dimension Ninth Dimension is offline
Join Date: Oct 2001
Real name: Daniel Hollands
Coolness, this hack looks cool, and i very much might have to spend some time testing this little baby out. well done and good work.

one quick question, I'm guessing that battles can go on for as long as need be until it's over? so that I can battle with someone that it's a diffrent timezone to me? (much like long distance games of chess?)
Daniel Hollands -
Interactive Story Site - Network -
Arathor Realm Forums -
Reply With Quote
Old 06 Dec 2002, 11:05
Kevorkian's Avatar
Kevorkian Kevorkian is offline
Join Date: Dec 2002
i've inserted the code for the exp bar ap ma ecc... but work only exp why?
Reply With Quote
Old 06 Dec 2002, 11:42
Kevorkian's Avatar
Kevorkian Kevorkian is offline
Join Date: Dec 2002
the life up with the post O_O i'm at seven post with 81 of hp
Reply With Quote
Old 06 Dec 2002, 12:34
DrkFusion's Avatar
DrkFusion DrkFusion is offline
Join Date: Nov 2001
I am not really a fan of RPG, but you have done a goo job looking from the previews.
Reply With Quote
Old 06 Dec 2002, 15:40
Bitsys's Avatar
Bitsys Bitsys is offline
Join Date: Oct 2002
I guess it is a good thing I don't drink

I'll be on AIM for a while today and most of the weekend. You are on my buddy list also.

Ninth Dimension:
That is correct, battles go on as long as possible and both combatants are NOT required to be online at the same time in order to fight. There are several ways a battle can end. If you kill the other player, then the battle ends. If you retreat from the battle, then the battle ends with you getting defeated (i.e. losing the wager). If you request a draw and the other player declines, then you cannot ask for another draw until after the other player requests a draw (and you decline his request). If you request a draw and the other player accepts, then the battle ends. If the other player is being extremeley stubborn, and you do not want to retreat and lose the money, then you can ask an admin to delete the battle from the admin control panel.

Look at the 'getpostbit' function of "functions.php" located in your admin directory. Search for code that is not tabbed over like the rest of the code (assuming you installed it with vbHacker). If you do not see code that is un-tabbed, then the install did not go as planned for some reason. Were there any errors in the installation? Also, did you update your stats in the user control panel? If you have not updated your stats or not selected an alignment/race/class/element etc. then you should get 0s for all of the values. At the moment, you are getting nothing (from what I can see). I have attached an image of an example postbit.


One thing I forgot to mention about the battle is that there is a built-in anti-grief mechanism. Whenever anyone challenges you, you will receive a PM explaining the terms of the battle. It will also include a link to the battle. When you click on that link (or the one on the battle browse page) you will be asked if you want to accept the challenge. If you decline the challenge, then the battle is over with no more input from you or the person that challenged you. This is in place because several of the level 21s on my forum thought it would be "funny" to challenge level 5s and kill them in one hit. Hence the term "anti-grief mechanism".

Here's the image, Kevorkian:
Attached Images
File Type: jpg postbit.jpg (18.8 KB, 262 views)
Reply With Quote
Old 06 Dec 2002, 16:29
Join Date: Nov 2001
Real name: Mike
holy monkeysticks, it's finally happens *hides in fear*

well it looks nice so far, just to wait now for the billion rpg forums around the internet to install this hack
Reply With Quote
Old 06 Dec 2002, 17:44
Dean C's Avatar
Dean C Dean C is offline
Join Date: Jan 2002
Real name: Dean Clatworthy
This looks quite nice

If i had a battle hack i dont want all this RPG stuff in it but thanks for sharing it with the community anyway


- miSt
Dean Clatworthy - Web Developer/Designer
Reply With Quote
Old 06 Dec 2002, 18:12
Velocd's Avatar
Velocd Velocd is offline
Join Date: Mar 2002
Real name: Mike
Looks interesting, would anybody be interested in giving a demo account if you have it installed on your forums? Before installation, considering it is a quite large.
Reply With Quote
Old 06 Dec 2002, 22:56
JaZz0r JaZz0r is offline
Join Date: Oct 2001
Very nice! I have installed it on my test board and FINALLY able to tease my users just a little bit more...

Suggestion: Would be nice to have an option to turn on/off the RPG postbit info (if there is an easy way to do this, please let me know!).

Edit: Can't battle for some reason. When I try to challange someone, I get an error: "Your opponent is ineligible for battle at this time." What makes us eligible? Characters appear to be complete...

Also: The requested URL /battleforum/mod/refill.php was not found on this server.

Last edited by JaZz0r; 06 Dec 2002 at 23:54.
Reply With Quote
Old 06 Dec 2002, 23:55
DarkDraco07's Avatar
DarkDraco07 DarkDraco07 is offline
Join Date: Apr 2002
hey bitsys, can i talk to you too on aim? my screen name is DarkDraco07
Reply With Quote
Old 06 Dec 2002, 23:58
DarkDraco07's Avatar
DarkDraco07 DarkDraco07 is offline
Join Date: Apr 2002
also can anyone make this store hack integrated? because im using the hack that lets you use store money in itemshop
Reply With Quote
Old 07 Dec 2002, 00:13
Bitsys's Avatar
Bitsys Bitsys is offline
Join Date: Oct 2002
If you want, you can make a test board (as stated at This is the easiest way to get familiar with this hack, since the admin features are half the fun It takes about 20 minutes to set up a test board and install this hack.

Could you please explain a little more about the on/off postbit thing? Do you want it to only display in a certain forum? Or do you want an admin cp "yes/no" button that turns it on and off for the whole board?

I found the missing file causing the 404 error. It was hiding from me. The next update will include it.

There are several checks in place before you can battle. When creating battles, it checks to see if
  • you have no class selected
  • you have no race selected
  • you have no gender selected
  • you have no alignment selected
  • you have no hp (you are dead)
  • you have no posts
If any of the above are true, with either you OR your opponent, then it will say you (or your opponent) are ineligible for battle.

I have fixed an error where the user's RPG name was not displayed properly in the battle arena.

I have added another feature. Instead of having a user's power level automatically calculated based on their post count, you now have the option to make a user's level admin-defined, based on a profile field in the `userfield` database. User fields can be added via the admin cp. The new feature will appear in the battle options menu, and I will upload that version (with the bug fix) as soon as I test it. Someone requested this feature (they also found the bug ).

Thanks to everyone who has tested (or wants to test) this hack! I greatly appreciate it!

Last edited by Bitsys; 07 Dec 2002 at 00:35.
Reply With Quote

Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

New To Site? Need Help?

All times are GMT. The time now is 01:27.

Layout Options | Width: Wide Color: