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

[Mijae]

not sure if its supposed to do this, but I can use heal.php DURING a battle.

[Mijae]

A simple request:

How can I add the level, class, in battle, etc for my forumhome template?

[Strider Xero]

Bitsys, for some reason on my test board a member's full stats shows as follows:

Class: Assassin
Race: Orc
Alignment: Evil
RPG Gender: Male
Attack: 0
Magic Attack: 0
Speed: 0
Defense: 0
Magic Defense: 0
Evade: 0

I'm using the default numbers for magic attack, speed, etc. Also, the level isnt showing up in the postbit for some reason. And lastly, the guy thats battling me gets an error when he tries to attack. He has yet to post the error. I will post the error once he gives it to me. Until then, what could the other stuff be caused by?

[SpyGuy007]

Originally posted by v0id
A simple request:

How can I add the level, class, in battle, etc for my forumhome template?

Yes, this would be an excellent add-on for my "Account Information" sidebar on my forumhome.

I beleive it's a simple database query to add onto index.php, but I don't want to give the wrong instructions. I'll try it out and see if I get the right query and I'll post it here, but I bet Bitsys will beat me to it.

[Bitsys]

Hey Guys! I got really sick on Thursday, and this is the first time I have been one my computer since then, so I am back as long as I don't get sick again.

Originally posted by Strider Xero
Hey bitsys thanks a bunch, it worked!! =)

Suggestions

Forgive me if someone has already mentioned these, but I think it's a pretty reasonable and logical suggestion. Bitsys, do you plan on making different levels of classes?? For example, say a new nember chooses his Class as a normal Wizard. Once he/she reaches level 10, he/she will be automatically Re-classed as a Magician. Once he/she reaches level 20, again the user will re-classed to "Mage". When the user reaches 30, they become a Summoner, and so on and so on. Is this feature planned for future releases??

Also, I noticed on some boards, once a user chooses an alignment, element, race and class, it becomes permament. As in they will not be able to change any of it with that username--unless of course the feature I mentioned above was implemented, and only their class would change. Do you plan on making this feature in future releases??

Suggestion1: I believe that was in the original class hack. The problem I had with it in this hack is that for each class, you would have to assign a post count and a Name for that level of the class. This seemed like a ton of work, plus, it would have been hard to implement in the postbit stuff as well as battle. I am still looking into it though.

Suggestion2: It has been suggested before, and I am still thinking about it.


xxskullxx (first post):
Assuming you are still having that problem, what do you have your battle options screen set to?


PSI|Dr-X:
It would be out sooner if I hadn't gotten sick and if I didn't have tomorrow booked solid.


VeoMorphine:
Strider Xero explained how do to that 2 posts above you. If you do want that feature, then you can no longer have levels based on post count. However, if you still wnat levels based on post count, then I can make it so that only the winner of the battle gets experience when the results of the battle are posted to a forum.


Mrpolish:
The referral idea sounds easy enough.

The problem with updating stats automatically is that every time you made a post, it would have to run through the update stats code. I am not sure that this is what everyone wants, since that would add quite a few queries each time a user posts.

v0id:
How did the battle end?

They should not be losing money when they update their stats. In fact, the update stats code does not even touch the user's money. There must be something else causing the members to lose money.

v0id (second post):
Nope, its not supposed to do that. I will look into it.

v0id (third post):
Open up "Member Profile Add-on.txt" that was included in the .zip file. Copy the appropriate code into index.php above the point where the forumhome template is called.

In the code you just pasted, find:

PHP Code:

user.userid=$userid 


and replace it with

PHP Code:

user.userid=$bbuserinfo[userid] 


You should now be able to use all of the variables that are listed at thebottom of "Member Profile Add-on.txt" in your forumhome template.


Strider Xero:
What are your Battle Options set to?

[Mijae]

I found another bug/error:

When you enter ' in a battle's name it will cause a mySQL error and the battle cant go through.

[Bitsys]

Originally posted by v0id
I found another bug/error:

When you enter ' in a battle's name it will cause a mySQL error and the battle cant go through.

Thanks. It will be fixed in the next version.

[Strider Xero]

Edit Battle Options
Name of the field used to store a user's RPG name - field6


Battle Hack is on. - Yes

Maximum number of battles - 0

Battles are private. - No

Refresh time to automaticaly refresh battles (in seconds). - 60


Last activity time for pruning battles - 604800


Post battle results. - Yes

Power Level Options
Do you want a user's power level calculated by and based on their post count? - No

Power level modifier
This controls how fast user's gain levels based on their post count. - 3


Name of the field used to store a user's level. - field7


Experience Options
Give experience to users for participating in battles based on the number of turns. - Yes

Amount of experience to give per turn in battle. - 10


Give experience to users for participating in battles based on the winner of the battle. - Yes

Amount of experience to give per win in battle. - 10


Name of the field used to store a user's experience - field8

[PSI|Dr-X]

Hey i found a bug i think

If i do the Do you want a user's power level calculated by and based on their post count? - No

then there is a mysql error

[Bitsys]

Strider Xero:
Make sure that you have created two user profile fields, one to store the user's level, and another to store the user's experience. Then, make sure that you and your opponent have those fields filled in appropriately. You can do this in the admin cp by viewing a user's profile in the admin cp.

I think I will change the whole experience/level system. Here is how the new system will work, let me know what you think:

Two new fields will be created in the user table. One will be called experience, the other will be called level. Any time a user posts, they will gain experience (if the admin chooses that option). That experience will add to their total experience (can be greater than 100). In order to calculate the user's level, I will use the same formula that is currently used for the user's post count. So, a user with 63,000 experience will have a level based on what you set the power level modifier to. If you set the modifier to 5, then with 63,000 experience, the user may only have a level of 27, but with a modifier of 1, the user may have a level of 2,000. The remainder of experience above the level will be used to calculate the user's progress towards gaining another level. This system will be better for the following reasons:

• People who want to use the post count to determine experience can still do so.
• People who want to give experience based on battle AND post count can do so.
• People who want to be able to manually change the user's experience/level and make it PERMANENT will be able to do so.
• I can still make it retroactive based on post count.
• Users can still gain experience based on battles even if the admin chooses not to post the results of the battle to a forum

This will simplify the battle options menu greatly. If I were to implement this system, there would be much fewer database errors since there is no need to iunput the correct name of the user profile field. Also, Admins could switch between systems at any point in time, without worrying about users losing levels and experience.

Let me know what you think or if you need a little more explanation. Overall, I think this would be for the better if I changed it around a little bit.


WAIT! I just had another idea. Instead of making two new fields, I only need one - the experience field. Assuming that you would want to use the formula, I could make it so that everything is based off of experience, and the level is automatically calculated from that. Whenever you wanted to reward a user, you could give him/her a specific amount of experience. The higher the user's level, the more experience they would need to get to the next level.

So, how about that?