Commands & configuration

Commands

Command tree

Start here. * requires permission level 2. < > marks a required value, [ ] an optional value, and | a choice. Do not type the brackets.


/valemShow help
├─ pricePrice command help
│  ├─ show [item_id]View price and status
│  ├─ set <price>Price the held item *
│  ├─ set <item_id> <price>Price a specific item *
│  └─ reset [item_id]Restore default pricing *
├─ banBan command help
│  ├─ add [item_id]Block trading *
│  ├─ remove [item_id]Remove a ban *
│  └─ list [page]List banned items
├─ reloadReload both JSON files *
├─ pay <online_player> <amount>Pay from personal funds
└─ teamShow team overview
   ├─ create <name>Create a team
   ├─ membersList members
   ├─ invite <online_player>Invite a player (owner)
   ├─ accept <team_name>Accept an invitation
   ├─ decline <team_name>Decline an invitation
   ├─ leaveLeave your team
   ├─ kick <player>Remove a member (owner)
   ├─ transfer-owner <player>Transfer ownership (owner)
   ├─ disbandDisband an empty wallet team (owner)
   └─ walletShow balances and active wallet
      ├─ use personalUse your personal wallet
      ├─ use teamUse the team wallet
      ├─ deposit <amount|all>Personal → team wallet
      ├─ withdraw <amount|all>Team wallet → yourself
      └─ pay <online_player> <amount>Team wallet → another player

Input and permissions

Enter commands in chat with a leading /; Tab offers completion. The server console can omit the /. Payment and team commands must be run by a player in-game.

Price queries, the ban list, personal payments and ordinary team actions do not require OP. Setting or resetting prices, editing bans and reloading require permission level 2 or higher: enable cheats in single-player or obtain server permissions. Owner actions require team ownership.

Use /valem for help, or /valem price and /valem ban for their command groups. The price and ban help lists available actions according to your permissions.

Item IDs and held items

An item ID is a registry name such as minecraft:diamond, not a display name such as Diamond. Enable advanced tooltips with F3 + H and hover over an item, or use Tab completion in commands.

You may omit the ID for show, reset, ban add and ban remove; set may take just a price. The main-hand item is used first, then the off-hand item if the main hand is empty. Empty hands fail. An explicit ID takes precedence; the server console requires one. Changes apply to the item type, not a single stack or an individual NBT variant.

View, set and reset prices

You can also use the graphical interface: open Settings at the top right of the terminal, then General Settings → Item Pricing. Search by item name, pinyin or ID, select the item, enter a price and click Set Price. The same page can restore default pricing, ban trading or remove a ban. These controls also require permission level 2 or higher; successful changes are saved and applied automatically, with no extra reload.

View price and status

/valem price show minecraft:diamond

Shows the current base price and its source, or reports banned, unpriced or ineligible status. With personal price fluctuation enabled, use the trading screen for the actual order quote.

Set a price

/valem price set minecraft:diamond 100

Sets the diamond base price to 100. When holding a diamond, /valem price set 100 does the same. Prices must be positive, with at most two decimal places; do not use $, K, M, grouping commas or scientific notation. Unban an item before setting its price. Ineligible items such as banknotes cannot be priced.

Restore default pricing

/valem price reset minecraft:diamond

Removes the item entry from the price JSON and lets built-in or recipe pricing apply again. It does not restore your previous custom value or guarantee a price can be found. It does not lift an existing ban.

When a price or ban command changes the configuration, it saves the file and recalculates prices automatically; no extra reload is needed. Pricing does not unlock purchases. Normally a player must first sell the item successfully, unless the administrator enables Unlock All Items.

Ban and unban items

Ban an item

/valem ban add minecraft:diamond

Adds diamonds to the ban list, blocking both buying and selling. Any custom price remains in the price file but cannot take effect while the ban is active.

Remove a ban

/valem ban remove minecraft:diamond

