Random Transmutation

[residntevl]

Random Transmutation 1.0.2
Resi​

Download
Right Click this link and "Save Link As..."

Introduction
This plugin allows you randomly transmute items from one to another.

Features
- Input an item
- Default Transmutation - Receive an item based on the input's defined categories
- Forced Rarity Transmutation - Receive an item on the input's defined categories, but you choose the pool of items it pulls from
- Forced Item Transmutation - Receive a specific item based on the input (or whatever else, your choice)
- Force Item Pool Transmutation - Create your own unique pool of potential combinations, disregarding category and rarity settings.

Screenshots
Here is a video of the plugin in action. I've attached some screenshots on how to use the plugin below.



How to Use
Download the script from the attachment or from the download link at the top and place it in your plugins/js folder. Make sure that it is named resiRandomTransmutation.js or it's likely it won't work.

* First, assign the appropriate notetags to your items in the database.
<Category: x, y, z> or <Menu Category: x, y,z> to declare an item's category.
<Rarity: name:> to declare an items category. Rarities are defined in the plugin parameters.
<No Transmute> if you do not want an item to be a potential input or output item.



* Second, create an event with the Select Item command. Make sure the Variable option matches the one declared in the Plugin Parameters.


* OPTIONAL - Use one of the corresponding Plugin Commands defined below to alter how transmutation takes place.

This is an example of how you can use my plugin more in depth with the new features added.

PLUGIN COMMANDS

* Transmute
Basic random transmutation, creates item pools that match the input item category and separates the pools by rarity.

* Transmute ForcePool rarity
Basic random transmutation, but after pools are created, a specific pool will be chosen from by declared rarity. If the pool has no eligible output items the next highest rarity will be selected. If no pool is eligible the input item will not be used.

* Transmute ForceItem ID
Forces the output to be the item ID declared. This ignores all notetags.

* Transmute ForceItemPool ID ID ID etc
Forces the output to be a pool of the item IDs declared. This ignores all notetags.

Plugin
The download was placed above, but I'm posting it here in case you skipped it.
Right Click this link and "Save Link As..."
I've also attached the plugin to this post as well if you want to download it from here.

FAQ
QnA will show up if necessary.

Credit and Thanks
- Resi

Updates
1.01
* Added <No Transmute> tag which prevents an item from being an output
1.02
* <No Transmute> tag also now prevents an item from being an input
* Added plugin command to force a rarity pool
* Added plugin command to force a specific item
* Added plugin command to force a specific set of items
* Updated documentation

Author's Notes
My game features a crafting system. Kind of annoying, kind of complex, but a lot of fun. You can normally transmute items, but you can't for example transmute food items into other food items in the crafting system. This pool allows for a fun gimmick such as that, transmuting items that normally can't be transmuted.

Feel free to use it in commercial/noncommercial projects as you please, just credit me, thank you.

 

[residntevl]

Updated my plugin with significant changes from the original.

1.01
* Added <No Transmute> tag which prevents an item from being an output
1.02
* <No Transmute> tag also now prevents an item from being an input and output
* Added plugin command to force a rarity pool
* Added plugin command to force a specific item
* Added plugin command to force a specific set of items
* Updated documentation

The plugin has been accordingly updated on the site and on github.