Numismatics Treasury

Overview

Numismatics Treasury is a NeoForge 1.21.1 addon for Numismatics that expands its banking system with direct transfers, configurable shops, player-owned stores, and a global Auction House.

All transactions use Numismatics bank accounts directly. Players do not need to carry physical coins or manually convert currency before buying, selling, bidding, or transferring money.

The mod includes English text and a complete French translation.

Includes

• Direct bank transfers with /pay
• Auction House
• Transfer Teller block
• Portable Transfer Terminal
• Operator-managed Server Shops
• Player Shops
• Shared Player Shop revenue

Features

Bank Transfers

Transfer money directly between Numismatics bank accounts with:

• The /pay <player> <amount> command
• The Transfer Teller block
• The Portable Transfer Terminal

Known player names can be completed automatically, including offline players who already have a Numismatics account.

Server Shops

Server Shops are controlled by operators and use unlimited server stock and funds.

Administrators can configure:

• The displayed item
• The transaction type
• The number of items per lot
• The price of each lot

A Server Shop can either sell items to players or buy items from them. Payments are taken from or deposited directly into the player’s bank account.

Server Shops have no crafting recipe and are intended to be distributed by server administrators.

Player Shops

Player Shops allow players to sell one configured item.

Each shop provides:

• One unlimited-capacity stock slot
• A configurable lot size and price
• Direct payments through Numismatics bank accounts
• Automatic item insertion through hoppers, funnels, and compatible transfer systems
• A filter that only accepts the configured item
• Support for multiple associates and shared revenue

The shop owner can add up to 16 associates and assign an individual revenue percentage to each one. The combined associate shares cannot exceed 100%.

Revenue is distributed directly between the owner’s and associates’ Numismatics bank accounts after every sale. Any remaining amount and all rounding differences are paid to the owner.

Associates are managed through a dedicated scrollable interface. Player names support Tab completion, including offline players who already have a Numismatics account.

Associates receive a notification when they are added to a shop and whenever their revenue percentage changes. Notifications are stored and delivered later if the player is offline.

The owner, linked associates, and server operators can manage the shop. Only the owner or a server operator can modify the associate list and revenue percentages.

A Player Shop cannot be broken until its stock has been emptied.

Global Auction House

Every Auction House block opens the same server-wide marketplace.

Players can:

• Create direct-sale listings
• Create timed auctions
• Browse listings from every player
• Place bids using their bank balance
• Manage their active listings
• Collect pending items from the Claims page

Auction bids are held securely until the auction ends. Outbid players are refunded, and the winning payment is transferred after the configurable commission is applied.

Purchased items are placed directly into the player’s inventory whenever possible. Items that cannot be delivered safely remain available on the Claims page.

Players can receive notifications for purchases, bids, outbids, sales, and completed listings, including notifications stored while they are offline.

Configurable Modules

Each major feature can be enabled or disabled independently:

• /pay
• Transfer Teller
• Portable Transfer Terminal
• Server Shop
• Player Shop
• Auction House

When a block module is disabled, its recipe is removed after the server configuration is reloaded, and already placed blocks become inactive.

Configuration

The server configuration is stored in:

config/numismatics_treasury.json

The file is generated automatically on the first server launch. It only needs to be edited on the server; relevant settings are synchronized with connected clients.

Apply changes without restarting the server with:

/numismatics_treasury reload

This command requires operator permissions.

Module Settings

The modules section controls which features are available:

"modules": {
  "payCommand": true,
  "bankTeller": true,
  "portableTransferTerminal": true,
  "serverShop": true,
  "playerShop": true,
  "auctionHouse": true
}

Set a value to false to disable that module.

Payment Limits

The pay section defines the minimum and maximum amount allowed for a transfer:

"pay": {
  "minimum": 1,
  "maximum": 2000000000
}

Auction House Settings

The auctionHouse section controls marketplace limits and fees:

"auctionHouse": {
  "commissionPercent": 5.0,
  "maximumListingsPerPlayer": 20,
  "minimumPrice": 1,
  "maximumPrice": 2000000000,
  "allowedDurationsHours": [
    1,
    6,
    12,
    24,
    48
  ]
}

• commissionPercent: percentage removed from completed sales
• maximumListingsPerPlayer: maximum number of simultaneous listings per player
• minimumPrice: lowest accepted price or starting bid
• maximumPrice: highest accepted price or starting bid
• allowedDurationsHours: listing durations available in the interface

Requirements

• Minecraft 1.21.1
• NeoForge 21.1.242 or later for Minecraft 1.21.1
• Numismatics 1.0.20 or later

Numismatics is the only mod dependency declared by Numismatics Treasury.