Dynamic Economy

📈 Dynamic Economy Addon

A Minecraft Bedrock Edition addon bringing a dynamic economy based on Supply & Demand, shaped by Daily Market Events, and featuring a Daily Hazards System (Hazards & Mitigation) and a Server Cooperative Project. Lightweight, safe, and 100% compatible with other addons since it never modifies player.json.

Achievement Friendly: no experimental toggles required, so achievements stay fully enabled in your world.

---

🆕 What's New in v1.3.5

Verocraft Ecosystem Integration (Plug & Play / Zero-Config)

• Verobank Integration: an [OPEN BANK] button automatically appears in the Global Market menu when the Verobank addon is installed in the world. Daily hazard events and cooperative donation progress are broadcast to Verobank automatically via loosely-coupled ScriptEvents.
• Player Auction House Integration: a [PLAYER AUCTIONS] button automatically appears in the Global Market menu when the Auction House addon is installed.
• Zero-Config Auto-Detection: admins no longer need to manually edit config.js. A session token system (vc:session_id, vc:session_de, vc:active_de) automatically detects installed companion addons when the world loads. The options in config.js now act purely as a killswitch if an admin wants to force a button off.

New Environmental Hazard: Stench Outbreak

Toxic methane gas and a foul rotting smell are seeping out of the ground! Working without respiratory protection while this hazard is active periodically triggers Nausea (dizziness) and Hunger (rapid hunger drain). Wear a Scented Mask in your Helmet slot to become immune to the toxic gas.

• dyneco:scented_mask: 32 uses, craftable.
• dyneco:super_scented_mask: 64 uses, Black Market exclusive (500 Ducats).

3 New Minor Daily Events

• Construction Boom (construction_boom): A neighboring town's building project drives wood prices up to 1.5x.
• Fuel Shortage (fuel_shortage): Industrial coal supply runs low, mineral prices rise to 1.6x.
• Arms Surplus (arms_surplus): Donated war supplies flood the market, equipment prices drop to 0.6x.

---

🚀 Key Features

1. Dynamic Economy (Supply & Demand) Sell an item → stock goes up → price automatically drops. Buy an item → stock goes down → price automatically rises.

2. Bulk Pricing Prevents price exploitation on large buy/sell transactions using precise accumulative price calculation.

3. Sell Tax (Spread) System Sell price is set at 65% of buy price, keeping the economy stable and preventing infinite money-printing loops.

4. Daily Market Events & Economic Hazards Random daily events affect the market, plus 5 Daily Economic Hazards that disrupt productivity and require specific mitigation tools:

   • Crop Plague (crop_plague): Harvesting without Pesticide yields Spoiled Crop.
   • Volcanic Eruption (volcanic_eruption): Mining ore without a Stabilizer Chisel in your off-hand crushes it into Cobblestone.
   • Animal Disease (animal_disease): Slaughtering livestock without an Animal Vaccine only drops Rotten Flesh.
   • Wood Blight (wood_blight): Chopping any tree log without Tree Medicine in your off-hand crushes it into a plain Stick.
   • Stench Outbreak (stench_outbreak): Toxic gas triggers periodic Nausea and Hunger unless you're wearing a Scented Mask.

   Plus 7 minor daily events that shift category prices without needing mitigation: Great Harvest (crops 0.6x), Miners' Strike (minerals 1.6x), Blacksmith Holiday (equipment 1.5x), Mystical Eclipse (mob drops 1.4x), Construction Boom (wood 1.5x), Fuel Shortage (minerals 1.6x), and Arms Surplus (equipment 0.6x).

   Plus 7 broader market/crisis events: Normal Day, Famine (crops 1.8x), Gold Rush (minerals 0.6x), Monster Invasion (mob drops 1.6x), Monsoon Storm (wood 1.8x), Trader Festival (all prices 0.75x), and Nether Breach (Nether commodities spike sharply).

5. Server Cooperative Project A hazard won't end until the donation target is met. The target scales dynamically: Target Per Player × Number of Online Players: still solo-player friendly.

6. Black Market A secret shop that only appears while a hazard is active, selling Super Tools (64 uses) for 500 Ducats.

7. Daily News An in-UI news sheet with hazard lore and full mitigation instructions.

8. Live Hazard Visuals A chat log alert with full guidance appears when a hazard is active, plus an ActionBar ticker showing the hazard name and cooperative donation progress every 5 seconds.

9. Dynamic Translation (displayName Fallback) Custom item names are automatically pulled from displayName in config.js, no extra .lang file needed.

---

🎮 In-Game Usage

1. Opening the Market UI

• Market Ledger: Automatically given on first join. Right-click to open the menu. If lost: /give @s dyneco:market_ledger
• Bulletin Board: Place the dyneco:bulletin_board block, then right-click it to open the market instantly.
• Command / Command Block: /scriptevent economy:market

2. Displaying the Balance on Screen

/scoreboard objectives setdisplay sidebar money

3. Admin Hazard Commands (Force Trigger)

# Major Hazards
/scriptevent dyneco:trigger_hazard crop_plague
/scriptevent dyneco:trigger_hazard volcanic_eruption
/scriptevent dyneco:trigger_hazard animal_disease
/scriptevent dyneco:trigger_hazard wood_blight
/scriptevent dyneco:trigger_hazard stench_outbreak

# Minor Events
/scriptevent dyneco:trigger_hazard great_harvest
/scriptevent dyneco:trigger_hazard miners_strike
/scriptevent dyneco:trigger_hazard blacksmith_holiday
/scriptevent dyneco:trigger_hazard mystical_eclipse
/scriptevent dyneco:trigger_hazard construction_boom
/scriptevent dyneco:trigger_hazard fuel_shortage
/scriptevent dyneco:trigger_hazard arms_surplus

# Other Market & Global Crisis Events
/scriptevent dyneco:trigger_hazard normal
/scriptevent dyneco:trigger_hazard famine
/scriptevent dyneco:trigger_hazard gold_rush
/scriptevent dyneco:trigger_hazard monster_invasion
/scriptevent dyneco:trigger_hazard monsoon_storm
/scriptevent dyneco:trigger_hazard trader_festival
/scriptevent dyneco:trigger_hazard nether_breach

Admins get instant chat feedback on whether the event triggered successfully or the ID wasn't found.

---

⚙️ Admin Configuration (scripts/config.js)

A. Mitigation Tool Crafting Recipes

• Pesticide: 1x Glass Bottle + 1x Spider Eye + 1x Bone Meal + 1x Iron Ingot (main hand)
• Stabilizer Chisel: 1x Iron Ingot + 2x Sticks + 1x Flint, shapeless recipe (off-hand)
• Animal Vaccine: 1x Glass Bottle + 1x Spider Eye + 1x Sugar + 1x Iron Ingot (main hand)
• Tree Medicine: 1x Glass Bottle + 1x Spider Eye + 1x Bone Meal + 1x Sugar, shapeless recipe (off-hand)
• Scented Mask: 1x Paper + 1x Yellow Flower (Dandelion) + 1x Sugar + 1x Glass Bottle, shapeless recipe (Helmet slot)
• Bulletin Board: top row 3x Wood Planks, middle row 3x Wood Slabs, bottom row Stick + Paper + Stick

B. Registering New Items & Subcategories

items: {
  // VANILLA ITEM IN A STANDARD CATEGORY
  "minecraft:diamond": {
    displayName: "Diamond",
    category: "minerals", // crops | minerals | mob_drops | woods
    basePrice: 150,
    baseStock: 100,
    minPrice: 40,
    maxPrice: 600
  },

  // EQUIPMENT ITEM WITH A SUBCATEGORY
  "minecraft:netherite_sword": {
    displayName: "Netherite Sword",
    category: "equipment",   // Main Equipment category
    subcategory: "weapons",  // weapons | armor | tools
    basePrice: 1500,
    baseStock: 10,
    minPrice: 500,
    maxPrice: 3000,
    icon: "textures/items/netherite_sword.png"
  }
}

---

🔗 Integration with Player Auction House Addon

This addon supports direct integration with the Gilded Ledger: Player Auction House Addon using a Loose Coupling system (ScriptEvents). This lets players open the auction menu directly from the main Global Market menu, and vice versa, so players only need to carry a single Ledger item in their inventory.

