Pocket Putt Islands
README.md
screens
Every screen and sound of Pocket Putt Islands, started by the main scene's entrypoint: Screens.start() in play (after Round.start()), Screens.stop() on unload.
start() spawns one local, temporary entity carrying pocketPutt.ui.ScreensHost, which owns the screens (so their buttons' callbacks have an owner) and listens to pocketPutt.round's Rules.EVENTS. host() answers that entity.
What the player gets:
- Title (menusKit, custom look
pocketPutt): bubbly yellow/coral POCKET PUTT ISLANDS logo with a golf-ball dot over the live archipelago, big lime PLAY and turquoise FRIENDS pills, a turquoise settings gear in the corner (menusKit settings: music/effects volume, language, controls). - HUD: HOLE n · PAR n pill, STROKES n pill, other players' progress, a big coral pause button and a turquoise scorecard button; "waiting for friends" while others finish.
- Pause (menusKit): Resume, Scorecard, Restart, Settings, Main Menu. Escape / P / pad Start also pause.
- Hole result toast: HOLE n banner on each tee; BIRDIE!/PAR/BOGEY... with 1-3 stars when you hole out; SPLASH! +1 on water; short notices for friends.
- Hole in one: rotating sun rays, big yellow HOLE IN ONE!, three popping gold stars, trophyKit confetti burst at the cup, juiceKit heavy shake and a fanfare.
- Scorecard: every player's strokes on every hole (puttCourse
tropicalWoodscorecard style), from the HUD, the pause menu or the results. - Results: holes 1-6 par / strokes / to-par chips (green under, yellow level, coral over), total, round stars (
Rules.roundStars), saved best round with a NEW BEST! badge, every player ranked with gold/silver/bronze medals, PLAY AGAIN (Round.restart). - Sound:
pocketPutt.audio.sound(soundstage cartoon music: menu on the title, explore while putting, action on the results; putt, cup, splash, fanfare, rail/bumper knocks, UI clicks).
Touch, mouse and gamepad: every button is a big pill; overlays hold the pointer so a pad's d-pad/stick moves focus and south presses. Layouts adapt to portrait and landscape and stay inside ui.safeArea().