Removes diamonds from the ban list. A saved custom price applies again; otherwise built-in or recipe pricing is used. Removing a ban does not create a price by itself.

List banned items

/valem ban list 1

Pages start at 1, with 8 items per page; omit the page number for page 1. Use price show to check an individual item.

Reload configuration

/valem reload

Run this after editing and saving the two JSON files. It rereads prices and bans, recalculates the catalog and synchronizes it to players without a game restart.

This is not vanilla /reload: it does not reload datapacks or client appearance settings. If it fails, correct the reported file and entry, then retry. See Configuration errors below.

Personal payments

/valem pay Alex 100.50

Pays online player Alex from your personal wallet. It always uses personal funds, even when the trading screen is set to the team wallet. You cannot pay yourself.

Amounts must be positive with at most two decimal places, using the same format as prices. all is not supported. Insufficient funds or exceeding the recipient’s balance limit rejects the entire transfer.

Teams and wallets

You can belong to one team. Personal and team balances are separate; joining does not move your money. Every member can use shared funds, while the owner manages membership.

View your team

/valem team

Shows your team and owner, or instructions for creating or joining a team.

Create a team

/valem team create "矿工小队"

Names are 1–24 characters and case-insensitive; wrap names containing spaces in double quotes. The creator becomes owner; the new team wallet starts at 0.

List members

/valem team members

Lists the members of your current team.

Invite a player

/valem team invite Alex

Owner only; Alex must be online. Invitations expire after 5 real-time minutes and do not survive a server restart.

Accept an invitation

/valem team accept "矿工小队"

Joins the team that invited you. Use Tab to complete a pending team invitation.

Decline an invitation

/valem team decline "矿工小队"

Declines that team’s invitation.

Leave a team

/valem team leave

Members may leave directly. The owner must first transfer ownership or disband. Leaving does not automatically withdraw a share of team funds.

Remove a member

/valem team kick Alex

Owner only; the target must be a teammate. Known offline members can also be removed. You cannot kick yourself.

Transfer ownership

/valem team transfer-owner Alex

Transfers ownership to another teammate, including a known offline member. You remain in the team.

Disband the team

/valem team disband

Owner only; the team wallet must be empty. Disbanding takes effect immediately, so settle funds and arrangements with members first.

View wallet balances

/valem team wallet

Shows personal and team balances and the active trading wallet. You can view your personal wallet without joining a team.

Choose a trading wallet

/valem team wallet use team
/valem team wallet use personal

Chooses the wallet used for terminal trades; use team requires membership. Switching does not move any funds.

Deposit into the team wallet

/valem team wallet deposit 100

Moves personal funds into the team wallet. Replace the amount with all to move the entire personal balance. This is not a bank term deposit.

Withdraw from the team wallet

/valem team wallet withdraw 100

Moves team funds into your personal wallet. Replace the amount with all to withdraw the entire team balance. Every member can do this.

Pay from team funds

/valem team wallet pay Alex 80.25

Pays online player Alex’s personal wallet from team funds. Alex need not be a teammate, but cannot be you; use withdraw for yourself. all is not supported here.

Configuration files

Locations and applying changes

Both files live in config/valemetry/ under the active game instance or server directory. Enter a world or start the server once to generate them. In multiplayer, edit the server files; local client copies cannot change server prices.

config/valemetry/
├── item_values.json
└── item_bans.json

Back up the files, edit them as plain text, save as UTF-8 and run /valem reload. JSON does not allow comments or trailing commas. Single-player worlds in the same instance share these files; they are not per-world files.

item_values.json: override and add prices

The price file uses { }, with item IDs on the left and base prices on the right. These values illustrate the format; they are not recommended prices.

{
  "minecraft:diamond": 100,
  "minecraft:iron_ingot": 12.50
}

Prices must be positive numbers with at most two decimal places, without quotes. Version 1.2.0 no longer accepts 0; use the ban list to disable trading.

First creation and later loads differ

