Skip to content

Custom Forms

Andre edited this page Jul 8, 2026 · 1 revision

Custom Forms & Regional Variants

New in 1.1.0. Give any species alternate forms — including your own regional variants that wild Pokémon spawn with on the maps you choose. Open a species in the Pokédex and click 🧬 Forms.

Engine forms vs. your forms

The base engine already ships forms for many species (Alolan, Galarian, Hisuian, Paldean, megas, Deerling's seasons…). The modal lists them with a button that jumps straight to their code in the Scripts tab.

Your custom forms are added on top without touching the engine's: just use form numbers the engine doesn't already use for that species.

Creating a form

Click + Add form and fill in only what changes — every empty field is inherited from the base form:

Field Notes
Form # 1–99. Fixed once saved (sprites and data use it)
Types, abilities (+hidden) Pick from your project's types/abilities
Base stats / EVs given 6 comma-separated numbers (HP, Atk, Def, Speed, Sp.Atk, Sp.Def)
Level-up moves One per line: 7,DRAGONBREATH. If filled, it replaces the whole list
Compatible TMs & tutors Internal names, comma-separated. If filled, replaces the whole list
Height / weight / category / Pokédex entry / base EXP Cosmetic and progression data
Wild with this form on maps Map IDs — wild Pokémon generated there spawn already wearing this form. This is what makes it a regional variant

Sprites

Each form gets its own sprite slots (front, back, both shinies, icon) with the _N suffix next to the species' sprites — e.g. Front/019_1.png, icon019_1.png. Any missing sprite falls back to the base form.

Using forms from events

  • Give a Pokémon its form: pkmn.form = 1 (0 = base form).
  • Combine with Shiny Variants: a variant can be restricted to one form with its Only form # condition.

Where the data lives

  • PBS/reliqui_forms.txt (editable text, compiled automatically for the game).
  • The form logic is data-driven — no Ruby to write. It chains with the engine's MultipleForms handlers, so engine forms keep working untouched.

Turning whole mechanics on/off

Looking to disable megas or Dynamax instead? That's in Game Settings & Battle Mechanics.

Clone this wiki locally