RPG Integration Hack /w Battle (BETA)

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:

• Zajako's Ultimate HP/MP Stats Hack -----(https://vborg.vbsupport.ru/showthrea...threadid=37720)
• Zajako's RPG Elements Hack -----(https://vborg.vbsupport.ru/showthrea...threadid=35318)
• Zajako's In battle hack -----(https://vborg.vbsupport.ru/showthrea...threadid=42715)
• Zajako's RPname hack -----(https://vborg.vbsupport.ru/showthrea...threadid=43651)
• DV class hack used with permission of J2K (aka the RPG Class Hack v3.3) ----- (https://vborg.vbsupport.ru/showthrea...threadid=43558)
• Mewtwo's/Rake's Original Itemshop v5 -----(https://vborg.vbsupport.ru/showthrea...threadid=38090)

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:


WARNINGS:

• 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.

Miscellaneous:

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:

Installation instructions are included in the .zip file.


ACKK! I NEED HELP!!!

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.

MY THREADS STOPPED DISPLAYING CORRECTLY!!!
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 https://vborg.vbsupport.ru/showpost....postcount=2261 and follow the instructions there.


Add-ons:
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 https://vborg.vbsupport.ru/showthrea...452#post356452

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 https://vborg.vbsupport.ru/showthrea...652#post408652

Battle Background Midi System by Darkwaltz4
Full control over the music that plays during your battles! The add-on is located at https://vborg.vbsupport.ru/showthrea...530#post410530

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 https://vborg.vbsupport.ru/showthrea...614#post410614

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 https://vborg.vbsupport.ru/showthrea...111#post411111

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 https://vborg.vbsupport.ru/showthrea...328#post426328

Challengable Option by Darkwaltz4
Allows users to set themselves against recieving battle challenges. This add-on can be found at https://vborg.vbsupport.ru/showthrea...143#post411143


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

~~~~~~~~~~~~
Update 09/04/03 @ 1:46pm
v0.68c

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):

[Vivi Ornitier]

okay i'm just curious. I haven't installed this hack yet but ummm . . . u said it's not installable if you have any of the other hacks installed. I have like half of those hacks installed already, so is it just impossible for me to install the hack now? Even if i get rid of those hacks and start over again? Also i'm on 2.2.6, any confirmation that it works on it? Any clue when the final release comes?

[Bitsys]

Originally posted by Dribbles
I'm trying to figure out how much experience I should award users per post and for fights, etc ... just curious, when it says set how much experience a user needs before going up a level (choose number between 1-5) ... how exactly does it work? Is it the same number of experience to go up every level? (ie- level 1 -> level 2 = same amount needed as level 75 -> level 76) ... also, how much experience in points do the numbers 1 -> 5 relate to? thnx

The level formula is logarithmic. Therefore, the higher your level, the more experience it takes to gain another level. If you want to see the actul code, then search for the getlevel function in admin/functions.php.

Originally posted by Darkwaltz4
and....if ur interested, maybe this could be integrated as well? or just an addon?

The add-on sounds pretty cool. I can't guarantee that I'll integrate because I need to look at the source code first.

Originally posted by chrisz
Bitsys when I lvl up on my forum how come my HP doesnt rise???

Like geniuscrew said, did you update your stats in the user cp?

Originally posted by Vivi Ornitier
okay i'm just curious. I haven't installed this hack yet but ummm . . . u said it's not installable if you have any of the other hacks installed. I have like half of those hacks installed already, so is it just impossible for me to install the hack now? Even if i get rid of those hacks and start over again?

If you get rid of those hacks, then you should be fine installing this hack. The reason why you can't have both installed at the same time is because they use a lot of the same variables. Just make sure that all of the hacks are removed before installing this hack.

Originally posted by Vivi Ornitier
Also i'm on 2.2.6, any confirmation that it works on it? Any clue when the final release comes?

There have been 2 or 3 people that have reported it working fine on version 2.2.6. I myself have not tested it on 2.2.6, but I don't think you will have any problems. No date for the final release yet. There is still one bug that I am looking in to.

[h4x0rtje]

Vivi Ornitier: It works for me fine on a fresh 2.2.6 no problems !

[Mystic Gohan]

I like the Esper System add-on you have. I would like very much on my forum. As I am a Final Fantasy fan

[Darkwaltz4]

alright--i wanna fix up a few little things, and finish adding pp potions. then ill prolly pm you all the edited files bitsys

i think for shields, itll need a 'lastmove' column for the battle table, which would record the itemtype used last battle, and 0 if it was fists or something. then u could track if a shield was cast the last move, and to act differently upon it. i definately wanna incorporate that ^_^

[Bitsys]

Originally posted by Darkwaltz4
i think for shields, itll need a 'lastmove' column for the battle table, which would record the itemtype used last battle, and 0 if it was fists or something. then u could track if a shield was cast the last move, and to act differently upon it. i definately wanna incorporate that ^_^

Just use the winstatus column. That column isn't used until someone wins, and since you can't attack after someone has won, then it should be free for you to use for the shield status.

[Darkwaltz4]

what exactly were the 'beta tests' done? u keep mentioning passed failed things, but i dont know what you tried *shrugs*

[Dribbles]

Are the weapons working for anyone in v.63? For some reason, it's not working for me still Maybe it could be the Lesane store hack?

[Dribbles]

Just checked ... When I add a new item, it's not showing up in itemshop.php either

[Bitsys]

Originally posted by Darkwaltz4
what exactly were the 'beta tests' done? u keep mentioning passed failed things, but i dont know what you tried *shrugs*

Are you referring to the things that I have tried but didn't actually work out?

If so, then the major one was limit breaks. The original RPG Class Hack had limit breaks for different classes. You would get a new level break after getting a new level.

The way I saw it was that these limit breaks took a certain amount of PP to execute. So, if I wanted to use "Dragon Punch" in battle, then it might cost me 300 PP, etc. These limit breaks would each do a certain enhancement, like 200% extra damage, or skip a turn, or immobilize your enemy for a turn. Basically, they were special attacks that could affect the status of the battle in a unique way. Mind you, this was when the moderators calculated damage for a battle and subtracted the HP manually. The Mods also did the coin flipping and sometimes the narration.

When I originally set out to do the RPG hack, I was very intent on having PP and limit breaks. However, I looked at the code and it did not seem feasible for several reasons:

• Each class had 5 limit breaks. Approx. 30 classes * 5 limit breaks = 150 different limit breaks, which is quite a few.
• Each limit break would have to have one or more special pre-designed abilities that could affect the battle. They would also have to take away a set amount of PP.
• There would have to be a system for gaining a level break. Would it just be that you automatically get it when you reach a certain level? Or should there be a training ground?
• The database structure would have been very complicated. What happens when the admin deletes a class? Would the user lose the limit breaks associated with that class, and possibly lose all of that hard work in the training grounds?

Problems such as these caused me to push the limit breaks and PP off to the side. I tried to do part of the table structures, but gave up. I can see a way of doing it now, but it wouldn't stay true to the original Class Hack.

I am not saying that it is impossible, it would just be more difficult than a lot of the other parts of the hack. I don't think it would be as hard as the php/javascript code I put into member.php to automatically update the races/classes based on what you choose.

That is the main feature that I have tried and felt like it wasn't worth the time to implement. However, I am not discouraging you against pursuing this add-on or any other add-on. Just because I didn't feel like it was feasible, that doesn't mean you won't.

Most of the other things that I have tried and failed at were just incremental parts of the hack. Like, the original way I had battles set up was rather horrible. So I changed it and re-wrote the code. That version was pretty bad too. So I changed it again. This process went on and on until you see what it is now.

Originally posted by Dribbles
Are the weapons working for anyone in v.63? For some reason, it's not working for me still Maybe it could be the Lesane store hack?

They work for me. I don't think it is Lesane's store hack, since that only affects the monetary system and itemshop. Check your PMs.

Originally posted by Dribbles
Just checked ... When I add a new item, it's not showing up in itemshop.php either

Make sure you are assigning it an RPG Type in the Edit Item Types menu. Just click the checkboxes below the class types that you want to have access to that weapon.