Difference between revisions of "State Categories (YEP)"

From Yanfly.moe Wiki
Jump to navigation Jump to search
(Created page with "{{MvPlugin |preview=<youtube>https://www.youtube.com/watch?v=xqaMM7SXlmw</youtube> |link1=<html><iframe src="https://itch.io/embed/398303" height="167" width="552" frameborder...")
 
Line 1: Line 1:
 
{{MvPlugin
 
{{MvPlugin
|preview=<youtube>https://www.youtube.com/watch?v=xqaMM7SXlmw</youtube>
+
|preview = <youtube>https://www.youtube.com/watch?v=xqaMM7SXlmw</youtube>
|link1=<html><iframe src="https://itch.io/embed/398303" height="167" width="552" frameborder="0"></iframe></html>
+
|link1 = <html><iframe src="https://itch.io/embed/398303" height="167" width="552" frameborder="0"></iframe></html>
|link2=[http://yanfly.moe/plugins/en/YEP_X_StateCategories.js Mirror]
+
|link2 = [http://yanfly.moe/plugins/en/YEP_X_StateCategories.js Mirror]
  
 
}}
 
}}
Line 12: Line 12:
 
{{Yanfly Engine Plugins}}
 
{{Yanfly Engine Plugins}}
  
== Help File ==
+
== Introduction ==
  
 
  <nowiki>
 
  <nowiki>
============================================================================
 
Introduction
 
============================================================================
 
 
 
This plugin requires YEP_BuffsStatesCore. Make sure this plugin is located
 
This plugin requires YEP_BuffsStatesCore. Make sure this plugin is located
 
under YEP_BuffsStatesCore in the plugin list.
 
under YEP_BuffsStatesCore in the plugin list.
Line 28: Line 24:
 
have them bypass certain key removal aspects such as on Death removal or
 
have them bypass certain key removal aspects such as on Death removal or
 
Recover All removal.
 
Recover All removal.
 +
</nowiki>
  
============================================================================
+
== Notetags ==
Notetags
 
============================================================================
 
  
 +
<nowiki>
 
Use the following notetags to alter various properties revolving around
 
Use the following notetags to alter various properties revolving around
 
state categories for your database objects.
 
state categories for your database objects.
Line 66: Line 62:
 
   to lowest priority with the matching category text. This will not attempt
 
   to lowest priority with the matching category text. This will not attempt
 
   to remove passive states.
 
   to remove passive states.
 +
</nowiki>
  
============================================================================
+
== Lunatic Mode - Custom State Category Removal ==
Lunatic Mode - Custom State Category Removal
 
============================================================================
 
  
 +
<nowiki>
 
For those with JavaScript experience and would like to remove a dynamic
 
For those with JavaScript experience and would like to remove a dynamic
 
number of states of a pertaining category, you can do so with the following
 
number of states of a pertaining category, you can do so with the following
Line 85: Line 81:
 
   then the 'value' variable will start off with that amount. If not, the
 
   then the 'value' variable will start off with that amount. If not, the
 
   'value' variable will start off at 1.
 
   'value' variable will start off at 1.
 +
</nowiki>
  
============================================================================
+
== Lunatic Mode - New JavaScript Functions ==
Lunatic Mode - New JavaScript Functions
 
============================================================================
 
  
 +
<nowiki>
 
For those with JavaScript experience, you can use the following functions
 
For those with JavaScript experience, you can use the following functions
 
newly added with this plugin. The 'battler' variable refers to either an
 
newly added with this plugin. The 'battler' variable refers to either an
Line 115: Line 111:
 
the battler is affected by with the category 'text'. Replace 'text' with the
 
the battler is affected by with the category 'text'. Replace 'text' with the
 
category name but keep the quotes.
 
category name but keep the quotes.
 +
</nowiki>
  
============================================================================
+
== Changelog ==
Changelog
 
============================================================================
 
  
 +
<nowiki>
 
Version 1.07:
 
Version 1.07:
 
- Bypass the isDevToolsOpen() error when bad code is inserted into a script
 
- Bypass the isDevToolsOpen() error when bad code is inserted into a script

Revision as of 00:46, 22 June 2019

Welcome to the wiki! This is where you can find resources from Yanfly.moe, Ækashics.moe,
VisuStella, Caz Wolf, Fallen Angel Olivia, Atelier Irina, and other affiliated content creators.



Download

System

This is a plugin created for RPG Maker MV.

For help on how to install plugins, click here.

For help on how to update plugins, click here.

Got errors with your RPG Maker MV plugin? Click here.


Masterarbeit Writer

Required Plugins

The following plugins are required in order to use this plugin.

Place the following plugins above this plugin located in the Plugin Manager.

Yanfly Engine Plugins

This plugin is a part of the Yanfly Engine Plugins library.


Introduction

This plugin requires YEP_BuffsStatesCore. Make sure this plugin is located
under YEP_BuffsStatesCore in the plugin list.

This plugin allows you to set categories for your states. They can be one
category, multiple categories, or no categories. With this in mind, there's
a few new features this plugin provides that pertains to this category
system such as removal of states under a certain category and the ability to
have them bypass certain key removal aspects such as on Death removal or
Recover All removal.

Notetags

Use the following notetags to alter various properties revolving around
state categories for your database objects.

State Notetags:

  <Category: text>
  Adds the 'text' category to this state. You can insert multiples of this
  notetag to give a state multiple categories.

  <Category: Bypass Death Removal>
  Adds the 'Bypass Death Removal' category to the state. This is a category
  utilized by the plugin to bypass removal of it upon death.

  <Category: Bypass Recover All Removal>
  Adds the 'Bypass Recover All Removal' category to the state. This is a
  category utilized by the plugin to bypass removal of it upon using the
  Recover All event.

  <Category: Group Defeat>
  Adds the 'Group Defeat' category to the state. If all group members are
  afflicted by states that have this effect, it is considered a lost battle.

Skill and Item Notetags:

  <Remove State Category: text>
  Causes this action to remove all states from category 'text' from the
  action's target. This will not attempt to remove passive states.

  <Remove x State Category: text>
  Causes this action to remove x states from category 'text' from the
  action's target. The states removed will be the front x states of highest
  to lowest priority with the matching category text. This will not attempt
  to remove passive states.

Lunatic Mode - Custom State Category Removal

For those with JavaScript experience and would like to remove a dynamic
number of states of a pertaining category, you can do so with the following
notetags!

Skill and Item Notetags:

  <Custom Remove State Category: text>
   value += user.level;
   value -= target.level;
  </Custom Remove State Category: text>
  The 'value' variable is the amount of states to be removed by the action.
  If there was a <Remove x State Category: text> in the skill/item notebox,
  then the 'value' variable will start off with that amount. If not, the
  'value' variable will start off at 1.

Lunatic Mode - New JavaScript Functions

For those with JavaScript experience, you can use the following functions
newly added with this plugin. The 'battler' variable refers to either an
actor or an enemy.

--- Functions ---

battler.removeStateCategoryAll('text');
- This will remove all states of the category 'text' from the battler.
Replace 'text' with the category name but keep the quotes. This will not
attempt to remove passive states.

battler.removeStateCategory('text', x);
- This will remove x states of the category 'text' from the battler. Replace
'text' with the category name but keep the quotes. Replace x with a number.
This will not attempt to remove passive states.

battler.isStateCategoryAffected('text')
- This will return a 'true' or 'false' after checking if battler is affected
by a state with category 'text'. Replace 'text' with the category name but
keep the quotes. This will check even passive states.

battler.getStateCategoryAffectedCount('text');
- This will return a number value to see how many states (passives included)
the battler is affected by with the category 'text'. Replace 'text' with the
category name but keep the quotes.

Changelog

Version 1.07:
- Bypass the isDevToolsOpen() error when bad code is inserted into a script
call or custom Lunatic Mode code segment due to updating to MV 1.6.1.

Version 1.06:
- Updated for RPG Maker MV version 1.5.0.

Version 1.05a:
- Lunatic Mode fail safes added.
- Fixed a documentation error with <Custom Remove State Category: text>.

Version 1.04:
- Compatibility update with Selection Control to not game over the player
while there are still members alive.

Version 1.03:
- States with <Category: Bypass Death Removal> can now be added onto already
dead battlers.

Version 1.02:
- When using the JavaScript functions, the categories will now automatically
be converted to uppercase to function with the rest of the plugin.

Version 1.01:
- Added <Category: Group Defeat> effect.

Version 1.00:
- Finished Plugin!