Rpg Maker Developers Group

(This plugin was originally posted in my JS Snippets thread along with the rest of my small plugins, but even though this plugin is still short in terms of code, I feel like it deserves its own thread for the functionality it can provide.)

Introduction
This plugin allows you to designate any item as belonging to one or more custom types. It also lets you show only items of one specific custom type in the Select Item window, for when the Item Type distinction in the database isn't enough.

With some creativity, you can use this plugin to event a full crafting system / cooking system with variable ingredients. (This was part of my motivation for writing it in the first place - a demo can be found at the end of the post.)



How to use

To specify a custom item type, add a notetag of the format
<type:X>
to the item, where X is the custom item type (can be any string that does not contain spaces).

You can change the brackets in the plugin parameters, e.g. set prefix to [ and postfix to ] to only write [X] in the item note field in order to specify custom type X. If you leave both parameters empty, an item will belong to custom type X if the string X appears anywhere in the note field.

Items can have multiple custom types. Simply add more notetags, e.g.
<type:food> <type:fish> <type:cooked>

Plugin commands

Before using the Select Item command in an event, use the plugin command
SetSelectItemType X
to only show items of the type X in the Select Item window.

Use the plugin command
SetSelectItemType 0
to return to the default behavior (showing all items in the selection window).


Script calls (advanced)

These script calls will probably be most useful in the Script fields of the Change Variables and Conditional Branch event commands.

Use the script call
$gameParty.customItemTypeCount('X')
to get the number of items from custom type X in the party's inventory.

The script call
DataManager.isItemCustomType($dataItems[n], 'X')
returns true if the item with ID n has the custom type X, otherwise false.


Terms of use
- Free for use in both non-commercial and commercial games.
- Please credit me as LadyBaskerville if you use this plugin (version 1.1.0 and higher).
- You may edit this plugin.
- You may redistribute this plugin and edits of it. In that case, please give credit and, if possible, link back to the original plugin thread.

Download
LB_CustomItemChoices.js
Plugin Demo (7.5 MB )