27 KiB
R6 Localization research (2026-10-06)
Status: research, nothing built. Every choice is PROPOSED; the owner decides.
Paths: <game> = LonaRPG root, <mod> = <game>/ModScripts/_Mods/LonaCraft, <mods> = <game>/ModScripts/_Mods.
Line numbers are as read on 2026-10-06; other executors are editing the mod, so mod lines may shift by a few.
Summary
| # | Finding |
|---|---|
| 1 | The mod is already almost fully behind text keys: 302 keys, 66 item files (132 key refs, none missing), 0 text in Recipes/*.json, 0 text in Maps. Hard-coded player-visible words: 9 (3 error box headers, 5 fallback tier names, 1 composed sentence), plus 15 punctuation/format joins, plus 6 debug-popup bits. |
| 2 | All five other language folders (CHT, KOR, MTL, RUS, UKR) are byte-identical copies of ENG: 0 translated keys out of 302 each. |
| 3 | The game never selects MTL (language list = folders of <game>/Text/, which has no MTL). Delete it. |
| 4 | A missing KEY shows the raw key text; a missing FILE shows a blocking msgbox error then raw keys; neither falls back to ENG. The game has no fallback. |
| 5 | A fallback hook fits in one new file (about 30 lines) because the mod already aliases Text#[] (Scripts/50_Tiers.rb:537-554). |
| 6 | Recommendation: (a) key the 1 composed sentence only, leave error boxes, debug and glue; (b) add the ENG fallback hook; (c) machine-translate CHT/KOR/RUS/UKR with Claude, marked for review, after the key set settles; (d) scratchpad checker; (e) drop MTL. 4 build items (section 5). |
1. How the game picks a language and loads text
| Fact | Evidence |
|---|---|
Language code is read from UserData/GameLona.ini [LonaRPG] Language (now ENG). |
<game>/UserData/GameLona.ini:2-9; <game>/Data/Scripts/Frames/5_DataManager.rb:105-108 |
Supported codes = the sub-folders of <game>/Text/: today CHT, ENG, KOR, RUS, UKR. The list is built by scanning the folder, not hard-coded. |
5_DataManager.rb:273-286 (createLangArray); <game>/Text/ listing |
An unknown code at boot resets to ENG and starts the first-run language pick. |
5_DataManager.rb:94-102 |
The language picks (title options, first-run setup, in-game System menu) all list createLangArray. |
Data/Scripts/Editables/122_Scene_TitleOption.rb:75; 123_Scene_FirstTimeSetup.rb:56; Frames/194_menu_08_0_System.rb:339, 804 |
Adding a language = a new folder under <game>/Text/ plus a Fonts/SYS-<CODE>-*.ttf. |
<game>/Fonts/_HowToAddFontToYourLang.txt |
Fonts per language: CHT, KOR, RUS, UKR, ENG each ship a SYS-<code> font. CHT/KOR/JPN get a larger message size. |
<game>/Fonts/ listing; Editables/50_System_Settings.rb:12, 40 |
A mod declares "texts": "Text" in _ModInfo.json; the loader stores it and registers the folder <mod path>/Text/<$lang> as part <mod id>. |
<mod>/_ModInfo.json:6; Frames/RVscript/710_Mod_InGameUI_ClassMod.rb:31; 730_Mod_InGameUI_mod_manager.rb:240-244 (link_texts) |
Key syntax: Part:File:id. A mod key is LonaCraft:<File>:<id>, which reads <mod>/Text/<lang>/<File>.txt, block <id>. Two-part keys (File:id) are the game's own <game>/Text/<lang>/. |
121_Dialog_Control_System.rb:87-96 (split_key), 98-111 ([]), 113-121 (load_file) |
File format: blocks separated by a blank line; first line = id, then body lines; # lines skipped; body lines joined with \f. A body line containing : is split as speaker: text (the trap noted in every mod Text file header). |
121_Dialog_Control_System.rb:123-148, esp. 137 |
Text is read lazily: a file is loaded on the first lookup and cached in the Text object. The Text object is rebuilt (cache cleared) at boot, on every update_Lang, and whenever create_game_objects runs (new game, load). update_Lang re-links all mod parts. |
5000_Mod_loader.rb:4-7 (<game>/ModScripts/); 5_DataManager.rb:114-117, 530-534; 121_...rb:103-105 |
Switching language in a menu rebuilds at once (update_Lang); title/first-run options also show a "restart recommended" notice. |
194_menu_08_0_System.rb:802-806; 122_Scene_TitleOption.rb:380-388 |
Item names and descriptions: JSON "textFlag": {"name": "<key>", "description": "<key>"}; the key is read through $game_text by every item screen. |
Frames/Modules/ItemConfig.rb:159-161; mod example <mod>/Item/Plank.json |
Mods menu: a _ModInfo.json description starting with $ is resolved as a key (LonaCraft uses $LonaCraft:Info:ModInfo/description). |
710_Mod_InGameUI_ClassMod.rb:93-94; 720_Mod_InGameUI_MOD SCENE.rb:474; <mod>/_ModInfo.json:5 |
Popups given a string go through $game_text[...], so keys work in $game_map.popup; a plain sentence with no : passes through unchanged. |
Frames/200_Galv_Event_Popup.rb:109 |
Escape \t[key] inside a message resolves a key (this is what call_msg("key") does). |
Frames/53_Window_Base.rb:246-248; Editables/29_Functions_417_Interpreter.rb:202-207 |
Fallback behaviour when something is missing
| Case | What happens | Evidence |
|---|---|---|
| Key missing in the chosen language, file exists | $game_text[key] returns the key string itself (e.g. LonaCraft:Items:Plank/item_name). With noError = true it returns "". No crash, no ENG fallback. |
121_Dialog_Control_System.rb:105-110 |
Mod folder Text/<lang>/<File>.txt missing |
A blocking msgbox "ERROR: missing translation file ..." (once per file per rebuild of $game_text), then every key of that file shows as the raw key. |
121_...rb:113-121 (118 is the msgbox), cached empty hash at 100-104 |
Mod part not registered (mod disabled / texts empty) |
Returns the key. | 121_...rb:100 |
| Malformed key (not 2 or 3 parts) | Returns the key. | 121_...rb:87-96, 100 |
Real-world check: RolePlayS ships only Text/CHT (1 file, GGININDER.txt), ENG and RUS (<mods>/RolePlayS/Text/), so in KOR and UKR (and CHT for most files) RolePlayS shows error boxes and raw keys. Nothing in RolePlayS hooks a fallback (its attempt is commented out: RolePlayS/Scripts/999_tmp_CORE.rb:821-837).
Can a mod hook a fallback?
Yes. Text is an ordinary Ruby class; LonaCraft already reopens it and aliases [] (Scripts/50_Tiers.rb:537-554, answers its LCTier: keys and decorates base names). A second alias on [] and one on load_file(part = nil, file) (121_...rb:113) can answer a missing LonaCraft: key or file from Text/ENG. See 5(b). Text#parse (121_...rb:123) can be reused to read the ENG file.
What MTL is
| Fact | Evidence |
|---|---|
The game never loads a folder called MTL: createLangArray lists <game>/Text/ only (CHT, ENG, KOR, RUS, UKR), and a mod folder is read only as Text/<$lang>. |
5_DataManager.rb:273-286, 106; 730_...mod_manager.rb:242; <game>/Text/ listing |
"MTL" appears nowhere in the game scripts or the mod's scripts; only in docs/BOARD.md:16 and the lore notes ("MTL tier" = machine-translated quality). |
grep of <game>/Data/Scripts, <mod>/Scripts, <mod>/docs; <mods>/LonaRPG_Lore_B.0.10.8.26.md:510, 1843, 2255 |
The booba mod carries the same dead Text/MTL/ (an identical copy of ENG), so MTL looks like a layout copied between mods, not a language. |
<mods>/Lona_Booba_Graphics/Text/ (CHT, ENG, KOR, MTL, RUS); its MTL/booba.txt = ENG |
| Result: dead folder, 8 files, 302 keys of English. Candidate for deletion. | section 2 |
2. Current state of <mod>/Text
Counted with the game's own block rule (blank-line separated blocks). Snapshot 15:5x on 2026-10-06; the Menu file is new that hour.
| File | Keys | ENG lines | What it holds |
|---|---|---|---|
| Craft.txt | 31 | 98 | crafting screen heads, groups, labels, messages, station names |
| Furniture.txt | 173 | 586 | 54 pieces x (item_name, description, menu) = 162, 4 menu_town, 7 shared (Place/, Storage/) |
| Homes.txt | 29 | 101 | 3 homes (shack, stone house, inn room), seller menu labels, purchase text |
| Info.txt | 2 | 10 | Mods-menu description, load-order warning |
| Items.txt | 24 | 76 | 12 materials x (item_name, description) |
| Menu.txt | 7 | 26 | main-menu "Craft" page (Scripts/85_MenuCraft.rb) |
| Station.txt | 22 | 75 | pot prompt, 9 process labels, 7 salvage texts |
| Tiers.txt | 14 | 49 | 5 tier names, bonus words, skill name, level-up popup |
| Total | 302 | 1,021 | 367 text lines, about 1,983 words, about 11.5k characters, 20,651 bytes, 0 non-ASCII |
| Language | Files | Keys | Differs from ENG | Verdict |
|---|---|---|---|---|
| ENG | 8 | 302 | (source) | real |
| CHT | 8 | 302 | 0 files (diff -rq) |
English copy |
| KOR | 8 | 302 | 0 files | English copy |
| MTL | 8 | 302 | 0 files | English copy, never loaded |
| RUS | 8 | 302 | 0 files | English copy |
| UKR | 8 | 302 | 0 files | English copy |
Other mods for comparison (<mods>/*/Text/):
| Mod | Languages shipped | Translated for real |
|---|---|---|
| LonaCraft | ENG CHT KOR MTL RUS UKR | ENG only |
| RolePlayS | ENG, RUS (20 files each), CHT (1 file) | RUS yes (human, Cyrillic); CHT 1 file |
| Campsites | ENG (strings.txt) |
ENG only |
| Otto_PassiveRegen | ENG, RUS | RUS |
| Lona_Booba_Graphics | CHT ENG KOR MTL RUS (1 file) | none (copies) |
| CustomDifficulty, EasyTravel | "texts": "", labels hard-coded in code/JSON |
n/a |
Encoding: the game's own Text files are UTF-8 without BOM, LF (<game>/Text/CHT/DataEquip.txt, first bytes # #). The loader does File.read(...).encode("utf-8") (121_...rb:115); write mod files as UTF-8 without BOM, LF.
3. Audit of strings not read through a text key
Method: every string literal in Scripts/*.rb, HCGframes/*.rb, loader.rb outside comments and p lines, plus every Item/*.json (66) and Recipes/*.json (56), plus Maps/*.rvdata2 and Salvage/*.json.
Clean (no hard-coded text): Item/*.json (all 66 carry textFlag; all 132 keys exist in ENG), Recipes/*.json (item ids and numbers only), Maps/*.rvdata2 (only -point- event names), Salvage/1000_LonaCraft_Salvage.json (export_name is internal), HCGframes/*.rb (one call each), menu labels, crafting screen headers, popups, choice labels, station names, furniture names and menus, home texts, "(Common)" tier word (key Tiers:Tier/name1). The mod's name "LonaCraft" is a brand.
3a. Player sees it, not behind a key (normal play)
| # | Where | String | Verdict |
|---|---|---|---|
| H1 | Scripts/0_Core.rb:134 |
msgbox("LonaCraft failed to load its data.\n" + message + backtrace) |
error box with Ruby backtrace; keep English |
| H2 | Scripts/50_Tiers.rb:207 |
msgbox("LonaCraft failed to build quality tiers. ...") |
same, keep English |
| H3 | Scripts/55_Recipes.rb:214 |
msgbox("LonaCraft failed to build its recipes. ...") |
same, keep English |
| H4 | Scripts/50_Tiers.rb:49-53 |
TIERS fallback names Common, Uncommon, Rare, Epic, Legendary; used only when the tier key is missing (50_Tiers.rb:154-157, tier_name) |
this is already an in-code ENG fallback; the hook (5b) makes it redundant but harmless; keep |
| H5 | Scripts/30_Process.rb:155 (with 108-113) |
"\t[Process/fibre_used] " + "<plant> x2, <plant> x1" + "." : the sentence is the key, but the list, the x, the , and the final . are glued in code. Korean and Chinese put the verb after the list, so the sentence cannot be translated properly. |
KEY IT: make the key a template with %s |
3b. Punctuation and format glue (language-neutral enough; leave)
| Where | Glue |
|---|---|
Scripts/50_Tiers.rb:449, 473 |
"<name> (<tier>)" ASCII parentheses |
Scripts/50_Tiers.rb:502 |
", " between bonus stats |
Scripts/50_Tiers.rb:507 |
"+" sign |
Scripts/30_Process.rb:111-112 |
" x2" and ", " between plants |
Scripts/80_CraftScene.rb:517, 590 |
"x2" output quantity |
Scripts/80_CraftScene.rb:611 |
"have/need" |
Scripts/80_CraftScene.rb:623 |
"Need 3 You 2 (Level 1)" spacing and parentheses |
Scripts/80_CraftScene.rb:656 |
"50%" |
Scripts/80_CraftScene.rb:669 |
two-space join of ATK/DEF parts |
Scripts/85_MenuCraft.rb:111 |
"<Craft/level> <n>" |
Scripts/0_Core.rb:162 |
", " between mod names in the load-order box |
Count: 15 sites. A Chinese translator might prefer full-width brackets; not worth a key (PROPOSED: leave).
3c. Debug (visible only while DEBUG = true, Scripts/95_Debug.rb:18; the hotkeys are numpad)
| Where | String |
|---|---|
Scripts/95_Debug.rb:52 |
"LonaCraft debug +10 x N <label>" with labels "materials" (80), "furniture" (83), "raw inputs" (85) |
Scripts/95_Debug.rb:62 |
"LonaCraft debug crafting level N" |
Scripts/95_Debug.rb:89 |
"LonaCraft debug all homes owned or rented 52 weeks (N)" |
Developer tool; stays English. Note DEBUG = true ships on today: the owner may want it false for a release (outside this item).
3d. Console only (p lines; stay English)
About 90 p "..." lines (per file: 0_Core 5, 100_Homes 27, 10_Icons 1, 30_Process 1, 40_Mining 1, 50_Tiers 10, 55_Recipes 6, 60_Skill 4, 70_Save 13, 80_CraftScene 1, 85_MenuCraft 2, 90_Furniture 18, 95_Debug 1). 0_Core.rb:161 is the console twin of the keyed load-order box.
3e. Translation traps found in the existing keys (not hard-coded strings, but they affect (c))
| Trap | Evidence | Why it matters |
|---|---|---|
\optB[a,b,c] lists live inside the translation; the count and order of entries must equal ENG, because code maps pick index to action. |
Text/ENG/Furniture.txt:7-8 header; Scripts/90_Furniture.rb:1028 (actions_for(kind, town)[pick], defined :212) |
A translator that adds or drops an entry breaks furniture actions. 68 lines carry \optB; 42 of them are the same Pick up,Cancel list. |
No commas or [ ] in labels that get spliced into a seller's \optB (Homes *_opt, common/collect_opt, common/gold, Process labels). |
Text/ENG/Homes.txt:1-11 header; Scripts/100_Homes.rb:996-1008; Text/ENG/Station.txt:4 |
A comma splits one choice into two. |
| Choice window is about 600 px wide; a longer line is squeezed. | Text/ENG/Homes.txt:7-11 |
Russian/Ukrainian run about 30% longer; CJK glyphs are double width. |
No ASCII : in body lines (parsed as speaker: text). |
121_...rb:137; headers of every mod Text file |
Translators write : by habit in RUS/UKR/CHT; use full-width : or rephrase. |
A blank line ends a block; # lines are dropped; \n ends each description line; \} opens it; \narr, \cg[..], #{$story_stats["HiddenOPT0"]} and %s must be copied verbatim. |
121_...rb:123-148; Text/ENG/Items.txt, Homes.txt:76, Tiers.txt:4, 25 |
Counted in the checker (5d). |
| Process labels name vanilla items ("Wooden Club", "Crystal Ore", "Iron Ore") in full sentences. | Text/ENG/Station.txt:14-41 |
Translators must use the game's own item words (glossary below). |
Homes: <price> <coin_week> and <buy_opt> <price> <gold> fix the order (price after the label). |
Scripts/100_Homes.rb:999-1008 |
Acceptable; translators put the unit word in the key (LC/week). |
Menu keys for a new :hand station and arrow group are coming (Station/hand, Group/Ammo, Pot text removed). Craft:Station/hand is not in Craft.txt yet; today :hand is not in Stations::LIST (55_Recipes.rb:49) so the screen falls back to the pot (80_CraftScene.rb:35). |
docs/SPEC_MENU_CRAFT.md:74, 165-166, 276-278; Scripts/85_MenuCraft.rb:49 |
The key set is still moving; translate after it settles or run the checker per batch. |
Vanilla glossary that the translations should reuse (read from <game>/Text/<lang>/):
| Term used in LonaCraft ENG | Vanilla key | ENG | CHT | KOR | RUS | UKR |
|---|---|---|---|---|---|---|
| Wooden Club | DataEquip:MhWoodenClub/item_name |
Wooden Club | 木棒 | 나무 몽둥이 | Дубинка | Дерев’яна палиця |
| Crystal Ore | DataItem:Mineral/item_name |
Crystal Ore | 晶礦 | 광석 | Кристаллическая руда | Кристалічна Руда |
| Large Copper Coin | DataItem:Coin2/item_name |
Large Copper Coin | 大銅幣 | 큰 동전 | Большой медяк | Велика мідна монета |
| Gold Coin | DataItem:Coin3/item_name |
Gold Coin | 金幣 | 금화 | Золотая монета | Золота монета |
| ATK | menu:equip/atk (Text/ENG/menu.txt:646) |
ATK | 攻擊 | 공격 | АТК | АТК |
| DEF | menu:equip/def (:649) |
DEF | 防禦 | 방어 | ЗАЩ | ЗАХ |
| HP | menu:core_stats/hp (:121) |
HP | 生命 | 생명 | ОЗ | Здоров’я |
| STA | menu:core_stats/sta (:127) |
STA | 體力 | 스태미너 | СИЛА | Сили |
| SPD | menu:equip/spd (:679) |
SPD | 敏捷 | 속도 | СКОР | ШВД |
| Level | menu:main_stats/level (:184) |
Level | 等級 | 레벨 | Уровень | Рівень |
Tiers.txt:5 already says "Bonus/*: stat words as in the game's DataEquip.txt"; the vanilla keys above are the real source and are localised in all four languages.
4. How RolePlayS localises, and what to copy
| Aspect | RolePlayS | Evidence | LonaCraft today |
|---|---|---|---|
| Mechanism | "texts": "Text"; items use "textFlag": {"name": "RolePlayS:DataItem:<Id>/item_name", ...}; no per-language JSON fields |
<mods>/RolePlayS/_ModInfo.json:12; RolePlayS/Item/BehelitAbom.json |
same mechanism (textFlag + Text/<lang>/) |
| File layout | Mirrors the game's files: DataItem.txt, DataEquip.txt, DataSkill.txt, DataState.txt, menu.txt, QuickMsg.txt, Locations.txt, plus mail/ |
<mods>/RolePlayS/Text/ENG/ (20 files) |
by topic: Items, Furniture, Homes, Craft, Station, Tiers, Menu, Info: fine, keep |
| Key style | <Id>/item_name, <Id>/description; menu keys menu:attr_up/up |
RolePlayS/Text/ENG/DataItem.txt:280-286; RolePlayS/Scripts/05_Attr_Exp.rb:190-193 |
same <Id>/item_name, <Id>/description |
| Description style | \} first line, each line ends \n, first-person Lona voice |
RolePlayS/Text/ENG/DataItem.txt:284-285; vanilla <game>/Text/ENG/DataEquip.txt:555-558 |
\}Crafting material. ...\n : matches |
| Translations | Real RUS (same keys, same line structure, 296 vs 295 lines in DataItem); CHT 1 file; no KOR, no UKR | RolePlayS/Text/RUS/DataItem.txt:281-286; Text/CHT/GGININDER.txt |
none |
| Reuse of vanilla keys | Campsites reuses OvermapEvents:World/Region_option_Cancel etc. instead of new words |
<mods>/Campsites/Scripts/10_Campsites.rb:365-368 |
own words for ATK/DEF/Level/Cancel |
| Missing language | no fallback; error boxes in KOR/UKR | section 1 | no fallback (all copies) |
Conventions LonaCraft should copy: keep <Id>/item_name + <Id>/description keys and the \}..\n description shape (already so); describe vanilla terms with the vanilla words (glossary); reuse vanilla keys for universal words (Campsites precedent); real translations go in the same file and key layout as ENG so a diff works (RolePlayS RUS is line-for-line with ENG). With RolePlayS only in ENG/RUS (and one CHT file), LonaCraft cannot look "consistent" with it in KOR/UKR: that gap is RolePlayS's, not fixable here (PROPOSED: do not touch it).
5. PROPOSED plan
(a) Text-key sweep
| Option | Effect | Cost |
|---|---|---|
| A1 Key all 9 hard-coded words incl. error boxes, tier fallback, debug | 100% literal | error boxes carry backtraces (cannot be keyed usefully); debug never leaves the owner |
A2 (RECOMMENDED) Key only what needs a different sentence shape: H5 (Process/fibre_used becomes "... out of %s." and the code does the gsub; Desc/header already uses %s, Tiers.txt:4, 25). Leave H1-H4, glue (3b), debug (3c), console (3d) |
every normal-play sentence is translatable; 0 new keys, 1 changed key | Scripts/30_Process.rb:108-113, 155 (about 6 lines) + Text/<lang>/Station.txt Process/fibre_used |
| A3 A2 plus format keys for the glue in 3b | full-width brackets etc. | 3-5 new keys x 5 languages; low value |
Also PROPOSED within A2 (optional, in the same item): read ATK, DEF, HP, STA, SPD, Level from the vanilla keys in the glossary table instead of owning 8 keys of our own (Craft:Label/Level, Atk, Def; Tiers:Bonus/atk, def, sta, health, move_speed). Saves 8 keys x 4 languages (32 translations) and matches the equipment screen in every language. Risk: low; the 8 keys stay in ENG as the fallback if the vanilla key is ever missing. Use: $game_text["menu:equip/atk"].
(b) ENG fallback for a missing key
| Option | How | Cost |
|---|---|---|
B1 (RECOMMENDED) Runtime hook for the LonaCraft part: new Scripts/5_TextFallback.rb, loaded right after 0_Core.rb in loader.rb. (1) Alias Text#[]: split the key, if part is LonaCraft and the result equals the key or is empty and $lang != "ENG", return the same id from Text/ENG/<File>.txt. (2) Alias Text#load_file(*args): for part LonaCraft, if Text/<lang>/<File>.txt is missing, return the parsed ENG file and skip the blocking msgbox. The ENG file is read once per file per session with Text#parse and kept in a module-level Hash (survives Text.new on language switch, since ENG never changes). |
one new file about 30 lines, one line in loader.rb; cost at run time: a Hash lookup only on a miss. It coexists with the Tiers alias (50_Tiers.rb:537-554), whichever loads first. |
|
| B2 Tool-synced files: the checker copies missing ENG keys into each language file | no runtime code | re-creates today's problem (English copies cannot be told from translations); needs a re-run on every key added |
| B3 Nothing: raw keys and error boxes in the untranslated languages | zero | unacceptable: a player on KOR sees LonaCraft:Furniture:Bed/menu |
| B4 Generic hook for every mod part (fixes RolePlayS in KOR/UKR too) | same code, no LonaCraft check |
changes other mods' behaviour without their authors; not recommended |
With B1, a language folder may hold only the keys that are really translated (a missing key or file shows ENG), which also fixes the "copies look like translations" problem. The owner can still hot-test: switch language and back in the System menu to rebuild $game_text and reload the files without a restart (194_menu_08_0_System.rb:802-806).
(c) How the translations get made
| Option | Quality | Cost | Risk |
|---|---|---|---|
| C1 Owner-provided | best | owner time, about 2,000 words x 4 | slow; blocks release |
C2 (RECOMMENDED) Claude translates CHT, KOR, RUS, UKR, one executor per language, with the vanilla glossary (section 3e) and the rules in 3e as input; each file starts with a # comment line # Machine-translated by Claude on <date>, not reviewed by a native speaker (comment lines are dropped by the parser, 121_...rb:129); the checker (d) gates it (keys, \optB counts, control codes, :); the owner or a community reviewer corrects later and removes the comment |
good for UI/short text; flavour text and Lona's voice in CHT/KOR need review | about 2,000 words per language; order of 20-25k output tokens per language plus glossary input; Sonnet for RUS/UKR, Opus for CHT/KOR | tone and register errors; labelled so players know |
| C3 Leave English | n/a | zero | mixed UI; fine only with (b) |
Timing: do C2 after the in-flight key changes land (docs/SPEC_MENU_CRAFT.md:74, 165-166, 276-278: Station/hand, Group/Ammo, pot text removal, arrows; also R3 base building and R5 nodes add keys). Until then (b) covers every new key. After C2, only the delta (checker's "missing" list) is translated per milestone.
(d) The checker (describe, not written)
A single Python 3.10 script run from the scratchpad (not shipped in the mod folder), python lc_text_check.py [--lang CHT] [--code], output as tables, exit code 1 when anything is missing. It uses the game's parse rule (blank-line blocks, # skipped) and prints per language and per file:
| Check | Reports |
|---|---|
| Missing keys | in ENG, absent in <lang> |
| Extra keys | in <lang>, absent in ENG |
| Untranslated | body identical to ENG (excluding keys that are numbers or names) |
\optB entry count / order |
count differs from ENG |
| Forbidden characters | ASCII , [ ] in labels spliced into \optB (Homes *_opt, common/*, Process labels); ASCII : in any body line |
| Control codes | the multiset of \narr, \}, \n, \cg[..], \C[..], #{..}, %s differs from ENG |
| Width | display width of \optB lines over ENG width x 1.3 (CJK counted double) |
| Format | empty body, duplicate key, BOM, CRLF, non-UTF-8, id with a space or colon |
--code (optional) |
keys referenced by the Ruby/JSON (static "LonaCraft:File:id" strings and #{} prefixes such as Process/#{key}) that ENG does not define (typos), and ENG keys nothing references |
It also prints a coverage table (lang | translated | missing | untranslated | %). A first draft of the code-reference part already ran (audit.py in the scratchpad): 302 keys defined, all 132 textFlag references resolve.
(e) Drop MTL
PROPOSED: yes, delete <mod>/Text/MTL/ (8 files). The game cannot select it (section 1); keeping it adds one more copy to keep in step with every new key. If the owner ever wants a machine-translated tier, it would have to be a real game language folder under <game>/Text/ plus a font (_HowToAddFontToYourLang.txt), which is out of scope for a mod.
Recommendation in one line
A2 + B1 + C2 + the checker + delete MTL, as four build items; start with L1 and L2 (small, no translation), run L3 once the owner has settled the key set.
Work breakdown
| Item | Builds | Files touched | Strings | Executor |
|---|---|---|---|---|
| L1 Fallback hook and sentence key | B1; A2 (H5) and optional vanilla-key reuse | new Scripts/5_TextFallback.rb; loader.rb (+1 line); Scripts/30_Process.rb:108-113, 155; Text/ENG/Station.txt (Process/fibre_used); optional Scripts/80_CraftScene.rb, Scripts/50_Tiers.rb text lookups for the 8 stat/level words |
1 key reworded (x1 ENG; the other languages get it in L3); optional 8 keys retired | Sonnet builder (small); owner decides the optional part |
| L2 Checker, MTL removal, baseline | (d), (e) | scratchpad lc_text_check.py; delete Text/MTL/ (8 files); docs/BOARD.md note; README one line on languages |
0 strings; baseline table (302 keys, 0 translated x 4) | Sonnet |
| L3 Translations (4 in parallel, one per language) | C2 | Text/CHT/*.txt, Text/KOR/*.txt, Text/RUS/*.txt, Text/UKR/*.txt (8 files each, 32 total) |
302 keys per language (294 if the vanilla reuse in L1 lands), about 1,983 words, about 11.5k characters of ENG source each; 4 languages = about 1,200 keys | Sonnet RUS/UKR, Opus CHT/KOR; checker gate; no shared files so no merge conflict |
| L4 Delta passes (recurring) | keep languages current | the files above, only the checker's missing list | the keys added by each milestone (R2 B1/B3, R3, R5) | Sonnet, after each milestone |
Gate for each build item stays as the board says (static checks by Claude, then the owner's in-game run, no agent launches the game). L3's extra gate: the checker prints 0 missing, 0 control-code mismatches, 0 \optB mismatches, 0 forbidden characters.
Questions for the owner (one choice each, recommendation first)
| # | Question | Recommendation |
|---|---|---|
| Q1 | Add the ENG fallback hook (B1)? | Yes |
| Q2 | Key only the fibre sentence (A2), keep error boxes, debug, glue in English? | Yes |
| Q3 | Reuse the vanilla words for ATK/DEF/HP/STA/SPD/Level? | Yes |
| Q4 | Translations by Claude with a review note (C2)? | Yes, after the key set settles |
| Q5 | Delete Text/MTL? |
Yes |
| Q6 | Set DEBUG = false (Scripts/95_Debug.rb:18) for a release? |
Outside R6; flag only |