From Simulation to Learning Experience: Evolving Budget Blueprint SG
A reflection on what good educational game design really takes
https://youtu.be/-u0Qv1ag23c {source}<iframe width="560" height="315" src="https://www.youtube.com/embed/-u0Qv1ag23c?si=jn0z3M2aDzeQd18s" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>{/source}
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
{source}<h2 data-end="203" data-start="177"><strong data-end="203" data-start="180">Budget Blueprint SG</strong></h2>
<p data-end="533" data-start="205"><strong data-end="228" data-start="205">Budget Blueprint SG</strong> is an immersive simulation game that places students in the role of <strong data-end="337" data-start="297">Singapore’s national budget planners</strong>. 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.</p>
<table align="center" cellpadding="0" cellspacing="0" class="tr-caption-container" style="margin-left: auto; margin-right: auto;"><tbody><tr><td style="text-align: center;"><a href="https://blogger.googleusercontent.com/img/a/AVvXsEioGjwLnV5_Nq_eTsXYIxCpmGb3-PvQghAwj08FAMK1AJtVpnhIvKkmNG9sE5ONjSRN3rD4zHv3CmpILNuMM9BuqW8Tm_VSfEzF5h8prG23Ee0AaQ-z3s1nIg03Ae0j3ry_U2nqu92dR8tzj0dEuTFgf1o8SGWk4H5jRmPSlRB4rwlc2z4SpS7BQhwomUrU" style="margin-left: auto; margin-right: auto;"><img alt="" data-original-height="787" data-original-width="1309" height="384" src="https://blogger.googleusercontent.com/img/a/AVvXsEioGjwLnV5_Nq_eTsXYIxCpmGb3-PvQghAwj08FAMK1AJtVpnhIvKkmNG9sE5ONjSRN3rD4zHv3CmpILNuMM9BuqW8Tm_VSfEzF5h8prG23Ee0AaQ-z3s1nIg03Ae0j3ry_U2nqu92dR8tzj0dEuTFgf1o8SGWk4H5jRmPSlRB4rwlc2z4SpS7BQhwomUrU=w640-h384" width="640" /></a></td></tr><tr><td class="tr-caption" style="text-align: center;"><li data-end="2850" data-start="2728"><p data-end="2850" data-start="2730"><strong data-end="2746" data-start="2730">Play online:</strong><br data-end="2749" data-start="2746" />
<a class="decorated-link" data-end="2850" data-start="2751" href="https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.html" rel="noopener" target="_new">https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.html<span aria-hidden="true" class="ms-0.5 inline-block align-middle leading-none"><svg class="block h-[0.75emhttp://www.w3.org/2000/svg"><path d="M14.3349 13.3301V6.60645L5.47065 15.4707C5.21095 15.7304 4.78895 15.7304 4.52925 15.4707C4.26955 15.211 4.26955 14.789 4.52925 14.5293L13.3935 5.66504H6.66011C6.29284 5.66504 5.99507 5.36727 5.99507 5C5.99507 4.63273 6.29284 4.33496 6.66011 4.33496H14.9999L15.1337 4.34863C15.4369 4.41057 15.665 4.67857 15.665 5V13.3301C15.6649 13.6973 15.3672 13.9951 14.9999 13.9951C14.6327 13.9951 14.335 13.6973 14.3349 13.3301Z"></path></svg></span></a></p>
</li>
<li data-end="2975" data-start="2851">
<p data-end="2975" data-start="2853"><strong data-end="2872" data-start="2853">Download (ZIP):</strong><br data-end="2875" data-start="2872" />
<a class="decorated-link" data-end="2975" data-start="2877" href="https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.zip" rel="noopener" target="_new">https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.zip</a></p></li></td></tr></tbody></table><br /><hr data-end="538" data-start="535" />
<h3 data-end="570" data-start="540">🎯 <strong data-end="570" data-start="547">Learning Experience</strong></h3>
<p data-end="829" data-start="571">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.</p>
<hr data-end="834" data-start="831" />
<h3 data-end="859" data-start="836">🧩 <strong data-end="859" data-start="843">Key Features</strong></h3>
<h4 data-end="888" data-start="861"><strong data-end="888" data-start="866">Fiscal Year System</strong></h4>
<ul data-end="994" data-start="889">
<li data-end="943" data-start="889">
<p data-end="943" data-start="891">Manage the national budget across <strong data-end="943" data-start="925">4 fiscal years</strong></p>
</li>
<li data-end="994" data-start="944">
<p data-end="994" data-start="946">Review outcomes and adjust strategies each cycle</p>
</li>
</ul>
<h4 data-end="1024" data-start="996"><strong data-end="1024" data-start="1001">Resource Management</strong></h4>
<p data-end="1077" data-start="1025">Track and balance three critical national resources:</p>
<ul data-end="1170" data-start="1078">
<li data-end="1117" data-start="1078">
<p data-end="1117" data-start="1080"><strong data-end="1089" data-start="1080">Funds</strong> (starting budget: <strong data-end="1116" data-start="1108">$10M</strong>)</p>
</li>
<li data-end="1132" data-start="1118">
<p data-end="1132" data-start="1120"><strong data-end="1132" data-start="1120">Manpower</strong></p>
</li>
<li data-end="1170" data-start="1133">
<p data-end="1170" data-start="1135"><strong data-end="1170" data-start="1135">National Wellbeing Points (NWP)</strong></p>
</li>
</ul>
<h4 data-end="1195" data-start="1172"><strong data-end="1195" data-start="1177">Ministry Teams</strong></h4>
<p data-end="1286" data-start="1196">Engage with <strong data-end="1236" data-start="1208">six Singapore ministries</strong>, each representing different national priorities:</p>
<ul data-end="1508" data-start="1287">
<li data-end="1313" data-start="1287">
<p data-end="1313" data-start="1289">Ministry of Health (MOH)</p>
</li>
<li data-end="1344" data-start="1314">
<p data-end="1344" data-start="1316">Ministry of Defence (MINDEF)</p>
</li>
<li data-end="1381" data-start="1345">
<p data-end="1381" data-start="1347">Ministry of Trade & Industry (MTI)</p>
</li>
<li data-end="1429" data-start="1382">
<p data-end="1429" data-start="1384">Ministry of Social & Family Development (MSF)</p>
</li>
<li data-end="1478" data-start="1430">
<p data-end="1478" data-start="1432">Ministry of Sustainability & Environment (MSE)</p>
</li>
<li data-end="1508" data-start="1479">
<p data-end="1508" data-start="1481">Ministry of Education (MOE)</p>
</li>
</ul>
<h4 data-end="1545" data-start="1510"><strong data-end="1545" data-start="1515">National Priority Projects</strong></h4>
<p data-end="1612" data-start="1546">Decide which projects to fund, knowing that resources are limited:</p>
<ul data-end="1845" data-start="1613">
<li data-end="1680" data-start="1613">
<p data-end="1680" data-start="1615"><strong data-end="1648" data-start="1615">Build New Polyclinic (Health)</strong><br data-end="1651" data-start="1648" />
Cost: $6M | Reward: +10 NWP</p>
</li>
<li data-end="1757" data-start="1681">
<p data-end="1757" data-start="1683"><strong data-end="1726" data-start="1683">Invest in Green Energy (Sustainability)</strong><br data-end="1729" data-start="1726" />
Cost: $7M | Reward: +9 NWP</p>
</li>
<li data-end="1845" data-start="1758">
<p data-end="1845" data-start="1760"><strong data-end="1801" data-start="1760">Upgrade School Facilities (Education)</strong><br data-end="1804" data-start="1801" />
Cost: $3M + 1 Manpower | Reward: +6 NWP</p>
</li>
</ul>
<h4 data-end="1870" data-start="1847"><strong data-end="1870" data-start="1852">Dynamic Events</strong></h4>
<p data-end="1988" data-start="1871">Respond to unexpected scenarios (e.g. <strong data-end="1933" data-start="1909">“Regional Tensions!”</strong>) that disrupt plans and force rapid policy trade-offs.</p>
<h4 data-end="2019" data-start="1990"><strong data-end="2019" data-start="1995">Strategic Trade-offs</strong></h4>
<p data-end="2040" data-start="2020">Students learn that:</p>
<ul data-end="2190" data-start="2041">
<li data-end="2083" data-start="2041">
<p data-end="2083" data-start="2043">Funding one initiative may delay another</p>
</li>
<li data-end="2132" data-start="2084">
<p data-end="2132" data-start="2086">Short-term gains can affect long-term outcomes</p>
</li>
<li data-end="2190" data-start="2133">
<p data-end="2190" data-start="2135">Governance involves balancing diverse stakeholder needs</p>
</li>
</ul>
<hr data-end="2195" data-start="2192" />
<h3 data-end="2225" data-start="2197">🎓 <strong data-end="2225" data-start="2204">Educational Value</strong></h3>
<p data-end="2336" data-start="2226">This simulation supports learning in <strong data-end="2304" data-start="2263">Social Studies, Economics, and Civics</strong> by helping students understand:</p>
<ul data-end="2560" data-start="2337">
<li data-end="2377" data-start="2337">
<p data-end="2377" data-start="2339">Government budget allocation processes</p>
</li>
<li data-end="2409" data-start="2378">
<p data-end="2409" data-start="2380">Competing national priorities</p>
</li>
<li data-end="2451" data-start="2410">
<p data-end="2451" data-start="2412">Resource scarcity and opportunity costs</p>
</li>
<li data-end="2494" data-start="2452">
<p data-end="2494" data-start="2454">Stakeholder and ministry decision-making</p>
</li>
<li data-end="2525" data-start="2495">
<p data-end="2525" data-start="2497">Long-term strategic planning</p>
</li>
<li data-end="2560" data-start="2526">
<p data-end="2560" data-start="2528">Singapore’s governance structure</p>
</li>
</ul>
<p data-end="2703" data-start="2562">Students develop <strong data-end="2600" data-start="2579">critical thinking</strong>, policy reasoning skills, and a deeper appreciation of the complexity behind national decision-making.</p>
<hr data-end="2708" data-start="2705" />
<h3 data-end="2727" data-start="2710">▶️ <strong data-end="2727" data-start="2717">Try It</strong></h3>
<ul data-end="2975" data-start="2728">
<li data-end="2850" data-start="2728">
<p data-end="2850" data-start="2730"><strong data-end="2746" data-start="2730">Play online:</strong><br data-end="2749" data-start="2746" />
<a class="decorated-link" data-end="2850" data-start="2751" href="https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.html" rel="noopener" target="_new">https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.html<span aria-hidden="true" class="ms-0.5 inline-block align-middle leading-none"><svg class="block h-[0.75emhttp://www.w3.org/2000/svg"><path d="M14.3349 13.3301V6.60645L5.47065 15.4707C5.21095 15.7304 4.78895 15.7304 4.52925 15.4707C4.26955 15.211 4.26955 14.789 4.52925 14.5293L13.3935 5.66504H6.66011C6.29284 5.66504 5.99507 5.36727 5.99507 5C5.99507 4.63273 6.29284 4.33496 6.66011 4.33496H14.9999L15.1337 4.34863C15.4369 4.41057 15.665 4.67857 15.665 5V13.3301C15.6649 13.6973 15.3672 13.9951 14.9999 13.9951C14.6327 13.9951 14.335 13.6973 14.3349 13.3301Z"></path></svg></span></a></p>
</li>
<li data-end="2975" data-start="2851">
<p data-end="2975" data-start="2853"><strong data-end="2872" data-start="2853">Download (ZIP):</strong><br data-end="2875" data-start="2872" />
<a class="decorated-link" data-end="2975" data-start="2877" href="https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.zip" rel="noopener" target="_new">https://iwant2study.org/lookangejss/promptLibrary/ACPcookout2025/users/Budget%20Blueprint%20SG.zip<span aria-hidden="true" class="ms-0.5 inline-block align-middle leading-none"><svg class="block h-[0.75emhttp://www.w3.org/2000/svg"><path d="M14.3349 13.3301V6.60645L5.47065 15.4707C5.21095 15.7304 4.78895 15.7304 4.52925 15.4707C4.26955 15.211 4.26955 14.789 4.52925 14.5293L13.3935 5.66504H6.66011C6.29284 5.66504 5.99507 5.36727 5.99507 5C5.99507 4.63273 6.29284 4.33496 6.66011 4.33496H14.9999L15.1337 4.34863C15.4369 4.41057 15.665 4.67857 15.665 5V13.3301C15.6649 13.6973 15.3672 13.9951 14.9999 13.9951C14.6327 13.9951 14.335 13.6973 14.3349 13.3301Z"></path></svg></span></a></p>
</li>
</ul>
<hr data-end="2980" data-start="2977" />
<h3 data-end="3001" data-start="2982">🛠️ <strong data-end="3001" data-start="2990">Credits</strong></h3>
<p data-end="3245" data-start="3002">Created by participants of the <strong data-end="3057" data-start="3033">SLS Cookout Workshop</strong>, using <strong data-end="3077" data-start="3065">Claude 4</strong>.<br data-end="3081" data-start="3078" />
For more AI-generated educational simulations, visit:<br data-end="3137" data-start="3134" />
<a class="decorated-link" data-end="3245" data-start="3137" href="https://sg.iwant2study.org/ospsgx/index.php/ai-prompt-library/1366-prompt-library-for-educational-simulations" rel="noopener" target="_new">https://sg.iwant2study.org/ospsgx/index.php/ai-prompt-library/1366-prompt-library-for-educational-simulations<span aria-hidden="true" class="ms-0.5 inline-block align-middle leading-none"><svg class="block h-[0.75emhttp://www.w3.org/2000/svg"><path d="M14.3349 13.3301V6.60645L5.47065 15.4707C5.21095 15.7304 4.78895 15.7304 4.52925 15.4707C4.26955 15.211 4.26955 14.789 4.52925 14.5293L13.3935 5.66504H6.66011C6.29284 5.66504 5.99507 5.36727 5.99507 5C5.99507 4.63273 6.29284 4.33496 6.66011 4.33496H14.9999L15.1337 4.34863C15.4369 4.41057 15.665 4.67857 15.665 5V13.3301C15.6649 13.6973 15.3672 13.9951 14.9999 13.9951C14.6327 13.9951 14.335 13.6973 14.3349 13.3301Z"></path></svg></span></a></p><br />{/source}