109 lines
4.6 KiB
Markdown
109 lines
4.6 KiB
Markdown
# Preferences Language Toggles Implementation Plan
|
|
|
|
> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
|
|
**Goal:** Add a Language section to Preferences with two mutually exclusive toggles that switch active game language between default (`None`) and Spanish (`"spanish"`), placed to the right of Skip.
|
|
|
|
**Architecture:** Extend the existing top preferences row in `screen preferences()` by adding one `radio`-styled `vbox` section for language controls. Use Ren'Py built-in `Language(...)` actions for immediate language switching and selected-state semantics. Update Spanish translation strings so button labels follow Option B behavior (`English/Inglés`, `Spanish/Español` depending on active language).
|
|
|
|
**Tech Stack:** Ren'Py screen language (`.rpy`), Ren'Py translation files (`game/tl/spanish/*.rpy`), Ren'Py CLI (`renpy.sh` lint/compile/run).
|
|
|
|
---
|
|
|
|
## File Structure
|
|
|
|
- Modify: `game/screens.rpy` (preferences layout and language toggle actions)
|
|
- Modify: `game/tl/spanish/screens.rpy` (translations for `Language`, `English`, `Spanish`)
|
|
- Reference: `docs/superpowers/specs/2026-03-20-preferences-language-toggles-design.md`
|
|
|
|
Notes:
|
|
- Keep all work in the currently active local translation branch.
|
|
- Do not create or use git worktrees for this task (required for local playtesting workflow).
|
|
- Follow existing `Display`/`Skip` section layout and style patterns.
|
|
|
|
## Chunk 1: Preferences UI Section
|
|
|
|
### Task 1: Add Language block in top preferences row
|
|
|
|
**Files:**
|
|
- Modify: `game/screens.rpy` (inside `screen preferences()` first `hbox` near existing `Display` and `Skip` blocks)
|
|
|
|
- [ ] **Step 1: Baseline acceptance check (expected to fail current requirement)**
|
|
|
|
Run: `"renpy.sh" "/home/$USER/Documentos/Renpy Projects/Soul Droid Chat" run`
|
|
Expected baseline: Preferences has no `Language` section to the right of `Skip`.
|
|
|
|
- [ ] **Step 2: Add Language section with matching style/title**
|
|
|
|
In `screen preferences()` first `hbox`, add this `vbox` immediately after the existing `Skip` `vbox`:
|
|
|
|
```renpy
|
|
vbox:
|
|
style_prefix "radio"
|
|
label _("Language")
|
|
textbutton _("English") action Language(None)
|
|
textbutton _("Spanish") action Language("spanish")
|
|
```
|
|
|
|
Implementation details:
|
|
- Keep section placement in the same `hbox` that contains `Display` and `Skip`.
|
|
- Keep title wrapped in `_()`.
|
|
- Use `style_prefix "radio"` so title/button appearance matches established pattern.
|
|
|
|
- [ ] **Step 3: Run lint to validate screen syntax after UI change**
|
|
|
|
Run: `"renpy.sh" "/home/$USER/Documentos/Renpy Projects/Soul Droid Chat" lint`
|
|
Expected: No new lint errors from preferences screen edits.
|
|
|
|
## Chunk 2: Translation Labels and End-to-End Validation
|
|
|
|
### Task 2: Add Spanish string mappings for Option B labels
|
|
|
|
**Files:**
|
|
- Modify: `game/tl/spanish/screens.rpy` (within `translate spanish strings:`)
|
|
|
|
- [ ] **Step 1: Add/confirm Spanish translations for new strings**
|
|
|
|
Ensure these mappings exist exactly once in `game/tl/spanish/screens.rpy`:
|
|
|
|
```renpy
|
|
old "Language"
|
|
new "Idioma"
|
|
|
|
old "English"
|
|
new "Inglés"
|
|
|
|
old "Spanish"
|
|
new "Español"
|
|
```
|
|
|
|
- [ ] **Step 2: Verify compile after translation update**
|
|
|
|
Run: `"renpy.sh" "/home/$USER/Documentos/Renpy Projects/Soul Droid Chat" compile`
|
|
Expected: Successful compile.
|
|
|
|
- [ ] **Step 3: Manual smoke test for behavior and mutual exclusivity**
|
|
|
|
Run: `"renpy.sh" "/home/$USER/Documentos/Renpy Projects/Soul Droid Chat" run`
|
|
|
|
Validate in Preferences:
|
|
- `Language` section appears to the right of `Skip`.
|
|
- `Language` title style matches `Display` and `Skip` titles.
|
|
- Selecting `English` sets default language (`Language(None)`).
|
|
- Selecting `Spanish` sets Spanish language (`Language("spanish")`).
|
|
- Only one of the two language toggles appears selected at a time.
|
|
- Section title and labels behave per Option B/localization mappings:
|
|
- Default language active: section title `Language`; buttons `English`, `Spanish`
|
|
- Spanish active: section title `Idioma`; buttons `Inglés`, `Español`
|
|
- Switching back to English restores title `Language` and buttons `English`, `Spanish`
|
|
|
|
## Completion Checklist
|
|
|
|
- [ ] Language section added with title `_("Language")`.
|
|
- [ ] Section appears to the right of Skip in the preferences top row.
|
|
- [ ] Toggles use `Language(None)` and `Language("spanish")`.
|
|
- [ ] Mutual exclusivity confirmed in UI selected state.
|
|
- [ ] Option B labels confirmed (`English/Inglés`, `Spanish/Español` by active language).
|
|
- [ ] `lint` and `compile` completed successfully.
|
|
- [ ] Manual run smoke check completed.
|