Difference between revisions of "Template:VisuMZ Items and Equips Core Notetags"
(→Equipment Notetags) |
(→Status Window Notetags) |
||
Line 316: | Line 316: | ||
codes for this. | codes for this. | ||
- Insert or remove as many "key: data" lines as needed. | - Insert or remove as many "key: data" lines as needed. | ||
+ | </pre> | ||
+ | |||
+ | --- | ||
+ | |||
+ | <pre> | ||
+ | <Shop Picture Name: filename> | ||
+ | |||
+ | - Used for: Skill, Item, Weapon, Armor Notetags | ||
+ | - Enables a shop picture for the status window. This image can be seen in | ||
+ | the item scene, shop scene, and skill scene if enabled. | ||
+ | - If this notetag is not used, there will be no image. | ||
+ | - Replace 'filename' with the filename of the graphic to use from the game | ||
+ | project's img/pictures/ folder. Filenames are case sensitive. Leave out | ||
+ | the filename extension from the notetag. | ||
+ | - Use the supporting notetags to determine where the image appears. If not, | ||
+ | they will default to the background, fit to the window dimensions, | ||
+ | centered at the middle of the window. | ||
+ | </pre> | ||
+ | |||
+ | --- | ||
+ | |||
+ | <pre> | ||
+ | <Shop Picture Layer: Background> | ||
+ | <Shop Picture Layer: Foreground> | ||
+ | |||
+ | - Used for: Skill, Item, Weapon, Armor Notetags | ||
+ | - Determines which layer the graphic will be drawn on. | ||
+ | - If the background layer is selected, the picture will appear behind the | ||
+ | data text. | ||
+ | - If the foreground layer is selected, the picture will appear in front of | ||
+ | the data text. | ||
+ | - If this notetag is not used, it will default to the background layer. | ||
+ | </pre> | ||
+ | |||
+ | --- | ||
+ | |||
+ | <pre> | ||
+ | <Shop Picture Max Width: x> | ||
+ | <Shop Picture Max Height: y> | ||
+ | <Shop Picture Max Dimensions: x, y> | ||
+ | |||
+ | - Used for: Skill, Item, Weapon, Armor Notetags | ||
+ | - Determines the maximum width and/or height for the image. | ||
+ | - This means the image will be automatically scaled proportionally to that | ||
+ | width or height as long as everything else does not break boundaries. | ||
+ | - Replace 'x' and 'y' with number values representing the maximum dimensions | ||
+ | the image can be in pixels. | ||
+ | - If these notetags are not used, the image will be automatically scaled to | ||
+ | the dimensions of the shop status window. | ||
+ | </pre> | ||
+ | |||
+ | --- | ||
+ | |||
+ | <pre> | ||
+ | <Shop Picture Alignment: Left> | ||
+ | <Shop Picture Alignment: Center> | ||
+ | <Shop Picture Alignment: Right> | ||
+ | |||
+ | - Used for: Skill, Item, Weapon, Armor Notetags | ||
+ | - Adjusts the horizontal alignment for the image. | ||
+ | - Left, center, right determines how it's aligned horizontally if the | ||
+ | image does not horizontally fit in the width of the window. | ||
+ | - If any of these notetags are not used, the image will default to the | ||
+ | 'center' alignment. | ||
+ | </pre> | ||
+ | |||
+ | --- | ||
+ | |||
+ | <pre> | ||
+ | <Shop Picture Position: Top> | ||
+ | <Shop Picture Position: Middle> | ||
+ | <Shop Picture Position: Bottom> | ||
+ | |||
+ | - Used for: Skill, Item, Weapon, Armor Notetags | ||
+ | - Adjusts the vertical position for the image. | ||
+ | - Top, middle, bottom determines how it's positioned vertically if the | ||
+ | image does not vertically fit in the width of the window. | ||
+ | - If any of these notetags are not used, the image will default to the | ||
+ | 'middle' position. | ||
+ | </pre> | ||
+ | |||
+ | --- | ||
+ | |||
+ | <pre> | ||
+ | <Shop Picture Offset X: +x> | ||
+ | <Shop Picture Offset X: -x> | ||
+ | |||
+ | <Shop Picture Offset Y: +y> | ||
+ | <Shop Picture Offset Y: -y> | ||
+ | |||
+ | <Shop Picture Offset: +x, +y> | ||
+ | <Shop Picture Offset: -y, -y> | ||
+ | |||
+ | - Used for: Skill, Item, Weapon, Armor Notetags | ||
+ | - Offsets the X and Y positions of the image in the shop status window. | ||
+ | - X offsets adjust the horizontal position by x pixels. | ||
+ | - Positive goes right. | ||
+ | - Negative goes left. | ||
+ | - Y offsets adjust the horizontal position by y pixels. | ||
+ | - Positive goes down. | ||
+ | - Negative goes up. | ||
+ | - Replace 'x' and 'y' with number values representing the pixels to offset | ||
+ | the image by. The '+' and '-' signs are required. | ||
+ | - If none of these notetags are used, there will be no offsets. | ||
+ | </pre> | ||
+ | |||
+ | --- | ||
+ | |||
+ | <pre> | ||
+ | <Shop Picture Opacity: x> | ||
+ | <Shop Picture Opacity: x%> | ||
+ | |||
+ | - Used for: Skill, Item, Weapon, Armor Notetags | ||
+ | - Adjusts the opacity of the image used. | ||
+ | - When using 'x' and not 'x%', use a number between 0 and 255. | ||
+ | - The closer to 0, the more transparent the image is. | ||
+ | - The closer to 255, the more opaque the image is. | ||
+ | - When using 'x%' and not 'x', use a number between 0% and 100%. | ||
+ | - The closer to 0%, the more transparent the image is. | ||
+ | - The closer to 100%, the more opaque the image is. | ||
</pre> | </pre> | ||
Revision as of 14:32, 30 April 2021
The following are notetags that have been added through this plugin. These notetags will not work with your game if this plugin is OFF or not present.
Contents
General
These notetags affect the Items, Weapons, and Armors on a general scale.
---
<Max: x> - Used for: Item, Weapon, Armor Notetags - Determines the maximum quantity that can be held for this item. - Replace 'x' with a number value to determine the maximum amount.
---
<Color: x> <Color: #rrggbb> - Used for: Item, Weapon, Armor, Skill Notetags - Determines the color of the object inside the in-game menus. - Replace 'x' with a number value depicting a window text color. - Replace 'rrggbb' with a hex color code for a more custom color.
---
<Category: x> - Used for: Item, Weapon, Armor Notetags - Arranges items into certain/multiple categories to work with the Category Plugin Parameter setting: "Category:x". - Replace 'x' with a category name to mark this item as.
---
<Categories> x x </Categories> - Used for: Item, Weapon, Armor Notetags - Arranges items into certain/multiple categories to work with the Category Plugin Parameter setting: "Category:x". - Replace each 'x' with a category name to mark this item as.
---
Item Accessibility Notetags
The following notetags allow you to choose when items can/cannot be used based on switches.
---
<Enable Switch: x> <Enable All Switches: x,x,x> <Enable Any Switches: x,x,x> - Used for: Item Notetags - Determines the enabled status of the item based on switches. - Replace 'x' with the switch ID to determine the item's enabled status. - If 'All' notetag variant is used, item will be disabled until all switches are ON. Then, it would be enabled. - If 'Any' notetag variant is used, item will be enabled if any of the switches are ON. Otherwise, it would be disabled.
---
<Disable Switch: x> <Disable All Switches: x,x,x> <Disable Any Switches: x,x,x> - Used for: Item Notetags - Determines the enabled status of the item based on switches. - Replace 'x' with the switch ID to determine the item's enabled status. - If 'All' notetag variant is used, item will be enabled until all switches are ON. Then, it would be disabled. - If 'Any' notetag variant is used, item will be disabled if any of the switches are ON. Otherwise, it would be enabled.
---
JavaScript Notetags: Item Accessibility
The following are notetags made for users with JavaScript knowledge to determine if an item can be accessible by code.
---
<JS Item Enable> code code enabled = code; </JS Item Enable> - Used for: Item Notetags - Determines the enabled status of the item based on JavaScript code. - If the actor this is disabled for is the only party member, it will not be visible in the item list unless the VisuStella Battle Core is installed. - If the VisuStella Battle Core is installed, then all battle scope items will be visible even if they're disabled. - Replace 'code' to determine the type enabled status of the item. - The 'enabled' variable returns a boolean (true/false) to determine if the item will be enabled or not. - The 'user' variable refers to the user with the item. - The 'item' variable refers to the item being checked. - All other item conditions must be met in order for this to code to count.
---
Equipment Notetags
The following notetags provide equipment-related effects from deciding what equip slots can be given to classes to the base parameter changes asigned to weapons and armors.
---
<Equip Slots> slotName slotName slotName </Equip Slots> - Used for: Class Notetags - Changes the equipment slot loadout for any actor who is that class. - Replace 'slotName' with an Equipment Type name from Database > Types. This is case-sensitive. - Insert or remove as many "slotName" equipment types as needed.
---
<param: +x> <param: -x> - Used for: Weapon, Armor Notetags - Changes the base parameter value for the equip item. - Replace 'param' with any of the following: 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI', or 'LUK' to change that specific parameter's value. - These notetags do NOT work with X Parameters, S Parameters, or any custom parameters. These notetags ONLY work with the base parameters. - Replace 'x' with a number value to set the parameter value to. - This allows you to bypass the Database Editor's number limitations.
---
<Equip Copy Limit: x> - Used for: Weapon, Armor Notetags - Sets a maximum number of copies that the actor can wear of this equipment. - Replace 'x' with a number value to determine the copy limit. - This can be bypassed using Event Commands and/or Script Calls. - Usage Example: Actors can only equip one copy of the "One-of-a-Kind Ring" on at any time despite having empty accessory slots because the ring has a <Equip Copy Limit: 1> notetag.
---
<Equip Weapon Type Limit: x> - Used for: Weapon - This weapon cannot be equipped with other weapons of the same type once the limited amount has been reached. - Replace 'x' with a number value to determine the weapon type limit. - This can be bypassed using Event Commands and/or Script Calls. - Usage Example: A dualwielding warrior who can only equip one sword and a dagger but never two swords or two daggers because the swords and daggers all have the <Equip Weapon Type Limit: 1> notetags on them.
---
<Equip Armor Type Limit: x> - Used for: Armor - This armor cannot be equipped with other armors of the same type once the limited amount has been reached. - Replace 'x' with a number value to determine the armor type limit. - This can be bypassed using Event Commands and/or Script Calls. - Usage Example: People cannot equip more than two glove accessories on at a time because the glove is a "Glove" armor-type and each glove item has the <Equip Armor Type Limit: 2> notetags on them.
---
JavaScript Notetags: Equipment
The following are notetags made for users with JavaScript knowledge to adjust the parameter through code.
---
<JS Parameters> MaxHP = code; MaxMP = code; ATK = code; DEF = code; MAT = code; MDF = code; AGI = code; LUK = code; </JS Parameters> - Used for: Weapon, Armor Notetags - Uses JavaScript to determine the values for the basic parameters based on the code used to calculate its value. - The variables 'MaxHP', 'MaxMP', 'ATK', 'DEF', 'MAT', 'MDF', 'AGI', and 'LUK' are used to determine the finalized value of the parameter. This variable is case sensitive. - If a parameter is not present, its value will be treated as +0.
---
Status Window Notetags
The following notetags will affect the Shop Status Window info. If for any reason the data that is displayed is not to your liking or insufficient, you can change it up using the following notetags.
---
<Status Info> key: data key: data key: data </Status Info> - Used for: Skill, Item, Weapon, Armor Notetags - If you do not like the generated data that's displayed, you can change it using this notetag to display what you want. - Replace 'key' with one of the following: - Consumable - Quantity - Occasion - Scope - Speed - Success Rate - Repeat - Hit Type - Element - Damage Multiplier - HP Recovery - MP Recovery - TP Recovery - HP Damage - MP Damage - TP Damage - User TP Gain - Added Effects - Removed Effects - Replace 'data' with the text data you want to visually appear. You may use text codes for this. - This only affects info entries that are already visible and won't make other categories suddenly appear. - Insert or remove as many "key: data" lines as needed.
---
<Custom Status Info> key: data key: data key: data </Custom Status Info> - Used for: Skill, Item Notetags - If you want custom categories and data to be displayed for your items that aren't provided by the Shop Status Window Info to begin with, you can use this notetag to add in your own entries. - Replace 'key' with text of the exact label you want. You may use text codes for this. - Replace 'data' with text of the exact text data you want. You may use text codes for this. - Insert or remove as many "key: data" lines as needed.
---
<Shop Picture Name: filename> - Used for: Skill, Item, Weapon, Armor Notetags - Enables a shop picture for the status window. This image can be seen in the item scene, shop scene, and skill scene if enabled. - If this notetag is not used, there will be no image. - Replace 'filename' with the filename of the graphic to use from the game project's img/pictures/ folder. Filenames are case sensitive. Leave out the filename extension from the notetag. - Use the supporting notetags to determine where the image appears. If not, they will default to the background, fit to the window dimensions, centered at the middle of the window.
---
<Shop Picture Layer: Background> <Shop Picture Layer: Foreground> - Used for: Skill, Item, Weapon, Armor Notetags - Determines which layer the graphic will be drawn on. - If the background layer is selected, the picture will appear behind the data text. - If the foreground layer is selected, the picture will appear in front of the data text. - If this notetag is not used, it will default to the background layer.
---
<Shop Picture Max Width: x> <Shop Picture Max Height: y> <Shop Picture Max Dimensions: x, y> - Used for: Skill, Item, Weapon, Armor Notetags - Determines the maximum width and/or height for the image. - This means the image will be automatically scaled proportionally to that width or height as long as everything else does not break boundaries. - Replace 'x' and 'y' with number values representing the maximum dimensions the image can be in pixels. - If these notetags are not used, the image will be automatically scaled to the dimensions of the shop status window.
---
<Shop Picture Alignment: Left> <Shop Picture Alignment: Center> <Shop Picture Alignment: Right> - Used for: Skill, Item, Weapon, Armor Notetags - Adjusts the horizontal alignment for the image. - Left, center, right determines how it's aligned horizontally if the image does not horizontally fit in the width of the window. - If any of these notetags are not used, the image will default to the 'center' alignment.
---
<Shop Picture Position: Top> <Shop Picture Position: Middle> <Shop Picture Position: Bottom> - Used for: Skill, Item, Weapon, Armor Notetags - Adjusts the vertical position for the image. - Top, middle, bottom determines how it's positioned vertically if the image does not vertically fit in the width of the window. - If any of these notetags are not used, the image will default to the 'middle' position.
---
<Shop Picture Offset X: +x> <Shop Picture Offset X: -x> <Shop Picture Offset Y: +y> <Shop Picture Offset Y: -y> <Shop Picture Offset: +x, +y> <Shop Picture Offset: -y, -y> - Used for: Skill, Item, Weapon, Armor Notetags - Offsets the X and Y positions of the image in the shop status window. - X offsets adjust the horizontal position by x pixels. - Positive goes right. - Negative goes left. - Y offsets adjust the horizontal position by y pixels. - Positive goes down. - Negative goes up. - Replace 'x' and 'y' with number values representing the pixels to offset the image by. The '+' and '-' signs are required. - If none of these notetags are used, there will be no offsets.
---
<Shop Picture Opacity: x> <Shop Picture Opacity: x%> - Used for: Skill, Item, Weapon, Armor Notetags - Adjusts the opacity of the image used. - When using 'x' and not 'x%', use a number between 0 and 255. - The closer to 0, the more transparent the image is. - The closer to 255, the more opaque the image is. - When using 'x%' and not 'x', use a number between 0% and 100%. - The closer to 0%, the more transparent the image is. - The closer to 100%, the more opaque the image is.
---
Shop Menu Notetags
These notetags adjust how prices and such are managed inside the Shop Menu as well as whether or not some items are visible depending on switch states.
---
<Price: x> - Used for: Item, Weapon, Armor Notetags - Adjusts the buying price for this item. - Replace 'x' with a number depicting the desired value for the buy price. - This allows you to bypass the RPG Maker MZ editor's limitation of 999,999.
---
<Can Sell> <Cannot Sell> - Used for: Item, Weapon, Armor Notetags - Makes the item either always sellable or cannot be sold. - This bypasses the game's internal hard-coding to prevent items with a price of 0 from being able to be sold. - This bypasses the game's internal hard-coding to always allow items with a price value of being able to be sold.
---
<Sell Price: x> - Used for: Item, Weapon, Armor Notetags - Changes the sell price to be something different than the default amount. - Replace 'x' with a number depicting the desired value for the sell price.
---
<Show Shop Switch: x> <Show Shop All Switches: x,x,x> <Show Shop Any Switches: x,x,x> - Used for: Item, Weapon, Armor Notetags - Determines the visibility of the shop item based on switches. - Replace 'x' with the switch ID to determine the shop item's visibility. - If 'All' notetag variant is used, item will be hidden until all switches are ON. Then, it would be shown. - If 'Any' notetag variant is used, item will be shown if any of the switches are ON. Otherwise, it would be hidden.
---
<Hide Shop Switch: x> <Hide Shop All Switches: x,x,x> <Hide Shop Any Switches: x,x,x> - Used for: Item, Weapon, Armor Notetags - Determines the visibility of the shop item based on switches. - Replace 'x' with the switch ID to determine the shop item's visibility. - If 'All' notetag variant is used, item will be shown until all switches are ON. Then, it would be hidden. - If 'Any' notetag variant is used, item will be hidden if any of the switches are ON. Otherwise, it would be shown.
---
<Cannot Sell Switch: x> <Cannot Sell All Switches: x,x,x> <Cannot Sell Any Switches: x,x,x> - Used for: Item, Weapon, Armor Notetags - Determines the sellability of the shop item based on switches. - Replace 'x' with the switch ID to determine the shop item's sellability. - If 'All' notetag variant is used, item cannot be sold until all switches are ON. Otherwise, it can be sold. - If 'Any' notetag variant is used, item cannot be sold if any of the switches are ON. Otherwise, it can be sold.
---
JavaScript Notetags: Shop Menu
The following are notetags made for users with JavaScript knowledge. These notetags are primarily aimed at Buy and Sell prices.
---
<JS Buy Price> code code price = code; </JS Buy Price> - Used for: Item, Weapon, Armor Notetags - Replace 'code' to determine the buying 'price' of the item. - Insert the final buy price into the 'price' variable. - The 'item' variable refers to the item being bought.
---
<JS Sell Price> code code price = code; </JS Sell Price> - Used for: Item, Weapon, Armor Notetags - Replace 'code' to determine the selling 'price' of the item. - Insert the final sell price into the 'price' variable. - The 'item' variable refers to the item being sold.
---