Welcome to PGMV! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.
FTKR Item Composition System - FTKR_ItemCompositionSystem.js
Plugin desc : v1.7.4 Item Synthesis System
License : MIT License
Author : Futokoro
Desc page : https://github.com/munokura/futokoro-MV-plugins
Download Page : https://raw.githubusercontent.com/munokura/futokoro-MV-plugins/refs/heads/master/FTKR_ItemCompositionSystem.js
File name : FTKR_ItemCompositionSystem.js
Help of plugin :
@plugindesc v1.7.4 Item Synthesis System
@author Futokoro
@url https://github.com/munokura/futokoro-MV-plugins
@license MIT License
@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help，
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/futokoro-MV-plugins ).
Original plugin by Futokoro.
Please check the URL below for the latest version of the plugin.
URL https://github.com/futokoro/RPGMaker
-----
-----------------------------------------------------------------------------
Overview
-----------------------------------------------------------------------------
This plugin implements the item composition system.
Online Manual
https://github.com/futokoro/RPGMaker/blob/master/FTKR_ItemCompositionSystem.ja.md
-----------------------------------------------------------------------------
Setup Method/PluginManager Setting
----------------------------------------------------------------------------
1. Add this plugin to the "Plugin Manager (Plugin Management)."
----------------------------------------------------------------------------
Plugin Commands
----------------------------------------------------------------------------
The following plugin commands are available:
1. Display the Item Composition Screen
ICS_Open [compositTitle] [slotTitle] [statusTitle] [commandList]
: The [] part is optional.
: If entered， it will change the display of each component on the composition screen.
: Control characters can be used in the title string.
:
:Command List - Use the same input method as the plugin parameter <Command List>.
ICS_Open [listNumber]
:Specifying a list number will change the content displayed on the synthesis screen to that of the list number set in the plugin parameter.
:2. Add a Recipe
ICS_ADD_RECIPE ITEMNAME RecipeId
ICS_ADD_RECIPE ITEM ItemId RecipeId
:For the 'item' portion， enter 'weapon' for weapons and 'armor' for armor.
:Memorize the recipe for the specified item.
:By entering v[n] in the item name， item， or item ID portion，
:You can reference the contents of the in-game variable ID n.
:If you do not enter a recipe ID， the first recipe for the specified item will be used.
:
:Input example) If item ID 11 is a potion， the following will produce the same result.
: ICS_Add Recipe Potion 1
: ICS_Add Recipe Item 11 1
3. Deleting a Recipe
ICS_REDUCE_RECIPE ITEMNAME RecipeId
ICS_REDUCE_RECIPE ITEM ItemId RecipeId
:For the 'item' part， enter 'weapon' for weapons and 'armor' for armor.
:Forgets the recipe for the specified item.
:By entering v[n] in the item name， item， or item ID part，
:You can reference the contents of the in-game variable ID n.
:If you do not enter a recipe ID， the first recipe for the specified item will be used.
-----------------------------------------------------------------------------
License for this plugin
-----------------------------------------------------------------------------
This plugin is released under the MIT License.
Copyright (c) 2019 Futokoro
http://opensource.org/licenses/mit-license.php
Plugin source
https://github.com/futokoro/RPGMaker/blob/master/README.md
-----------------------------------------------------------------------------
Change History
-----------------------------------------------------------------------------
v1.7.4 - 2020/03/18: Fixed a typo in the plugin title.
v1.7.3 - 2019/12/27: Bug fixes and Traits additions.
1. Fixed an issue where more items corresponding to category materials could be placed in material slots than the number of items in the category when synthesizing a recipe containing category materials.
2. When synthesizing recipes containing category materials， we've fixed the issue so that combining multiple items of a specified category will automatically set them in a material slot.
3. The recipe material synthesis information window now displays not only the required number of materials but also the number of materials you have.
v1.7.2 - 2018/11/07: Bug Fixes
1. Fixed an issue where， when multiple recipes for a single item were learned， you could create the item using another recipe if you had the materials for one of the recipes.
v1.7.1 - 2018/10/22: Traits Addition
1. Added a Traits to disable numerical input when selecting materials.
v1.7.0 - 2018/10/14: Traits Addition
1. Added a Traits to restore materials used in synthesis even when the synthesis is successful.
2. Added a Traits to adjust the display position of command and title strings.
3. Added advanced synthesis， which allows you to obtain multiple items when synthesizing.
4. Added the ability to set a delimiter between the item name and the number of items.
v1.6.0 - October 9， 2018: Added Traits and reduced help.
1. Added the ability to set a bonus upon success.
v1.5.4 - July 12， 2018: Prevented conflicts with other plugins.
1. Changed the inheritance source of Scene_ICS from Scene_Item to Scene_ItemBase.
2. Changed the inheritance source of Window_IcsItemList from Window_ItemList to Window_Selectable.
v1.5.3 - December 11， 2017: Bug fixes， help fixes， and other minor fixes.
1. Fixed an issue where the synthesis command's function to display only items from a specific category was not Reflectioned even when a category was set for an item with a recipe.
2. Revised the default values of plugin parameters.
v1.5.2 - November 1， 2017: Help revisions
1. Corrected an incorrect explanation for setting categories for recipe ingredients.
v1.5.1 - October 16， 2017: Traits additions
1. Changed the setting method for the menu command that displays the synthesis screen to a list format.
2. Added the ability to set multiple synthesis commands on the menu screen.
v1.5.0 - October 11， 2017: Traits additions and specification changes
1. Changed the input method for plugin parameters that set the display content of the synthesis screen to a list format.
2. Added a Traits that allows you to specify a list number as an option when displaying the synthesis screen with a plugin command to change the display content to match the list number.
3. Added a Traits that displays a confirmation screen when synthesis is complete.
v1.4.0 - October 7， 2017: Traits additions
1. Added the ability to set a background image with a plugin command.
2. Added the ability to create synthesis commands that display only items from a specific category.
v1.3.2 - 2017/09/03: Bug fixes
1. Bug fixes for changes in 1.3.0
v1.3.1 - 2017/09/02: Traits additions
1. Added the ability to set a background image.
v1.3.0 - 2017/09/01: Traits additions
1. Added the ability to set the window background transparency and border.
v1.2.0 - 2017/08/29: Bug fixes and Traits additions
1. Fixed an issue where multiple recipes set for a single item were not correctly read.
2. Added the ability to change the display names of "Items，" "Weapons，" and "Armor" in synthesis commands when selecting materials and recipes.
v1.1.0 - 2017/08/22: Traits Additions
1. Added the ability to set the display names of "items，" "weapons，" and "armor" for the synthesis command using plugin parameters.
2. Added the ability to set matching conditions between synthesis recipes and materials used.
3. Modified to prevent synthesis from being performed if no materials are set.
v1.0.6 - 2017/08/19: Bug Fixes
1. Fixed an issue where an error occurred when performing synthesis with the confirmation window disabled.
v1.0.5 - 2017/07/12: Specification Changes
1. Modified to allow synthesis even with only one type of recipe material.
v1.0.4 - 2017/07/07: Bug Fixes
1. Fixed an issue where plugin commands would not process correctly if the recipe ID was not specified.
v1.0.3 - June 27， 2017: Bug fixes and Traits additions
1. Fixed a bug where the Traits displaying required recipes in the synthesis information window was not working correctly.
2. Added a plugin parameter to set whether required recipes are displayed in the material quantity specification window.
v1.0.2 - June 27， 2017: Bug fixes and help corrections
1. Fixed an issue where difficulty settings in recipe tags were not Reflectioned correctly.
v1.0.1 - June 27， 2017: Help corrections
v1.0.0 - June 26， 2017: Official release
1. Fixed an issue where the correct number of materials was not set in the slot even when selecting the number of materials from the recipe.
2. Functionality enhancements to the synthesis screen display command.
3. Changed the name of the plugin parameter that sets the command name.
4. Changed the notation of plugin commands.
v0.9.4 - 2017/06/11: Added Traits
1. Added the ability to turn the difficulty display on/off in the synthesis information window.
2. Added the ability to display the required recipes in the synthesis information window when selecting from recipes.
v0.9.3 - 2017/06/08: Added Traits
1. Added a process to return the used item if the inserted item does not match any recipe.
v0.9.2 - 2017/04/14: Added Traits
1. Added special synthesis.
v0.9.1 - 2017/04/13: Bug fixes and added Traits
1. Fixed an error that prevented the app from launching.
2. Added a process to cause the synthesis results to disappear if the inserted item does not match any recipe.
2. Added "Items，" "Weapons，" and "Armor" as default categories.
v0.9.0 - April 8， 2017: Prototype released.
-----------------------------------------------------------------------------
@param --基本設定--
@text --Basic settings--
@param Menu Command
@desc Sets the commands to be displayed in the menu.
@default ["{￥"enabled￥":￥"1￥"，￥"name￥":￥"Composite￥"，￥"switchId￥":￥"0￥"}"]
@type struct<menu>[]
@param Enable Confirmation
@desc When combining items， do you want to confirm the execution on the confirmation screen?
@default 1
@type select
@option confirm
@value 1
@option Do not confirm
@value 0
@param Enable End Confirmation
@desc When item synthesis is complete， do you want to confirm the execution on the confirmation screen?
@default 0
@type select
@option confirm
@value 1
@option Do not confirm
@value 0
@param Disable Material Number Input
@desc Disable numeric input when selecting material items.
@default 0
@type select
@option Entering numbers
@value 0
@option Do not enter a number
@value 1
@param Category Type ID
@desc Set the weapon type ID for the category type.
@param Category Format
@desc Sets the display content of the category type. %1 - Category type
@default Category %1
@param Not Applicable to Recipe
@desc Sets the result for combinations that do not have a recipe. lost - lost， reset - restored
@default lost
@type select
@option Lost
@value lost
@option Reset
@value reset
@param Recipe Materials Treatment
@desc Sets how to handle the material items used in synthesis. lost - lost， reset - restored
@default lost
@type select
@option Lost
@value lost
@option Reset
@value reset
@param Recipe Matching Pattern
@desc This sets how closely the materials set in the recipe must match for the synthesis to be successful.
@default 0
@type select
@option Matches the recipe
@value 1
@option Includes recipes
@value 0
@param Item Number Delimiters
@desc Sets the separator between the item name and the item number.
@default :
@param --合成成功率の設定--
@text --Synthesis success rate setting--
@param Composition Parameter
@desc Specifies the parameter to refer to in the success rate of item synthesis. If not set， the difficulty of the item will be the success value.
@param Success Base Rate
@desc Set the success value when the synthesis difficulty and parameters match.
@default 80
@param Upper Add Rate
@desc Sets the success correction value when the parameter is higher than the synthesis difficulty.
@default 2
@param Downer Reduce Rate
@desc Sets the success correction value when the parameter is lower than the synthesis difficulty.
@default -5
@param Max Success Rate
@desc Set the percentage of success value to be calculated. Success rate = success value / this value (maximum 10000)
@default 100
@param Default Difficulty
@desc Success rates to use when not using tags. Separate with commas (，) (great success， success， failure)
@default 10，40，40
@param --合成タイトルウィンドウの設定--
@text --Composite title window settings--
@param Composit Title Format
@desc Set the title to be displayed on the composite screen.
@default ["￥￥c[16]Composite"]
@type string[]
@param Composit Title Align
@desc Set the display position of the displayed content.
@default 0
@type select
@option Left-justified
@value 0
@option center
@value 1
@option Right-justified
@value 2
@param Comp Title Opacity
@desc Specifies the transparency of the composite title window.
@default 192
@type number
@param Comp Title Frame Hide
@desc Whether to hide the composite title window frame.
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --合成コマンドウィンドウの設定--
@text --Synthesis Command Window Settings--
@param Command List
@desc Set the command display content and order. Separate with a comma (，).
@default ["action，item，weapon，armor，change，slot，end"]
@type string[]
@param Change Materials Name
@desc Sets the display content for the "Select from Materials" command.
@default ["Select from Materials"]
@type string[]
@param Change Resipes Name
@desc Sets the display content for the "Choose from recipes" command.
@default ["Choose from recipes"]
@type string[]
@param Slot Cmd Name
@desc Sets the display content for the "Return synthesis material" command.
@default ["Return synthesis material"]
@type string[]
@param Action Cmd Name
@desc Sets the display content of the "Composite" command.
@default ["Composite"]
@type string[]
@param End Cmd Name
@desc Sets the display content for the "Stop Compositing" command.
@default ["Stop Compositing"]
@type string[]
@param Item Cmd Name
@desc Sets the display content for the "Item" command. Separating with ';' will change the display when selecting materials and recipes.
@default ["Item"]
@type string[]
@param Weapon Cmd Name
@desc Sets the display content for the "Weapon" command. Separating with ';' will change the display when selecting materials and recipes.
@default ["Weapon"]
@type string[]
@param Armor Cmd Name
@desc Sets the display content for the "Armor" command. Separating with ';' will change the display when selecting materials and recipes.
@default ["Armor"]
@type string[]
@param Composit Command Align
@desc Set the display position of the displayed content.
@default 0
@type select
@option Left-justified
@value 0
@option center
@value 1
@option Right-justified
@value 2
@param Comp Cmd Opacity
@desc Specifies the transparency of the composite command window.
@default 192
@type number
@param Comp Cmd Frame Hide
@desc Hide the composite command window frame.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --アイテムリストウィンドウの設定--
@text --Item list window settings--
@param Item List Opacity
@desc Specifies the transparency of the item list window.
@default 192
@type number
@param Item List Frame Hide
@desc Whether to hide the item list window frame.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --素材数指定ウィンドウの設定--
@text --Material Quantity Specification Window Settings--
@param Show Number Button
@desc Whether to display touch buttons on the item number setting screen. 1 - Display， 0 - Do not display
@default 1
@param Display Materials On Number
@desc Whether to display recipe materials in the material number selection window. 0 - Do not display， 1 - Display
@default 1
@param Number Opacity
@desc Specifies the transparency of the material number specification window.
@default 192
@type number
@param Number Frame Hide
@desc Whether to hide the frame of the material number specification window.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --スロットタイトルウィンドウの設定--
@text --Slot Title Window Settings--
@param Slot Title Format
@desc Sets the title display content of the slot title window.
@default ["￥￥c[16]Synthetic materials"]
@type string[]
@param Slot Title Align
@desc Set the display position of the displayed content.
@default 0
@type select
@option Left-justified
@value 0
@option center
@value 1
@option Right-justified
@value 2
@param Slot Title Opacity
@desc Specifies the transparency of the slot title window.
@default 192
@type number
@param Slot Title Frame Hide
@desc Whether to hide the slot title window frame.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --素材スロットウィンドウの設定--
@text --Material Slot Window Settings--
@param Empty Format
@desc Sets the display name for the empty slot.
@default ["Not set"]
@type string[]
@param Empty Icon
@desc Set empty slot icon.
@default 160
@param Return All Slot
@desc Sets the display name for the command to return all synthetic materials.
@default ["Return All Slot"]
@type string[]
@param Slot Opacity
@desc Specifies the transparency of the material slot window.
@default 192
@type number
@param Slot Frame Hide
@desc Hide the material slot window border.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --合成情報タイトルウィンドウの設定--
@text --Composite Information Title Window Settings--
@param Status Title Format
@desc Sets the title display content of the composite information window.
@default ["￥￥c[16]composite information"]
@type string[]
@param Status Title Align
@desc Set the display position of the displayed content.
@default 0
@type select
@option Left-justified
@value 0
@option center
@value 1
@option Right-justified
@value 2
@param Status Title Opacity
@desc Specifies the transparency of the composite information title window.
@default 192
@type number
@param Status Title Frame Hide
@desc Whether to hide the composite information title window frame.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --合成情報ウィンドウの設定--
@text --Mixing Information Window Settings--
@param Unkouwn Item Name
@desc Sets the content to be displayed when the composite result is unknown.
@default ["？？？？"]
@type string[]
@param Display Difficulty
@desc Set whether to display the synthesis difficulty. 1 - Display， 0 - Do not display
@default 1
@param Difficulty Format
@desc Sets the display of the difficulty of the number of synthesized items generated. %1 - Difficulty of synthesis
@default ["Difficulty:%1"]
@type string[]
@param Composit Number Format
@desc Sets the display content for the number of composite items generated.
@default ["Composit Number:"]
@type string[]
@param Display Recipe Materials
@desc Show required ingredients when selecting from recipe. 1 - Show， 0 - Don't show
@default 1
@param Recipe Title Format
@desc Set the title string when displaying required materials.
@default ["Required Materials"]
@type string[]
@param Recipe Material Number Format
@desc Sets the display format for the number of required materials.
@default {"text":"%2/%1"，"width":"5"}
@type struct<numItem>
@param Status Opacity
@desc Specifies the transparency of the composite information window.
@default 192
@type number
@param Status Frame Hide
@desc Hide the composite information window frame.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --確認ウィンドウの設定(Confirmation Window)--
@text --Confirmation Window Settings--
@param Conf Title Format
@desc This describes the confirmation items when synthesizing items.
@default ["￥￥c[16]合成実行の確認"]
@type string[]
@param Conf Title Align
@desc Set the display position of the confirmation content.
@default 0
@type select
@option Left-justified
@value 0
@option center
@value 1
@option Right-justified
@value 2
@param Confirmation Ok Format
@desc Describes what will be displayed when you click "Execute" in the confirmation command.
@default ["Execute"]
@type string[]
@param Confirmation Cancel Format
@desc Describes the display content of the confirmation command "Do not execute."
@default ["Do not execute"]
@type string[]
@param Conf Command Align
@desc Set the display position of the confirmation command.
@default 1
@type select
@option Left-justified
@value 0
@option center
@value 1
@option Right-justified
@value 2
@param Confirmation Opacity
@desc Specifies the transparency of the confirmation window.
@default 192
@type number
@param Confirmation Frame Hide
@desc Whether to hide the confirmation window frame.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --合成結果ウィンドウの設定--
@text --Synthesis Result Window Settings--
@param Result Title Format
@desc Describes the title display content of the synthesis result window.
@default ["￥￥c[16]合成結果"]
@type string[]
@param Result Title Align
@desc Set the display position of the displayed content.
@default 0
@type select
@option Left-justified
@value 0
@option center
@value 1
@option Right-justified
@value 2
@param Result Great Success
@desc Describes what will be displayed when the game is a great success.
@default ["大成功"]
@type string[]
@param Result Success
@desc Describes what will be displayed when successful.
@default ["Success"]
@type string[]
@param Result Failure
@desc Describes what will be displayed in case of failure.
@default ["Failure"]
@type string[]
@param Result Lost
@desc Describes what will be displayed when the data is lost.
@default ["Lost"]
@type string[]
@param Result Reset
@desc Describes what will be displayed when restoring.
@default ["Reset"]
@type string[]
@param Result Ok Format
@desc Describes the display content of the confirmation command.
@default ["Confirmation"]
@type string[]
@param Result Opacity
@desc Specifies the transparency of the composite result window.
@default 192
@type number
@param Result Frame Hide
@desc Hide the composite results window frame.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --終了確認ウィンドウの設定--
@text --Setting the Exit Confirmation Window--
@param End Title Format
@desc Describes the confirmation content when completing item synthesis.
@default ["￥￥c[16]Do you want to end the synthesis?"]
@type string[]
@param End Title Align
@desc Set the display position of the confirmation message.
@default 0
@type select
@option Left-justified
@value 0
@option center
@value 1
@option Right-justified
@value 2
@param End Ok Format
@desc Describes what will be displayed when you click "Exit" in the confirmation command for exiting.
@default ["Exit"]
@type string[]
@param End Cancel Format
@desc Describes what will be displayed when the confirmation command for termination is "Do not terminate."
@default ["Do not terminate"]
@type string[]
@param End Command Align
@desc Sets the display position of the exit confirmation command.
@default 1
@type select
@option Left-justified
@value 0
@option center
@value 1
@option Right-justified
@value 2
@param End Opacity
@desc Specifies the transparency of the exit confirmation window.
@default 192
@type number
@param End Frame Hide
@desc Whether to hide the exit confirmation window frame.
@default 表示する(show)
@type select
@option show
@value 表示する(show)
@option hide
@value 表示しない(hide)
@param --背景設定(Background Window)--
@text --Background Window--
@param Background Image Name
@desc Specify the image file name to use as the background. The image file must be saved in /img/system.
@type file[]
@require 1
@dir img/system/
@param --合成時のSEの設定--
@text --Sound effects settings for synthesis--
@param Success SE
@desc Specifies the sound effect to be played when combining items.
@default ["{￥"name￥":￥"Sound2￥"，￥"volume￥":￥"90￥"，￥"pitch￥":￥"100￥"，￥"pan￥":￥"0￥"}"]
@type struct<sound>[]
@param Great SE
@desc Specifies the name of the sound effect to be played when combining items.
@default ["{￥"name￥":￥"Sound2￥"，￥"volume￥":￥"90￥"，￥"pitch￥":￥"100￥"，￥"pan￥":￥"0￥"}"]
@type struct<sound>[]
@param Failure SE
@desc Specifies the name of the sound effect to be played when combining items.
@default ["{￥"name￥":￥"Sound2￥"，￥"volume￥":￥"90￥"，￥"pitch￥":￥"100￥"，￥"pan￥":￥"0￥"}"]
@type struct<sound>[]
@param Lost SE
@desc Specifies the name of the sound effect to be played when combining items.
@default ["{￥"name￥":￥"Sound2￥"，￥"volume￥":￥"90￥"，￥"pitch￥":￥"100￥"，￥"pan￥":￥"0￥"}"]
@type struct<sound>[]
@param --カテゴリー別の合成コマンドの設定--
@text --Setting synthesis commands by category--
@param Custom Cmd 1 Name
@desc Sets the display content for Command 1 by category. Separating with ';' will change the display when selecting ingredients and recipes.
@param Custom Cmd 1 Category
@desc Set the category for Command 1. Enter the same string as the category name set in the composite category.
@param Custom Cmd 2 Name
@desc Sets the display content for Category Command 2. Separating with ';' will change the display when selecting ingredients and recipes.
@param Custom Cmd 2 Category
@desc Set the category for Command 2. Enter the same string as the category name set in the composite category.
@param Custom Cmd 3 Name
@desc Sets the display content for Category Command 3. Separating with ';' will change the display when selecting ingredients and recipes.
@param Custom Cmd 3 Category
@desc Set the category for Command 3. Enter the same string as the category name set in the composite category.
@param Custom Cmd 4 Name
@desc Sets the display content for Command 4 by category. Separating with ';' will change the display when selecting ingredients and recipes.
@param Custom Cmd 4 Category
@desc Set the category for Command 4. Enter the same string as the category name set in the composite category.
@param Custom Cmd 5 Name
@desc Sets the display content for Command 5 by category. Separating with ';' will change the display when selecting ingredients and recipes.
@param Custom Cmd 5 Category
@desc Set the category for Command 5. Enter the same string as the category name set in the composite category.