From Simulation to Learning Experience: Evolving Budget Blueprint SG
A reflection on what good educational game design really takes
What Is Budget Blueprint SG?
Budget Blueprint SG is an in-browser simulation game created by participants of Singapore's SLS Cookout Workshop, using Claude AI. Players step into the role of Singapore's Finance Minister, managing a national budget across four fiscal years. Each year, they deploy limited ministry teams to government sectors to earn funds and manpower, then invest those resources into national priority projects — healthcare, defence, education, sustainability — to accumulate National Well-being Points (NWP).
The concept is elegant: mirror the real-world tension of public budgeting in a fast, accessible game. But a great concept and a great learning tool are not the same thing. The original build was a working prototype. What followed was a deliberate evolution towards something pedagogically sound and genuinely usable.
What the Original Build Looked Like
The first version had the bones of a solid game:
- A resource dashboard showing Fiscal Year, Funds, Manpower, and NWP
- Six ministry sector cards players could click to earn resources
- Three national priority cards to fund for NWP
- A global event modal at the start of each round
- A game-over screen with a basic decision summary
It worked. But it made several assumptions about players that were not justified — that they already understood what ministry teams were, that they knew what to do first, that they would remember the active global event while making decisions, and that they would draw their own conclusions about what they had learned.
For a general audience, and especially for students in a classroom, these were costly gaps.
The Enhancement Journey
The improvements were made in three focused passes, each building on the last.
Pass 1 — Establishing Context Before Play Begins
The problem: Players landed directly in the game with no orientation. The resource dashboard meant nothing without a frame.
What we added: A full onboarding modal that appears before the game starts. It introduces the player's role ("You are Singapore's Finance Minister"), explains the four-step game loop with numbered visual steps, and defines four key vocabulary terms — Fiscal Year, Funds, Manpower, and NWP — in a highlighted glossary box. A persistent "?" button lets players reopen this at any point mid-game.
Why it matters pedagogically: Cognitive load theory tells us that learning is impaired when students must simultaneously decode a new system and absorb new content. The intro modal offloads the "how do I play" question entirely before the learning experience — Singapore's budget structure — begins. Students arrive at the game board already primed.
Pass 2 — Making the Game Readable While Playing
The problem: Once inside the game, several things were invisible or ambiguous. The global event appeared once as a pop-up and was never seen again. Priority cards all looked the same regardless of policy area. The three ministry team icons were identical and their purpose unclear. When a player couldn't afford a priority, the button simply greyed out with no explanation.
 |
| old |
 |
| now |
What we added:
Persistent event banner. The global event — the year's external shock — is now displayed as an amber warning strip for the entire fiscal year, not just at the start. Players can see "Economic Slowdown: MTI generates 3M instead of 5M this year" while they are actively making sector deployment decisions.
 |
Category colour-coding. Each priority card now has a coloured left border and category badge: red for Health, blue for Economy, orange for Social, dark for Defence, green for Sustainability, purple for Education. At a glance, students can see which policy areas they are funding and which they are ignoring.
 |
