TDEconemy

TDEconemy is a server-authoritative economy and shop platform for Minecraft servers. It provides secure virtual currency, personal and shared accounts, configurable item and mob shops, in-game management interfaces, administrative tools, and transaction protection.

The mod must be installed on both the server and every connecting client. Compatible TDEconemy versions are required on both sides.

All balances, permissions, account access, shop changes, purchases, and administrative actions are validated by the server. Client interfaces only display server-provided data and submit requests; they never decide economy outcomes.

TDEconemy uses virtual in-game currency only. It does not use, represent, exchange, or interact with real-world money.

Features

• Personal player balances and direct money transfers
• Independent player-managed group accounts
• Craftable Account Terminal and Group Account Contract
• Named administrative system accounts
• Dedicated craftable Shop Boards with graphical editors
• Item buy and sell shops with finite or infinite storage
• Variable shop quantities and live stock or capacity displays
• Purchases using personal or authorized group accounts
• Configurable, datapack-driven mob shops
• Reusable exact and template shop presets
• Searchable account, group, shop, player, mob-template, and preset selectors
• Complete in-game player and operator management interfaces
• Expensive-purchase and variable-quantity confirmation screens
• Server-side validation, shop indexing, locking, and repair tools
• Protection against unsafe duplicated or copied shop data
• Atomic money and item transactions with rollback protection
• Optional asynchronous MariaDB audit logging
• Local append-only JSONL audit fallback
• Optional FTB Quests money rewards
• Optional Xaero Minimap shop waypoints
• English and German localization

Account Management

Players can open the account dashboard with /money or by using the craftable TDEconemy Account Terminal.

The dashboard displays the player’s personal balance, accessible group accounts, owned shops, account roles, members, and linked shops. Players can transfer whole-number amounts from their personal account or an authorized group account. Every transfer is checked and executed atomically by the server.

All currency values are non-negative whole numbers. Decimal amounts are not supported, and arithmetic is checked against overflow and invalid states.

Group Accounts

Group accounts are independent shared accounts managed by players. They do not require FTB Teams.

A player creates a group using the craftable tdeconemy:group_account_contract. The required creation item, ownership limit, and membership limit are configurable by the server.

Group accounts support:

• Confirmed player invitations
• Owners and regular members
• Shared deposits, withdrawals, and payments
• Group-funded shop purchases
• Shops linked to the group account
• Ownership transfer to an existing member
• Member removal and voluntary departure
• Group renaming
• Controlled archiving and operator reactivation

The creator becomes the group owner. Members may use the group balance and manage eligible group-linked finite item shops, but they cannot change ownership, enable administrative shop features, or manage other members unless they are the owner.

System Accounts

Operators can create named system accounts for controlled server economies:

• Finite: Uses and stores a limited balance.
• Source: Provides unlimited outgoing funds but rejects incoming payments.
• Sink: Accepts unlimited incoming payments but cannot provide outgoing funds.
• Infinite: Accepts and provides unlimited funds.

System-account behavior affects money only. It never automatically enables infinite shop storage.

Archived accounts retain their identity, balance, and existing shop links, but cannot receive new links.

Item Shops

TDEconemy uses its own full-height wall-mounted Shop Board instead of editable vanilla signs.

Place a Shop Board against a supported inventory such as a barrel or chest. A structured editor opens automatically and allows the owner to configure:

• Whether the shop buys from or sells to customers
• The traded item
• Minimum and maximum quantities
• Fixed or storage-dependent quantity limits
• Whole-number prices
• Two custom display lines
• The payment account
• Finite or infinite storage
• An internal searchable management name

The Shop Board displays the trade direction, custom text, price, quantity range, and current stock or available storage capacity.

Shop ownership, payment account, and storage mode are independent:

• Owner controls who may manage the shop.
• Account determines where money is received from or paid to.
• Storage determines whether a real attached inventory is used.

This allows combinations such as a player-managed shop funded by a system account while still using real inventory stock.

Secure Transactions

Before an item transaction is applied, TDEconemy validates:

