Preferences Language Toggles Design

Goal

Add a new Language section to the preferences screen with two mutually exclusive toggles:

Default language (None translation), labeled English in default language and Inglés when Spanish is active.
Spanish language ("spanish" translation), labeled Spanish in default language and Español when Spanish is active.

Selecting either toggle must immediately set the active game language.

Scope

Modify only preferences UI and related translatable strings.
Preserve existing layout and visual language used by Display and Skip sections.
Keep behavior compatible with Ren'Py language switching conventions.
Work in the current active local translation branch (no git worktrees), to keep local playtesting straightforward.

Current Context

game/screens.rpy currently defines two top-row preference blocks in screen preferences(): Display and Skip.
This row uses hbox with box_wrap True and section vbox blocks.
Spanish translations for screen strings live in game/tl/spanish/screens.rpy.

Proposed UI/Behavior

Placement

Add a third vbox in the first preferences hbox, immediately after the Skip block, so Language appears to the right of Skip in desktop/web layout.

Styling

Use style_prefix "radio" on the Language vbox.
Use label _("Language") for the section title so it matches existing section title styling and translation behavior.

Controls

Add two radio-style textbuttons:

textbutton _("English") action Language(None)
textbutton _("Spanish") action Language("spanish")

These actions switch active language immediately and preserve mutual exclusivity through the radio preference button styling/selection behavior.

Translation Labels (Option B)

Add/ensure Spanish translations in game/tl/spanish/screens.rpy:

Language -> Idioma
English -> Inglés
Spanish -> Español

Because button text is wrapped in _(), labels automatically localize based on active language.

Error Handling and Edge Cases

If Spanish translations are unavailable at runtime, Language("spanish") still sets the language code; labels fall back based on available string catalog.
Language(None) safely returns to default strings.

Validation Plan

Run lint:
- "renpy.sh" "/home/$USER/Documentos/Renpy Projects/Soul Droid Chat" lint
Run compile:
- "renpy.sh" "/home/$USER/Documentos/Renpy Projects/Soul Droid Chat" compile
Manual smoke check via run:
- "renpy.sh" "/home/$USER/Documentos/Renpy Projects/Soul Droid Chat" run

Manual checks during run:

Open Preferences and verify Language section appears to the right of Skip.
Confirm title style matches Display/Skip.
Toggle English -> UI strings reflect default language.
Toggle Spanish -> UI strings reflect Spanish.
Confirm labels show English/Spanish in default language and Inglés/Español in Spanish.
Confirm only one language toggle appears active at a time.

Out of Scope

Adding more languages.
Refactoring preferences screen structure beyond this section.
Any worktree setup or branch restructuring.

3.1 KiB Raw Blame History