All 6 sector cards now have consistent colour-coding:
- 🔴 HEALTH — Ministry of Health (MOH)
- ⚫ DEFENCE — Ministry of Defence (MINDEF)
- 🔵 ECONOMY — Ministry of Trade & Industry (MTI)
- 🟠 SOCIAL — Ministry of Social & Family Dev (MSF)
- 🟢 SUSTAINABILITY — Ministry of Sustainability (MSE)
- 🟣 EDUCATION — Ministry of Education (MOE)
The colour language is now consistent across both sector cards and priority cards — students immediately see which policy area each card belongs to.
Clearer team mechanics. The worker pool label was rewritten from "Ministry Teams:" to "Your Teams to Deploy:", with a live counter ("3 of 3 free → 2 of 3 free → all deployed ✓") and a persistent hint: "Each 🏛️ is a generic team — click any sector card below to send it there and earn that sector's resources." This resolves the single most common confusion: students wondering whether each icon represented a specific ministry.
Affordability hints. Disabled Fund buttons now carry a tooltip explaining exactly why the project is unaffordable: "Cannot afford — need \(3M more funds and 1 more manpower." Instead of a dead end, the player gets actionable information.
Rich educational tooltips. Every sector card's hover tooltip was rewritten to include real-world Singapore context. MOH now reads: "Manages Singapore's universal healthcare system — polyclinics, hospitals, MediShield Life. Deploy here to gain \)3M." MTI reads: "Drives Singapore's economic growth through trade agreements, enterprise support and foreign investment. Your biggest revenue source." The game becomes a vocabulary lesson without feeling like one.
Deploy flash animation. When a team is deployed to a sector, the card briefly flashes green. This micro-feedback confirms the action and makes the game feel responsive.
Why it matters pedagogically: Worked examples research and dual-coding theory both support the value of presenting information in multiple modalities simultaneously. The colour-coded badges give students a second channel (visual/spatial) alongside the text. The persistent event banner keeps working memory from having to hold a key constraint unaided. The tooltips turn each interaction into a micro-lesson about Singapore's actual governance structure — something impossible in a worksheet.
Why it matters for UI: Feedback, visibility of system state, and error prevention are three of Nielsen's ten usability heuristics. All three were significantly weak in the original. Each enhancement above addresses at least one of them directly.
Pass 3 — Progressive Guidance and Reflective Closure
The problem: Even with all the above, there was nothing telling a first-time player what to do right now. And at the end of the game, there was a score and a statistics table — but no closing of the learning loop.
What we added:
Progressive hint system. Three layers of animated guidance activate contextually:
- Sector cards pulse with a blue glow whenever a team is still available to deploy — the cards literally shimmer to say "click me"
- Fund Project buttons turn green and shimmer whenever a priority is affordable — the visual language shifts from blue (deploy) to green (fund)
- The End Fiscal Year button pulses and scales once all teams are deployed — drawing the eye to the final action of the round
A dynamic Next Step banner ties these together with plain language: "Step 1 — Deploy 3 more teams: click any glowing sector card below ↓" transitions to "✓ All teams deployed! Step 2 — Fund a glowing priority below, then End Fiscal Year ↓" then to "✓ All teams deployed! Click End Fiscal Year to advance →".
Policy Area Coverage grid. The end-game screen now shows a 6-cell grid with ✅ or ❌ for each policy area (Health, Economy, Social, Defence, Sustainability, Education), with a summary: "You funded projects in 4 of 6 policy areas." This makes the trade-off pattern of the player's entire game visible at a glance.
Dynamic reflection prompts. Three questions are generated from the player's actual decisions:
- "You deployed most frequently to Ministry of Trade & Industry. What government needs drove that decision? Were there areas that received less attention as a result?"
- "You did not fund any Health or Social projects. How might Singaporeans who rely on those services have been affected?"
- "You finished with \(12M unspent. In real government budgeting, unused funds often return to reserves. Should you have invested more? What held you back?"
"What You Practised Today" learning points. A closing box names the four transferable concepts the game embeds: budget trade-offs, adaptive planning under uncertainty, short-term vs long-term investment thinking, and Singapore's real ministerial structure.
Why it matters pedagogically: This is the most significant enhancement of all. Kolb's experiential learning cycle requires four stages: concrete experience, reflective observation, abstract conceptualisation, and active experimentation. The original game covered stage one only. The reflection prompts and coverage grid activate stages two and three. The "What You Practised Today" section provides the conceptual anchor. Students who replay the game (stage four) now have a framework to experiment with intentionally.
Research on simulation-based learning consistently shows that without structured debriefing, simulations improve engagement but not necessarily understanding. The debrief does not need to be long — it needs to be focused and rooted in the learner's own experience. These prompts are generated from actual play data, which means they are always personally relevant.
Why it matters for UI: Progressive disclosure — revealing complexity only as it becomes relevant — is a well-established principle in interaction design. The hint system implements this directly: a brand-new player sees "click the glowing card" and follows it successfully without reading anything. A returning player ignores the hints entirely and plays at full speed. The game works for both without compromise.
What This Evolution Demonstrates
The gap between a working simulation and an effective learning tool is not primarily about content — it is about communication. Budget Blueprint SG always had good content: real Singapore ministries, realistic trade-offs, dynamic events, meaningful choices. What it lacked was scaffolding.
Scaffolding in educational design means providing temporary support structures that help learners access content they could not reach independently, then gradually removing those supports as competence develops. The progressive hint system does exactly that. The intro modal, event banner, category colours, and tooltips are all scaffolds. The reflection prompts are the transfer mechanism that helps students carry what they experienced in the game out into real understanding of how Singapore governs itself.
The result is a tool that works not just as a game, but as a lesson — one that can stand alone in a self-directed learning environment or serve as a rich discussion anchor in a classroom. That is the difference between a prototype and a pedagogical resource.
Budget Blueprint SG was created by participants of the SLS Cookout Workshop, using Claude 4, further edited by lookang. For more resources: sg.iwant2study.org
Why \)10 Million Isn’t Enough: Lessons in Survival from the Singapore Budget Simulator
Budget Blueprint SG
Budget Blueprint SG is an immersive simulation game that places students in the role of Singapore’s national budget planners. Through strategic decision-making and resource management, students experience the complexities of government budgeting, national priorities, and policy trade-offs involved in running a country.
🎯 Learning Experience
Students make budgeting decisions across multiple fiscal cycles while balancing limited resources, competing ministry needs, and unexpected national events. Every choice carries opportunity costs, encouraging deep thinking about governance and public policy.
🧩 Key Features
Fiscal Year System
-
Manage the national budget across 4 fiscal years
-
Review outcomes and adjust strategies each cycle
Resource Management
Track and balance three critical national resources:
-
Funds (starting budget: \)10M)
-
Manpower
-
National Wellbeing Points (NWP)
Ministry Teams
Engage with six Singapore ministries, each representing different national priorities:
-
Ministry of Health (MOH)
-
Ministry of Defence (MINDEF)
-
Ministry of Trade & Industry (MTI)
-
Ministry of Social & Family Development (MSF)
-
Ministry of Sustainability & Environment (MSE)
-
Ministry of Education (MOE)
National Priority Projects
Decide which projects to fund, knowing that resources are limited:
-
Build New Polyclinic (Health)
Cost: \(6M | Reward: +10 NWP -
Invest in Green Energy (Sustainability)
Cost: \)7M | Reward: +9 NWP -
Upgrade School Facilities (Education)
Cost: $3M + 1 Manpower | Reward: +6 NWP
Dynamic Events
Respond to unexpected scenarios (e.g. “Regional Tensions!”) that disrupt plans and force rapid policy trade-offs.
Strategic Trade-offs
Students learn that:
-
Funding one initiative may delay another
-
Short-term gains can affect long-term outcomes
-
Governance involves balancing diverse stakeholder needs
🎓 Educational Value
This simulation supports learning in Social Studies, Economics, and Civics by helping students understand:
-
Government budget allocation processes
-
Competing national priorities
-
Resource scarcity and opportunity costs
-
Stakeholder and ministry decision-making
-
Long-term strategic planning
-
Singapore’s governance structure
Students develop critical thinking, policy reasoning skills, and a deeper appreciation of the complexity behind national decision-making.
▶️ Try It
-
Play online:
https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.html -
Download (ZIP):
https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.zip
🛠️ Credits
Created by participants of the SLS Cookout Workshop, using Claude 4.
For more AI-generated educational simulations, visit:
https://sg.iwant2study.org/ospsg/index.php/ai-prompt-library/1366-prompt-library-for-educational-simulations