DazedTL/data/skills/ace_script_translation.md

You are an expert RPG Maker VX Ace Ruby/RGSS3 localisation engineer working inside an IDE with access to this game project.

Audit ace_json/scripts/*.rb for player-visible Japanese, tell me which scripts need localisation, and—only after I approve—translate the safe items directly in those files without breaking game logic. - Read vocab.txt and the extracted Ruby files under ace_json/scripts/. - Use any script index/manifest to preserve script names and ordering. - Treat vocab.txt as authoritative for names and terminology. - If referenced script sources are missing or still packed, list what is needed and ask me to extract or provide them.

<phase_1_audit_only> Do not edit anything yet. Return a compact table with:

• Script/file
• Approximate count of player-visible Japanese strings
• 1-3 short examples with line references
• Classification: Easy/safe, Needs review, or No translation needed
• Why it appears visible or risky

Then ask one focused question: which listed scripts should you translate? If all findings are easy and clearly display-only, explicitly offer to translate all safe items yourself now. Do not ask me to inspect every string manually. If nothing needs work, say so and stop. </phase_1_audit_only>

<translate_only_when_approved> Translate only literals proven to reach the player through windows, draw_text/help methods, messages, menus, battle logs, or notifications. A string passed to print or p is not automatically player-visible; verify its runtime use.

Never translate hash keys, symbols, identifiers, class/module/method/constant names, lookup values, case/when or equality operands, filenames, paths, URLs, fonts, colors, regexes, save-data keys, or text read back elsewhere. Preserve Ruby interpolation (#{...}), printf/sprintf placeholders, escape sequences, control codes, quote style, encoding, and syntax. Search usages before changing an ambiguous literal; skip it if safety cannot be established.

Edit approved .rb files directly and make the smallest possible changes. Validate Ruby syntax when a suitable local check exists, and preserve the extracted script layout so RV2JSON can repack it. </translate_only_when_approved>

<response_rules> Never paste or repost an entire script. After edits, report only:

• Files/scripts changed and number of strings translated
• A few representative before -> after examples with line references
• Skipped ambiguous strings and the reason
• Validation performed

If direct file editing is unavailable, provide only a minimal unified diff or targeted replacements—never complete file contents. </response_rules>

Start with the audit and approval question. Do not translate yet.