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

[Bitsys]

SpyGuy007, I love your forums! Do you mind if I put your FAQ in the next release of the help file?

Also, I forgot to mention in my last post that the next version will include an uninstall script. You will be able to run the uninstall script and the install script interchangeably. I have been doing it all day - installing the hack, then uninstalling it, etc. I have done it about 10 times in a row and it works great! Hopefully I will be able to release it tomorrow, but it depends on how soon New Years Eve starts

[Kaelon]

Great job, Bitsys!

Have you tested the install/uninstall script on non-standard (i.e., modified) vBulletins? I'm hoping to start testing this on an exact copy of my forums, which are heavily modded.

Thanks a bunch!

Regards,
Kaelon

[SpyGuy007]

Originally posted by Bitsys
SpyGuy007, I love your forums! Do you mind if I put your FAQ in the next release of the help file?

Also, I forgot to mention in my last post that the next version will include an uninstall script. You will be able to run the uninstall script and the install script interchangeably. I have been doing it all day - installing the hack, then uninstalling it, etc. I have done it about 10 times in a row and it works great! Hopefully I will be able to release it tomorrow, but it depends on how soon New Years Eve starts

Why, thank you, and of course, I don't mind!

[Xyphen]

Originally posted by Bitsys
SpyGuy007:
Yes, that has been requested numerous times. Right now, I have plans on providing integration instructions after I release it. Or, I might provide a separate set of .php files that you can simply upload in place of the other ones.

AViO 07:
Someone pointed that out the other day. I have gone through battleupdate.php and hopefully found every occurance of a gender specific word and replaced it with a variable that inserts the correct word. An updated battleupdate.php will be included in the next release.


Speaking of the next release, it will have a new feature. In the admin cp, you will be able to add different backgrounds for the battle arena. Then, when the user creates a battle, they can select which background they want.

Hey, I was about to suggest the background thing next, lol, anwayzy, thats good you already thought of it. Also, I flipped all the character images, males and females. So now they are facing each other. If you want I can tell you what to do and give you all the images..

[Xyphen]

Bitsys, I found a bug, and I also have a suggestion..

Bug

The bug i found is, the Personal Itemshop doesn't work, you can't buy from a personal itemshop, you can't sell from a personal itemshop. nothing.. but you can create the person Itemshop.

Suggestion

Three suggestions, in the next realse, can you make this addon, that when 2 members are battling, On online.php it says, In Battle. Second suggestion is, if you can think about the Clan addon i told you about, where ppl can make there battle clans aproved by admins, and other members can join, there clan info is displayed on their user profile. Third suggestion, can you please make the fists work -_-, i asked this before, you could make it the lowest attack or whatever, just make it work, and sometimes it should miss also.

If you can take these suggestions under consideration, and make them I would be so GLAD, and let me know if you need help with anything. I am here, also sry about the double posting -_-.
Once again i would like to thank you Bitsys for making such an amazing hack the best hack so far.. at least for me..!!

[Bitsys]

Kaelon:
I have not tested the script on hacked an extremely hacked board. However, if the install script runs flawlessly, and you do not edit any of the RPG code that is inserted, then the uninstall will also work flawlessly. Either way, if it can't undo the changes to the .php files, then you can always re-upload the saved files, or do it manually. The database queries will always remove the appropriate tables from the database.

AViO 07:
Sure, I'd love to see what you did to flip the images!

AViO 07 (second post):
That bug was caused by a bug I fixed. In previous versions, you could "create" the buy item URL from scratch if you knew certain characteristics of the item you wanted to buy. To fix this, I had to add code to check and make sure you were eligible to buy the item. In the process, I forgot that personal items do not have the same rules as normal items, thus making them un-purchaseable. This problem will be fixed in the next version. Thanks for finding it!

I will fix online.php also, since it currently only has one of the files in the array.

Could you explain a little more about what you had in mind about the clans and how they relate to the battle/rpg hack?

Fists should be working in version 0.57. They should do 10 * your level in damage. Let me know if this is not the case, and I can run some more tests.

[Xyphen]

Ok, the fists don't work, I upgraded.. lol. I have another suggestion and i'll explain about the clan. Ok

CLan
Someone applys to open a clan, if hes accepted by the admins, he has his own clan. Now when people visit clans, they see all the clans that are created, if they want to join the clan. The click join. And the leader of the clan has some rules, like your level should be 10, or your hp must be 500+. Like that, if the person meets the requirements, he can join the clan. All the members in a clan, have some things, like. If one of the members win a battle, he gets this much amount of money automatically, and he gets whatever amount of money weekly or monthly. Also every clan can have a 50x50 icon which is displayed on members profile, and on the leaders profile it says Lead of the "Clan name".
and displays the CLan Icon. Also every clan has a little description which is displayed on every members profile.

Suggestion
Ok, the suggestion I have is, you should also add a little battle Text on the postbit, so if someone wants to battle someone, they click battle on their post, and it goes to the battle start page, with the username of the person they clicked on already entered.

Another Suggestion
ok, one last suggestion, every member should be allowed to set the amount of wager they would take, anything lower is acceptable, but nothing higher is acceptable. Ok, say I set $600 wager maximum, no more then that. THen anyone who challanges me, if he has $700, it will give an error, saying User Doesn't accept wager higher then $600. Isn't that a good idea?
but if the challenger puts wager anything lesser then $600, or even $600, the battle message has gone to the oppenent.

[Xyphen]

Also, bitsys, if you want to see how my image system works, all i did was open all the images of the classes, flip them, and edit template called
battle_arena, and put a 1 beside the whatever is on the left.
So its like this $opponent[classfolder]1.gif instead of $opponent[classfolder].gif
And I have all the flipped images saved as, name1.gif.
If you want the images, i'll upload them ^_^

[PSI|Dr-X]

And bytsis can you arrange that the battle stats in a fight does appear under the battle screen it would be easier i think


AVIO 07 :

i wanna have them if you agree with it

BYTSIS:thnx very much bytsiS FOR THE greatest hack in the century ^_^

[Bitsys]

Version 0.58 is done (see the first post for an updated .zip file). An upgrade file is included in the upgrade directory. Please follow the instructions EXACTLY. They are a little different this time.

Bugs:

• Fixed bank money not showing in itemshop.
• Reduced queries in battlefight.php down to 15 when it is not your turn (i.e. when anyone but the combatants views the battle, there are only 15 queries made.)
• Adjusted several input boxes in the RPG Admin menus. The positions changed around and were made uniform.
• Fixed inability to buy personal itemshop items.
• Fixed gender-specific wording in battleupdate.php.
• Some other typographical errors.

Features:

• You can now add/delete/edit battle scenes in the admin cp. Users get to select which one they want when they create the battle. The same battle scene stays throughout the entire battle.
• Fists now do damage.
• The help Documentation has been updated again and will now be included in each version of the hack. It is located in the "extra" directory. This can be used in place of the readme file.

AViO 07:
The Clan idea sounds like it will take a while. Maybe after full release.

1st suggestion:
I think I can do that. I don't know if I will get around to it though, it has been on my list for a while.

2nd suggestion:
I like that idea. Once again though, I am not sure I will be able to implement it in time.

AViO 07 (second post):
I'd love to see the images!

PSI|Dr-X:
You want everyone's battle stats displayed in the battle arena?