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

[chrisz]

It works fine on my forum.
Some little bugs but they have all been fixed by the great Bitsys.
Thnx DarkWaltz your always a big help
And yes about listing the RPG members...
Like how there is the memberlist can you make one of those except they are RPG characters?
Thnx a bunch everyone.
EDIT: How do I make it when they go to the Itemshop it automaticly take it to the items available in their Item Type like generic, ranger or whatever.
Like at DarkWaltz forum.

[Bitsys]

Originally posted by Moreliator
Thanks bitsy!

Say, is there an easy way to import your RPG settings to another board (excuse me for my ignorance)... Like a template upload or something?

Not really.

Originally posted by Moreliator
Also, just a quick question regarding a user's character... are there any penalties for switching characters (like XP loss or level loss) or can users constantly change characters without any consequences?

They can switch constantly with no penalties.

Originally posted by Moreliator
If this is the case, is there anything stopping a user from buying an item with an allowable RPG type and then switching types, illegaly using an item with an RPG type he shouldn't be? Hopefully thats clear enough, if not I'll expand on the question.
Thanks for your quick and thorough answers bitsy.

If they have an item that is meant for a different type, then they will get an error message in battle telling them to sell the weapon. They won't be able to use the weapon.

Originally posted by chrisz
Hey how can I close my itemshop?
I am adding a idea and closed the battle but how do I do the same to the Itemshop???

Do what Darkwaltz4 said.

Originally posted by DaPro
Itemshop items have always been ok, just clases and what not not working, it is really weird, and when I ran the install again, it worked like I installed it for the first time, but when I went to user cp, still empty drop downs. ran the db fix 3 times, same response and no change, please help.

Installing it more than once without uninstalling first is very bad. When you do this, it sometimes adds the code edits more than once. It also adds all of the items more than once, and has the possibility to add the classes/types more than once. This will make the hack function in an unpredictable way. When I went to your itemshop, I noticed that the items were installed 3 times. That's not good.

Before installing this hack, you should have saved copies of the .php files that were edited. Re-upload these original files in order to remove the hack. Go back to vbhacker. Start to install the hack. This time, however, don't run the template edits, don't run the new templates, and don't run the database queries. Only do the file edits. Make sure you record what goes wrong, if anything. Vbhacker will tell you if something goes wrong, make sure to pay attention.

Back to the emtpy drop downs. Go back to vbhacker and select my hack. Before clicking on the continue button, make sure you click the radio button that says "Generate a text file". After doing this, click the continue button. It should give you a text file. In this text file, look for the edits that are done to member.php. Once you find them, try to manually apply them to member.php. If they are already there, then don't re-apply them.

Originally posted by PSI|Dr-X
Idea till the next version?

Nope.

Originally posted by Mystic Gohan
I think there should be like a rafle thing that all the members that pay like so much can get a large sum of money when ypi choose. I think there is hack like this for Lesane's Store could that be ported to this hack?

I am not familiar with that hack. I guess it could be ported with minimal effort. I really don't know though.

Originally posted by sonic3d
i was wondering can some1 (it can be ne1) make a page where it will list all the members with the rpname, lvl, class, alignment, element. i think its very easy to do.

l8er
sonic

That seems fairly easy to do. It would require some more templates though.

Originally posted by Colon33
How stable is this version yet? My members are really eager


Are there any MAJOR bugs with it yet?

Its fairly stable. There will be at least 3 bug fixes in the next version though. There have been well over 40 bug fixes in the past, from version 0.50 to the current version.

[chrisz]

Ok sounds cool what about my last post bitsys?

[Vivi Ornitier]

when's the summon thing com eout? my members are too hyped about it

[chrisz]

Yeah I know.
Bitsys came on a few times but I didnt think he noticed the posts I really wanna finish all I need is the summons, and some small requests that I made like RPG memberlist and the Itemshop mod that Darkwaltz has.

[Bitsys]

Originally posted by chrisz
EDIT: How do I make it when they go to the Itemshop it automaticly take it to the items available in their Item Type like generic, ranger or whatever.
Like at DarkWaltz forum.

Originally posted by Darkwaltz4
all basically done by tacking ?itemtype=$bbuserinfo[rpgtype] to all itemshop.php urls.

From https://vborg.vbsupport.ru/showthrea...710#post347710

I guess that is how he did it. He can probably write you some instructions or something if you need them.

[chrisz]

Ok thnx I will wait for him to post.
Can you make the RPG memberlist Bitsys?
EDIT: Also Ithink that has alreay been answered but anyways..
Is there anyway to make the person who goes first random?
EDIT: Also how do I add the users avatar next to what his says while battling?

[Bitsys]

Originally posted by chrisz
Ok thnx I will wait for him to post.
Can you make the RPG memberlist Bitsys?

Not right now.

Originally posted by chrisz
EDIT: Also Ithink that has alreay been answered but anyways..
Is there anyway to make the person who goes first random?

Not really. I wouldn't suggest doing it either. The reason why the battle starter doesn't get to go first is so that the person who is challenged doesn't get roped into a battle and die without getting a chance to fight. It seems more fair this way.

Originally posted by chrisz
EDIT: Also what file do I edit the stuff they say during battle like
Username taunts or Username misses Username gains 15ap?

All of that is in battleupdate.php.

[chrisz]

Ok I found that how do I add the persons avatar next to what they said during battle?

[Bitsys]

Originally posted by chrisz
Ok I found that how do I add the persons avatar next to what they said during battle?

In battlefight.php, find:

PHP Code:

/*
                $owneravatarurl=getavatarurl($ownerstats[userid]);
                $oppavatarurl=getavatarurl($oppstats[userid]);
                if (isset($owneravatarurl) and !empty($owneravatarurl)) {
                        $owneravatar = "<img src="$owneravatarurl"></img>";
                } else {
                        $owneravatar = "<br>";
                }
                if (isset($oppavatarurl) and !empty($oppavatarurl)) {
                        $oppavatar = "<img src="$oppavatarurl"></img>";
                } else {
                        $oppavatar = "<br>";
                }
                */ 


and change it to:

PHP Code:

                $owneravatarurl=getavatarurl($ownerstats[userid]);
                $oppavatarurl=getavatarurl($oppstats[userid]);
                if (isset($owneravatarurl) and !empty($owneravatarurl)) {
                        $owneravatar = "<img src="$owneravatarurl"></img>";
                } else {
                        $owneravatar = "<br>";
                }
                if (isset($oppavatarurl) and !empty($oppavatarurl)) {
                        $oppavatar = "<img src="$oppavatarurl"></img>";
                } else {
                        $oppavatar = "<br>";
                } 


Then, in the battle_postbit and battle_postbit2 templates, add $owneravatar where you want the owner's avatat and $oppavatar where you want the opponent's avatar.

I have not tested this in a long time, so it may not work. Also, doing this will add at least 2 queries to battlefight.php.