If the file is missing, the mod writes its bundled vanilla prices into a new JSON file. Existing files are only read: updating the mod neither rewrites them nor inserts new entries.

At each calculation, built-in base prices are loaded first, then JSON overrides are applied. If both contain an item, JSON wins. JSON-only items are added; built-in-only items keep their built-in prices. Remaining items are priced from recipes where possible; unresolved items stay unpriced. Bans and trading eligibility still apply.

Delete one entry: remove its custom price. A built-in price applies if available; otherwise recipe pricing is attempted. This neither sets the price to 0 nor bans the item.
Save an empty object {}: remove all custom overrides while retaining built-in and recipe pricing.
Delete the file: the next load creates a fresh file from bundled defaults. Custom edits in the deleted file are not retained.

For example, if the built-in diamond price is A and JSON says 100, 100 applies. Deleting that entry restores A. For another mod’s item without a built-in price, deleting its override leaves recipe pricing to find a value; a price is not guaranteed.

item_bans.json: the file is the active list

The ban file uses [ ], containing item ID strings. Listed items cannot be bought or sold and have no displayed trade price. A ban wins even if the price file gives the item a positive value.

[
  "minecraft:emerald",
  "minecraft:emerald_block"
]

The bundled default bans are emeralds and emerald blocks. They are only used to create the JSON when it is missing. Once the file exists, its contents are the complete active list; bundled defaults are not merged back in.

Remove an ID from the array: lift that ban. Trading still requires a valid price and item eligibility.
Save an empty array []: remove every ban in this list, including the default emerald bans.
Delete the file: the next load recreates the defaults, banning emeralds and emerald blocks again.

Banning does not delete a saved custom price. If you temporarily ban diamonds and later unban them, their saved custom price can apply again.

Unpriced, banned and ineligible items

Unpriced does not mean priced at 0. An item from a newly installed mod may lack a built-in or custom price and a solvable recipe. It simply stays unpriced, without belonging to another list. It cannot currently trade and does not display a price of 0. Adding a usable price lets it participate in pricing.

A ban is an administrator’s decision to block trading. Being unpriced means no price is available. Both prevent trading, but the remedy differs: lift a ban, or provide enough pricing information.

Valemetry’s own items also have a fixed eligibility rule. The trade console, portable terminal, and blank, crafting, furnace, pipe and batch-selling upgrades are eligible: seven items in total. This rule applies only to the valemetry namespace; it does not exclude other mods wholesale.

Banknotes are outside those seven items. Emptying the ban JSON or adding a manual price entry cannot make them tradable; pricing commands and the pricing screen reject them. Their denomination is fixed by the banknote type and used for equal-value bank deposits and withdrawals. Other items must still pass item-state checks; a custom price does not bypass them.

Configuration errors

Read the in-game message, then check logs/latest.log for the file, entry and cause. Common mistakes include missing or trailing commas, invalid IDs, duplicate price entries, and prices written as 0, negative numbers or strings.

A well-formed positive price for an unregistered item is kept in the file, warned about and left inactive. An unregistered ID in the ban file instead rejects the entire update, so a broken ban list cannot be partially applied.

If reloading fails, the previous valid prices and bans remain active for the current run. If startup has no valid configuration, item trading is paused. Fix the file and run /valem reload again; a failed load does not rewrite your files.

Trading settings are separate

Sell payout, daily limits, transaction time, processing costs, price fluctuation and unlocking all items are changed in the terminal’s Trading Settings, requiring permission level 2 or higher. They are saved with the current world, not in these JSON files, and do not require a manual /valem reload.

Local UI preferences

Personal colors, backgrounds, UI style, main-screen fullscreen and sorting preferences are stored in config/valemetry-client.toml. Normally you can edit them in-game without writing TOML. Imported background copies live in config/valemetry/; include them when backing up your appearance settings.

These settings affect only the local display. They do not store wallet balances or alter server prices. /valem reload does not reload this client file.