🪙 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, 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. 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.
• /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 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. 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.