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 16 Feb 2004, 20:14
PixelFx PixelFx is offline
Join Date: Dec 2002
Originally Posted by Rogue Pan
i know it has to be i am half way in to it
Please let me know if you need any testers on this
Reply With Quote
Old 17 Feb 2004, 08:23
chrisz chrisz is offline
Join Date: Jan 2003
My friend Metal Gear I almost finished the vB3 version.
He made it for wbb and phpbb.
He is about 70% done
Reply With Quote
Old 17 Feb 2004, 10:01
deathemperor's Avatar
deathemperor deathemperor is offline
Join Date: Jul 2003
Real name: Lucius Hunk
Wow, this is a very impressive new ! I am curious about it,hope to see it soon !
thank you guy much !
Reply With Quote
Old 18 Feb 2004, 09:16
Rogue Pan Rogue Pan is offline
Join Date: Mar 2002
i am metal gear lol
Reply With Quote
Old 18 Feb 2004, 11:05
deathemperor's Avatar
deathemperor deathemperor is offline
Join Date: Jul 2003
Real name: Lucius Hunk
so you are working on it ? 70% right ?
Reply With Quote
Old 18 Feb 2004, 23:00
Rogue Pan Rogue Pan is offline
Join Date: Mar 2002
its more 80% i need someone to do the templates
when i look over the php files so it can be done faster

Last edited by Rogue Pan; 18 Feb 2004 at 23:04.
Reply With Quote
Old 19 Feb 2004, 02:24
deathemperor's Avatar
deathemperor deathemperor is offline
Join Date: Jul 2003
Real name: Lucius Hunk
thank you for the very interesting news
Reply With Quote
Old 23 Feb 2004, 11:10
PixelFx PixelFx is offline
Join Date: Dec 2002
I may be able to help with templates, if needed, hows your progress? and do you plan to release this to the public? Hopes
Reply With Quote
Old 26 Feb 2004, 02:43
Kerrek Cage Kerrek Cage is offline
Join Date: Nov 2003
Quick question... I am noticing that the Admin Manual is incomplete. One of the categories is missing, and it's a crucial portion of it..
Reply With Quote
Old 07 Mar 2004, 06:15
rikku3978 rikku3978 is offline
Join Date: Mar 2004
Guys, I'm really REALLY sorry. But I'm not going through a whole 162 pages to find the problem I'm having.

I just want to know, is there any possible way to get this thing to work on 2.3.4?
Reply With Quote
Old 07 Mar 2004, 06:26
Jagang Jagang is offline
Join Date: Mar 2003
It does work on 2.3.4. Now, I'm really REALLY sorry. But I'm not going to mind read through your whole brain to find out the problem your having. So why don't you tell us about it and we'll see if we can help you.
Reply With Quote
Old 07 Mar 2004, 07:58
rikku3978 rikku3978 is offline
Join Date: Mar 2004
Well, I didn't want to bother anyone if it didn't work on vB 2.3.4

None of the stats are working in the hack, and I'm getting a lot of errors.

When trying to post a reply

Database error in vBulletin 2.3.4:

Invalid SQL: SELECT field5 FROM userfield WHERE userid='1'
mysql error: Unknown column 'field5' in 'field list'

mysql error number: 1054

Date: Sunday 07th of March 2004 02:59:20 AM

Most of the errors look like that.

Thanks for the help.
Reply With Quote
Old 07 Mar 2004, 08:44
Jagang Jagang is offline
Join Date: Mar 2003
The error you posted is saying you don't have a custom field with a field id of 5. This is for the points or "money" setting of the hack and can differ from board to board depending on your setup.

Go into your Admin CP and go to the section User Profile Fields, click Modify, you should see the title Points listed. (If it's not here, create it) Place you pointer over the edit for Points and look at the status bar of your browser, you should see something like this:

OK now what's important is that last #, in my example 5 but yours might differ - take that # and go to Itemshop, Edit Options. you will see a field labled Point Field enter in field# where # is the number you had previously.
Reply With Quote
Old 07 Mar 2004, 17:06
rikku3978 rikku3978 is offline
Join Date: Mar 2004
okay, that helped that error. Thank you!

But, on the postbit, the RPG stats do not update. And I am unable to gain any points for posts.

Edit: That stats work in the RPG CP but not in the main posts.

Last edited by rikku3978; 07 Mar 2004 at 17:30.
Reply With Quote
Old 07 Mar 2004, 20:40
Jagang Jagang is offline
Join Date: Mar 2003
Are you using the Auto-Update Stats Add-on ? If not you can find it with the files in the original zip. This allows for stats to updated after each post, otherwise they don't update til a player goes into their user cp and update them manually. Also check you settings in the Admin panel. Under Battle, Edit Options, look for Experience Options Now make sure these are on and set the way you want. If you not gaining experence nothing else will change. Also for money look to Itemshop, Edit Options, Activity Points - number of points given to members for each reply and new thread and make sure you have a number here. Also make sure the forum settings are set to: Count posts made in this forum towards user post counts? Yes If it's set to no then posting in that forum won't affect stats. This is useful if you only want users getting experence & money from posting in certain forums. however it does take away a post total from the rest of your members. Let me know if any of that helped.
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 16:58.

Layout Options | Width: Wide Color: