FAQs - ApiaTeam/ApiaEnvoy-Docs GitHub Wiki

What the hell is platform and global envoys?

Platform envoys are the envoys that depends on another supported plugins such as BentoBox, Factions, Lands... You can find the full list of supported plugins in the resource page.
Global envoys are the envoys that can spawn anywhere in the world. Also has WorldGuard regions support.

---

I want envoys to fall in WorldGuard regions. How can I do that?

This is for global envoys. So enable global envoys in config.yml first. Then in config_global.yml enable worldguard under integrations then restart your server. Now you will find locations under global envoys like this:

locations:
  '0':
    x:
      min: 0
      max: 17
    y:
      min: 60
      max: 70
    z:
      min: 0
      max: 17

Remove x and z and put region there like this:

locations:
  '0':
    region: 'my_beautiful_arena'
    y:
      min: 60
      max: 70

You can keep the y setting or delete it, its your choice. If you delete it plugin will select region's y coord as minimum and maximum.

---

I have NBT items and want to put it in the loots. How can I do that?

First download NBT API then restart the server. Now there is red pill and blue pill choose carefully.

• The red pill: Via config editing
• • Just add nbt_data then put data inside it like:

loots:
  '0':
    chance: 20
    material: DIAMOND
    nbt_data: '{SomeCoolTag:1b}'

• The blue pill: Via menu
• • Run /ApiaEnvoy Menu then select platform or global then add loot. Then I suggest you to use adding bulk loot which opens a GUI and you put your NBT items then click OK. After that you can customize chance & other stuff in the config. If you use normal add item button you will need to edit everything via menu which is slower than the config.

---

I want to drop an envoy on a specific day and time. How can I do that?

For platform envoys

envoy_dates:
  enabled: true
  # %d for day
  # %h for hour
  # %m for minute
  # %s for second
  placeholder_format: '%d:%h:%m:%s'
  '0':
    # List of values: SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, WEEKDAY, WEEKEND, EVERYDAY
    day: FRIDAY
    # Valid values: 0-23
    hour: 23
    # Valid values: 0-59
    minute: 4
    tiers:
      - 'blocks'
      - 'commands'
    # It will appear in the hologram
    reason: 'Have a good Friday!'

For global envoys

envoy_dates:
  enabled: false
  # %d for day
  # %h for hour
  # %m for minute
  # %s for second
  placeholder_format: '%d:%h:%m:%s'
  '0':
    # List of values: SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, WEEKDAY, WEEKEND, EVERYDAY
    day: FRIDAY
    # Valid values: 0-23
    hour: 19
    # Valid values: 0-59
    minute: 23
    # Global envoy id. Which is the world it belongs to and the id.
    # You first need to configure global envoy for this.
    world_id: 'world_0'