Common issues

This page lists frequent problems and the fastest fixes.

Translation API errors

401 Unauthorized

key is wrong, revoked, or missing billing access
re-create the key and try again

429 Too Many Requests

rate limit reached
reduce batch size
wait and retry
avoid running multiple translators in parallel tabs

Timeout / Network error

retry
switch backend (DeepSeek ↔ OpenAI ↔ DeepL)
check your connection

Ren’Py: “ScriptError” / traceback after replacing `.rpy`

Most common causes:

missing closing tag (e.g., {i} without {/i})
modified variable name ([player] changed)
broken quotes or indentation

Fix:

open the file
locate the failing line from traceback
correct tags/variables
export again

RPG Maker: game won’t start / “Invalid JSON”

Most common causes:

broken quotes (" not escaped)
incorrect backslash escaping
trailing commas

Fix:

validate the JSON in an editor
restore escapes (\\)
export again

Preview doesn’t show changes

refresh the preview page
re-export translation and ensure the latest file is loaded
clear old sessions if you have stale data

Performance issues

If the UI becomes slow:

translate smaller batches
translate fewer files at a time
close heavy tabs
clear old sessions/storage

See: System requirements