Economy - 経済（緒方 水輝@Vtuber）

Beta (1.0.0-beta.1) — core gameplay is available; please report bugs before a stable release.

Economy

A self-contained economy mod for NeoForge 26.x. Currency, shops, banking, stock-like ETF trading, loans, a player flea market, and rankings — all stored in your Minecraft world save. No separate API process, database, or Docker stack.

Works in singleplayer, Open to LAN, and dedicated multiplayer (install on both client and server).

Features

• Currency — wallet, bank balance, and debt, with an on-screen HUD
• Action rewards — earn money from mining, logging, combat, fishing, farming, and more (configured in master data)
• Death penalty — configurable loss rate on death
• NPC shops — buy from sellers, sell to the pawn shop, trade ETFs, and use the flea market
• ATM — deposit and withdraw bank funds
• ETF trading — category prices with random-walk updates and short-selling limits
• Loans — borrow from a loan NPC with asset-based limits
• Flea market — list and buy items between players
• Rankings — compile and browse wealth / activity snapshots (admin tools included)
• Admin block — in-game GUI to view balances, edit master prices/rewards/shops, and reset selected economy data
• Master JSON — bundled defaults export to config/economy/economy_master.json on first load; edit prices, items (including other mods), and shops there or via the admin GUI

Optional integrations

Mod	Effect
Nickname	Prefer nicknames in rankings and admin player lists
Guide Lib	In-game manual and Codex entry

The mod runs fine without these.

Setup notes

• On first world load, the bundled master is written to config/economy/economy_master.json (server root config/, not inside the world folder).
• Admin GUI saves update that file and reload immediately. Manual JSON edits need a world restart (or use Restore bundled in the admin GUI).
• config/economy-common.toml only controls reward chat aggregation timing — game balance lives in the master JSON / admin GUI.

Credits

This mod was developed with partial assistance from AI (Claude, Gemini, etc.) to improve development efficiency and optimize code. All game balance decisions and playtesting were performed manually by the developer. If you encounter any unexpected issues, please report them via GitHub Issues.

ベータ版 (1.0.0-beta.1) — 基本的なゲームプレイは利用可能です。安定版リリース前にバグを報告してください。

経済システム

NeoForge 26.x 向けの独立した経済MODです。通貨、ショップ、銀行、株式のようなETF取引、ローン、プレイヤー向けフリーマーケット、ランキングなど、すべてがMinecraftのワールドセーブデータ内に保存されます。別途APIプロセス、データベース、Dockerスタックは必要ありません。

シングルプレイヤー、LAN対応、および専用マルチプレイヤー（クライアントとサーバーの両方にインストール）で動作します。

機能

• 通貨 — ウォレット、銀行残高、負債。画面上にHUDが表示されます
• アクション報酬 — 採掘、伐採、戦闘、釣り、農業などでお金を獲得できます（マスターデータで設定可能）
• 死亡ペナルティ — 死亡時の損失率をカスタマイズ可能
• NPCショップ — 売り手から購入、質屋への売却、ETF取引、フリーマーケットの利用が可能
• ATM — 銀行資金の入出金
• ETF取引 — ランダムウォーク方式で価格が更新されるカテゴリー別価格と、空売り制限
• ローン — 資産を基にした限度額内で、ローンNPCから借入が可能
• フリーマーケット — プレイヤー間でアイテムを出品・購入
• ランキング — 資産・活動状況のスナップショットをまとめ、閲覧可能（管理者ツール付き）
• 管理者ブロック — 残高の確認、マスター価格・報酬・ショップの編集、選択した経済データのリセットを行うためのゲーム内GUI
• マスターJSON — 初回読み込み時にデフォルト設定が config/economy/economy_master.json にエクスポートされます。価格、アイテム（他のMODを含む）、ショップは、このファイルまたは管理者用GUIから編集可能です

オプションの統合機能

MOD	効果
ニックネーム	ランキングや管理用プレイヤーリストでニックネームを優先表示
ガイドライブラリ	ゲーム内マニュアルおよびコーデックス項目

これらの機能なしでもMODは正常に動作します。

セットアップに関する注意事項

• ワールドを初めて読み込んだ際、バンドルされたマスターデータが config/economy/economy_master.json に書き込まれます（サーバーのルートディレクトリ config/ 内にあり、ワールドフォルダ内ではありません）。
• 管理者GUIでこのファイルを更新して保存すると、即座に再読み込みされます。JSONファイルを手動で編集した場合は、ワールドを再起動する必要があります（または、管理者GUIの**「バンドルを復元」**機能を使用してください）。
• config/economy-common.toml は報酬チャットの集計タイミングのみを制御します。ゲームバランスに関する設定は、マスター JSON ファイルおよび管理 GUI で行われます。

クレジット

このMODは、開発効率の向上とコードの最適化を目的として、AI（Claude、Geminiなど）による一部支援を受けて開発されました。ゲームバランスの決定およびプレイテストはすべて、開発者によって手動で行われました。予期せぬ問題が発生した場合は、GitHub Issues を通じて報告してください。