Skip to content

Guide Save Editor

bryanthaboi edited this page Jul 19, 2026 · 1 revision

Save editor

A built-in editor for party, boxes, items, event flags, map location, and Pokedex flags — no play-through required. Close the game first, then from the repo root:

love . --editor
# or
POKEPORT_EDITOR=1 love .
# open a specific save
love . --editor --save "/path/to/save.lua"

Which save it opens

By default it loads the game's LÖVE save (save.lua):

OS Path
macOS ~/Library/Application Support/LOVE/pokemon-love2d/save.lua (without the LOVE/ segment in a packaged build)
Linux ~/.local/share/love/pokemon-love2d/save.lua
Windows %APPDATA%\love\pokemon-love2d\save.lua

If that file is missing or you want another copy, use Open..., drop a save.lua onto the window, or pass --save.

Safety

Every write makes a save.lua.bak-YYYYMMDD-HHMMSS backup first. Saves are plain Lua data files parsed by a data-only reader — the editor (and the game) never execute code from a save.

Headless test instructions live in tools/save-editor/README.md.

Clone this wiki locally