NeMV - Tags

じ☆ve冰风

Plugin: NeMV - Tags


Version: 1.2.3


Author: Nekoyoubi


Release: March 28th 2016


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


Introduction


        This plugin allows actors, enemies, classes, skills, states, items, weapons, armors, and events to be tagged and those tags to be easily retrieved via script.


Features

• Simple notetag syntax
  
• Applies to nearly any object (now even events!)
  
• Reduces conditional blocks considerably
  

Example Use Cases


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

• Adding/removing states to items (e.g. fresh/spoiled food)
  
• Defining thematic categories of items (e.g. scientific/magical)
  
• Giving enemies traits to affect the behaviors of skills (e.g. weapons that hurt plants extra)
  
• Giving actors/enemies a gender to better influence random conversation (e.g. "Yeah, girl power!" when all party actors are tagged female)
  
• Changing the user experience dynamically (e.g. only show crafting UI options when the party actually has a crafting material)
  
• Customizing skills (e.g. only purge positive states from an enemy without specifying every possible buff)
  
• Tracking event activation (e.g. how many treasure chests the player opens or elders they talk to)
  
• Add visual markers to types of events (e.g. highlight all "harvestable" plants on a common event)
  

        Anyway, those are just a few things that come to mind (and a couple that I'm using in my project currently), but I'm sure there are many, many more that can surface over time.


How to Use


        Add tags to your actor, class, enemy, skill, state, item, weapon, armor, or event as illustrated below.


        Multiple tags per entry can be separated by white-space or commas, and tags are caseinsensitive.


        Add tags to events via the Comment event command.


<Tags: Plant>


        ... or...


<TAGS: root, red, alchemy>


        ... or...


<tags: BOSS FIRERESIST EXTRAGOLD>


        Once your tags are added, they can be accessed in almost any location via:


[Object].hasTag("plant")   // for exact tag checking

// ... or you can use asterisks to specify wild-card tag searches (v1.1)...

[Object].hasTag("*RESIST") // for performing a wild-card search looking for anything that ends with "resist"


        This will return a boolean result indicating whether your object contains that tag or not. Tags can also be added and removed programmatically by calling either:


[Object].addTag("spoiled")


        ... or...


[Object].removeTag("fresh")


Note: Removing a tag that does not exist will NOT throw an error.


Events Note: Due to the volatile nature of events, adding and removing tags dynamically is not currently possible. Tags on events do change between the events pages; they simply cannot be addTag()/removeTag()'d.


        A couple of utility methods have also been added to allow you to quickly scan the party for tags on items they either possess or have equipped, or tags on states they may have active.


NeMV.Tags.AnyPartyItemsHaveTag("magical")


        ... will return true if the party possesses any items tagged as "magical".


NeMV.Tags.AnyPartyStatesHaveTag("weapon")


        ... will return true if a party actor has a state tagged as "weapon".


NeMV.Tags.EventsThatHaveTag("harvestable")


        ... will return a collection of Game_Event objects tagged as "harvestable".


Script (external)


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


FAQ


Q: Does this work with YEP - ______?


A: There is some additional support for YEP - Item Core, and that works assuming you use... 


DataManager.getBaseItem(item)


        Other than that, I don't know of any conflicts with anything in the YEP.


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 always giving such awesome feedback!
  

Author's Notes


        I put together this little plugin that I thought may be of use to someone, and since I don't have any real posts here yet, I thought I'd give it a go. Happy tagging!


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