Configuration

Here you can read what you can set up in the merchants folder.

In the merchants folder, you can create as many subfolders as you want. However, within the entire merchants folder, you cannot have two YAML files with the same name.

You can find how to set up entities sections here What actions we know or how to manipulate them here. How conditions work or how to manipulate them can be found here. All information about setting up an item for a product can be found here.

🧭Region [🆕]

This region controls where your merchant can spawn — either inside a WorldGuard region or within a specific area.

🌍 WorldGuard support (optional)

You must have the WorldGuard plugin downloaded on your server. To use a WorldGuard region:

worldguard:
  world: "world"         # Name of the world
  name: "region_name"    # Name of your WorldGuard region

🧱 Settings (optional)

Here you can find the actual setup for this region, from setting the boundaries to spawning on the given blocks

min-y: 60   # Minimum height (optional)
max-y: 100  # Maximum height (optional)
#min-x: ...   # Use region's X boundary (optional)
#max-x: ... (optional)
#min-z: ... (optional)
#max-z: ... (optional)
block: # optional
  whitelist: # only spawn on these blocks (optional)
    - GRASS_BLOCK
    - STONE
  blacklist: # never spawn on these blocks (optional)
    - WATER
    - LAVA

➡️ Example: Merchant will spawn between Y=60 and Y=100, but X and Z are based on the WorldGuard region.

PreviousPlaceholdersNextEntities

Last updated