Rpg Maker Developers Group

Given the huge amount of plugins already made i thought i wouldn't need to write my own plugins for the game i'm making. But it seems for one thing no plugin existed, that i could use.


What does this plugin do?


This plugin enables you to add additional stats to your actors and enemies. You define the stats by configuring a list of names in the plugin parameters. Afterwards you can use notetags to set these stats to values and even use simple property-acess to use these in damage formulas.


There is also a default-parameter, so you don't have to use notetags on every actor or enemy.


Usage


Assuming you have the names-parameter of the plugin set to "strength, willpower" - Note that these names are case-sensitive and must be full words (no spaces)


Now you will have two additional stats, strength and willpower. Actors, classes, states, weapons, armor and enemies can now hold values for these stats using a simple notetag:


This would set the strength to 10 and the willpower to 5.


To use these stats you can use a simple JavaScript function:


a.sgsStat('strength')


For enemies their stat (what gets returned by the property) is modified by their own notetag and the stat of all affecting states.


For Actors the stat is in addition to that also influenced by his class and his current equipment.


To change the stat of an actor or enemy you can use a javascript function:


a.incSGSStat('strength', 20);


This would increase the strength of actor/enemy 'a' by 20. Usage of negative values allow decreasing the stat.


The exact way to calculate the stat can now be configured in the plugin-parameters. There is now also a notetag to set a simple static stat-increase when an actor levels up.


These stats are also already part of the save-game.


Current Limitation:


As this plugin is a work in progress not everything you would like to do is possible. What is mentioned under usage is everything that is currently implemented. That means in particular the following features aren't implemented (but might be in the future):

• Setting a level-based stat-increase via class-notetag. Included in v0.3.
  
• Changing the stat-value of a class, weapon or armor. Won't be added, as these are static database-objects. If required this can be achieved using the advanced notetags
  
• Easily changing the stat via skill or item with notetags. (Currently only possible with other plugins that allow custom javascript execution for skills and item-effect)
  
• There is also no display of these stats anywhere in the menu.
  
• There is no upper or lower limit on these stats
  

Still i think it is already useable. If you find any bugs or have suggestions for future features, please let me know.


Known Bugs:

• 
  Changing the equipment on an actor will crash the game (Reason)
  

Plans for v1.0

• Notetag to change Stat via Item/Skill
  
• Level based increase on class (v0.3)
  
• Parameter formula to calculate stat (v0.3)
  
• Rate-Notetag for every State, Skill, Item, Equipment, Class
  
•  Advanced (JavaScript) Notetag for every basic notetag (v0.4)
  
• Upper and lower limit for stats
  
• Change stats on classes and equipment like currently for battlers
  

Changelog:


v0.4

• Added advanced notetag for base value
  
• Added advanced notetag for per level value
  
• Added a javascript method to set the plus-value of a stat (to reset all incStat-calls f.ex.)
  
• Refactored under the hood, to make extensions easier
  

v0.3

• Removed the property-access way. This should also remove the 'can not redefine property'-error
  
• Renamed the getter-Function to something smaller and simpler
  
• Added a notetag to increase stats when leveling up an actor
  
• Added parameters to define the actual formula used to calculate a stat
  
  It is possible to use a different formula for enemies
  

v0.2.1

• Fixed an error when defining several stats with spaces around the stat.
  

v0.2

• Initial release
  

License:


Free for all games in MV (free and commercial). Credit to MagicMagor must be given inside the game or a credits-file. Modification to the script is allowed, but the modified script can not be distributed. Distributing the script via the game, that uses it is the only exception for this.


As the script is WIP no guarentee is made against errors this plugin might produce or that it will stay compatible to future versions.


Download (v0.4):
Dropbox