Minecraft Stock Market & Federal Government

Game-economy simulation only — not real securities, legal advice, or government procedure.

What shipped

Architecture matches existing Vault/Factions services: Spigot owns money/land truth, _AI runs deliberation.

Market (stock exchange)

Instruments (default)

• IRON, FOOD, COMBAT — tradable AMM pools
• SPY — non-tradable equal-weight index

Engine

Constant-product AMM (cash * shares = k), fee sink → government treasury, circuit breakers, paper ledger when Vault is missing.

In-game

/ai market status
/ai market quote
/ai market buy IRON qty:10 apply
/ai market sell IRON qty:5 apply
/ai market portfolio
/ai market halt symbol:IRON hours:2 apply
/ai market open apply
/ai market set_fee amount:1.5 apply

From _AI (bridge connected)

minecraft market status
minecraft market quote
minecraft market buy symbol:IRON qty:10 player:Steve apply
minecraft market portfolio player:Steve

Observation fields

mkt_available, mkt_quotes, mkt_nav, mkt_positions, mkt_fee_pct, mkt_paper, …

Config

plugins/AugmentedIntelligenceBridge/market.yml (copied from jar on first load).
Runtime state: market_state.yml.

Government (USGov-style process)

Modeled on US-Federal-Government-Agents.lua:

1. Cabinet review
2. Charter / SCOTUS preview
3. Senate
4. House
5. Conference + President sign/veto
6. Judicial / ethics hold
7. Optional closed-ballot enactment

Closed ballot (plugin)

no_action, publish_budget, charter_review, ethics_audit, set_sales_tax,
halt_market_IRON|FOOD|COMBAT, open_market_all, jobs_boost_notice,
stimulus_payout, claim_freeze_notice, refer_public

High-risk actions never invent ban/wipe/op. Claim freeze and Jobs boost are notices unless staff hooks them later.
Default is dry-run (government.yml: dry-run-default: true, execute-winner: false).

In-game

/ai gov status
/ai gov ballot
/ai gov charter
/ai gov bill Cap market fees at 1%
/ai gov session force
/ai gov enact set_sales_tax param:1
/ai gov enact set_sales_tax param:1 apply
/ai gov laws
/ai gov appoint player:Steve office:president apply

From _AI

minecraft gov status
minecraft gov charter
minecraft gov bill Stabilize IRON prices
minecraft gov session force
minecraft gov enact publish_budget apply

Observation fields

gov_available, gov_treasury, gov_sales_tax_pct, gov_active_bill,
gov_last_enacted, gov_judicial_hold, gov_office, …

Config

government.yml + government_state.yml (treasury, laws, offices).

Lua setup (simple script execute)

One-shot console for bridge + gov + market probes, optional owner appoint, dry enact:

simple script execute lua_scripts/MC-Government-Setup.lua

Short alias:

simple script execute lua_scripts/MC-Gov.lua

Useful env flags:

set MCGOV_SETUP_APPOINT=1
set MCGOV_SETUP_OWNER=Macdaddy4sure
set MCGOV_SETUP_OFFICE=president
set MCGOV_SETUP_APPLY=0
set MCGOV_SETUP_FEDERAL=1
set MCGOV_SETUP_SELFTEST=1
set MCGOV_SETUP_MENU=1
simple script execute lua_scripts/MC-Gov.lua

Lua multi-agent session

set MCGOV_DRY_RUN=1
set MCGOV_EXECUTE_WINNER=0
set MCGOV_BILL=Publish budget and keep IRON liquid
simple script execute lua_scripts/MC-Federal-Government-Agents.lua

Or:

agent start mc_federal

Self-test:

set MCGOV_SELFTEST=1
simple script execute lua_scripts/MC-Federal-Government-Agents.lua

Env flags mirror USGov: MCGOV_SESSIONS, MCGOV_VOTE_ONLY, MCGOV_RL, MCGOV_STATE_FILE, MCGOV_MENU.

Ballot commands call minecraft gov enact … / minecraft market … when MCGOV_EXECUTE_WINNER=1 and not dry-run.

Bridge JSON

{"type":"market","id":1,"op":"buy","player":"Steve","symbol":"IRON","qty":10,"apply":true}
{"type":"market_result","ok":true,"summary":"bought 10 IRON @ ..."}

{"type":"gov","id":2,"op":"enact","action":"set_sales_tax","param":1.0,"apply":true}
{"type":"gov_result","ok":true,"summary":"sales_tax_pct=1.0","judicial_hold":false}

Safe rollout

1. Deploy plugin; confirm /ai market status and /ai gov status.
2. Leave execute-winner: false and market trades dry-run until tested.
3. Run Lua with MCGOV_DRY_RUN=1.
4. Enable live trades/enacts only after fee caps and stimulus caps look correct.
5. Appoint human officers via /ai gov appoint if you want mixed human/AI congress.

Disclaimer

Virtual game economy and civics simulation for entertainment and training. Not financial, legal, or governmental advice.