Differences

This shows you the differences between two versions of the page.

--- plugin-card-shop [2024/09/11 05:33] – [Parameters] isiahgames
+++ plugin-card-shop [2025/01/29 22:15] (current) – [Parameters] isiahgames
@@ Line 6: / Line 6: @@
   - In that same event or common event, call the script: <code>this.cardShopProcessing();</code>
-Only one shop preset can be made per Event, but until the shop is reset its stock will carry over between sessions. This means if the player buys its entire stock, when the player returns to the shop it will stay empty.
+Only one shop preset can be made per Event Page, but until the shop is reset its stock will carry over between sessions. This means if the player buys its entire stock, when the player returns to the shop it will stay empty.
 Card Shop Plugin is available on [[https://mythatelier.itch.io/card-shop-cgc-expansion-plugin|itch.io]].
+**Current Version: v1.2.1**
 ===== Buy, Sell, and Remove =====
@@ Line 53: / Line 55: @@
 | **Remove Price Formula** | The formula to determine the price of removing a card. See help section for details. |
 | **Free Card Text** | The text to display for a card that costs 0 Gold. |
+| **Confirm Texts** | The text that appears in the confirm pop-up window. \\ You can use %skill as a textcode to get the name of the Skill that is being bought or sold. |
 ===Card Shop Scene===
 {{https://cdn.discordapp.com/attachments/235557488794009600/1151226066459971624/image.png}}
+| **Command Names** | The names of the commands that can appear inside the Card Shop scene. They include: \\ Buy - The command that activates the Buy Window. \\ Sell - The command that activates the Sell Window. \\ Remove - The command that activates the Remove Window. \\ Cancel - The command that exists the Card Shop scene. \\ Yes - The text for the prompt that confirms a selection. \\ No - The text for the prompt that cancels a selection. |
 | **Preview Coordinates** | The coordinates of the preview card in the Card Shop scene. |
 | **Preview Card Scale** | The scale of the preview card in the Card Shop scene. |
@@ Line 102: / Line 106: @@
 ^  Notetag Syntax  ^  Database Usage  ^  Description  ^
-| <code><Card Price: X></code> |  Skill  | This will set the price of that skill's Card to X. You can use \v[x] to substitute the price with a Game Variable. |
+| <code><Card Price: X>
+<Card Buy Price></code> |  Skill  | This will set the price of that skill's Card to X. You can use \v[x] to substitute the price with a Game Variable. |
+| <code><Card Sell Price></code> |  Skill  | This will set the sell price of that skill's Card to X. You can use \v[x] to substitute the price with a Game Variable. |
+| <code><Card Remove Price></code> |  Skill  | This will set the removal price of that skill's Card to X. You can use \v[x] to substitute the price with a Game Variable. |
+| <code><Prevent Card Buy></code> |  Skill  | This will prevent that skill's Card from being able to be selected for purchase. |
+| <code><Prevent Card Sell></code> |  Skill  | This will prevent that skill's Card from being able to be selected for selling. |
+| <code><Prevent Card Remove></code> |  Skill  | This will prevent that skill's Card from being able to be selected for removal at a Card Shop. |
+| <code><Shop Image: fileName></code> |  Skill  | This will cause that skill's Card to appear using the specified image in the Card Shop. Images should be placed in img/CGC/shop. |
 | <code><card shop>
 x Skill Y
@@ Line 117: / Line 128: @@
 x skillName Y Price Z
 </card shop></code> |  Event  | If you want a card that has a different price from the default, this format will let you label specific items in the shop at a custom price |
+| <code><card shop>
+Pack Preset Y
+x Pack Preset Y
+</card shop></code> |  Event  | You can add Card Packs that have been set up through the Card Pack Preset parameters. |
 | <code><card shop>
 Command: buy
 Command: buy, sell, remove, cancel
 </card shop></code> |  Event  | This determines which commands will be present in the scene. If only one is present, the Command Window will be invisible and more space will be given to the Card Selection Window. |
+| <code><card shop>
+Buy Price priceFormula
+Sell Price priceFormula
+Remove price priceFormula
+</card shop></code> |  Event  | These override the default formulas used to determine how much a card is worth when buying, selling or removing. The default formulas are set through plugin parameters. |
+| <code><card shop>
+Buy Limit X
+Sell Limit X
+Remove Limit X
+</card shop></code> |  Event  | These determine how many cards can be bought, sold, or removed respectively before the option to buy/sell/remove is disabled. |
+Lastly, this plugin has tools to allow you to randomize values within these
+comments, like so:
+x Skill [1-4]
+Replacing a number with [min-max] will make the shop determine a random
+number between the minimum and the maximum (inclusive). So in the above
+example Skill 1, Skill 2, Skill 3, or Skill 4 may appear.
+You can also put this at the beginning of the notetag, like so:
+   [1-3]x Skill 4
+This will cause the Shop to stock between 1 and 3 copies of Skill 4.
+Additionally, you can also use the following:
+x Skill [5, 7, 9]
+Replacing a number with [x, y, z, etc] will make the shop choose
+from the list of numbers inside the brackets. So in the above example
+Skill 5, Skill 7, or skill 9 may appear.
+This works anywhere in the comments to determine the shop inventory. This
+means you can do this:
+    <card shop>
+    [3-4]x Skill [7, 8, 9, 11, 13, 15]
+    [1-2]x Pack Preset [1-3]
+    [1-2]x Pack Preset [1-3]
+    [1-2]x Pack Preset [1-3]
+    Buy Price buyPrice * [1-2]
+    </card shop>
+Note that these randomization methods will only produce whole numbers.
+Also note that any random numbers will retain their values when a shop's
+inventory is reset through script calls or plugin commands.
 ====== Script Calls ======
@@ Line 135: / Line 198: @@
 ====== Version History ======
 <code>
+v1.2.1
+- Added <Prevent Card Buy/Sell/Remove> notetag.
+- Fixed CardShopCore bug where Help Window would still appear when its Rows parameter was 0.
+- Fixed Param Descriptions in CardShopCore referring to Simple Library
+- Fixed crash when trying to sell cards that don't exist.
+- Added several parameters to change text components.
+- One event can now contain multiple shops - one per event page.
+v1.2.0
+- Updated for compatibility with CoreEngine v1.6.2.
+- Complete overhaul of Card Shop Scene as a product of the Library overhaul.
+- Lots of UI improvements. More UI parameters.
+- Fixed bug where buy formula would reset to default after backing out and reentering shop.
+- Fixed bug where bought and sold variables would reset between shop instances.
+- Fixed default sell formula not working.
+- Added parameter to change what displays when a card is free.
+- Added Card Packs to the shop.
+- Added custom Sell and Remove prices to Card Notetags.
+- Added custom Image notetags for Cards when displaying in the Shop.
+- Added Buy Limit, Sell Limit, and Remove Limit options in a <card shop> settings tag.
+- Added randomization options in <card shop> settings tags.
+- Added compatibility with YEP_X_MoreCurrencies.
 v 1.1.1
 - Added Plugin Params for default Buy and Sell Price Formulas