daily auto-sync 2026-07-21

resources/paper-apps/README.md

@@ -0,0 +1,181 @@
+---
+Date: 2026-07-21
+Author: Adolfo Reyna
+Tags: [games, paper-apps, foundation, tactility]
+---
+
+# Paper Apps - Game Foundation
+
+Purchased games from Gladden Design - to be used as foundation for device games.
+
+## Files
+- `Paper-Apps-GOLF-ZERO.pdf` - Original GOLF notebook (3 courses x 18 holes)
+- `Paper_Apps_GALAXY_ZERO.pdf` - Original GALAXY notebook (~50 sectors + encounters)
+- `GOLF-rules.txt` / `GALAXY-rules.txt` - Extracted rules text
+- This README - distilled mechanics for porting
+
+## GOLF (Paper Apps GOLF)
+
+### Core Loop
+- 3 courses per notebook, each 18 holes, each hole randomly generated, unique per notebook
+- Goal: ball to hole in fewest hits. Par 6 per hole.
+
+### Movement
+- 8-directional movement (orthogonal + diagonal)
+- Draw line + circle for new position
+
+### Dice GOLF Mode
+- Roll d6 = distance
+- Fairway: +1 to roll
+- Sand: -1 to roll
+- Can always choose to putt (move 1) instead
+- Tee: one free re-roll; 6 Mulligans per course for re-rolls
+- Optional challenge: pick direction BEFORE roll
+
+### Speed GOLF Mode (no dice)
+- DRIVER: move 6, fairway only, can go over trees
+- IRON: move 3 (2 from sand), can't go over trees
+- PUTTER: move 1, always allowed
+- Overshoot rule: crossing hole allows overshoot by 1 and counts as in; otherwise over.
+
+### Terrain
+- **Rough**: majority, normal movement
+- **Fairway**: bonus (+1 dice, allows 6-move), only place can hit over trees, includes green
+- **Sand trap**: penalty (-1 dice, 2 max in Speed)
+- **Water**: cannot land, can travel over
+- **Trees**: cannot land, cannot travel over except from fairway
+- **Slopes (arrows)**: auto-roll 1 space in direction; chain if next is arrow; ignore if points to water; if 2 arrows point at each other, stop after first
+
+### Multiplayer
+- Different colors, Dice mode best
+- Turn order by distance (furthest first) after tee-off
+
+### Device Adaptation Ideas
+- Grid-based golf puzzle: procedurally generate holes (terrain tiles)
+- 8-way input, dice roll animation or Speed mode for kids
+- Render fairway/rough/sand/water/trees as sprites
+- Slope arrows auto-move
+- Score tracking per hole / course
+- Perfect for: Tactility devices (M5 stack, T-Deck), e-ink, kidsOS
+
+---
+
+## GALAXY (Paper Apps GALAXY)
+
+### Core Loop / Meta
+- Pilot ID card: draw profile + choose race (Robot/Human/Alien) - preferential treatment from same race
+- System map: ~50 numbered sectors, arrow = start, cross off as completed
+- Can travel to any sector connected to completed sector
+- Collect 6 Warp Drive Pieces: must complete ALL sectors connected to a piece to collect it
+- Most sectors played just to collect pieces; completionist = visit every sector
+- Credits earned on win, spent immediately on upgrades or prestige ranks
+- On loss: keep only credits picked up on map, spend immediately
+
+### Sector Layout
+- Top: sector map (ship starts bottom row)
+- Middle: Flight Computer = movement values (numbers + ? = roll d6)
+- Bottom left: missile + shield counters
+- Bottom right: mission, reward, W/L mark, sector number
+
+### Sector Objects
+- **Ship**: start bottom row
+- **Asteroid**: shoot to clear, or fly through losing 1 shield
+- **Wormhole**: always 2 per sector, teleport to other, keep direction + remaining spaces
+- **Mine**: explodes if within 1 space (lose shield). Can shoot to detonate - destroys anything within 1 (enemy/asteroid/mine). Chain!
+- **Credit pickup**: note it, spend after sector
+- **Shield pickup**: outline new circle in shield counter (not carried over)
+- **Missile pickup**: outline new circle in missile counter (not carried over)
+- Items single-use except wormholes
+
+### Movement
+- 6 directions (hex-like)
+- Values in Flight Computer - cross off as used
+- Can skip a value (cross off) but NOT ? values
+- ? = must roll d6 for distance
+- Straight line only per move, can cross own path
+- If no possible moves: skip to next value; if rolled value has no possible directions, cross out and move on
+- If run out of moves without objective -> Lose (fuel)
+
+### Combat - Attacking
+- Between movements (not during) can fire missiles
+- Fire in same 6 directions as movement - must be aligned
+- Cross out missile from counter (used even if miss)
+- Count spaces to enemy, must roll that value or higher on d6 to hit (1 away = auto-hit)
+- Destroyed enemies can be flown over, no longer fire
+
+### Combat - Being Attacked
+- Enemies fire when you cross through their range (line of sight)
+- Roll distance or higher for hit against you
+- Lose shield if hit; no shields left = Lose
+- Enemies can see/fire through asteroids
+
+### Mission / Win Conditions
+- Either "Blast X enemies" or "Grab artifact" / "Grab parts" etc.
+- Win = objective without running out shields/fuel -> mark W, earn CREDITS
+- Lose = mark L, tally lost ship in stats
+
+### Upgrades (spend credits in order)
+- Double Shot: 2 rolls to hit (not vs enemy fire)
+- Battering Ram: ignore asteroids
+- Nav-Control: choose movement instead of rolling ?
+- Extra Starting Shields: 1/2/3 additional (must earn in order)
+- Extra Starting Missiles: same, in order
+- Missile Range: +1 or +2 to hit roll
+- Prestige Ranks: spend credits for rank (Cadet -> higher) - fun/challenge
+
+### Special Sectors
+
+**Space Monsters mini-game**: 
+- 8 rolls d6, choose row OR column of that number containing monster, cross out 1 monster, 1 credit per hit
+
+**Alien Encounters**:
+- Narrative encounters with race types (Robot/Human/Alien)
+- Bonuses: credits (roll dice, +1 if same race), extra missiles next sector (+2, +3 if same race), random bonus table (d6: -1 shield, -1 shield, +1 missile, +1 credit, -1 missile, -1 shield - pick best of 2 if same race as Alien)
+
+### Device Adaptation Ideas
+- Hex grid movement (6-directional)
+- Procedural sector generation: asteroids, enemies, wormholes, mines, pickups
+- Flight computer as queue of moves with skippable values
+- Missile combat with dice-roll hit check (distance mechanic)
+- Shield/missile counter UI
+- Galaxy map as node graph - unlock connected sectors
+- 6 warp pieces as meta-progression
+- Encounters as pop-up events with race bonuses
+- Space Monsters as bonus mini-game
+- Upgrade shop between sectors
+- Save: W/L per sector, credits, upgrades, warp pieces, lost ships tally
+
+### Seed / Generation
+- SYSTEM MAP - GALAXY #000000 - suggests seeded generation (000000 is seed)
+- Each notebook unique random generation like GOLF's 3 courses unique
+- Flight computer values appear random with ? mixed in
+
+---
+
+## Common Paper Apps DNA
+- Pencil + d6 (or Speed/variant without)
+- Draw lines + circles to track
+- Cross-off counters (shields, missiles, Mulligans, Flight Computer values)
+- Single notebook = complete campaign (3 courses / ~50 sector galaxy)
+- Randomly generated per notebook -> replayability via new notebook
+- Both have special rule variations and multiplayer/social hooks
+- Contact: hey.gladden@gmail.com - Gladden Design - www.gladdendesign.com
+
+## Adaptation Strategy for Devices
+
+### Tactility / ESP32
+- Grid engine: generic tile system (GOLF: 8-way square, GALAXY: 6-way hex)
+- Dice as RNG + animation
+- Procedural generation using seed (like notebook number)
+- Save system: sector/hole progress, counters, upgrades
+- Render: low-res tile sprites work on M5Stack / T-Deck / RLCD
+
+### KidsOS / Grace and Elias
+- GOLF simplified: Speed mode (6/3/1) no dice math, colorful tiles
+- GALAXY simplified: fewer enemies, auto-hit at close range, visual dice
+- Race selection fun (Robot/Human/Alien or royal twist)
+- Prestige/ranks appealing for Grace
+
+### Reuse
+- Both games provide proven fun loops with minimal rules
+- Good candidates to merge: exploration map (GALAXY) + precision movement puzzles (GOLF terrain ideas)