OreMarket

A lightweight, server-authoritative stock market simulation for Minecraft ores. Trade, watch prices move, take loans, and decide how much risk you want to carry using in-game items.

Features

• Market GUI: Full trading terminal with candlestick charts, volume indicators, and switchable timeframes.
• Advanced Trading: Supports market orders, limit orders, and short selling with margin requirements.
• Loans & Risk: Apply for system loans with credit scoring. Beware of maintenance margin calls and forced liquidations.
• Dynamic Events: Random news and market events that alter stock prices, volatility, and trends.
• Highly Configurable: 8 built-in ore markets, with the ability to add custom stocks, adjust fees, and tweak economic parameters.
• Localization: Includes English, Simplified Chinese, and Traditional Chinese.

Requirements

• Minecraft: 1.20.1
• Forge: 47.4.23 or newer (47.x compatible)
• Java: 17
• Environment: Both Client and Server are required for multiplayer. For single-player, it acts as a client-side mod.

Optional Recommendations

For a better experience, we recommend playing with the following mods:

• Configured: Allows you to change market settings in-game without manually editing the oremarket.toml file.
• Modern UI: Provides modern, aesthetic rendering, making the market interface look even better.

Installation

1. Install Minecraft Forge for 1.20.1.
2. Put the OreMarket .jar in the mods folder.
3. Start the game once to generate config/oremarket.toml.
4. In multiplayer, ensure the server and clients use the same mod version.

Getting Started

Press Ctrl+G by default to open or close the market. The key can be changed in Options → Controls → Key Binds → Miscellaneous.

Useful commands:

• /oremarket open — Open the market UI
• /oremarket balance — View your coins and holdings
• /oremarket price <stock> — View a stock quote
• /oremarket config show — View the active market settings

The market is configured in config/oremarket.toml. Server settings are authoritative in multiplayer, so client-side values do not override the server.

Important Notes

• Beta Status: This is a beta release. Economic values (prices, loan rates, fees) are subject to change. Please back up your world before installing.
• Developer Note: This project is currently in an early development stage. Code readability and architecture are not yet fully optimized. Additionally, the developer currently lacks the bandwidth to continue active maintenance.

The project is licensed under GPL-3.0-or-later.