Getting Started

Welcome to TravelingMerchant, a lightweight and powerful plugin designed to let you create timed merchants, rotating shops, and location-based traders – without the need for NPCs!

This guide will help you install the plugin, run your first test, and point you to where you can get support and explore more features.

✅ Installation

  1. Download the plugin from Spigot or your preferred platform.

  2. Place the .jar file into your server’s /plugins folder.

  3. Restart the server or use /reload to load the plugin.

💡 Dependencies

🚀 First-Time Setup

Once the plugin is installed, here’s how you can quickly test it out:

🧭 1. Set the Merchant Spawn Location

/merchant location example add

➡ This sets the current player location as a possible spawn point for the example merchant.

🔁 2. Reload the Plugin Configurations

/merchant reload

➡ This reloads all configs, including merchants, locations, categories, and items.

✨ 3. Spawn the Merchant

/merchant spawn example example_villager

➡ Spawns the merchant instantly at one of its defined locations.

Now the merchant should appear! You can interact with the merchant or try other commands.

🔍 What’s Next?

From here, you can:

  • Explore other /merchant commands

  • Configure categories, items, and offers via YAML files

  • Use rotating inventories and placeholder conditions

  • Integrate with economy or create your own logic using the API

See the full Wiki Documentation for advanced configuration and features.

📢 Support & Community

Need help? Found a bug? Have a suggestion?

💬 Join the Discord: LINK 📚 Download: LINK 🐛 Bug Reports: Please join my discord and report them there.

🛠 Plugin Info

  • Plugin Name: TravelingMerchant

  • Latest Version: BETA-1.0v1

  • Authors: Optimal

  • Minecraft Versions: 1.8+

  • Requires Vault: ✅ Yes (for economy)

  • Requires PlaceholderAPI: ✅ Optional but supported

PreviousWelcomeNextCommands

Last updated