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, 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
• Global Auction House
• Transfer Teller block
• Portable Transfer Terminal
• Operator-managed Server Shops
• Player-owned shops

Features

Bank Transfers

Transfer money directly between Numismatics bank accounts using:

• 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 unit price

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 unit price
• Direct payments to the owner’s bank account
• Automatic item insertion through hoppers, funnels, and compatible transfer systems
• A filter that only accepts the configured item

Only the owner or a server operator can configure or break the shop. 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 reloads and already placed blocks become inactive.

Configuration

The server configuration is stored in:

config/numismatics_treasury.json

The file is generated automatically when the server is launched for the first time. 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.