How the Integration Works (Zero-Config Auto-Detection)

As of v1.4.1, the Verocraft ecosystem uses a Plug & Play (Zero-Config) protocol. You no longer need to manually edit any config file:

• Just install the Player Auction House addon in the same world.
• Dynamic Economy automatically detects the Auction House session via a session token (vc:session_ah / vc:active_ah).
• The [PLAYER AUCTIONS] button appears automatically in the Global Market menu.
• Optional: to force this button off (killswitch), set enableAuctionIntegration: false in scripts/config.js.

---

🏦 Integration with Verobank Addon

This addon supports integration with Verobank (banking addon) using a Loose Coupling system via ScriptEvents and Zero-Config Auto-Detection. If Verobank isn't installed, Dynamic Economy still works 100% normally with no crashes.

How the Integration Works (Zero-Config Auto-Detection)

• Just install the Verobank addon in the same world.
• Dynamic Economy automatically detects Verobank via a session token (vc:session_bank / vc:active_bank / verocraft:bank_active).
• The [OPEN BANK] button appears automatically in the Global Market menu.
• Hazard crisis broadcasts and cooperative donation progress are sent to Verobank automatically.
• Optional: to force this integration off (killswitch), set enableBankIntegration: false in scripts/config.js.

What Dynamic Economy Sends to Verobank (ScriptEvents)

ScriptEvent ID	Payload	When It's Sent
dynamiceconomy:hazard_triggered	{ hazardType, severity, timestamp }	Every time a new daily hazard becomes active
dynamiceconomy:hazard_resolved	{ hazardType, timestamp }	When the cooperative project successfully resolves a hazard
dynamiceconomy:cooperative_project_active	{ active, hazardType, progressPercent }	Periodically while a hazard is active (every 5 seconds) and after each cooperative donation

[OPEN BANK] Button in the Main Menu

If enableBankIntegration: true, an [OPEN BANK] button appears in the Global Market's main menu. Clicking it sends the verobank:open_menu ScriptEvent to open the Bank menu.

Shared Currency (Ducats)

Both addons share the same Ducats currency through the money scoreboard objective. Verobank can directly read/write a player's balance through this scoreboard without any additional handshake.

---

🌐 Verocraft Commercial Ecosystem & Verohub Recommendation

Dynamic Economy is designed as the core of the unified Verocraft economy ecosystem, which includes:

• Dynamic Economy: dynamic market pricing, hazard crises, and the cooperative project.
• Auction House: player-to-player auctions and trading.
• Verobank: banking, deposit interest, collateral loans, and the stock market.
• Verohub (Ecosystem Coordinator): a connector addon and live monitoring dashboard.

Why Installing Verohub Is Strongly Recommended

If you install more than one commercial addon on your server/world, installing Verohub is strongly recommended:

1. One Item for All Services (Merchant License): without Verohub, new players receive a separate book from each addon (market_ledger, auction:ledger, bankbook), cluttering their inventory. With Verohub installed, all starter items are automatically suppressed, players receive just one official item, the Merchant License (verohub:merchant_license), which opens a unified menu for the Market, Auction House, and Bank at once.
2. Real-Time Admin Monitoring Dashboard (/scriptevent vc:panel): a visual panel to monitor each addon's online/offline status, heartbeat stability, and market crisis status, without needing to check the server console.
3. Global Scoreboard Protocol (vc_status): Zero-Config, Scoreboard-based automatic detection ensures all addons recognize each other instantly with no complex handshake required.

---

📜 Changelog

v1.3.5: Verocraft Ecosystem Integration

• Zero-Config Auto-Detection for the entire Verocraft ecosystem, no more manual config editing to link addons.
• New Verobank integration: an [OPEN BANK] button and automatic hazard/donation-progress broadcasts via ScriptEvents.
• Player Auction House integration upgraded to the same session-token based Zero-Config system.
• New 5th major hazard: Stench Outbreak, toxic gas causes periodic Nausea/Hunger unless wearing a Scented Mask.
• 3 new minor daily events: Construction Boom, Fuel Shortage, Arms Surplus