Differences

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

--- plugin-card-shop [2024/03/22 14:35] – banerjeesw
+++ 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 21: / Line 23: @@
 Price formulas work like damage formulas, except they determine how much a card costs to buy or remove, or how much it gives the player on selling. Price formulas have several variables you can use:
 <code>
-cardPrice - the original price of a card set in Skill notetags
+buyPrice - the original Buy Price of a card set through Skill notetags.
+sellPrice - the original Sell Price of a card set through Skill notetags.
+removePrice - the original Remove Price of a card set through notetags.
 bought - the total cards bought at that shop
 sold - the total cards sold at that shop
 removed - the total cards removed at that shop
 adjustedCardPrice - a variable just for the Buy formula, this is the price of a card specific to this shop.
 </code>
 **Example 1**:
-<code>Remove price cardPrice + 10 * removed</code>
+<code>Remove price removePrice + 10 * removed</code>
-If a card costs 40 to purchase, it will cost 40 to remove if the player
+If a card costs 40 to remove by default, it will cost 40 to remove if the player
 has not removed any cards at this shop, and every time they do the price
 will increase by 10.
@@ Line 39: / Line 45: @@
 **Example 3**:
-<code>Sell price Math.floor(cardPrice * 0.3)</code>
+<code>Sell price Math.floor(buyPrice * 0.3)</code>
 This creates a shop where all cards sold will get you roughly 30%
-of their value back in gold. This is not impacted by adjustments.
+of their buy value back in gold. This is not impacted by adjustments.
 ====== Parameters ======
 {{https://cdn.discordapp.com/attachments/235557488794009600/1155224021282078762/image.png}}
@@ Line 48: / Line 54: @@
 | **Sell Price Formula** | The formula to determine the price of selling a card. See help section for details. |
 | **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}}
-| **Preview Card X** | The X coordinate of the preview card in the Card Shop scene. |
+| **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 Card Y** | The Y coordinate of the preview card in the Card Shop scene. |
+| **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. |
-| **Window Card Scale** | The scale of the cards in the windows in the Card Shop scene. |
+| **Preview Cost Coordinates** | The offset coordinates for the Cost text for the preview card. |
-| **Selected Card Scale** | The scale of the card in the windows in the Card Shop scene that is currently being inspected. |
+| **Max Visible Rows** | A number used to calculate what row the player currently has selected before scrolling down. If the game scrolls down too early, try raising this value; and it if scrolls too late, try lowering it. |
+| **Card Placement Settings** | A struct containing several parameters to determine how cards will fit inside their windows. |
+^ Card Placement Settings ^ ^
+| **Max Columns** | The number of cards a row before cards move to the next row in the window. |
+| **Card Scale** | The scale of the cards in the windows in the Deck Editor scene. |
+| **Selected Card Scale** | The scale of the card in the windows in the Deck Editor scene that is currently being inspected. |
+| **Starting Padding** | The padding between the left/top of the Window and the top-left-most card. |
+| **Card Spacing** | The spacing between cards. |
+| **Amount Text Offset** | The coordinate offset values for the Amount text. They default to underneath the center of the cards. |
+| **Amount Text Justify** | Whether the amount text of a card will be centered, aligned left, or right. |
 | **Card List Window Width** | The width in pixels of the Card List Window |
 | **Confirm Window Width** | The width in pixels of the Confirm Window |
+| **Gold Window Width** | The width in pixels of the Confirm Window |
+| **Hide Actor Window?** | If this is false, the Actor Window will appear to the side of the inventory window. If the Actor Window is hidden, it will instead appear in place of the inventory window when the user is prompted to select an actor to give a card to. This prompt occurs when buying a card while having multiple party members. |
+| **Actor Window Width** | The width of the Actor Window, if Hide Actor Window is set to false. |
+| **Short Actor Window?** | If this is true, the Actor Window will display less information. Useful if the window is thin. |
+| **Move Help Window** | If this is false, the Help Window will take up the entire bottom of the screen. If this is true, the Help Window will instead only be underneath the Card Preview, giving more height to the Card List. |
+| **Help Window Rows** | Sets the amount of rows of text that the Help Window can fit. 0 will hide the Help Window entirely. |
+===Scrollbar Settings===
 {{https://cdn.discordapp.com/attachments/235557488794009600/1155225217044590743/image.png}}
 | **Front Sprite** | The sprite used for the scrollbar. The middle third of its height scales to change the bar's size. |
@@ Line 61: / Line 90: @@
 | **Scroll Bar X** | The amount of pixels to the right of a scrolling window the scroll bar will appear. |
 | **Scroll Bar Y** | The amount of pixels the top is lowered by and the bottom is raised by to keep within the window. |
-{{https://cdn.discordapp.com/attachments/235557488794009600/1155225956173238352/image.png}}
-| **Use Alt UI?** | If set to ON, the Help Window will appear underneath the Card Preview, giving more height to the Card List. |
+| **Background Image** | A background image can be added to the scene. |
-| **Help Window Rows** | Set the amount of rows of text that the Help Window can fit |
-| **Short Actor Window?** | If set to ON, less information will show on the Actor Window. |
+===Card Pack settings===
+^ **Card Pack Presets** ^ A list of Card Packs you can add to the shop. Each Preset has the below parameters. ^
+| **Name** | The name that will display for the card pack. |
+| **Description** | The text that will fill the Help Window when highlighting this card pack. |
+| **Amount of Cards in Pack** | The amount of cards any copy of this pack can contain. |
+| **Card Pool** | The list cards that could appear in any copy of this pack. Each item in this list has two parameters: \\ \\ **Skill** is the Skill ID of the Card in the pool. \\ **Weight** is the value that determines the probability of this Card to be picked from the pool. Higher Weight means that a Card is more likely to appear. |
+| **Give Whole Pack to Actor?** | If true, when you buy a Card Pack all cards will go to the actor you select. When false, each card can go to a different actor individually. |
 ====== Notetags ======
 ^  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 83: / 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 101: / 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