UI language (no version): theme, frames, icons, body font, UI kit #59

Merged
ValleyGeek merged 12 commits from ui-language into main 2026-11-14 18:07:47 +00:00
Member

Adds the shared AnimRPG UI language on top of the v0.6.0 menus and battle (#57). Replaces #58 (same commit, renamed from 0.8.0/ui-language because this update carries no version). This PR is assets, theme, helpers and docs only; the game looks the same until the scene-script edits in docs/ui/ApplyChanges.md are applied.

What's in it

  • assets/ui/theme/animrpg_theme.tres + tokens.json: one project Theme (night-sky windows #1A2C52, sky rim #2F8CF0, sun-gold cursor #FFD45C; HP amber, MP blue, XP violet; stat up blue / down orange).
  • 15 nine-slice window frames (assets/ui/kit/), 41 stat/status icons (assets/ui/icons/).
  • Pixelify Sans (OFL 1.1) for body text; Press Start 2P stays for headers, numbers and commands.
  • scripts/ui/ui_kit.gd (UiKit: windows, rows, bars, formation) and scripts/ui/ui_motion.gd (the title-screen pulse as the one selection motion).
  • tools/ui/build_theme.gd rebuilds the theme from tokens.
  • docs/UILanguage.md (the spec), docs/ui/ApplyChanges.md (file-by-file edits), docs/ui/contact_sheet.png (17 mockups, all rendered by Godot from these files with example data).

Checks: godot4 --headless --import clean; tools/lint_gdscript.sh passes; tools/run_tests.sh 73/73. Contrast: 28 text pairs, 0 AA failures (lowest 4.59:1). Status never relies on red vs green alone.

Open choices for Brandon are listed in docs/UILanguage.md / the design README (body font, canvas_items scaling, pane sizes, enemy HP display, 12-enemy formation, and more).

No version step. Brandon set this as a non-versioned update: nothing in the game references these files until the edits in docs/ui/ApplyChanges.md are applied, so VERSION stays at 0.5.2 and the squash creates no release tag. The version step goes with the implementation PR. Merge stays with Brandon.

Adds the shared AnimRPG UI language on top of the v0.6.0 menus and battle (#57). Replaces #58 (same commit, renamed from `0.8.0/ui-language` because this update carries no version). This PR is assets, theme, helpers and docs only; the game looks the same until the scene-script edits in `docs/ui/ApplyChanges.md` are applied. **What's in it** - `assets/ui/theme/animrpg_theme.tres` + `tokens.json`: one project Theme (night-sky windows `#1A2C52`, sky rim `#2F8CF0`, sun-gold cursor `#FFD45C`; HP amber, MP blue, XP violet; stat up blue / down orange). - 15 nine-slice window frames (`assets/ui/kit/`), 41 stat/status icons (`assets/ui/icons/`). - Pixelify Sans (OFL 1.1) for body text; Press Start 2P stays for headers, numbers and commands. - `scripts/ui/ui_kit.gd` (`UiKit`: windows, rows, bars, formation) and `scripts/ui/ui_motion.gd` (the title-screen pulse as the one selection motion). - `tools/ui/build_theme.gd` rebuilds the theme from tokens. - `docs/UILanguage.md` (the spec), `docs/ui/ApplyChanges.md` (file-by-file edits), `docs/ui/contact_sheet.png` (17 mockups, all rendered by Godot from these files with example data). **Checks**: `godot4 --headless --import` clean; `tools/lint_gdscript.sh` passes; `tools/run_tests.sh` 73/73. Contrast: 28 text pairs, 0 AA failures (lowest 4.59:1). Status never relies on red vs green alone. **Open choices for Brandon** are listed in `docs/UILanguage.md` / the design README (body font, `canvas_items` scaling, pane sizes, enemy HP display, 12-enemy formation, and more). **No version step.** Brandon set this as a non-versioned update: nothing in the game references these files until the edits in `docs/ui/ApplyChanges.md` are applied, so `VERSION` stays at 0.5.2 and the squash creates no release tag. The version step goes with the implementation PR. Merge stays with Brandon.
Add the 0.8.0 UI language: theme, frames, icons, body font, and UI kit.
Some checks failed
CI / test (push) Has been cancelled
CI / lint (push) Has been cancelled
CI / release (push) Has been cancelled
CI / test (pull_request) Has been cancelled
CI / lint (pull_request) Has been cancelled
CI / release (pull_request) Has been cancelled
c8e0d16727
Adds the shared AnimRPG UI language on top of the v0.6.0 menus and battle layout:
a project Theme (assets/ui/theme/animrpg_theme.tres plus tokens.json), 15 nine-slice
window frames, 41 stat and status icons, Pixelify Sans (OFL) for body text, the UiKit
and UiMotion helpers in scripts/ui/, and tools/ui/build_theme.gd to rebuild the theme.

It replaces nothing yet. Each scene still sets its own dark box and font, so the visible
game is unchanged until the edits in docs/ui/ApplyChanges.md are made. docs/UILanguage.md
is the spec; docs/ui/contact_sheet.png shows the 17 Godot-rendered mockups. The aim is
one consistent, readable, deuteranopia-safe window and stat style across dialogs, NPC
menus, battle, and status screens, replacing the mixed per-screen styles.
Point ApplyChanges.md at the renamed ui-language branch.
All checks were successful
CI / test (push) Successful in 17s
CI / test (pull_request) Successful in 15s
CI / lint (push) Successful in 27s
CI / lint (pull_request) Successful in 25s
CI / release (pull_request) Has been skipped
CI / release (push) Successful in 1m12s
507064a216
Replaces the 0.8.0/ui-language branch name. Brandon set this as a non-versioned
update, so the branch carries no version prefix.
docs(ui): revise UILanguage and ApplyChanges to doc standard
All checks were successful
CI / test (push) Successful in 17s
CI / test (pull_request) Successful in 18s
CI / lint (push) Successful in 27s
CI / release (push) Successful in 4s
CI / lint (pull_request) Successful in 25s
CI / release (pull_request) Has been skipped
4ba3fb9e60
Language and structure only; every hex value, size, font name, path,
node name, and conflict/question reference (C1, C2, C1-C10, README Q2)
is kept.

UILanguage.md:
- Title and opening sentence per the standard; drops the v0.2 version
  qualifier and the bee6539 baseline line (ApplyChanges.md carries it).
- Removes superseded-design wording (0.6.0 "kept"/"re-laid out",
  "replaces the 1 px shadow", "unchanged values", "never the 0.6.0
  red/green set", "not green/red") and not-X-but-Y framing ("not by a
  slab of colour", "rendered vs composite", "no PIL composites").
- Removes rhetorical framing ("The title screen is the seed") and
  second person ("while you use it").
- Moves contrast results, spacing/sizes, service contents, and the
  type-variation list into tables; §9 patterns become ### headings.
- Points the change-list reference at ui/ApplyChanges.md in place of
  repo-drop/CHANGES.md; "[inferred, not mocked]" becomes "No mockup
  covers these patterns."

ApplyChanges.md:
- Line 3 described copying the repo-drop tree into the repo; the files
  are on ui-language now, so the intro states that and records the
  bee6539 test application as a table.
- Edits are numbered §2.1-§2.17 and written as imperative steps;
  "for now", "as today", "no longer needed", "should still pass", and
  the proof's Kit rename note are removed.
- language.md references now name UILanguage.md.

Non-versioned per Brandon: VERSION and CHANGELOG untouched.
Add the UI node trees, audit, contrast report, and open questions to docs/ui.
All checks were successful
CI / test (pull_request) Successful in 17s
CI / test (push) Successful in 25s
CI / lint (push) Successful in 28s
CI / release (push) Successful in 4s
CI / lint (pull_request) Successful in 26s
CI / release (pull_request) Has been skipped
f5d4a64992
UILanguage.md and ApplyChanges.md referenced these design-pack files, but they
lived outside the repo. The node trees let Joystick rebuild each mockup exactly;
audit.md defines C1-C10; OpenQuestions.md replaces the 'README Qn' references.
Add tools/ui/draw_assets.py, the generator for the UI frames and icons.
All checks were successful
CI / test (push) Successful in 20s
CI / test (pull_request) Successful in 20s
CI / lint (push) Successful in 27s
CI / release (push) Successful in 4s
CI / lint (pull_request) Successful in 25s
CI / release (pull_request) Has been skipped
b7714f3407
The 15 frame and 41 icon PNGs were committed without their source. This script
draws each one from a hand-typed pixel map or ring rule in the tokens palette and
scales it 3x, so an icon is edited as text and regenerated. Run against this
branch it reproduces every committed PNG byte for byte.
docs(ui): apply Desi's answers and style-pass audit, contrast, questions
All checks were successful
CI / test (pull_request) Successful in 16s
CI / test (push) Successful in 17s
CI / lint (push) Successful in 27s
CI / release (push) Successful in 4s
CI / lint (pull_request) Successful in 25s
CI / release (pull_request) Has been skipped
0f6b3a19e4
Applies Desi's rulings on the open points from 4ba3fb9 and brings the
docs/ui files added in f5d4a64 to the documentation standard. Design
facts (hex, sizes, fonts, paths, node names, C1-C10, question
numbering and order) are kept.

UILanguage.md:
- Selection rule stated positively: pulse + sun cursor on the
  row_focus frame (ink.500 fill, sky rim); no bright solid block alone.
- Fairy orbs: drawn by the existing title code (main_menu.gd FairyOrbs
  Node2D), not the theme; replaces "Fairy orbs are the game script".
- Formation back row: one rule, two cases (shorter row centres in the
  gaps; equal row shifts half a pitch); replaces the "(or ...)" aside.
- Deity box spelled out: anchor (0,1) bottom-left, offset (672,-264),
  size 1224x240 (node tree 12, DeityBox).
- Paths corrected to assets/ui/kit, assets/ui/icons,
  tools/ui/build_theme.gd, and tools/ui/draw_assets.py (added in
  b7714f3); node-trees and contrast-report link the docs/ui files;
  godot-proof, audit/trial-theme-only and motion_check.gd are named as
  the design pack (outside the repo).

ApplyChanges.md:
- (§3) now names UILanguage §1 principle 5; README Q2 now
  OpenQuestions.md question 2; PANE_W/PANE_H become the log size
  960x228 (was 960x276, per Desi, as an edit instruction).
- GameDesign §11.3 Battle row made conditional on question 4.
- mock_tag deletion stated as optional cleanup.
- draw_assets.py points at tools/ui/draw_assets.py; audit.md,
  contrast-report.md and node-trees link the docs/ui files.

audit.md: title and opening sentence, numbered sections; first and
second person removed ("I applied", "until you register", "as you
buy"); "Baseline moved" callout and "(history)" framing become a
method statement; superseded wording (now, still, no longer, no more,
as before, "the seed") removed from prose; repo-drop/CHANGES.md now
ApplyChanges.md; removed the read date and the box-local
/workspace/animrpg-main worktree path. The §2.5 status table keeps its
status wording as audit data.

contrast-report.md: opening sentence, numbered sections, checks.py
named as design pack; "current" and "no longer instantiated" reworded
to bee6539 / "no code on main instantiates Meter".

OpenQuestions.md: intro sentence; "we"/"you" phrasing becomes neutral
questions; "language §9.13" links UILanguage.md; §11.2/§11.3 named as
GameDesign. Meaning, numbering, and order unchanged.

node-trees/: untouched; headers do not break the standard.
Non-versioned per Brandon: VERSION and CHANGELOG untouched.
docs(ui): correct audit C5/C8, date the surface inventory, label node trees
All checks were successful
CI / test (push) Successful in 15s
CI / test (pull_request) Successful in 15s
CI / lint (push) Successful in 26s
CI / release (push) Successful in 4s
CI / lint (pull_request) Successful in 26s
CI / release (pull_request) Has been skipped
78125a8c90
Applies Desi's answers to the six open points from 0f6b3a1.

audit.md:
- C5: the pack's boss is "×3 (288 px) centred", matching UILanguage
  §9.11; replaces the ×4 figure.
- C8: the OnBackdrop outline is 6 px (two art pixels), matching
  UILanguage §3 and ApplyChanges §2.3; replaces 3 px (one art pixel).
- §5 heading is now "Surface inventory at a509aeb": the table lists the
  action and game menus that bee6539 removed.
- §2.5 status wording and the design-pack labels stay as they are.

node-trees/*.txt (17 files): line 1 only. Each header states that the
file is the node tree of a design-pack proof scene
(res://scenes/NN_*.tscn), generated by the pack's tools/render_all.gd,
and that the scene is not in the repo, so the res:// path is not read
as a repo scene. Tree lines are unchanged.

Non-versioned per Brandon: VERSION and CHANGELOG untouched.
Record Brandon's answers to the UI open questions in docs/ui/Decisions.md.
All checks were successful
CI / test (push) Successful in 17s
CI / test (pull_request) Successful in 17s
CI / lint (push) Successful in 27s
CI / release (push) Successful in 4s
CI / lint (pull_request) Successful in 25s
CI / release (pull_request) Has been skipped
932a9188e1
Settles the 11 open questions (fixed 1920x1080 viewport with linear UI scaling,
two fonts, party shown in a diagonal battle stage, boss-only HP bar, cap 12,
no shop quantity, reduced-motion toggle, all-member compact HUD, new log colours)
and lists the follow-ups: diagonal formation, HUD comparison, toast mockups.
Lay out the diagonal battle stage, the compact party HUD and toasts, and fold the UI decisions into the spec
All checks were successful
CI / test (push) Successful in 16s
CI / test (pull_request) Successful in 17s
CI / lint (push) Successful in 28s
CI / lint (pull_request) Successful in 26s
CI / release (pull_request) Has been skipped
CI / release (push) Successful in 1m12s
715eb135ae
What changed:
- UiKit.formation / party_feet now build a diagonal battle stage: the party in the
  lower left facing up-right, up to 3 ranks of 4 enemies across the upper right,
  sorted far to near for draw order, cap 12, all feet on the 3 px grid. The boss
  (x3, 288 px) stands at the front-rank centre with a numberless HP bar; regular
  enemies show no HP. Battle log lines each carry an icon.
- New field HUD (UiKit.hud_card, HUD_W 345): every party member, name column 177 px
  (10 characters, ellipsis beyond), a 9 px HP bar matching the name width with the
  number beside it, and a 6 px MP bar only for members with magic.
- One low-HP rule everywhere (UiKit.hp_icon / hp_variation): <= 25 % shows the warn
  icon and the new amber WarnNum style; HP 0 shows the ko icon and DimNum. Battle
  party cards show MP only for members with magic.
- Toasts (912 Nameplate at top-centre, 66 px stack pitch, top layer) and the
  672-wide small yes/no prompt.
- UILanguage.md and ui/ApplyChanges.md state every decision as spec: fixed
  1920x1080 viewport (aspect keep), two fonts, fixed pane sizes, world zoom and UI
  size settings, reduced motion, one-at-a-time shop purchases, log colours.
- New mockup node trees 18 (12 enemies), 20 (field HUD) and 21 (toasts), updated
  battle and status trees, contrast report (31 pairs, 0 failures), contact sheet.

What it replaced: the flat two-row enemy formation, the leader-only field HUD,
MP bars on every member, the pink danger colour on low-HP numbers, and the
ui/OpenQuestions.md and ui/Decisions.md question documents (deleted).

Why: Brandon's UI decisions of 2026-11-14, including his pick of the bar HUD
with MP for casters only and a name-width-sized window.
docs(design): align GameDesign §11.2 and §11.3 with the UI language
All checks were successful
CI / test (push) Successful in 17s
CI / test (pull_request) Successful in 18s
CI / lint (push) Successful in 27s
CI / release (push) Successful in 4s
CI / lint (pull_request) Successful in 26s
CI / release (pull_request) Has been skipped
ca2984a09d
Brandon wants GameDesign to agree with docs/UILanguage.md before PR #59
merges. Applies ApplyChanges §2.16 and Brandon's UI decisions; every
value comes from UILanguage.md.

§11.2:
- View: a fixed 1920x1080 frame, same view at every resolution up to
  4K, letterboxed, interface scaling linearly; settings are UI size
  (75-125%) and world zoom (zoom in only). Replaces "the interface
  scales", "a lower resolution zooms in", and the separate interface
  scale/zoom wording.
- Fonts: Press Start 2P for headers, numbers and commands; Pixelify
  Sans for body text. Backdrop text has a 6 px ink outline (two art
  pixels). Replaces "all interface text uses Press Start 2P" and the
  one-pixel drop shadow (C1, C8).
- Field HUD: every party member, thin HP bar and number, MP only for
  members with magic. Replaces the leader-only HUD.
- Panes are fixed sizes: dialogue 1440x264; shop, healer, inn, guild
  and discard 1440x792 with list (780) and description inside; status
  1728x936 with Q/E tabs and a 408 member column; pause 672x564; guard,
  teleports and dungeon entrance 672 wide. Replaces the 35%, 35%x56%,
  hanging-description and 24% panes (C2-C4).
- Battle: diagonal stage (party lower left, enemies upper right,
  farther figures higher and behind), cap 12, regular enemy HP hidden,
  boss bar with no numbers, party status MP only for members with
  magic, log 960x228 and command pane 960 wide. Replaces the bottom-left
  / mid-right placement and the "one size, half the view width" panes.

§11.3: adds the Battle row; Main character and Party member rows list
battle so the table agrees with it. OpenQuestions.md no longer exists
(715eb13 folded the decisions into the spec), so the row is applied
unconditionally per Desi.

Not changed: version lines, VERSION, CHANGELOG, and the commercial game
names in §1, §4.5 and §11.1 (left for Brandon's decision).
docs(design): settle GameDesign enemy cap, pause, log, and settings per Desi
All checks were successful
CI / test (pull_request) Successful in 18s
CI / test (push) Successful in 18s
CI / lint (push) Successful in 28s
CI / release (push) Successful in 4s
CI / lint (pull_request) Successful in 25s
CI / release (pull_request) Has been skipped
14db1121b5
Applies Desi's and Brandon's answers to the nine GameDesign questions
from ca2984a. Values follow docs/UILanguage.md.

- §6.2: 12 enemies is a hard cap; mid-battle joins never take a battle
  past 12 (Brandon's call). The prior text left joins unbounded.
- §11.2 view: settings list UI size, world zoom, and reduced motion
  (reduced motion stops the selection pulse and cursor bob).
- §11.2 pause: a 672x564 window of five CommandButtons with centered
  labels; replaces "the type is larger than a shop", which the spec's
  PS2P 24 buttons vs Pixelify 30 rows contradict.
- §11.2 battle panes: log 960x228 and command pane 960x324, both
  bottom-centred; the command pane covers the log while a command is
  open. Replaces "as tall as its rows" and the layer wording. The log
  keeps four lines.
- §11.2 log: every line carries an icon and its theme colour, and the
  log uses no red or green; replaces "each use their own color", which
  read as colour-only meaning.
- §12.1: saves store input, world zoom, UI size, reduced motion, and
  text speed; replaces "zoom, interface scale" to match §11.2.

Kept per Desi: commercial game names, the Burdened line, the discard
pane in the 1440x792 service window, Pay / Turn back, and the
ca2984a pane sizes. Non-versioned: VERSION and CHANGELOG untouched.
Add a static critical-HP state and settle the HUD, prompt, log and enemy-cap spec
All checks were successful
CI / test (push) Successful in 18s
CI / test (pull_request) Successful in 18s
CI / lint (push) Successful in 29s
CI / lint (pull_request) Successful in 25s
CI / release (pull_request) Has been skipped
CI / release (push) Successful in 1m8s
7d70c8b228
What changed:
- A third HP state on every screen (field HUD, battle party cards, healer, status
  rows): 0 < HP <= 10 % (UiKit.CRIT_HP) shows the new hp_crit icon (a cracked heart,
  8x8 text map in tools/ui/draw_assets.py) and the new CritHpNum style in crit_hp
  coral #FFA88E. It is static: no pulse, no blink. Low HP (<= 25 %, LOW_HP) keeps the
  warn icon, amber WarnNum and its badge_blink; KO keeps ko + DimNum.
- crit_hp passes 4.5:1 on the window body (7.37), slots (8.54) and the focused row
  (4.61), and separates from amber and cream under deuteranopia (dE 34 / 26) and
  protanopia (dE 42 / 26). contrast-report.md gains the pairs and a protan table.
- Example data: Mira critical (3/38), Bartholome low (9/44); mockups 03, 05,
  08-11, 14-16, 18 and 20 node trees and the contact sheet are re-rendered.
- UILanguage.md, ApplyChanges.md and tokens.json state: the HUD Burdened row after
  gold (only over the carry cap, warn icon + DangerText); the small prompt takes any
  two choice labels with focus on the safer one; the log is 960x228 with four lines
  at the 51 px pitch and the command pane 960x324 covers it while a command is open;
  12 enemies is a hard cap that mid-battle joins never exceed.

What it replaced: the two-step low-HP rule (low and KO only) and the
"960 wide, grows up" command pane wording.

Why: Brandon's request of 2026-11-14 for a vision-friendly reddish number at
critically low HP, percentage based, with no animation.
ValleyGeek deleted branch ui-language 2026-11-14 18:07:47 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
ai-collab/animrpg202610!59
No description provided.