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:

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:

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.

4.6 KiB Raw Blame History