HTSellWands

Discord: https://discord.gg/y6RemcjSaD

HTSellWands lets your players sell the contents of chests and containers instantly with a single right-click. Create custom sell wands with different multipliers, limited uses, sound effects, and particle effects. Wands are fully configurable through an in-game UI or JSON files, and prices are set per item so you have complete control over your server's economy.

When a player right-clicks a container while holding a sell wand, every item inside that has a configured price gets sold automatically. The earnings are calculated as price x quantity x the wand's multiplier, then deposited straight into the player's balance. Items without a price stay in the container untouched. Each use costs one charge, and when the wand runs out it breaks.

Requires VaultUnlocked for economy integration. Works with any economy provider that registers through VaultUnlocked.

Commands

All commands are under /sellwand (alias /sw).

Command	Description
/sellwand give (player) (wand_id) [amount]	Give one or more wands to a player
/sellwand giveall (wand_id) [amount]	Give wands to every online player
/sellwand list	Show all configured wand types
/sellwand info (wand_id)	Display details about a specific wand
/sellwand setprice (item_id) (price)	Set the sell price for an item
/sellwand removeprice (item_id)	Remove an item's sell price
/sellwand pricelist [page]	List all configured item prices
/sellwand reload	Reload wands and prices from disk
/sellwand ui	Open the visual wand editor

Permissions

Permission	Description
htsellwands.admin	Access to the base /sellwand command
htsellwands.admin.give	Give wands to players
htsellwands.admin.giveall	Give wands to all online players
htsellwands.admin.list	List wand definitions
htsellwands.admin.info	View wand details
htsellwands.admin.setprice	Set item sell prices
htsellwands.admin.removeprice	Remove item sell prices
htsellwands.admin.pricelist	View the price list
htsellwands.admin.reload	Reload configuration files
htsellwands.admin.ui	Open the wand editor UI

Per-Wand Permissions

Each wand can optionally require its own permission before a player is allowed to use it. Set the "permission" field on any wand definition to a permission node of your choice. For example, if you set a wand's permission to "sellwand.use.premium", only players with that permission will be able to sell with it. Players without the permission will see a message telling them they don't have access. If you leave the permission field empty or don't include it, any player who has the wand in their hand can use it with no restrictions.

Configuration

The plugin creates two JSON files inside plugins/HTSellWands/ on first run.

wands.json — This is where your wand definitions live. Each wand has an id, a base item it clones its appearance from, a display name with color codes, a description template, a quality tier for the glow effect, max uses, a sell multiplier, and optional sound/particle effects. Here is an example:

{
"wands": [
{
"id": "htsellwands:basic_wand",
"baseItemId": "Tool_Growth_Potion",
"displayName": "Basic Sell Wand",
"description": "Right-click a chest to sell contents\nMultiplier: {multiplier}x\nUses: {uses_remaining}/{max_uses}",
"qualityIndex": 3,
"maxUses": 10,
"multiplier": 1.0,
"sellSound": "BlockPlace_Stone",
"sellSoundVolume": 1.0,
"sellSoundPitch": 1.2
},
{
"id": "htsellwands:premium_wand",
"baseItemId": "Tool_Growth_Potion",
"displayName": "Premium Sell Wand",
"description": "Right-click a chest to sell contents\nMultiplier: {multiplier}x\nUses: {uses_remaining}/{max_uses}",
"qualityIndex": 5,
"maxUses": 50,
"multiplier": 2.0,
"permission": "sellwand.use.premium",
"sellSound": "BlockPlace_Stone",
"sellSoundVolume": 1.0,
"sellSoundPitch": 0.8,
"sellParticle": "Combat_Crit_Attack",
"sellParticleScale": 1.0
}
]
}

The description field supports placeholders: {multiplier} shows the wand's sell multiplier, {max_uses} shows the total uses, and {uses_remaining} shows how many uses are left. Color codes use <color is=\"#FF22FF\">text</color> it is best to set this inside the json

item_prices.json — A simple mapping of item IDs to their base sell value. Only items listed here can be sold by wands. Anything not in this list stays in the container. Example:

{
"prices": {
"Food_Bread": 10.0,
"Ore_Copper_Stone": 25.0,
"Ore_Iron_Stone": 50.0,
"Ore_Gold_Stone": 100.0
}
}

You can also manage prices in-game using /sellwand setprice and /sellwand removeprice without editing the file.

How Selling Works

The final amount a player receives for each item is calculated as: base price x quantity x wand multiplier. So if bread is priced at 10, a chest has 64 bread, and the wand has a 2.0x multiplier, the player receives 1280. After selling, the wand loses one use regardless of how many items were in the container. When uses hit zero the wand is destroyed. The player always gets a chat message showing how many items were sold, the total earned, and how many uses remain.

Note About Tooltip Display

Due to limitations with how Hytale handles item tooltips, the uses remaining shown on the wand's tooltip may occasionally appear incorrect or not update visually right away. This is a display-only issue. The actual uses remaining are tracked accurately in the item's internal metadata and will always decrement correctly on each use. After every sell, the chat message will show the true number of uses left. The underlying data is always correct even if the tooltip lags behind.

HTSellwands