# WanderingTrades [![Jenkins build](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fjenkins.jpenilla.xyz%2Fjob%2FWanderingTrades%2F&label=Jenkins%20build&style=for-the-badge)](https://jenkins.jpenilla.xyz/job/WanderingTrades/) *WanderingTrades is a plugin that allows server owners to customize the trades of Wandering Traders through an easy to use in-game GUI. Also allows for creating custom traders and villagers, as well as selling Player Heads of players from your server!* ## Features - Adds trades defined in config files to Wandering Traders. - In-game GUI config editor - Trade config files are located in the `plugins/WanderingTrades/trades` folder in your server. - You may create as many trade configs as you like. If you have no configs, an example.yml config file will be created for you. - For more info on what the options are, check out the default [config.yml](https://github.com/jpenilla/WanderingTrades/blob/v1.8.0/src/main/resources/config.yml), and the [example.yml](https://github.com/jpenilla/WanderingTrades/blob/v1.8.0/src/main/resources/trades/example.yml) - Check out the VanillaTweaks-style [microblocks.yml](https://github.com/jpenilla/WanderingTrades/blob/v1.8.0/src/main/resources/trades/microblocks.yml) trade config (screenshots in gallery) - Supports custom player heads, custom item lores, custom item names, enchantments, and custom NBT data. - Supports RGB colors, gradients, and rainbows for trader and item names in 1.16+ using MiniMessage. To see how to format text for all versions refer to [this page](https://docs.adventure.kyori.net/minimessage.html#format) - Customizable chance for each trade config to be added to Wandering Traders, with option to limit to one config per trader. - Automatically adds trades for player heads of players from your server to Wandering Traders, with customizable head names, lore, amount, and fully customizable prices. Configure in [playerheads.yml](https://github.com/jpenilla/WanderingTrades/blob/v1.8.0/src/main/resources/playerheads.yml) - Option to remove the original trades of Wandering Traders - Summon custom Wandering Trader or Villager defined in config files through commands. - Command summoned traders can be configured to have custom names above their heads in the trade config. - Command summoned traders can refresh their trades automatically after an amount of time set in config.yml - You can summon Traders that do not move around using the noai summon commads. - If the value 'invincible: true' is in a trade config and a trader is summoned by command using that config, the trader will never despawn or take any damage from anything, except from players with the `wanderingtrades.damage` permission - Language localization support - Includes English (en_US), German (de_DE), Romanian (ro_RO), Russian (ru_RU), and Simplified Chinese (zh_CN) locales by default. Set the language in config.yml. - Any text in menus or commands is translatable - If you can speak another language and want to help translate the plugin make a Pull Request on GitHub or send me a config on Discord. ## Screenshots ![Config Interface](https://i.imgur.com/coL7PWY.gif) ![Config Interface 2](https://i.imgur.com/ZKG0cYz.gif) ![Config Interface 3](https://i.imgur.com/x8ERNhQ.gif) See the gallery for more ## Commands and Permissions | Command | Description | Permission | |---------|-------------|------------| | `/wanderingtrades` | Base command | - | | `/wanderingtrades edit` | Open the trade config edit GUI menu | `wanderingtrades.edit` | | `/wanderingtrades editconfig` | Edit the config.yml in-game through a GUI menu | `wanderingtrades.edit` | | `/wanderingtrades editplayerheads` | Edit the playerheads.yml in-game through a GUI menu | `wanderingtrades.edit` | | `/wanderingtrades reload` | Reload the plugin configuration | `wanderingtrades.reload` | | `/wanderingtrades list` | List available trade configurations | `wanderingtrades.list` | | `/wanderingtrades summon` | Summons a Wandering Trader using the specified config | `wanderingtrades.summon` | | `/wanderingtrades summonvillager` | Summons a Villager using the specified config | `wanderingtrades.summonvillager` | Additional permissions: - `wanderingtrades.damage`: needed to deal damage to command summoned traders with the invincible option on in their trade config. ## Plugin Compatibility - Integration with WorldGuard - In config.yml there is a configurable white/black list of WorldGuard regions to allow refreshing the trades of command spawned traders in. - Supports custom items from any plugin! Simply use the in-game config editing GUI (/wt edit) and set your trades to use custom items, for example Crazy Crates keys!

Key Trade

![Key Trade Example](https://i.imgur.com/DHsDDUe.png)

bStats

[Link](https://bstats.org/plugin/bukkit/WanderingTrades/7597) Opt-out of anonymous stats in the global bStats config. ![bStats](https://bstats.org/signatures/bukkit/WanderingTrades.svg)

*Looking for other Vanilla Tweaks datapack plugins?*

VanillaTweaks Plugin

Check out [VanillaTweaks](https://www.spigotmc.org/resources/vanillatweaks.81288/) by Machine Maker! If you use their "PersistentHeads" Module, Wandering Trades and other plugins Player Heads will preserve their Name and Lore after placing and breaking!

Wandering Trades

Microblock trades close up

Player heads from your server

Microblock trades

No-AI traders with custom names