Atk File Specification - wu4/rivals-easy-workshop-tool GitHub Wiki
fstrong.atk | fstrong.gml |
---|---|
|
|
Key-value pairs are defined by a key, containing alphanumeric characters, and a value, containing a Lua expression, delineated by the operator :
and at least one space.
All key names are case-insensitive.
length: 6
Blocks are defined by indentation. Blocks must be started after a hitbox or window statement.
Windows are defined by the operator >
, followed by a space. A key-value pair must follow the statement.
> length: 6
anim_frames: 2
Hitboxes are defined by the operator -
, followed by a space. A key-value pair must follow the statement.
- lifetime: 3
x: 25
y: -50
w: 30
h: 40
Hitboxes are nested within windows to associate them:
> length: 6
anim_frames: 2
- lifetime: 3
x: 25
y: -50
w: 30
h: 40
Some keys are automatically set. Here is the list:
-
AG_SPRITE
andAG_HURTBOX_SPRITE
: Can be overridden withsprite
andhurtbox_sprite
key-value pairs at root level, respectively. -
AG_NUM_WINDOWS
: Can be overridden with anum_windows
key-value pair at root level. -
HG_WINDOW
: Can't be overridden. Nest hitboxes in windows to associate them. - Hitbox count: Can't be overridden.
- Window IDs.
- Hitbox IDs. Nested hitboxes are ordered after root-level hitboxes.
Refer to the transpiled GML for window and hitbox IDs.
Repetitive prefixes, e.g. "HG_", "AG_" and "AG_WINDOW_", have been omitted from keys. They are not required, and are not valid in this language.
Key name | Transpiled result |
---|---|
length | AG_WINDOW_LENGTH |
Lifetime | HG_LIFETIME |
CATEGORY | AG_CATEGORY |
Key name | Transpiled result (invalid) |
---|---|
ag_window_length | AG_WINDOW_AG_WINDOW_LENGTH |
HG_Lifetime | HG_HG_LIFETIME |
AG_CATEGORY | AG_AG_CATEGORY |
In hitbox blocks, there are some shortcuts for better readability/typing:
Shortcut | Full name | Rivals GML equivalent |
---|---|---|
type | hitbox_type | HG_HITBOX_TYPE |
x | hitbox_x | HG_HITBOX_X |
y | hitbox_y | HG_HITBOX_Y |
w | width | HG_WIDTH |
h | height | HG_HEIGHT |
bkb | base_knockback | HG_BASE_KNOCKBACK |
kbg | knockback_scaling | HG_KNOCKBACK_SCALING |
dmg | damage | HG_DAMAGE |
vfx | visual_effect | HG_VISUAL_EFFECT |
sfx | hit_sfx | HG_HIT_SFX |
group | hitbox_group | HG_HITBOX_GROUP |
frame | window_creation_frame | HG_WINDOW_CREATION_FRAME |