Skins are fairly self-explanatory if you’re familiar with the term already; they’re cosmetics that can potentially replace all of a characters’ sprites and sounds while keeping gameplay pretty much the same. When Workshop is enabled in the match rules, skins can be equipped by selecting a character, and then using the gear-shaped button that appears on the player window.
In terms of file structure as well as underlying behavior, they work similarly to a custom character. That means a lot of the Intruduction page applies here, as well. Same folders, same file structure.
The main difference here is the addition of a “character” property in the config.ini. This determines the character the skin is assigned to.
Templates
The following templates for every character contain all of the sprites they use, as well as scripts with every animation-related variable you can change and attack scripts for all of their attack properties. Most of the properties in the attacks folder won’t be changed unless an Advanced Skin is used, which is explained below.
- Zetterburn Template
- Orcane Template
- Wrastor Template
- Kragg Template
- Forsburn Template
- Maypul Template
- Absa Template
- Etalus Template
- Ori & Sein Template
- Clairen Template
- Ranno Template
- Sylvanos Template
- Elliana Template
- Shovel Knight Template
- Mollo Template
- Hodan Template
- Pomme Template
- Olympia Template
Basic skins
Basic skins are meant to be purely cosmetic; changes are restricted to things that don’t affect actual gameplay, and can generally be safer to use in tournaments and a more competitive setting. (Though for tournament organizers, skins may still have terrible visual and audio clarity. That should be as bad as they get.) The scripts Basic skins run are:
- load.gml – called right after the item is loaded into the game. This is where you would normally set sprites’ origins and bounding boxes. To help place origins correctly, use the Rivals Workshop Helper.
- colors.gml – used to generate the alternate color palettes for the character.
- init.gml – called once the player object is created. This is where you want to initialize most of the player variables. In basic skins, only certain animation-related variables will keep their changes from this script.
Basic skins also restrict the attack and hitbox properties you can set to the following:
- AG_SPRITE
- AG_AIR_SPRITE
- AG_WINDOW_ANIM_FRAMES
- AG_WINDOW_ANIM_FRAME_START
- AG_WINDOW_HITPAUSE_FRAME
- AG_WINDOW_HAS_SFX
- AG_WINDOW_SFX
- AG_WINDOW_SFX_FRAME
- HG_VISUAL_EFFECT
- HG_VISUAL_EFFECT_X_OFFSET
- HG_VISUAL_EFFECT_Y_OFFSET
- HG_HIT_SFX
- HG_EXTRA_CAMERA_SHAKE
- HG_PROJECTILE_SPRITE
- HG_PROJECTILE_ANIM_SPEED
- HG_PROJECTILE_DESTROY_EFFECT
- HG_HIT_PARTICLE_NUM
Advanced skins
A skin can be switched to an Advanced skin by switching the “advanced” property in its config.ini to “1”. With this, you’re able to essentially create variants of the character with edited moves and properties.
The scripts Advanced skins run are:
- load.gml – called right after the item is loaded into the game. This is where you would normally set sprites’ origins and bounding boxes. To help place origins correctly, use the Rivals Workshop Helper.
- colors.gml – used to generate the alternate color palettes for the character.
- init.gml – called once the player object is created. This is where you want to initialize most of the player variables.
- update.gml – called every frame. Used for gameplay mechanics.
- set_attack.gml – called at the beginning of every attack. Used to change things like Dspecial into Dspecial_air under certain conditions.
- attack_update.gml – called every frame, but only if the character is performing an attack (attack type is stored inside the attack variable).
- animation.gml – called every frame. Used for animation purposes such as changing the character’s sprite_index and image_index.
- pre_draw.gml – used to draw sprites other than the player’s sprite. Everything will be drawn behind the player character.
- post_draw.gml – used to draw sprites other than the player’s sprite. Everything will be drawn in front of the player character.
Advanced skins can also have any of their attack or hitbox properties changed. The templates have scripts for every attack the character uses (and then some), though they won’t necessarily be kept up to date with balance patches. If you want to use the base game’s current version of an attack property, simply delete the line that sets it, or use the // symbol to comment out the line.
