Differences

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

--- plugin-card-summons [2024/10/15 06:04] – [Parameters] isiahgames
+++ plugin-card-summons [2025/06/27 22:36] (current) – [Version History] isiahgames
@@ Line 1: / Line 1: @@
-//**This page is a work in progress, and will be updating periodically.**//
+{{https://img.itch.zone/aW1nLzE4NzczOTY5LnBuZw==/original/Mglsyo.png?nolink&690}}
 This plugin adds a new Zone to battles called the Field, and with it come several new features.
@@ Line 57: / Line 57: @@
    <Field Skills>
-   skill x
+   Skill X
-   skill x limit y per turn
+   Skill X Limit Y per Turn
-   skill x limit y per battle
+   Skill X Limit Y per Battle
    </Field Skills>
-Replace 'x' with a Skill ID.
+Replace 'X' with a Skill ID.
-(Optional) replace 'y' with the amount of times a skill can be used within a turn/battle.
+(Optional) replace 'Y' with the amount of times a skill can be used within a turn/battle.
 If a card is removed from the Field and then placed again, its per-battle skills are refreshed.
@@ Line 76: / Line 76: @@
     <Card Passives>
-    Start of Turn Field: Skill x
+    Start of Turn Field: Skill X
-    End of Turn Field: Skill x
+    End of Turn Field: Skill X
     </Card Passives>
-Replace 'x' with a Skill ID.
+Replace 'X' with a Skill ID.
 This should go inside the Skills database regardless of whether this is for a Field Card or a Creature Card, as it belongs to the card itself.
@@ Line 127: / Line 127: @@
 Inside a card, you can set it to summon a Creature when it moves to the Field through the following Skill Notetag:
-    <Field Creature ID: x>
+    <Field Creature ID: X>
-Replace 'x' with an Enemy ID.
+Replace 'X' with an Enemy ID.
 When a card summons a Creature by moving to the field, the card is made invisible, but is still present underneath the Creature. When a Creature's HP reaches 0, its card is moved to the discard. Likewise, if a card is moved off of the field, its Creature dies.
-An animation can be played on the Creature when it is summoned by
+An animation can be played on the Creature when it is summoned by using the following Skill Notetag:
-using the following Skill Notetag:
-    <Summon Animation ID: x>
+    <Summon Animation ID: X>
-Replace 'x' with an Animation ID.
+Replace 'X' with an Animation ID.
 The specific placement of a Creature within the Field is relative to what RPG Maker considers its "center point," which is its center bottom in MV and its actual center in MZ. You can offset the location it will spawn in its place in the field using the following Enemy Notetags:
-    <grid offset X: x>
+    <Grid Offset X: Z>
-    <grid offset Y: x>
+    <Grid Offset Y: Z>
-Replace 'x' with a number, positive or negative.
+Replace 'Z' with a number, positive or negative.
 ==== Creatures' Stat Display ====
@@ Line 157: / Line 156: @@
 You can override default display behavior by using the following notetags:
-   <Show Stat x>
+   <Show Stat X>
-   <Hide Stat x>
+   <Hide Stat X>
-Replace 'x' with the stat/param associated with the Stat Display.
+Replace 'X' with the stat/param associated with the Stat Display.
 Stat Displays also have a list of Text Color Conditions, which determine what color the text will be that displays the stat. This allows you to use a system where a number changes color when it lowers.
@@ Line 170: / Line 169: @@
 The Stat Display will use the color of the first condition that returns true in the list.
+===== Summons Scope =====
+Base RPG Maker allows you to select the Scope of a skill, which determines who can be targeted for it. The addition of Creatures complicates this, and so you should work both with RPG Maker's Scope menu and the system below in tandem to get the scope you want.
+By default, all skills can target both Battlers and Creatures, and you can modify this with the following notetags:
+    <Card Summons Scope>
+    Battler
+    </Card Summons Scope>
+    <Card Summons Scope>
+    Creature
+    </Card Summons Scope>
+In addition, scope can be made to include Battlers or individual Creatures when certain conditions are met, like so:
+    <Card Summons Scope>
+    if [expression]
+    Creature
+    </Card Summons Scope>
+These if expressions are similar to the If Action in the Core Engine. They evaluate a code expression.
+However, in this condition the user has access to the variable "target", which represents any given Creature or Battler, and can be used to evaluate if that specific target is valid for the scope.
+For example:
+    <Card Summons Scope>
+    Battler
+    if target.hp >= target.mhp
+    Creature
+    </Card Summons Scope>
+In the above example, a skill could target the opponent Battler, and any Creature whose HP is greater than or equal to their Max HP - any Creature who hasn't taken damage.
+Creatures that cannot be targeted will be greyed out during selection.
+Another example:
+    <Card Summons Scope>
+    if target.friendsUnit().fieldCreatures().count == 0
+    Battler
+    if user.mp < user.mmp
+    Creature
+    </Card Summons Scope>
+The above example could target the opponent Battler only if there are no Creatures on their side of the field. It also can only target Creatures if the user's MP is not full. If neither condition is met there are no valid targets.
+===== Card Actions =====
+^  Card Action Syntax  ^ Description  ^
+|  <code>Select X from unitName Field</code>  |Replace 'X' with a number or game variable, and replace 'unitName' with 'Ally', 'Opponent', 'Party', or 'Troop'. This activates the respective Field to select the specified number of Cards.  |
+|  <code>Select X Type typeName from unitName Field</code>  |Replace 'X' with a number or game variable, and replace 'unitName' with 'Ally', 'Opponent', 'Party', or 'Troop'. Replace 'typeName' with a Card Type. This activates the respective Field to select the specified number of Cards, only being able to select the specified Type.  |
+|  <code>Select All from unitName Field
+Select All Type typeName from unitName Field</code>  |Works just like the above two Card Actions, but automatically selects all available Cards on the field. |
+|  <code>Use Skill X on Selected</code>  |Replace 'X' with a number or game variable. This performs a skill matching the ID of X on any Creatures selected using the above Select actions, using the Battler performing this Card Action as the subject for damage calculation.  |
+|  <code>Battle Log: message</code>  |Replace 'message' with text. This will push that text to the Battle Log.  |
 ===== Enemy Status Window =====
@@ Line 182: / Line 238: @@
 In the Enemies database, you can adjust the position of the Enemy sprite within the Enemy Status Window using the following notetags:
-    <Status Window Offset X: x>
+    <Status Window Offset X: Z>
-    <Status Window Offset Y: x>
+    <Status Window Offset Y: Z>
-Replace 'x' with a number, positive or negative.
+Replace 'Z' with a number, positive or negative.
 In Mugshot mode, this will determine what section of the Enemy Sprite is cropped within the corner of the window.
@@ Line 198: / Line 254: @@
 This can help the user set their parameters to match up with the images they're using to represent the field.
+===== Plugin Commands =====
+^  Command Syntax  ^  Event Usage  ^  Description  ^
+| <code>DisableCardField</code> |  Map Only  | Disables the Summons Field and returns to normal CGC battle. |
+| <code>EnableCardField</code> |  Map Only  | Enables the Summons Field if it's been disabled. |
 ====== Parameters ======
@@ Line 253: / Line 314: @@
 <code>
+**v1.0.3**
+- Added extra error handling when PartyUI_A is missing/below Card Summons, and when notetags reference an Enemy ID higher than is present in the project.
+**v1.0.2**
+- Fixed bug where Help Window would not open after using a Selection skill on the Field while using HelpBoxControl.
+**v1.0.1**
+- Fixed Use Skill on This Card Action targeting the wrong Creature when the Creature was not the most recently played Card.
 **v1.0.0**
 - Released plugin
 </code>