Bobstah's Enhanced Equipment, Item, Items Command, Skill, and Skill Type Restrictions 1.5.3

Spoiler





A group of restrictions is contained between the <Restrict> tags. You can have more than one group of restrictions per equip or item, and the actor only has to meet one set of restrictions. If you want multiple restrictions to be met, use a single group instead.





If desired, you can prefix any Restriction with an !. This will cause it to check the opposite of what you specify. If you use it with Actor: 1, for example, anyone but Actor 1 can equip the item.





You can also replace anything after : with Javascript code inside of $(), like so: Actor: $(yourFunction() ;)





You can even combine the two: !Actor: $(yourFunction() ;)





Below are all of the available options:


<Restrict>


LevelMin: X - Minimum level.


LevelMax: X - Maximum level.


Class: ID - Actor must be class ID.


Actor: ID - Actor must be this ID.


State: ID - Actor must have state ID applied.


Weapon: ID - Actor must be wearing this weapon.


Armor: ID - Actor must be wearing this armor.


StatMin(Symbol): X - Stat Symbol must be at least X.


StatMax(Symbol): X - Stat Symbol must be at most X.


Switch(ID): On/Off - Switch ID must be on/off.


VarMin(ID): X - Variable ID must be at least X.


VarMax(ID): X - Variable ID must be at most X.


Custom: $(codeHere) - Run some Javascript.


</Restrict>





To restrict a global property, like a Skill Type, add the following to any actor's note field:


<Restrict SType: ID,ID,etc>



LevelMin: X - Minimum level.


LevelMax: X - Maximum level.


Class: ID - Actor must be class ID.


Actor: ID - Actor must be this ID.


State: ID - Actor must have state ID applied.


Weapon: ID - Actor must be wearing this weapon.


Armor: ID - Actor must be wearing this armor.


StatMin(Symbol): X - Stat Symbol must be at least X.


StatMax(Symbol): X - Stat Symbol must be at most X.


Switch(ID): On/Off - Switch ID must be on/off.


VarMin(ID): X - Variable ID must be at least X.


VarMax(ID): X - Variable ID must be at most X.


Custom: $(codeHere) - Run some Javascript.


</Restrict>





You can also restrict the Items battle command by using <Restrict Items> and any of the above options.








For more information on eval, check the plugin's help documentation.






Examples





Spoiler





Let's make an Evil Sword that anyone but our Paladin, Actor#1, can equip:
<Restrict>
!Actor: 1
</Restrict>

Next, let's make a potion that someone can only use at level 5, 6, 7, 8, 9, and 10:
<Restrict>
LevelMin: 5
LevelMax: 10
</Restrict>

Let's build on that and say that only Actor#3 can equip a piece of armor whenever they want, but other actors can only wear it between levels 5 and 10:<Restrict>
actor: 3
</Restrict>
<Restrict>
LevelMin: 5
LevelMax: 10
</Restrict>

Building on that even more, let's go all out. The following example will allow any class but class#1 to equip it as long as their atk is at least 5, variable#6 is at least 10, and switch#4 is turned off. Or, they can be actor#3:
<Restrict>
!Class: 1
StatMin(Atk): 5
VariableMin(6): 10
Switch(4): off
</Restrict>
<Restrict>
Actor: 3
</Restrict>

Next, we'll check to see if an actor has state#3 using the eval feature:
<Restrict>
Custom: ($a._states.indexOf(3) !== -1;)
</Restrict>

What if we want to restrict a skill to actors that have less than 50% HP?
<Restrict>
StatMax(hp):$(a.mhp * 0.5)
</Restrict>

What about restricting a skill to actors that have more than 50% HP?
<Restrict>
StatMin(hp):$(a.mhp * 0.5)
</Restrict>

You can do the same thing with MP and TP, too. If you want to change the percentages, modify 0.5 (50%) to any other number. For example, 23% is 0.23.<Restrict>
StatMin(mp):$(a.mmp * 0.5)
StatMax(mp):$(a.mmp* 0.5)
StatMin(tp):50
StatMax(tp):50
</Restrict>

Spoiler



1.5.3 (08/03/2016) - Fixed a conflict between this plugin and Yanfly's Equip Core.


1.5.2 (12/23/2015) - Fixed an issue where Weapon and Armor restrictions would not function when using an Independent/Unique Item script.


1.5.1 (12/11/2015) - Fixed a restriction logic bug and also added individual actor item restriction checking to the default RPGMV Battle Item list. (Before, it was checking if any party member could use the item.)


1.5 (12/10/2015) - Added the ability to restrict the Items battle command.


1.4.2 (11/19/2015) - Fixed a crash bug that could occur when opening the equipment window.


1.4.1 (11/11/2015) - Fixed a crash bug that would occur if you did not restrict a skill type. Bug introduced in version 1.4.


1.4 (11/09/2015) - Added the ability to restrict global properties, starting with Skill Types!


1.3.3a (11/07/2015) - Fixed a bug with my compatibility patch for Ellye's State Damage that could cause the special state settings to not be restored under certain conditions.


1.3.3 (11/07/2015) - Fixed a crash bug introduced by compatibility with Ellye's State Damage.


1.3.2 (11/06/2015) - Added a compatibility patch for Ellye's State Damage.


1.3.1 (Unreleased) - Fixed a bug with Restrictions on armor.


1.3 (11/06/2015) - Added a new restriction type: State.


1.2 (11/04/2015) - Added Skill Restrictions.


1.1 (11/04/2015) - Added Item Restrictions.


1.0 (11/02/2015) - Initial release.