Kobase Traders

kobasetraders · by dkosin · license MIT

v1.0.2Minecraft 1.20.1 up to (not incl.) 1.21Forge 47.2 or newerclient + server

Traders exactly the way you want them: any look – creature, player skin or villager –, your own trades, shop areas, routes and opening hours, all set up in game with the Trader Wand.

⬇ Download v1.0.2 · 360 KB

Overview

With the Trader Wand you place traders wherever you like and set them up in an editor with four tabs: Appearance, Trades, Behaviour and Presets. A 3D preview turns on the right; every change shows up at once – in the preview and on the trader in the world.

Trading happens in Minecraft's normal trading screen: paying, shift-clicking and a full inventory work exactly like with villagers.

Any look

Any creature from vanilla and mods (with search and live preview, colours and variants for many animals), a player skin by name or UUID, or a villager with biome, profession and badge. Plus size 0.5–2, name and title line.

Your own trades

Price, second price and goods are free to choose – with amount and NBT (enchantments, names). Per trade: stock or unlimited, trader XP, price factor, demand, special price and trade level.

Restock & levels

Stock refills never, daily at a set time, every n minutes or like villagers. Optionally, trades unlock level by level.

Behaviour

Stand and look at players, wander in an area around the home point or follow a route of waypoints (loop or there and back, with pauses).

Opening hours

From–to, also across midnight. Outside them the trader shows “Closed · opens 08:00”, goes home, or goes home and sleeps. A greeting of up to 4 lines as a card, in chat or both.

Presets & templates

Save, load and share your own presets as JSON. Ready-made role templates: blacksmith, baker, farmer, librarian, cartographer, bank, jeweller, animal dealer, wandering trader mix and Kobase Shop.

Safe for servers

Invulnerable and persistent (configurable), not pushable. The server checks every input: permissions, limits, deny lists for items and models, NBT size.

Preview

Traders in the world – a villager blacksmith, a horse, an iron golem, a player skin, a snow fox, a closed and a sleeping — **Traders in the world** – a villager blacksmith, a horse, an iron golem, a player skin, a snow fox, a closed and a sleeping trader, each with name and title line.Real screenshot of a development build (game language English)

Appearance: creature – search over all creatures (vanilla and mods) and ready-made variants, here horse colour and marki — **Appearance: creature** – search over all creatures (vanilla and mods) and ready-made variants, here horse colour and markings.Real screenshot of a development build (game language English)

Trades – trades with price, second price and goods, stock, XP, price factor, demand, level and a test buy; at the top re — **Trades** – trades with price, second price and goods, stock, XP, price factor, demand, level and a test buy; at the top restock and levels.Real screenshot of a development build (game language English)

Behaviour – stand, area or route with waypoints, home point, opening hours, greeting and properties. — **Behaviour** – stand, area or route with waypoints, home point, opening hours, greeting and properties.Real screenshot of a development build (game language English)

Presets – role templates such as blacksmith, bank or animal dealer, own presets as JSON files to share. — **Presets** – role templates such as blacksmith, bank or animal dealer, own presets as JSON files to share.Real screenshot of a development build (game language English)

Trading in Minecraft's normal trading screen, with the trader's greeting card above it. — **Trading** in Minecraft's normal trading screen, with the trader's greeting card above it.Real screenshot of a development build (game language English)

Closing time – outside the opening hours this trader goes home and sleeps (“Zzz”). — **Closing time** – outside the opening hours this trader goes home and sleeps (“Zzz”).Real screenshot of a development build (game language English)

Controls

Input	Effect
Right-click a block with the Trader Wand	place a new trader and open the editor (permission needed)
`Sneak` + right-click a trader with the wand	open the editor
Right-click a trader	trade
Editor → Behaviour → Route → Record	the editor closes; right-clicking blocks adds waypoints, `Sneak` + right-click into the air finishes recording
Editor → Behaviour → Home With wand	the next block you click becomes the home point
Editor: Apply / Done / Cancel	send to the server / send and close / discard

The server decides who may place and edit traders (by default operators and players in creative mode; whoever placed a trader may always edit it). An invulnerable trader can only be removed in the editor or with /kill.

Items & Recipes

Recipes

Trader Wand – 1× Iron Ingot, 2× StickIron ingot top right, two sticks diagonally below it. — **Trader Wand** – 1× Iron Ingot, 2× Stick
Iron ingot top right, two sticks diagonally below it.Crafting Table · rendered from the game textures

Settings

