View source for More Currencies VisuStella MZ

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=FllHmZxx8H8</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/1395447" width="552" height="167"><a href="https://visustellamz.itch.io/more-currencies">More Currencies plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Merchant Manager Vol 2}}

}}

<!-- Preview -->

[[File:MoreCurrencies_Preview1.png|600px]]

[[File:MoreCurrencies_Preview2.png|600px]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]
* [[Items and Equips Core VisuStella MZ]]

<!--
{{ExtensionPluginsMZ}}
* [[Extension Plugin 1|Name1]]
* [[Extension Plugin 2|Name2]]
* [[Extension Plugin 3|Name3]]
-->

{{Visustella MZ}}

== Introduction ==

[[File:MoreCurrencies_Preview1.png|600px]]

This plugin expands the shop scene's functionality by allowing the game dev
to create items that can be sold for items and/or variables instead of gold.
Or you know what? Throw gold in there, too. Any combination of the them! By
doing so, gold no longer becomes the default currency for every shop, as
some special shops may require a different type of trade.

Features include all (but not limited to) the following:

* Items can be bought using items, weapons, armors, variables, gold, or any of the combinations listed.
* Sell items this way, too!
* Sold item listing window will now show the amount the player can get back per unit sold.
* Shop scene's calculation window is now updated to show the transaction details from how much the player owns to how much will be spent to what kind of result there will be.
* Proxy system support allows for shops to sell the same items but using different types of currencies.

== Requirements ==

This plugin is made for RPG Maker MZ. This will not work in other iterations
of RPG Maker.

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]
* [[Items and Equips Core VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

This plugin adds some new hard-coded features to RPG Maker MZ's functions.
The following is a list of them.

---

=== Window_ShopNumber ===

[[File:MoreCurrencies_Preview2.png|600px]]

The visual contents of this window have been completely overhauled to show
the details of what transactions are happening. This includes how much or
many of a resource the player owns, how much will be involved in the actual
transaction, and the net outcome after the transaction has taken place.

Naturally, this means that things will have to shift around in order for the
space to make any sense.

---

=== Proxy Items ===

[[File:MoreCurrencies_Preview1.png|600px]]

Proxy Items are temporary substitutes for another. When they are acquired
through shopping, they will turn into the item, weapon, or armor they are a
proxy for. Only the icon, name, help description, and status details will
match up. Everything else will remain separate such as the notetag data and
the trading list. This allows you to effectively have multiple ways to
trade the same item using different item combinations.

For more details, look inside of the Notetags section for Proxy items.

---

{{Notetags MZ}}

{{VisuMZ More Currencies Notetags}}

== Plugin Parameters ==

=== General Settings ===

[[File:MoreCurrencies_Preview2.png|600px]]

[[File:MoreCurrencies_Params1.png]]

Default settings for More Currencies.

---

General

  Automatic Sell Rate:
  - When using the plain "Cost" notetags, use this sell rate.

---

Vocabulary

  Owned:
  - Text used for how much of an item is owned.

  Shift:
  - Text used for the change in value.

  Net:
  - Text used for the net result.

---

=== Listing Settings ===

[[File:MoreCurrencies_Preview1.png|600px]]

[[File:MoreCurrencies_Params2.png]]

Settings for the currency listings.

---

Listing

  Listing Order:
  - Determines the order the trade components are listed.

  Show Sell Window:
  - Show listed items in the sell window?

  List Font Size:
  - Font size used for listed items.

  List Padding:
  - Pixel padding between listed items.

---

Text Format

  Item Format:
  Weapon Format:
  Armor Format:
  Variable Format:
  - Text format used for listed items.
  - %1 - Cost, %2 - Owned, %3 - Icon, %4 - Name

---

{{VisuStella MZ Terms of Use}}

== Credits ==

If you are using this plugin, credit the following people in your game:

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.04: December 14, 2023
* Bug Fixes!
** Fixed a bug where sold item costs didn't get returned. Fixed by Arisu.



Version 1.03: November 16, 2023
* Compatibility Update!
** Plugins should be more compatible with one another.



Version 1.02: July 13, 2023
* Bug Fixes!
** Fixed a crash when exiting certain menus from external sources into the shop scene. Fix made by Olivia.
* Optimization Update!
** Plugin should run more optimized.



Version 1.01: February 17, 2022
* Bug Fixes!
** Item, Weapon, Armor Cost Notetags should no work properly. Fix by Irina.
* Documentation Update!
** Added documentation for the following notetags:
*** <Variable id Buy Cost: x>
*** <Variable id Sell Cost: x>
*** <Variable id Cost: x>



Version 1.00 Official Release Date: March 7, 2022
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Merchant Manager Volume 2]]
* [[More Currencies (YEP)]]



== End of File ==

|}

<!-- This is a comment, remove the arrows surrounding this for the categories you want to show -->
<!-- [[Category: RPG Maker MZ Core Plugins]] -->
<!-- [[Category: RPG Maker MZ Battle Plugins]] -->
[[Category: RPG Maker MZ Item Plugins]]
<!-- [[Category: RPG Maker MZ Skill Plugins]] -->
[[Category: RPG Maker MZ Equip Plugins]]
<!-- [[Category: RPG Maker MZ Status Menu Plugins]] -->
[[Category: RPG Maker MZ Gameplay Plugins]]
<!-- [[Category: RPG Maker MZ Movement Plugins]] -->
<!-- [[Category: RPG Maker MZ Quest Plugins]] -->
<!-- [[Category: RPG Maker MZ Options Plugins]] -->
<!-- [[Category: RPG Maker MZ Eventing Plugins]] -->
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]
[[Category: RPG Maker MZ Menu Plugins]]
<!-- [[Category: RPG Maker MZ Message Plugins]] -->
<!-- [[Category: RPG Maker MZ Quality of Life Plugins]] -->
<!-- [[Category: Action Sequences (MZ)]] -->
<!-- [[Category: Comment Tags (MZ)]] -->
<!-- [[Category: Main Menu Manager Integration (MZ)]] -->
<!-- [[Category: Notetags (MZ)]] -->
<!-- [[Category: Options Core Integration (MZ)]] -->
<!-- [[Category: Plugin Commands (MZ)]] -->
<!-- [[Category: Script Calls (MZ)]] -->
<!-- [[Category: Text Codes (MZ)]] -->