Guestrax’s Server Utilities

Overview

MCServerUtils is a server-side economy and utility mod built for NeoForge 1.21.1. It focuses on a fully config-driven shop system, dynamic pricing, player market listings, item order requests, and a menu-first admin/player experience.

Core Features

Config-Driven Shop

• Shop categories and items are loaded from JSON config files in the server config folder.
• Category layouts, item pricing, and icons are stored in config rather than being edited live in-game.
• Admins can reload config changes through commands, keeping the server state synchronized.

Dynamic Economy Pricing

• Item buy/sell values react to stock levels.
• Prices are derived from item supply instead of being static forever.
• This creates a more natural trading economy and makes server shops feel alive.

Player Market

• Players can list items for sale in a market menu.
• Buyers can browse available listings and purchase them directly.
• Market listings are tracked in saved economy data.

Item Orders

• Players can request items they want by posting an order.
• Other players can fill those orders with matching items.
• The requester receives the item and the filler receives the reward.

Menu-Based UX

• The mod is designed around menus instead of chat-heavy admin editing.
• Players can access shop, market, order, and history screens through in-game menus.
• This keeps the experience cleaner and avoids cluttered chat commands for standard actions.

History and Transparency

• Transaction history is stored for major economy actions.
• Players can view recent activity in a shop history menu.
• This improves trust and makes the server economy easier to monitor.

Commands

Player Commands

• /shop — open the server shop
• /market — open the player market
• /order — open the order menu
• /history — view recent shop activity
• /menu — open the main menu hub
• /balance — check your balance
• /sell — sell the held item to the server

Admin Commands

• /shopadmin reload — reload shop config files
• /eco reload — reload economy and config state

Intended Use

This mod is designed for multiplayer servers that want:

• a cleaner player economy,
• a flexible server shop,
• market-driven player trading,
• order-based item requests,
• and a more menu-friendly experience than traditional chat-based config editing.

Notes

This project is intentionally structured to favor config-driven setup, menu-first access, and economy automation. It is optimized for server admins who want to keep the game world cleaner while still offering a robust in-game economy system.