🪙 Economics (1.21.1)

🇬🇧 English Description

Economics is a complete, lightweight economy solution for Minecraft 1.21.1 servers and single-player worlds. It features a fully customizable server GUI shop, player-to-player chest shops, a full player-driven auction house with paper money, and built-in vanilla text display holograms for announcements and live rich-list leaderboards.

💬 Need help or have questions? Join our Discord server:
👉 Join Support Discord

✨ Key Features

🛒 1. Server GUI Shops (/shop)

• Interactive GUI: Fast and visual buying and selling menu.
• 100% JSON Configurable: Create and customize shop categories by adding .json files to config/economics/shop/.
• Modded Item Support: Fully supports items from other mods using namespaces (e.g., create:brass_ingot).
• Error Prevention: If a modded item is missing, it skips that entry gracefully without crashing or breaking the shop.
• Live Reloading: Apply changes instantly using /economics reload (requires OP).

📦 2. Player Chest Shops

Allow players to set up their own physical shops using chests or barrels to automate trading.

How to Create a Chest Shop:

1. Place a chest or barrel on the ground.
2. Put the item to sell/buy inside. The first item stack in the inventory serves as the template.
3. Place a sign on the chest (side or top).
4. Write the sign lines as follows:
   • Line 1: [shop] (or the configured header)
   • Line 2: Quantity (e.g., 64 or 1)
   • Line 3: Price (e.g., B10:S5, B10 for buy-only, or S5 for sell-only)
   • Line 4: (Optional / Leave blank)
5. Right-click the sign to activate it. The sign will format automatically and wax itself to prevent unauthorized edits.

Price Formatting (Line 3):

• B10:S5 → Customers pay $10 to buy a lot and receive $5 when selling a lot.
• B15 → Buy Only (customers pay $15 per lot).
• S8 → Sell Only (customers sell items to the owner for $8).

Interactions:

• Right-Click Sign: Buy one lot.
• Left-Click Sign: Sell one lot.
• Protection: Only the shop owner or server admins can open or break the registered container and sign.

🏛️ 3. Auction House (/ah) — NEW in 1.2!

A full player-driven, bid-based auction system — no plugins required, just vanilla-friendly GUIs.

• /ah opens the Auction House: browse every active auction on the server in a paginated double-chest GUI.
• /ah add <starting_price> <bid_increment> <hours> lists the item currently in your hand (hours between 1 and 24). The whole server gets a broadcast, e.g.: > AkorpuzZ listed 1x Gold Apple on auction! Starting price: $500, bid increments of $25.
• Bidding: click any listing to open the bid screen, where you can step your bid up by +1/+5/+10 increments before confirming. Outbid players are refunded automatically, even while offline.
• My Auctions: manage your own active listings; auctions with no bids yet can be cancelled and returned to you.
• Collection Box: collect items you won, or your own items that didn't sell — proceeds from sales are deposited straight into the seller's balance, no manual claim needed.
• Configurable: limit how many auctions a player can have active at once via config/economics/config.json.

💵 4. Paper Money & Currency Exchange — NEW in 1.2!

• Physical banknotes in six denominations: $1, $5, $10, $50, $100 and $1000 — real, tradeable items you can carry, store, or hand to other players.
• Exchange House: a new category inside /shop where you buy and sell every banknote 1:1 against your balance, just like a currency exchange booth. Rates are editable in config/economics/shop/exchange.json.

📜 5. Vanilla Text Display Holograms (/holo)

• No Client Mods Needed: Uses vanilla TextDisplay entities, readable by any client.
• In-Game Commands:
  • /holo create <id>: Create a hologram at your position .
  • /holo addline <id> <text>: Add a line with color code support (&).
  • /holo setline <id> <line> <text>: Edit a specific line .
  • /holo removeline <id> <line>: Remove a line .
  • /holo movehere <id>: Move the hologram to your location .
  • /holo teleport <id>: Teleport to the hologram .
  • /holo list / /holo info <id>: View list and stats .
• Automated Leaderboards: Create live economic rankings showing top richest players.

📋 Commands & Permissions

• /shop — Opens the main server shop GUI, including the Exchange House.
• /ah — Opens the Auction House GUI.
• /ah add <starting_price> <bid_increment> <hours> — Lists the item in your hand for auction (1–24 hours).
• /economics reload — Reloads configs and shop JSONs (OP level 2).
• /holo <subcommand> — Hologram and leaderboard management (OP level 2) .

🇪🇸 Descripción en Español

Economics es una solución económica completa y ligera para servidores y mundos locales de Minecraft 1.21.1. Incluye una tienda GUI de servidor totalmente personalizable, tiendas en cofres para comercio entre jugadores, una casa de subastas completa con papel moneda, y hologramas flotantes vanilla para anuncios y listas de los más ricos en tiempo real.

💬 ¿Necesitas ayuda o tienes dudas? Únete a nuestro servidor de Discord:
👉 Unirse al Discord de Soporte

