pearl-instruction
Victor Slawski[SYSTEM INSTRUCTION: INTERACTIVE SIMULATOR GAME ENGINE] ## ROLE & ARCHITECTURE You are **Money Engine AI**, an ultra-engaging, bright, and interactive text-based Money Simulator game. - Your goal is to guide the player from a broke dreamer ($0) to a financial tycoon. - You operate using a dynamic turn-based game loop. - Your tone is high-energy, witty, encouraging, and colorful (use rich emojis and clear visual blocks). ## CORE MECHANICS & STATE MANAGEMENT Maintain the player's status in every turn. Track these primary metrics: - **Cash:** Current liquid money ($) - **Net Worth:** Total value of assets + cash ($) - **Passive Income:** Automatic money generated per turn ($/turn) - **Energy:** Refreshes to 100% every turn. Used for manual actions. - **Empire Rank:** Rookie → Hustler → Innovator → Mogul → Sovereign ## MONEY-MAKING CATEGORIES (UNIQUE & FUN) Instead of standard boring jobs, provide absurd, high-tech, and creative side hustles, such as: 1. **Quirky Digital Micro-Hustles:** Training pet AI chatbots, flipping virtual real estate in dead games, rating mystery voice clips. 2. **Wild Physical Side-Gigs:** Drone light show rental, renting out high-end robotic lawn mowers, selling artisanal bottled air/art. 3. **Absurd Ventures:** Moon-rock mineral rights speculation, meme-coin launching, bio-hacking consultancy. 4. **Passive Enterprises:** Automated AI-generated soundtrack licensing, automated vending machine empires, cloud storage reselling. ## GAMEPLAY TURN STRUCTURE For EVERY single turn, you MUST format your response as follows: 1. **PLAYER DASHBOARD (Visual Header Block)** - Display a formatted box with: Rank | Cash | Net Worth | Passive Income | Energy. 2. **TURN REVENUE RECAP** - Summarize passive income earned this turn, asset gains/losses, and major news. 3. **RANDOM DYNAMIC EVENT / WILD CARD (Occurs every 2 turns)** - Present a sudden event (e.g., "Market Bubble Burst," "Viral TikTok Trend," "Tech Boom") that offers a quick choice with high-risk/high-reward outcomes. 4. **ACTION MENU (4-5 Bright Options)** - Offer clear, numbered actions the player can take right now. - Option Types: [Hustle] (Uses Energy, gains quick Cash), [Invest/Buy Asset] (Increases Passive Income), [Upgrade Skills] (Unlocks higher tiers), [Wild Gamble/Risk] (Unpredictable). 5. **NEXT STEP PROMPT** - Ask the player what action they want to take (e.g., "Enter '1', '2', or tell me a custom action!"). ## RULES & BEHAVIOR CONSTRAINTS - NEVER complete multiple turns at once. Stop after presenting the turn options and wait for user input. - Allow full creative freedom: If the player types a custom action (e.g., "I want to pitch my idea to a shark tank investor"), calculate the success probability based on their current stats and resolve it dramatically. - Keep output highly visual using markdown tables, bullet points, and high-contrast formatting. - Make numbers pop! Use scaled multipliers (K, M, B) as the player progresses. ## INITIALIZATION Welcome the player, set up their starting zero-dollar dashboard, give them 3 wildly unique initial hustles to choose from to make their first $100, and ask for their Character Name to begin. make the code
Comments (0)
Sign in to leave a comment
System Requirements
pearl-instruction System Requirements Document (SRD)
Introduction
The "pearl-instruction" project is an interactive text-based Money Simulator game designed to guide players from being broke dreamers to financial tycoons. The game operates on a dynamic turn-based game loop, providing a high-energy, witty, and colorful experience.
System Overview
The system is designed to engage players through interactive gameplay, where they can make financial decisions, engage in unique money-making activities, and progress through various ranks by increasing their wealth and assets.
Functional Requirements as Story Points
- As a Player, I should be able to start the game with a zero-dollar dashboard and choose from three unique initial hustles to make my first $100.
- As a Player, I should be able to view my Player Dashboard displaying my Rank, Cash, Net Worth, Passive Income, and Energy.
- As a Player, I should be able to receive a Turn Revenue Recap summarizing my passive income, asset gains/losses, and major news.
- As a Player, I should encounter a Random Dynamic Event every two turns, offering high-risk/high-reward outcomes.
- As a Player, I should be able to choose from 4-5 bright action options each turn, including Hustle, Invest/Buy Asset, Upgrade Skills, and Wild Gamble/Risk.
- As a Player, I should be prompted to enter my next action choice after each turn.
- As a Player, I should be able to input custom actions and have the game calculate success probabilities based on my current stats.
User Personas
- Player: An individual seeking an engaging and interactive financial simulation experience. They are motivated by the challenge of progressing from a broke dreamer to a financial tycoon.
Core User Flows
- Game Initialization: Player starts the game -> Views zero-dollar dashboard -> Chooses from three initial hustles -> Enters Character Name.
- Turn Execution: Player views Player Dashboard -> Receives Turn Revenue Recap -> Encounters Random Dynamic Event (every two turns) -> Chooses action from Action Menu -> Proceeds to next turn.
- Custom Action Handling: Player inputs a custom action -> Game calculates success probability -> Resolves action outcome -> Updates Player Dashboard.
Visuals Colors and Theme
- primary: #FF5733 (a vibrant orange to reflect energy and excitement)
- primary_light: #FF8F66 (a lighter tint for hover states and secondary UI)
- secondary: #33C1FF (a bright blue for contrast and support)
- accent: #FFD700 (a gold color for CTAs and active states)
- highlight: #FF33A6 (a pink hue for notifications and active indicators)
- bg: #FFFFFF (a clean white background for clarity)
- surface: #F0F0F0 (a light grey for card/panel backgrounds)
- text: #333333 (a dark grey for primary text)
- text_muted: #777777 (a softer grey for secondary text)
- border: #DDDDDD (a subtle grey for borders)
Signature Design Concept
Interactive Money Simulator Dashboard: The homepage features a dynamic, interactive dashboard that visually represents the player's financial journey. As players make decisions, the dashboard updates in real-time with animated graphs and charts that reflect changes in cash flow, net worth, and energy levels. The dashboard is designed to be highly interactive, allowing players to click on different elements to view detailed breakdowns of their financial status. The use of emojis and colorful visual blocks enhances the playful and engaging atmosphere.
Landing Hero Motion Brief
The landing page features a continuously moving 2D composition built with accessible DOM, inline SVG, CSS, and motion/react. The animation tells the story of a broke dreamer gathering quirky digital micro-hustles, transforming into a financial tycoon with a thriving empire. The scene includes animated elements like flying dollar bills, growing bar charts, and playful emojis that loop every 10 seconds. The animation is interactive, allowing players to hover over elements for additional insights and animations. The first frame remains attractive and understandable when paused, with clear CTAs.
Interaction Model & Motion Direction
- Interaction Model: Animated
- The landing page includes moderate scroll-triggered reveals, hover transitions, and spring physics on interactive elements. This model is suitable for the feature-rich, engaging experience of the Money Simulator game.
Non-Functional Requirements
- The game must be responsive and accessible across various devices and screen sizes.
- The system should maintain high performance, ensuring smooth animations and interactions without lag.
- The game must be secure, protecting user data and preventing unauthorized access.
Tech Stack
- Frontend: React for Web
- Backend: Python, FastAPI
- Database: MySQL or MariaDB, using Alembic for migrations
- AI Models: GPT 5.4 for user-friendly responses
- Local Orchestration: Docker, docker-compose
Assumptions and Constraints
- The game assumes players have a basic understanding of financial concepts.
- The system is constrained by the need to provide a high-energy, engaging experience without overwhelming the player with complexity.
Glossary
- Player Dashboard: The interface displaying the player's current financial status and metrics.
- Turn Revenue Recap: A summary of the player's financial changes during a turn.
- Random Dynamic Event: An unexpected event that offers high-risk/high-reward choices.
- Action Menu: A list of actions the player can take during their turn.
- Empire Rank: The player's progression level in the game, from Rookie to Sovereign.
From Broke Dreamer to Financial Tycoon
Zero dollars. Infinite hustle. Play turn-based rounds of quirky micro-hustles, wild gambles, and passive-income empires — climb every Empire Rank from Rookie to Sovereign.
Built to Make Every Turn Feel Electric
Hover or tap any card to see the numbers come alive, that's the pearl-instruction engine at work.
Dynamic Turn-Based Gameplay
Every choice advances the clock. Plan your hustle, soak in the revenue recap, then brace for whatever the next turn throws at you.
Random Dynamic Events strike like clockwork
Rich Financial Progression
Climb the Empire Rank ladder as your Net Worth grows, from a scrappy Rookie all the way to an untouchable Sovereign.
Rookie → Hustler → Innovator → Mogul → Sovereign
Real-Time Dashboard Updates
Watch your Cash, Net Worth, Passive Income and Energy shift live on the dashboard as every decision lands.
Rank, Cash, Net Worth, Passive Income & Energy
Interactive Decision-Making
Hustle, invest, upgrade skills or gamble it all, or type your own custom move and let the odds decide your fate.
Hustle, Invest, Upgrade Skills, Wild Gamble & Custom Actions
Every Turn, Your Empire In One Glance
Five living metrics track your climb from broke dreamer to financial tycoon. Watch them build in real time as you scroll, then hover any metric to see how it shapes your strategy.
- Empire RankHustlerYour title climbs Rookie → Hustler → Innovator → Mogul → Sovereign as your empire grows, unlocking new hustles along the way.
- Cash$0Liquid money in hand right now — spend it on hustles, assets, and wild gambles.
- Net Worth$0The big-picture number: every asset you own, plus your cash on hand, combined.
- Passive Income$0/turnMoney that rolls in automatically each turn from the assets and enterprises you build.
- Energy0%Refreshes every turn — spend it to Hustle, Invest, Upgrade Skills, or take a Wild Gamble.
Every Turn Follows The Same High-Energy Loop
Five checkpoints, one repeating cycle. Scroll through the loop below, then hover (or tap) the Event Check node to see how the dice can fall.
Player Dashboard
Rank, Cash, Net Worth, Passive Income and Energy refresh at the top of every turn.
Revenue Recap
See exactly what moved while you were away — income, assets, and the headlines behind it.
- Passive Income:+$1,240
- Asset Gains/Losses:-$310
- Major News:Drone Light Show craze sweeps the nation
Event Check
Every 2 turns, fate rolls the dice on a Random Dynamic Event with high-risk, high-reward stakes.
Hover or tap for outcomesAction Menu
4-5 bright choices light up: Hustle, Invest/Buy Asset, Upgrade Skills, or Wild Gamble.
Back to Dashboard
Fresh stats lock in and roll straight into the next turn — the cycle spins again.
Five ways to move every single turn
Every turn refreshes your Energy to 100%. Spend it wisely across quick Hustles, long-term Investments, Skill Upgrades, Wild Gambles — or type a Custom Action and let the engine calculate your odds. Hover a card to see exactly how much Energy it drains.
Hustle
Grind out fast, quirky side-gigs for instant liquid Cash.
Invest / Buy Asset
Put Cash to work and grow your automatic income stream.
Upgrade Skills
Invest in yourself to unlock higher-tier hustles and odds.
Wild Gamble / Risk
Go all-in on a wild, high-risk high-reward swing.
Custom Action
Type any wild idea — the engine calculates your live odds.
From Broke Dreamer to Financial Tycoon
Every dollar you stack pushes you up the ladder. Watch your wealth bar fill as you climb from Rookie to Sovereign — hover any rank to see what it unlocks.
Rookie
Every tycoon starts broke. Scrape together cash with quirky micro-hustles and learn the ropes of the Empire.
Hustler
You are grinding turns and stacking side-gigs. Time to stop trading energy for cash and start buying assets.
Innovator
You spot trends before anyone else. Absurd ventures and clever bets start compounding into real wealth.
Mogul
A sprawling empire of passive enterprises now runs itself while you chase the next big score.
Sovereign
Broke dreamer to financial tycoon complete. You dictate the market instead of reacting to it.
Ready to go from broke dreamer to financial tycoon?
Fire up the Player Dashboard, pick your first hustle, and start stacking Cash, Net Worth and Passive Income turn by turn. Every wild card, every gamble, every rank-up is one click away.
Start GameNo sign-up friction. Choose a hustle, name your legend, and go.
From Broke Dreamer to Financial Tycoon
Zero dollars. Infinite hustle. Play turn-based rounds of quirky micro-hustles, wild gambles, and passive-income empires — climb every Empire Rank from Rookie to Sovereign.
Built to Make Every Turn Feel Electric
Hover or tap any card to see the numbers come alive, that's the pearl-instruction engine at work.
Dynamic Turn-Based Gameplay
Every choice advances the clock. Plan your hustle, soak in the revenue recap, then brace for whatever the next turn throws at you.
Random Dynamic Events strike like clockwork
Rich Financial Progression
Climb the Empire Rank ladder as your Net Worth grows, from a scrappy Rookie all the way to an untouchable Sovereign.
Rookie → Hustler → Innovator → Mogul → Sovereign
Real-Time Dashboard Updates
Watch your Cash, Net Worth, Passive Income and Energy shift live on the dashboard as every decision lands.
Rank, Cash, Net Worth, Passive Income & Energy
Interactive Decision-Making
Hustle, invest, upgrade skills or gamble it all, or type your own custom move and let the odds decide your fate.
Hustle, Invest, Upgrade Skills, Wild Gamble & Custom Actions
Every Turn, Your Empire In One Glance
Five living metrics track your climb from broke dreamer to financial tycoon. Watch them build in real time as you scroll, then hover any metric to see how it shapes your strategy.
- Empire RankHustlerYour title climbs Rookie → Hustler → Innovator → Mogul → Sovereign as your empire grows, unlocking new hustles along the way.
- Cash$0Liquid money in hand right now — spend it on hustles, assets, and wild gambles.
- Net Worth$0The big-picture number: every asset you own, plus your cash on hand, combined.
- Passive Income$0/turnMoney that rolls in automatically each turn from the assets and enterprises you build.
- Energy0%Refreshes every turn — spend it to Hustle, Invest, Upgrade Skills, or take a Wild Gamble.
Every Turn Follows The Same High-Energy Loop
Five checkpoints, one repeating cycle. Scroll through the loop below, then hover (or tap) the Event Check node to see how the dice can fall.
Player Dashboard
Rank, Cash, Net Worth, Passive Income and Energy refresh at the top of every turn.
Revenue Recap
See exactly what moved while you were away — income, assets, and the headlines behind it.
- Passive Income:+$1,240
- Asset Gains/Losses:-$310
- Major News:Drone Light Show craze sweeps the nation
Event Check
Every 2 turns, fate rolls the dice on a Random Dynamic Event with high-risk, high-reward stakes.
Hover or tap for outcomesAction Menu
4-5 bright choices light up: Hustle, Invest/Buy Asset, Upgrade Skills, or Wild Gamble.
Back to Dashboard
Fresh stats lock in and roll straight into the next turn — the cycle spins again.
Five ways to move every single turn
Every turn refreshes your Energy to 100%. Spend it wisely across quick Hustles, long-term Investments, Skill Upgrades, Wild Gambles — or type a Custom Action and let the engine calculate your odds. Hover a card to see exactly how much Energy it drains.
Hustle
Grind out fast, quirky side-gigs for instant liquid Cash.
Invest / Buy Asset
Put Cash to work and grow your automatic income stream.
Upgrade Skills
Invest in yourself to unlock higher-tier hustles and odds.
Wild Gamble / Risk
Go all-in on a wild, high-risk high-reward swing.
Custom Action
Type any wild idea — the engine calculates your live odds.
From Broke Dreamer to Financial Tycoon
Every dollar you stack pushes you up the ladder. Watch your wealth bar fill as you climb from Rookie to Sovereign — hover any rank to see what it unlocks.
Rookie
Every tycoon starts broke. Scrape together cash with quirky micro-hustles and learn the ropes of the Empire.
Hustler
You are grinding turns and stacking side-gigs. Time to stop trading energy for cash and start buying assets.
Innovator
You spot trends before anyone else. Absurd ventures and clever bets start compounding into real wealth.
Mogul
A sprawling empire of passive enterprises now runs itself while you chase the next big score.
Sovereign
Broke dreamer to financial tycoon complete. You dictate the market instead of reacting to it.
Ready to go from broke dreamer to financial tycoon?
Fire up the Player Dashboard, pick your first hustle, and start stacking Cash, Net Worth and Passive Income turn by turn. Every wild card, every gamble, every rank-up is one click away.
Start GameNo sign-up friction. Choose a hustle, name your legend, and go.
No comments yet. Be the first!