Skip to content

Preparation ​

Both characters and items can use animated sprites.

To convert your still image into an animated sprite, you'll need to provide a horizontal sprite sheet and an .ini file.

The filename of the .ini file, the filename of the horizontal sprite sheet, and the id column in the mod-loading Excel sheet must all match.

INI ​

ini
frame = 6
time = 0.066

This defines an animation with 6 frames at a 66 ms interval.

Example ​

Keeper of Garden Pole Dance (opens in a new tab)Lost Case Monster Girl Takeover (opens in a new tab)

Variation ​

You can use variations with animated sprites for automatic switching.

Switching at Runtime ​

To give one character a different sprite, animated or not, set a sprite override with the id of another texture in your Texture folder:

cs
chara.SetSpriteOverride("my_chara_alt");   // my_chara_alt.png, optional .ini and .pref
chara.SetSpriteOverride();                 // back to the normal sprite

In drama sheets, use set_sprite.

  • my_chara_alt_snow.png works as its snow variation. Without a .pref, the override uses the character's.
  • The override is saved with the character and takes priority over a custom skin.
  • It only works on characters using standalone textures (@chara in _idRenderData). Tile-sheet and PCC characters, including vanilla NPCs, keep their map sprite.

This project is an unofficial documentation site and is not affiliated with, endorsed by, or associated with Elin or Lafrontier / Noa. All trademarks are the property of their respective owners.