Every option can be changed in game: Mods → Kobase Traders → Config (via Kobase Core). Server options apply to all players; client options are set by each player – options marked lockable can be fixed by the server for everyone.

Option	Meaning	Default
Who may edit traders `permissions.edit` SERVER	Operators: only operators. Creative mode: operators and players in creative mode.	Creative mode Operators / Creative mode
Owners may edit `permissions.allowOwnerEdit` SERVER	The player who created a trader may always edit it.	on
Who may create traders `permissions.spawn` SERVER	Operators, creative mode (operators and creative players) or everyone.	Creative mode Operators / Creative mode / Everyone
Traders per player `spawn.maxPerPlayer` SERVER	How many traders one player who is not an operator may own (0 = unlimited).	0 range 0 – 1000
Start template `spawn.defaultTemplate` SERVER	Role template of freshly created traders.	None (no trades) None (no trades) / Blacksmith / Baker / Farmer / Librarian / Cartographer / Bank / Jeweler / Animal dealer / Wanderer mix / Kobase Shop
New traders invulnerable `defaults.invulnerable` SERVER	Only /kill removes them.	on
New traders stay `defaults.persistent` SERVER	They never despawn.	on
New traders pushable `defaults.pushable` SERVER	Players and mobs can push them.	off
Default restock `restock.defaultMode` SERVER	Never, daily, at an interval or like villagers (twice a day).	Like villagers Never / Daily / Interval / Like villagers
Restock interval (min) `restock.defaultMinutes` SERVER	Minutes between restocks in interval mode.	20 range 1 – 1440
Daily restock hour `restock.defaultHour` SERVER	In-game hour of the daily restock (6 = sunrise).	6 range 0 – 23
Max trades `limits.maxTrades` SERVER	Most trades per trader.	32 range 1 – 128
Max NBT size `limits.maxNbtBytes` SERVER	Largest NBT (bytes) of a trade item or model variant.	8192 range 256 – 262144
Max waypoints `limits.maxWaypoints` SERVER	Most waypoints of one route.	32 range 1 – 256
Max area radius `limits.maxRadius` SERVER	Largest shop area radius in blocks.	32 range 1 – 128
Max route distance `limits.maxRouteDistance` SERVER	Largest distance of a waypoint from home.	128 range 8 – 1024
Forbidden items `limits.itemDeny` SERVER	Items (ids or #tags) that cannot be sold.	minecraft:command_block, minecraft:chain_command_block, minecraft:repeating_command_block, minecraft:command_block_minecart, minecraft:structure_block, minecraft:structure_void, minecraft:jigsaw, minecraft:barrier, minecraft:light, minecraft:debug_stick, minecraft:spawner, minecraft:knowledge_book, minecraft:bedrock
Forbidden models `limits.appearanceDeny` SERVER	Entity types (or modid:*) that cannot be a trader model.	minecraft:ender_dragon
Operators ignore deny lists `limits.opsBypassDeny` SERVER	Operators may use forbidden items and models.	on
Allow spawn eggs `limits.allowSpawnEggs` SERVER	Editors who are not operators may sell spawn eggs.	off
Show titles `display.showTitles` CLIENTlockable	Title line above trader names.	on
Show 'closed' sign `display.showClosedSign` CLIENTlockable	Above traders outside their opening hours.	on
Greeting card `display.greetingCard` CLIENTlockable	Show the greeting above the trade screen.	on
Name range `display.nameRange` CLIENTlockable	Distance up to which trader names are shown.	24 range 4 – 64
Rotate preview `editor.autoRotate` CLIENT	Slowly rotate the model in the editor.	on

Compatibility

Minecraft	1.20.1
Mod loader	Forge 47.2 or newer
Kobase Core	included in the mod jar (1.0.2 up to (not incl.) 2.0.0) – nothing extra to install
Installation	On the server and all clients (one jar for both, Kobase Core is built in).
Modpacks	CJ_SimpleMod · Modpack D+J

For other mods: an API (de.kobase.traders.api.TraderApi) creates and configures traders from code or JSON and opens the editor; TraderClientApi offers the editor as a design dialog. Kobase Traders stays an optional dependency.

Versions

v1.0.0 First release: traders with any look, own trades, restock, levels, areas, routes, opening hours, presets and role templates; settings via Kobase Core; 12 languages.
v1.0.1 Translations: all texts of the mod and its settings in 13 languages; ships Kobase Core 1.0.3.
v1.0.2 Settings: missing tooltips/labels added in all languages.