NeMV - Tagged Action Count

じ☆ve冰风

Plugin: NeMV - Tagged Action Count


Version: 1.1


Author: Nekoyoubi


Release: April 3rd 2016


Download: https://raw.githubusercontent.com/nekoyoubi/NeMV/master/NeMV_X_TaggedActionCount.js


Requires: NeMV - Tags


Introduction


        This plugin allows the counting of certain actions to be tied to their tags, and optionally, for those tags to be bound to variables in your game.


        Currently supported actions:

• Party kills (enemy tags)
  
• Item use (item tags)
  
• Item creation (item tags; via YEP - Item Synthesis)
  
• Party skill use (skill tags; works with items too)
  
• Event use (event tags)
  

Features

• The first practical application of NeMV - Tags
  
• Flexible enough to support much more than it does out of the box
  
• Assists in building entirely new functional mechanics
  
• Has nifty plugin commands for easy access in your events
  

Example Use Cases


        The general usage below should give you a couple of ideas, but in case you miss them here are a few of the examples mentioned:

• Track kill quest progress (e.g. number of slain plants)
  
• Track seemingly useless statistics on your players (e.g. number of potions consumed)
  
• Build survival systems (e.g. track food consumed to inflict fatigue when malnourished)
  
• Limit item use for creating item-based skills (e.g. you can't place more than four traps of any kind)
  
• Create an rewarding artisan crafting system (e.g. crafting skill improves the more items you make)
  
• Create combat mastery systems (e.g. allow your wizards to focus on an element to raise its power)
  
• Even build completely new ability systems (e.g. use certain attacks to build up and unlock special ultimate/limit-break abilities)
  

How to Use


        Configure the respective action entries in the plugin's parameters as the below examples illustrate. These are only examples of what you can do, and what this plugin directly supports.

SpoilerOn Kills
                        If you want to track how many times you've killed a certain type of enemy (e.g. elementals), add a variable to track the total - something like...

                Code:       

1. Variables  >  [ 0101 - Elementals Killed ]

复制代码

                        Now add a counter in TAC's parameters under one of the "Kill Action Counter" params.  It should look like the following...

                Code:       

1. elemental 101

复制代码

                        Now anytime your party kills any enemy tagged with "elemental"...



Enemy  >  Notebox  >  <tags: fire, elemental, boss, angry>


                        ... the game's variable 101 will increase by one.


                        You can use this to track quest progress, give your players achievements, or even use the counter to affect combat with a little scripting.


On Item Use
                        To track how many times party members have used items with a particular tag on the item, first create a variable to track the total uses...

                Code:       

1. Variables  >  [ 0201 - Potions Consumed ]

复制代码

                        Now set an "ItemUse Action Counter" in the plugin params to something like:

                Code:       

1. potion 201

复制代码

                        Now whenever you consume an item with the tag "potion"...



Item  >  Notebox  >  <tags: potion, healing, weak>


                        ... the 201 variable in your game will increase by one.


                        You can use this to create tolerances for potions, make hunger and survival systems, or even creating item-based abilities for things like placing traps that your party's crafted (e.g. can only have four active traps at a time).


On Item Creation
                        To track how many times party members have created items with a particular tag on the item, first create a variable to track the total creations...

                Code:       

1. Variables  >  [ 0301 - Traps Created ]

复制代码

                        Now set an "ItemCreate Action Counter" in the plugin params to this:

                Code:       

1. trap 301

复制代码

                        Now whenever you create an item tagged as a "trap"...



Item  >  Notebox  >  <tags: trap, poison, ground>


                        ... the 301 variable in your game increases by the amount of traps created.


                        You can use this to build a profession system around your item crafting, track crafting-based quest progress, or with some creativity, even give your players built in item variance improvements based on how much experience they have building certain types of items.


On Skill Use
                        To track how many times party members have used skills with a particular tag on the skill, first create a variable to track the total skill uses...

                Code:       

1. Variables  >  [ 0401 - Heals Used ]

复制代码

                        Now set an "SkillUse Action Counter" in the plugin params to this:

                Code:       

1. healing 401

复制代码

                        Now whenever you use a skill or skill-item tagged as "healing"...



Skill/Item  >  Notebox  >  <tags: healing, holy, regen>


                        ... the 401 variable in your game increases by one.


                        You can use this to build an element mastery system for your wizards, balance your heal-bot healers with diminishing returns, or even create an entire ability system around building a new energy pool that can be used for ultimate/limit-break abilities.


Please note that with the current implementation of SkillUse, some items may additionally be checked. This allows for things like tag checking bombs thrown at your enemies, but may also lead to collisions with ItemUse cases if super-simple tags are used between skills and items.


On Event Use
                        To track how many times the player has interacted with an event with a particular tag on the event's active page, first create a variable to track the total event uses...

                Code:       

1. Variables  >  [ 0501 - Treasures Found ]

复制代码

                        Now set an "EventUse Action Counter" in the plugin params to this:

                Code:       

1. treasure 501

复制代码

                        Now whenever you interact with an event page tagged as "treasure"...



Event  >  Comment  >  <tags: treasure, unlocked>


                        ... the 501 variable in your game increases by one.

                        You can use this to track looting stats, build quests where you must talk to several elders, monitor completion of areas, or even force your players to to lose the game because they've kicked too many puppies.
                         


Future Actions
                        This being the initial release of the TAC plugin, I obviously don't have all of the actions represented that I would like to. So since I will be adding actions to this as often as I'm able, I thought I'd list a few here that are planned for sooner rather than later.

• Skill > DamageDealt/DamageTaken/HealingDealt/HealingTaken
  
• State > TurnsAfflicted/StateGiven/StateTaken
  

Plugin Commands
                        TAC comes equipped with many options for plugin commands for adding, removing, and manually setting tag counters. The format for these commands is as follows.

                Code:       

1. TAC COMMAND ACTION TAG [ VARIABLE | AMOUNT ]

复制代码

Examples:  

                Code:       

1. tac add kill plant 101  
2. tac remove itemuse potion  
3. tac set itemcreate weapon 20  
4. tac add kill animal  

复制代码

                        In the examples above, the first adds a Kill counter for enemies with the "plant" tag and sets its game variable to 101. The second removes the ItemUse counter for items tagged as "potion". The third sets the ItemCreate for "weapon" tags to 20, updating its variable if one is associated. The fourth example illustrates adding a Kill counter for "animal" tags that isn't associated to a variable.
                         






Script (external)


NeMV on GitHub  | TAC on GitHub  | TAC on MV Plugins  | TAC on Stitch Gaming | >> Download TAC <<


FAQ


Q: Does this work with YEP - ______?


A: There is some additional support for YEP - Item Synthesis for tracking created items, and I use this with an almost full YEP stack by default without issue. 


Q: Is this able to be used in commercial projects?


A: Absolutely! Wouldn't that be cool?!


Q: If I use this, do I need to say so anywhere?


A: If you can make use of my work on any level, then I would absolutely love to know about it, but I make no attribution requirements or the like. NeMV is licensed under the WTFPLv2.


Credits & Thanks

• Yanfly for the guidance as always, and for letting me integrate with his plugins without shooting me on sight!
  
• Shaz for the Kill Counter plugin to help inspire this plugin.
  
• Gameus for even more reason to build it for all their questy inspiration.
  

Author's Notes


        Based on some of the feedback that I got on NeMV - Tags, I was concerned that while it may be powerful in its simplicity, it may also not be practical enough for people to figure out in the rough. As such, this extension plugin was born. I hope you get more from it than you expect. Happy counting!


本贴来自国际rpgmaker官方论坛作者:Nekoyoubi处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/nemv-tagged-action-count.59873/