> For the complete documentation index, see [llms.txt](https://optimals-plugins.gitbook.io/travelingmerchant/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://optimals-plugins.gitbook.io/travelingmerchant/welcome.md).

# Welcome

Hello and welcome to the Traveling Merchant wiki. Here you will find documentation for this plugin and learn how it works.

### What's Traveling Merchant?

**Traveling Merchant** is a dynamic NPC plugin for Minecraft servers. It introduces a mysterious trader who appears at random locations for a short time, offering rare loot, collectibles, and event-based items.

***

### ✨ Features

* 🔀 **Randomized Spawning**\
  Merchant appears every X minutes in one of your configured locations.
* 🕒 **Limited-Time Visits**\
  He stays for a short period (e.g. 15 minutes) before disappearing again.
* 🎁 **Unique Loot Pool**\
  Rare items, custom recipes, decorative blocks, and event-based loot.
* 🧭 **Location System**\
  Define specific named locations where the merchant can spawn.
* 💬 **Chat & Visual Effects**\
  Spawn announcements, particle effects, and immersive trader quotes.
* 🛠️ **Admin Tools**\
  Full control via commands for spawning, teleporting, setting locations, and reloading config.