• The current shop identity and revision
• Shop index and location
• The selected quantity and total price
• Customer and shop funds
• Item availability
• Destination inventory capacity
• Payment-account access
• Storage configuration
• Player distance and dimension
• Current server-side permissions

Money and items are planned before anything is changed. If the inventory changes unexpectedly or a later step fails, TDEconemy performs compensating transfers and item rollback. Items that cannot be restored are returned to the player or dropped instead of being silently deleted.

Expensive purchases and variable-quantity trades use a dedicated confirmation screen. The server checks whether the transaction is currently possible before opening the screen and validates the complete transaction again when the player confirms it.

Shop Management and Protection

Players can inspect and manage their shops from the account dashboard. Authorized owners and group members may remotely edit loaded shops without having to stand beside them.

Operators receive an additional management center for:

• Player balances
• Active and archived group accounts
• System accounts
• All indexed shops
• Mob shops
• Shop presets
• Validation and controlled repairs

Copied or duplicated Shop Boards are reconciled through their persistent identity and shop index. When the original shop cannot be identified safely, the copied shop remains closed instead of guessing and risking duplicated money, stock, or permissions. Operators can inspect and repair affected shops through confirmed administrative workflows.

If Xaero Minimap is installed, the shop list can create a temporary waypoint for a selected shop. Xaero is entirely optional.

Mob Shops

Operators can convert suitable item shops into controlled mob shops.

Mob shops use datapack-defined entity templates and configured spawn positions. They never execute arbitrary command strings.

Templates may define ordinary entity data such as equipment, attributes, names, and persistence. Unsafe identity and placement fields are removed before spawning. Operators can configure:

• Entity template
• Spawn location and dimension
• Price and payment account
• Display text
• Per-player cooldown
• Rolling usage limits

The template, spawn location, loaded chunk, usage limits, and entity preparation are validated before payment. A failed spawn does not leave the customer charged.

Shop Presets

Operators can save reusable shop configurations as presets:

• Exact presets retain ownership, payment account, storage, output, price, and display settings.
• Template presets create a new finite item shop for a selected player.

Preset placement creates a barrel and attached Shop Board together. Placement validates both target positions and restores the original blocks if any part of the operation fails.

Audit Logging

Minecraft SavedData remains authoritative for balances, accounts, group memberships, shops, presets, and transaction decisions.

MariaDB support is optional and audit-only. Database availability never controls balances, permissions, or transaction results.

Audit events are delivered asynchronously. If MariaDB is unavailable, events are written to immutable local JSONL segments and replayed later. Duplicate delivery is handled idempotently, and malformed segments are quarantined instead of silently discarded.

Optional Integrations

TDEconemy does not require FTB Library, FTB Teams, FTB Quests, or Xaero Minimap.

When FTB Quests and the libraries required by the installed FTB Quests version are present, TDEconemy registers an optional whole-unit money reward. Compatibility code remains inactive when those mods are absent.

Xaero Minimap support adds temporary waypoints for shops listed in the account dashboard.

Requirements

• Minecraft 1.21.1
• NeoForge 21.1.248 or a compatible newer 21.1 release
• Java 21
• TDEconemy installed on both the server and every client

No additional mod is required for the core economy, group-account, or shop functionality.

Important Compatibility Notice

TDEconemy is not a drop-in data migration for legacy Money and Sign Shops or DiceMC Money Mod worlds. Old shop signs, identifiers, account layouts, and unsupported persistence schemas are not silently reinterpreted.

Always create a complete world backup before installing TDEconemy or changing between incompatible versions. Never run multiple TDEconemy JAR versions at the same time.

Credits and Fork Information

TDEconemy was originally based on the MIT-licensed Money and Sign Shops / DiceMC Money Mod project by Caltinor.

Since the fork, the project has been substantially redesigned and extended with its own server-authoritative account model, independent group and system accounts, custom Shop Boards and interfaces, transactional item and mob shops, presets, administrative management tools, audit infrastructure, networking, localization, persistence validation, and automated tests.

TDEconemy is independently developed and maintained by Taker. It is not maintained by or affiliated with the original author. The original copyright and MIT License notices are retained.