This is an old revision of the document!
Table of Contents
Zones Overview
This page covers the new UI Elements that are added to the Battle Screen by MYTH_CGC_CoreEngine.
A Zone is a place that cards can move to/from during combat. There are 3 default Zones that all projects must have. There is overlap in their behavior, but each one works slightly differently.
- Hand
- Deck
- Discard
Beyond those three, you can add extra Zones through plugin parameters. Note that all Zones use the same parameter structure with the exception of the Hand.
Hand
This is the fan of Cards the active Actor has access to. The player can play any Card in the Hand as long as they meet all the necessary requirements.
The Hand behaves differently from every other Zone in that the Cards are spread out so the player can see them all at once. The parameters for the Hand are as follows:
| Center Coordinates | A set of X/Y values that set the center of the hand. Recommend placing this in the center of RPGM's window width and at the bottom of the screen. |
| Selected Card Y Offset | The number of pixels the currently selected card will raise above the rest of the hand |
| Discarding Card Y Offset | The number of pixels a card will be raised if it is chosen to be discarded. |
| Inactive Hand Y Offset | The number of pixels all cards will be lowered if the player cannot currently select cards. |
| Max Hand Width | The max horizontal space the hand can take up. |
| Min Card Separation W | The minimum space in pixels between cards until the max width would otherwise be reached. |
| Card Rotation Multiplier | Cards will rotate the farther they are from the hand. This adds a multiplier to that amount to increase or decrease that rotation. |
| Card Height Multiplier | Card height changes depending on their distance from the center of the hand. This adds a multiplier to that amount to increase or decrease that height. |
| Card Enter SFX | The SE that will play when a Card enters the Hand. |
| Card Enter SFX | The SE that will play when a Card exits the Hand. |
| Card Actions on Empty | See Card Actions on Empty |
| Card Actions on Empty Trigger | See Card Actions on Empty |
Deck
This is where all Cards are at the start of battle by default.
If using the Card Selection Window to view the contents of the Deck, the Cards that appear will be shuffled so that the player can't anticipate what they're going to draw next.
If the player uses the default parameter values for the Deck's Card Actions on Empty, then when the Deck is emptied all of the Cards from the Discard will be moved to the Deck, and then the Deck will be shuffled.
Discard
This is where all Cards will travel to after being played by default.
Zone Parameters
All Zones except for the Hand use the following parameters:
| Deck Image | An image file to represent the deck. It can be a card back, or something more abstract. |
| Deck X coordinate Deck Y coordinate | These represent the coordinates on the screen the deck image will appear. |
| Deck card scale Deck card rotation | If the Deck Image is smaller than the card images, and appears to be at an angle, as in the above screenshot, then when cards are drawn they should be scaled down and angled as they appear below the Deck Image, then scale up and re-orient themselves as they move into the hand. The effect is that cards appear the same size as the Deck Image, then grow into their full size. It feels more like cards are being drawn from the deck that way. Deck Card Scale is a number between 0 and 1 if the card should be smaller than its normal size, and between 1 and 4 if it should be bigger. Deck Card Rotation is measured in degrees between -360 and 360. |
| Deck Amount Number Font Size | The font size for the number representing how many cards are in the deck. |
| Deck Number X Coord Deck Number Y Coord | The coordinates for the Deck Amount Number. This number is right-aligned, so 0, 0 represents the top right of the Deck Image. |