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 [2024/12/18 18:29] (current) – 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 page is a work in progress, and will be updating periodically. The plugin is still in pre-release.**//
 This plugin adds a new Zone to battles called the Field, and with it come several new features.
@@ Line 170: / Line 172: @@
 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 =====
+|  <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>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 =====