GenesisForms 1.2.7

This release covers everything since the last public version, 1.2.5 — two internal builds (1.2.6) never went out publicly, so this bundles all of that work together. Highlights: a rewritten config system that auto-merges new settings into your existing files and reloads everything live, a much more flexible particle/glow/scale event system that now extends to key items, held items, fusions, possessions, and battle forms (not just the four core gimmicks), lossless Fusion saving, and a batch of stability fixes — including one that could permanently strand a Pokémon in Mega/Tera/Dynamax form after battle.

Cobblemon compatibility: 1.7.2 → 1.7.3. Minecraft/Fabric versions are unchanged.

⚠️ Breaking Changes

• events.json animation entries changed schema. Every animation entry now needs a type field ("vanilla", "snowstorm", or "snowstorm_entity"), and two fields were renamed: identifier → particle_resource, form_delay_seconds → form_change_delay_seconds. The shipped Mega Evolution animation has already been converted for you, but if you customized any animation entry yourself (or added new ones), it will fail to load until you update it to the new format — see the Events wiki page for the new schema and examples.
• config.json and messages.json are unchanged in content — same settings, same message keys — but are now shipped as bundled default files instead of generated in code. Your existing files load as-is.

Config files otherwise didn't change format. Everything you haven't customized will just pick up new default entries automatically on first load (see below).

Major New Features

• Config files now self-update. On startup, any config file missing new keys gets them backfilled automatically from the defaults, without touching anything you've already changed. /genesis reload also now reloads every config file — mega evolutions, fusions, held items, tera shards, Z-crystals, accessories, misc items, all of it. Previously only config.json, messages.json, events.json, and battle_forms.json reloaded live; everything else needed a full server restart.
• Particle/glow/scale effects now work on key items, held items, fusions, possessions, and battle forms. A new form_changes section in events.json extends the same animations/glow/features/scale system that Mega Evolution, Terastallization, Z-Power, and Dynamax already had — so you can now give a form-cycling key item its own particle burst, add a glow to a held-item transformation (Ogerpon's masks, Zacian/Zamazenta's blade forms), animate a Fusion, a Possession, or a weather/battle-driven form change (Castform, Cherrim, Aegislash, etc.).
• Two new animation types. snowstorm_entity attaches a particle effect to the Pokémon itself (via model locators, e.g. "root") so it follows the Pokémon around instead of staying fixed at a point in the world — this is what Mega Evolution's effect now uses. vanilla spawns an ordinary Minecraft particle, for when you don't need a custom particle resource.
• Fusion saving is now lossless. Fusing used to save only a hand-picked subset of the fused Pokémon's data (species, level, shiny, IVs/EVs, nature, ability, moves, held item, a few features) via custom serialization — anything else (nickname, ribbons/marks, exact experience, scale, Pokérus, ball seal, etc.) was silently dropped. It now uses Cobblemon's own save/load format, so un-fusing restores the fused Pokémon exactly as it went in. Old in-progress fusions from before this update are still readable.
• New /genesis clearGlowTeams command. The glow effect (used for Tera colors, etc.) works by creating a scoreboard team per glowing Pokémon; a bug (fixed below) could leave these teams behind permanently. This command does a one-time cleanup of every leftover glow_* team — worth running once after updating.
• debug: true in config.json now logs every raw Showdown battle message to console, useful when reporting battle-related bugs.

Config Changes

events.json

• Every animations entry now requires type (vanilla / snowstorm / snowstorm_entity), plus renamed fields particle_resource (was identifier) and form_change_delay_seconds (was form_delay_seconds).
• vanilla type adds count, delta_x/delta_y/delta_z, speed.
• snowstorm_entity type adds locators (a list of model bone names the particle attaches to, e.g. ["root"]).
• New top-level form_changes section with five sub-sections — key_items, held_items, fusions, possessions, battle_forms — each with the usual animations/glow/features/scale maps, all empty by default.

config.json / messages.json

• No setting or message keys changed — now shipped as bundled default resource files instead of being assembled in code at first run.

Everything else (mega_evolutions.json, battle_forms.json, fusion_items.json, z_crystals.json, tera_shards.json, held_form_items.json, held_battle_items.json, key_form_items.json, possession_items.json, max_items.json, misc_items.json, accessories/*.json)

• No schema changes. Internals were refactored to use the new config loader, but every field name on disk is identical to before.

Commands

• New: /genesis clearGlowTeams (permission genesisforms.clearglowteams) — removes every leftover glow scoreboard team.
• /genesis reload now reloads all config files, not just settings/messages/events/battle-forms.
• /genesis give ... subcommands now fail cleanly instead of crashing the console on an invalid item ID.

Bug Fixes

• Mega Evolution, Terastallization, and Dynamax could get permanently stuck active on a Pokémon after battle in some cases (the revert logic was checking the wrong battle object), leaking a glow scoreboard team each time — run /genesis clearGlowTeams after updating to clean up any that have already piled up.
• Ogerpon's Tera type wasn't reverting to Grass when its mask was removed.
• Tera Orbs previously only recharged from the Healing Machine block; they now recharge from any way of healing your party.
• Mega Evolution could occasionally fail to trigger mid-battle.
• Fixed a crash when using a Mega Accessory on a Pokémon with no loaded entity.
• Terastallizing while using certain moves could incorrectly reject valid targets.
• /genesis give commands no longer crash the server console on a typo'd/unknown item ID.
• Zacian and Zamazenta now swap moves properly on form change.

---

📖 Updated wiki: https://github.com/Unariginal/GenesisForms/wiki