Numismatics treasury & Auction house

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, a global Auction House, and detailed economy statistics.

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
• Personal transaction history
• Player Shop statistics
• Operator-only server economy statistics

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
• Detailed sales and revenue statistics

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.

Stock can be withdrawn through a dedicated quantity selector.

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

History & Statistics

The History & Statistics interface provides a detailed overview of each player’s activity across Numismatics Treasury.

It records:

• Bank transfers sent and received

• Server Shop purchases and sales

• Player Shop sales and revenue

• Auction House purchases, sales, bids, refunds, and completed listings

  

The overview displays the player’s total money earned, spent, sent, and received, together with a scrollable list of recent activity.

Each Player Shop has its own statistics, including:

• Lifetime sales
• Total items sold
• Total revenue
• Best sale
• Activity over the last 24 hours, 7 days, and 30 days
• Revenue received by the owner and each associate
• Sorting by recent activity, sales, items sold, revenue, or best sale

Operators can also access server-wide statistics showing transaction volumes from transfers, Player Shops, Server Shops, the Auction House, and collected Auction House commissions.

Item entries preserve their complete tooltip information, including enchantments, custom lore, and modded components.

The interface includes local settings to hide the displayed bank balance or disable Treasury notifications.

History & Statistics can be opened from:

• The Transfer Teller
• Player Shop management
• /numismatics_treasury history

History data is stored separately from shops. Existing shops continue working normally and begin collecting statistics after installing this version. Transactions completed before installation cannot be reconstructed.

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 module can be enabled or disabled independently:

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

History & Statistics can also be enabled or disabled through its dedicated configuration section.

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 modules 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

History & Statistics Settings

The history section controls data collection, retention, and operator access:

"history": {
  "enabled": true,
  "retentionDays": 30,
  "maximumEntriesPerPlayer": 500,
  "maximumEntriesPerShop": 500,
  "recordTransfers": true,
  "recordServerShops": true,
  "recordPlayerShops": true,
  "recordAuctionHouse": true,
  "operatorGlobalStatistics": true
}

• enabled: enables or disables History & Statistics
• retentionDays: number of days transaction entries are retained
• maximumEntriesPerPlayer: maximum number of stored entries for each player
• maximumEntriesPerShop: maximum number of stored entries for each Player Shop
• recordTransfers: records direct bank transfers
• recordServerShops: records Server Shop transactions
• recordPlayerShops: records Player Shop transactions
• recordAuctionHouse: records Auction House activity
• operatorGlobalStatistics: allows operators to access server-wide statistics

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.