From dm-game
Resource flow architecture, currency system design, inflation/deflation diagnosis, sink/source balancing, crafting economies, LiveOps event budgeting, and economy simulation modeling. Use when designing resource systems from scratch, adding currencies or stores, setting crafting costs or reward magnitudes, diagnosing inflation or wealth stratification, planning monetization, designing LiveOps events, or when veteran players stockpile while new players feel locked out. Goes deeper than game-balance's economy health check — this is the architectural skill for building and sustaining entire economic systems.
npx claudepluginhub rbergman/dark-matter-marketplace --plugin dm-gameThis skill uses the workspace's default tool permissions.
**Purpose:** Systematic tools for designing, simulating, and sustaining game economies — the architecture of resource flows, currency systems, and long-term economic health. Economy is a foundational system; most other systems are downstream of resource flow.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides MCP server integration in Claude Code plugins via .mcp.json or plugin.json configs for stdio, SSE, HTTP types, enabling external services as tools.
Purpose: Systematic tools for designing, simulating, and sustaining game economies — the architecture of resource flows, currency systems, and long-term economic health. Economy is a foundational system; most other systems are downstream of resource flow.
Core philosophy: An economy is a directed graph. Every resource has sources, sinks, converters, and pools. If you cannot draw the graph, you do not understand the economy. Draw first, implement second.
Use this skill when:
Relationship to game-balance: The game-balance skill covers balancing within an economy — cost curves, dominant strategy detection, tuning existing numbers. This skill covers designing economies from scratch — the architecture of flows, the choice of currencies, and the long-term health of the system.
Every economy is a directed graph of resources. Before writing any code, draw the graph.
| Component | Role | Examples |
|---|---|---|
| Sources | Where resources enter the system | Enemy drops, quest rewards, crafting yields, purchases, passive generation, event rewards |
| Sinks | Where resources leave the system | Crafting costs, repair fees, consumable use, transaction taxes, upgrade costs, cosmetic purchases |
| Converters | Transform one resource into another | Crafting (materials → items), trading (gold → gear), upgrading (item + currency → better item) |
| Pools | Where resources accumulate | Player inventory, bank, stash, guild vault, escrow |
| Connections | Flow between players or systems | Trade, gifting, marketplace, looting, auction house |
If total_source_rate > total_sink_rate → inflation (guaranteed)
If total_sink_rate > total_source_rate → deflation (guaranteed)
This is not a risk. It is arithmetic. An imbalance does not risk inflation — it causes it. The only question is how fast.
Every sink must feel meaningful to the player. "Taxes" are a terrible sink — they feel like punishment. "Crafting the weapon I want" is a great sink — it feels like progress. If players resent a sink, they will avoid it or quit. If players desire a sink, it regulates the economy while creating engagement.
Good sinks: Crafting, upgrading, cosmetic purchases, consumables that feel powerful, meaningful repairs, prestige resets (New Game+ currencies)
Bad sinks: Arbitrary fees, death penalties that feel unfair, durability loss on non-combat items, mandatory maintenance costs with no player agency
The number and structure of currencies is an architectural decision that shapes every downstream system.
| Type | Structure | Pros | Cons | Best For |
|---|---|---|---|---|
| Single | One resource for everything | Simple, easy to understand | Hard to balance across systems | Simple games, prototypes, jam games |
| Dual (soft/hard) | Earned currency + premium currency | Separates progression from monetization | Premium currency creates pay-to-win perception if mishandled | F2P with ethical monetization |
| Multi-currency | 3+ resources with different functions | Rich decision-making, deep crafting | Complexity overhead, inventory management burden | RPGs, survival games, deep crafting systems |
| Hybrid | Mix of above with conversion paths | Flexible, supports multiple progression tracks | Conversion rates are extremely hard to balance | Complex games with multiple progression paths |
Q: Does my game need more than one currency?
├─ Are there distinct resource acquisition loops? (combat vs. exploration vs. crafting)
│ └─ Yes → Consider multi-currency, one per loop
├─ Is there a monetization layer?
│ └─ Yes → Add a premium currency, strictly separated from power
├─ Are there time-gated and skill-gated progressions?
│ └─ Yes → Consider separate currencies for each gate
└─ None of the above → Single currency is probably sufficient
The core economic health problem. Every live economy trends toward one or the other unless actively managed.
Resources enter faster than they leave. Consequences cascade:
Resources leave faster than they enter. Consequences cascade:
| Signal | Indicates | Severity |
|---|---|---|
| Median player holdings doubling faster than designed | Inflation | High — exponential growth is hard to reverse |
| NPC shop prices feeling trivial by mid-game | Inflation | Medium — may be intentional progression |
| Player-to-player trade prices spiraling upward | Inflation | High — emergent market reflects real currency devaluation |
| Players hoarding instead of spending | Deflation | Medium — could also indicate poor sink quality |
| New players unable to afford baseline items in first session | Deflation | Critical — directly causes churn |
| Wealth Gini coefficient rising over time | Stratification | High — rich-poor gap compounds |
Anti-inflation: Scaling sinks (costs increase with item level), progressive transaction taxes, limited-time cosmetic sinks (voluntary and desirable), currency caps, diminishing returns on sources, prestige resets. Each carries risk — scaling sinks can feel punitive, caps feel restrictive, diminishing returns must be transparent.
Anti-deflation: Increased drop rates, catch-up mechanics (bonus earning for players behind median), guaranteed minimum rewards, resource sharing between players, price floors. Each carries risk — increased drops can overshoot into inflation, catch-up mechanics can feel patronizing.
Key insight: Equilibrium is dynamic, not static. Sources and sinks must scale with player population, average playtime, and progression stage. A fixed faucet-drain ratio that works at launch will break within months. Budget for ongoing tuning, not a one-time balance pass.
Model the economy in a spreadsheet before implementing it in code. Spreadsheets are cheap to iterate; code is expensive.
For each resource, calculate:
session_net = (all sources per session) - (all sinks per session)
If session_net is positive, the player accumulates. If negative, the player depletes. Both are fine — what matters is whether the rate matches your design intent.
Model at least three archetypes and project their accumulation curves:
| Archetype | Play Pattern | What to Check |
|---|---|---|
| Casual | 30 min/day, 3-4 days/week | Can they afford baseline items within the first week? |
| Regular | 1-2 hours/day, 5-6 days/week | Does their progression feel steady and rewarding? |
| Hardcore | 4+ hours/day, daily | At what point do they break the economy? |
Economic systems self-reinforce through feedback loops. Understanding which loops exist in your economy is essential for predicting long-term behavior.
Positive feedback (rich get richer): Player earns gold → buys better gear → earns gold faster. Creates dramatic progression but also stratification. Every positive feedback loop needs a ceiling or a counterbalancing negative loop.
Negative feedback (rubber-banding): Player falls behind → gets bonus rewards → catches up. Prevents stratification but can feel patronizing if too visible.
Positive feedback for SKILL. Negative feedback for TIME. Better players should earn more (skill respects mastery). Players who miss sessions should be able to catch up (time respects life). Never pure positive feedback — it creates runaway inequality. Never pure negative feedback — it removes the reward for investment.
For each resource flow in your graph, trace the cycle: does earning resource A enable earning more of A? If yes, classify the amplification as skill-based, time-based, or both. Time-based amplification needs negative feedback (catch-up, diminishing returns). Skill-based needs a ceiling. Both: ensure the skill component dominates at high levels.
Resource scarcity creates challenge without stat scaling. This is often more interesting than making enemies harder, because it changes player decisions rather than requiring faster reflexes.
| Scarce Resource | Decision It Creates | Example |
|---|---|---|
| Ammo | Shot selection, target prioritization | Survival horror: every bullet matters |
| Health items | Risk assessment, retreat timing | Soulslike: when to use the last estus |
| Crafting materials | Build commitment, specialization | Survival: invest in weapons or shelter? |
| Currency | Purchasing priorities, opportunity cost | RPG: buy the armor or save for the sword? |
| Time (as currency) | Activity prioritization | Farming sim: water crops or explore the mine? |
| Inventory space | Carry decisions, value assessment | Roguelike: which items to keep? |
Time-limited events stress the base economy. This is where real products break most often — the base economy is fine until events start stacking.
Overlapping events multiply economic stress. Each event is designed in isolation, but players experience them simultaneously.
FOMO is a powerful motivator but easily becomes toxic. Provide paths to earn event items later at higher cost. Never make gameplay-affecting items permanently exclusive. Communicate return schedules clearly.
Budget for real-world calendar effects: holidays create spending peaks, end-of-season events drive engagement spikes, anniversary giveaways inject resources. Model cumulative impact before committing.
Crafting is an economy subsystem — a converter (materials → items) and a sink (materials consumed). It deserves dedicated design attention because it sits at the intersection of economy, progression, and player expression.
Crafting decisions should be meaningful. Which item to craft, what to sacrifice, which path to specialize in. "Collect enough, press button" is content, not a system.
No acquisition path should dominate. Crafting (time + materials → guaranteed item), buying (currency → immediate, limited), finding (luck → free, unpredictable), trading (social → specific, market-priced) should each have trade-offs.
Recipes should pull players through multiple systems. Ingredients from combat drops + exploration finds + economy purchases create cross-system engagement.
Crafting must function as a real sink. If materials are trivially abundant, crafting is not regulating the economy.
Failed crafting must feel fair. Return partial value or provide meaningful feedback. Pure loss drives players away from the system.
What to track in a live economy. These metrics should be on a dashboard, reviewed regularly.
| Metric | What It Measures | Warning Signal |
|---|---|---|
| Median currency holdings by player age | Accumulation rate | Exponential growth after first week |
| Price index (basket of key items) | Inflation/deflation | >10% change per month in player markets |
| Time-to-purchase key items | Accessibility | New players cannot afford baseline items within first session |
| Sink engagement rate | Sink quality | <50% of players using a designed sink |
| Currency velocity | Economic activity | Low velocity = hoarding; high velocity = spending faster than earning |
| Gini coefficient | Wealth distribution | Rising Gini over time = rich-poor gap widening |
| Source/sink ratio by player segment | Segment-specific health | Ratio diverging between casual and hardcore |
| Conversion rate usage | Currency architecture health | One currency being converted to another at >80% rate = currencies are functionally one |
Listen for: "Everything is too expensive" (deflation), "Gold is meaningless" (inflation), "I can't catch up" (stratification), "Why does repair cost so much?" (punitive sink), "The market is dead" (deflation or supply drought).
| Anti-Pattern | Symptom | Fix |
|---|---|---|
| Meaningless sinks | Players resent fees, avoid sinks | Connect every sink to something players want — crafting is desirable, taxes are not |
| Uncapped generation | Hardcore players inflate the economy | Diminishing returns, daily/weekly caps, scaling sink costs |
| Currency bloat | Players confused by too many currencies | Audit: "Does this currency create a unique decision?" If no, merge |
| Price anchoring failure | Second item feels absurdly expensive | First purchase must anchor expectations for the full price range; earning rate must visibly increase alongside prices |
| Spiral of power | Better gear → more gold → better gear → trivializes content | Decouple gear from earning rate; add scaling sinks; introduce horizontal progression. See progression-systems |
| Event economy neglect | Base economy unrecognizable after months of events | Every event gets an economy impact budget; maintain running ledger of cumulative injections |
Use this when designing a new economy or auditing an existing one.
| Area | Skill | When to Go There |
|---|---|---|
| Balancing within an economy | game-balance | Tuning specific prices, cost curves, dominant strategy detection — operates on an economy this skill designed |
| Economy as a system | systems-design | Evaluating how the economy interacts with other game systems — economy is typically a foundational system |
| Reward psychology | motivation-design | Understanding why players engage with economic systems — reinforcement schedules, intrinsic vs. extrinsic motivation |
| Progression pacing | progression-systems | Aligning economy pacing with power curves and unlock schedules — the two systems must be synchronized |
| Core loop engagement | experience-design | Ensuring economic decisions contribute to the engagement loop, not just numerical accumulation |
| Playtest validation | playtest-design | Testing whether the economy produces the intended player experience — metrics to track, questions to ask |
| Player cognitive load | player-ux | When currency count or economic complexity exceeds player attention budget |