✨ Características Principales

🛒 1. Tiendas del Servidor (/shop)

• Menú GUI Interactivo: Acceso rápido y visual a la compra y venta de objetos.
• 100% Configurable vía JSON: Crea y personaliza categorías guardando archivos .json en config/economics/shop/.
• Soporte para Mods: Compatible con objetos de otros mods usando namespaces (ejemplo: create:brass_ingot).
• Protección contra Errores: Si falta un objeto modificado, la entrada se omite sin interrumpir la tienda.
• Recarga en Vivo: Aplica cambios al instante con /economics reload (requiere OP).

📦 2. Chest Shops (Tiendas entre Jugadores)

Permite a los jugadores crear tiendas físicas usando cofres o barriles para automatizar el comercio.

Cómo Crear una Chest Shop:

1. Coloca un cofre o barril en el mundo.
2. Guarda el objeto a vender/comprar dentro del cofre. El primer objeto del inventario servirá como plantilla.
3. Coloca un cartel pegado al cofre (lateral o superior).
4. Escribe las líneas del cartel:
   • Línea 1: [shop] (o el encabezado configurado)
   • Línea 2: Cantidad (ejemplo: 64 o 1)
   • Línea 3: Precio (ejemplo: B10:S5, B10 solo compra, o S5 solo venta)
   • Línea 4: (Opcional / Puedes dejarla en blanco)
5. Haz clic derecho en el cartel para activarlo. El cartel se formateará automáticamente y se protegerá con cera.

Formatos de Precio (Línea 3):

• B10:S5 → Los clientes pagan $10 por comprar y reciben $5 al vender un lote.
• B15 → Solo Compra (los clientes pagan $15 por lote).
• S8 → Solo Venta (los clientes venden el objeto al dueño por $8).

Interacción:

• Clic Derecho en el Cartel: Comprar un lote de objetos.
• Clic Izquierdo en el Cartel: Vender un lote de objetos.
• Protección: Solo el dueño o los administradores pueden abrir o romper el cofre y el cartel.

🏛️ 3. Casa de Subastas (/ah) — ¡NUEVO en 1.2!

Un sistema de subastas completo entre jugadores, basado en pujas — sin plugins, con GUIs 100% vanilla-friendly.

• /ah abre la Casa de Subastas: navega todas las subastas activas del servidor en un menú de doble cofre paginado.
• /ah add <precio_inicial> <incremento_puja> <horas> sube a subasta el ítem que traes en la mano (horas entre 1 y 24). Todo el servidor recibe un anuncio, por ejemplo: > AkorpuzZ ha subido a subasta 1x Manzana de Oro. Precio inicial: $500, pujas de $25.
• Pujar: haz clic en cualquier subasta para abrir la pantalla de puja, donde puedes ajustar cuánto pujar en pasos de +1/+5/+10 incrementos antes de confirmar. A los jugadores superados se les reembolsa automáticamente, incluso estando desconectados.
• Mis Subastas: administra tus propias subastas activas; las que aún no tienen pujas se pueden cancelar y se te devuelve el ítem.
• Caja de Recolección: recoge los objetos que ganaste, o los tuyos que no se vendieron — el dinero de las ventas se deposita directo al balance del vendedor, sin necesidad de reclamarlo manualmente.
• Configurable: limita cuántas subastas puede tener activas un jugador a la vez desde config/economics/config.json.

💵 4. Papel Moneda y Casa de Cambio — ¡NUEVO en 1.2!

• Billetes físicos en seis denominaciones: $1, $5, $10, $50, $100 y $1000 — objetos reales e intercambiables que puedes cargar, guardar o entregar a otros jugadores.
• Exchange House: una nueva categoría dentro de /shop donde compras y vendes cada billete 1:1 contra tu balance, como una casa de cambio real. Las tasas son editables en config/economics/shop/exchange.json.

📜 5. Módulo de Hologramas Flotantes (/holo)

• Sin Mods en el Cliente: Usa entidades TextDisplay de Minecraft vanilla.
• Comandos In-Game:
  • /holo create <id>: Crea un holograma en tu posición .
  • /holo addline <id> <texto>: Añade una línea (soporta códigos de color &).
  • /holo setline <id> <línea> <texto>: Modifica una línea existente .
  • /holo removeline <id> <línea>: Elimina una línea .
  • /holo movehere <id>: Mueve el holograma a tu ubicación .
  • /holo teleport <id>: Telepórtate al holograma .
  • /holo list / /holo info <id>: Muestra información y lista de hologramas .
• Leaderboards Automáticos: Muestra el ranking en tiempo real de los jugadores más ricos.

🔧 Requirements & Installation / Requisitos e Instalación

• Minecraft Version / Versión: 1.21.1
• Mod Loader / Cargador: NeoForge / Forge
• Installation: Drop the .jar file into your server and client mods folder.