sneedBot - Asynchronous Terminal Idle RPG Companion

>_ TERMINAL INTERFACE

Differential double-buffered screen rendering for smooth, flicker-free companion gameplay.

sneedBot — terminal session [slot 1: sneeder]

80x24 ANSI

                         _______       _   
                        | | ___ \     | |  
 ___ _ __   ___  ___  __| | |_/ / ___ | |_ 
/ __| '_ \ / _ \/ _ \/ _  | ___ \/ _ \| __|
\__ \ | | |  __/  __/ (_| | |_/ / (_) | |_ 
|___/_| |_|\___|\___|\__,_\____/ \___/ \__|

Slot 1: sneeder Level: 12 | Zone: Dark Forest

HP: 265/265 ATK: 37 ACC: 77.8% SPD: 4.45s CRIT: 6.0% (+26%)

⛏️ Iron: 1,840 🪙 Silver: 215 👑 Gold: 4 🎟️ Tickets: 3 Auto-Healer: 54s (1.6%)

-- [COMBAT LOG STREAM] -- Goroutine Active

[23:42:01] Entering Dark Forest... (Level 3+ Zone)

[23:42:02] Encountered Shadow Bat (HP: 65/65 | Hit: 12 | Spd: 3.50s | Drain: 25%)

[23:42:03] You struck Shadow Bat for 37 DMG! Siphoned +2 HP. (Enemy: 28/65)

[23:42:04] Shadow Bat bit you for 10 DMG! Siphoned +2 HP. (You: 257/265)

[23:42:07] ⚡ CRIT! You struck Shadow Bat for 46 DMG! Siphoned +2 HP!

[23:42:07] [VICTORY] Defeated Shadow Bat! +35 XP, +28 Iron, +6 Silver

[23:42:07] Bestiary Updated: Shadow Bat recorded (Defeated: 14)

L Live Logs U Upgrades (1-8) Z World Zones S Bestiary & Stats Q Save & Quit

Raw-mode single-keystroke input

>_ GAME SYSTEMS & ARCHITECTURE

Engineered for reliability, zero runtime dependencies, and deeply rewarding incremental progression.

⚔️

Async Combat Engine

Combat runs entirely on isolated background goroutines using buffered event channels. Browse menus, upgrade stats, or leave it in a split terminal without interrupting the encounter cycle.

• Deliberate 5.00s baseline pacing
• Dynamic lifesteal for player & monsters
• Critical strikes with ⚡ CRIT! scaling
• Auto-Healer passive regen & resurrection

🗺️

Level-Gated Zones

Travel across 4 distinct biomes, each featuring level requirements and dynamic monster pools. Enemies spawn according to distinct weight algorithms with rare, high-value adversaries.

• Whispering Grasslands (Lvl 1+)
• Dark Forest (Lvl 3+)
• Sunken Dungeon (Lvl 5+)
• Gladiator Arena (Lvl 10+)

📜

Bestiary & Statistics

Track undiscovered enemies with the completionist ??? fog-of-war system. Inspect career dossiers, defeat counters, full monster profiles, and lifetime currency audit balances.

• Monster completion rate tracking
• Total XP, playtime & fall count dossier
• Terminal-height-aware pagination
• Complete Iron, Silver, Gold flow audit

💰

4-Tier Economy & Upgrades

Accumulate 4 currencies (Iron, Silver, Gold, Tickets) to permanently boost 8 character attributes up to Level 99 across a 5-tier Companion Cost Curve.

• 8 Upgrade attributes capped at Lvl 99
• Health, Hit, Speed, Crit, Drain, Healer
• Tier 1-5 companion cost scaling
• Prestige Tickets awarded on character level-ups

🖥️

Differential TUI Engine

Custom differential screen renderer compares frame buffers and redraws only modified lines via ANSI escape sequences (\033[H, \033[K), completely eliminating screen flicker.

• Zero terminal redraw flicker
• Responsive badge wrapping for narrow panes
• Instant raw-mode single-keystroke inputs
• Handcrafted Pastel & Neon palettes

🔒

HMAC Security & Persistence

Multi-slot character manager with zero-corruption atomic write guarantees. Character files are digitally signed and verified with salted HMAC-SHA256 checksums to protect against tampering.

• 3 independent save slots
• Atomic .tmp → .bak → .json pipeline
• Salted HMAC-SHA256 signature verification
• Automatic background autosave every 5s

>_ WORLD ZONES & REGIONS

Dynamic monster spawning, progressive level gating, and rewarding exploration.

LEVEL 1+

Whispering Grasslands

Peaceful sunlit plains teeming with Field Rats, Scout Goblins, and wild beasts. Baseline farming for Iron and early experience.

LEVEL 3+

Dark Forest

Overgrown ancient woodlands sheltered by thick shadowy canopies. Introduces Shadow Bats and Sprout Treants with innate lifesteal.

LEVEL 5+

Sunken Dungeon

Subterranean stone crypts echoing with caustic slimes, cave bats, and ancient stone golems. Heavy Silver rewards and tougher encounters.

LEVEL 10+

Gladiator Arena

Brutal proving grounds where seasoned warriors duel to the death. Elite arena champions dropping coveted Gold and prestige resources.

> Asynchronous Terminal Idle & Incremental RPG Companion