LEAK Envoys - The Ultimate Supply Drop Plugin 5.6.3

[DevUpdates]

Envoys is natively built on 1.16, but has compatibility for 1.17, and full backwards compatibility down to 1.8

Wiki: https://github.com/EnvoysDev/Envoys/wiki

Spoiler: Known Incompatible Plugins
Spoiler: Transcript
License
Spoiler: License
Wiki: https://github.com/Dot-Rar/Envoys/wiki
Discord support server: https://discord.gg/ENcFqWV

Spoiler: Default Configuration
Code (YAML):

#DO NOT TOUCH
config-version: 58

root-command: '/envoys'
verbose-logging: false

lang:
prefix: '&8[&4Envoys&8] &4' #The prefix to all messages
no-permission: 'You do not have permission for this' #No permission
setup-finished: 'Envoy setup successfully' #When an envoy is successfully created
not-a-valid-id: 'That ID does not exist / is not valid' #When you try to remove an envoy but there is no envoy with the ID you specified
removed-envoy: 'Successfully removed envoy.' #When an envoy is successfully removed
envoys-refilled: 'ALL ENVOYS HAVE BEEN REFILLED' #When envoys are refilled
amount: 'There are %amount envoys (%worldAmount in your world)' #The response to the amount sub-command
list: '%id (%tier) - World: %world X: %x Y: %y Z: %z' #The response to the list sub-command
random-envoy-locations: 'An envoy spawned at World: %world X: %x Y: %y Z: %z!' #If random-location.broadcast-locations is set to true, for every random envoy spawned, this message will be displayed
reload: 'Reloaded successfully'
data-saved: 'Data file saved successfully'
invalid-syntax: 'Invalid syntax, type /envoys help for help'
add-item-no-name-or-chance: 'You must specify a name and a chance' #If /envoys additem is entered with 0 or 1 arguments
no-item-in-hand: 'You must have an item in your hand' #If /envoys additem is entered without an item in the user's hand
name-already-exists: 'This name already exists in the config' #If /envoys additem is entered and the name specified already exists under contents in the config
added-item: 'Successfully added item' #When an item is successfully added to the contents
broadcast-open-message: '%player opened a %tier envoy at %world, %x, %y, %z. There are now %remaining envoys left.' #Set broadcast-on-open to false to disable
called-drop: 'You have called a drop in!'
already-opened: 'This envoy was already opened %minutes minutes ago!'
current-envoys:
top: 'Current envoys'
line: 'There is an %tier envoy at: %world, %x, %y, %z'
disabled-region: 'Envoy drops cannot be called in this area'
compass-disabled: 'Envoy compass tracking has been disabled'
compass-enabled: 'Envoy compass tracking has been enabled'
compass-envoy-distance: 'The nearest envoy is %distance metres away'
compass-no-active-envoys: 'There are no envoys currently active'
cleared-envoys: 'Cleared all envoys' # Message sent to the person who runs /envoys stop
all-envoys-opened: 'All envoys have been opened!' # Broadcasted when all envoys have been opened. Set to '' to disable.

contents:
tiers:
tier1: #envoy name
chance: 70 #Chances should add up to 100
items: #A list of items this envoy should contain from the items section below
- token
- my_item_1
- announcement
tier2: #envoy name
chance: 30 #Chances should add up to 100
items: #A list of items this envoy should contain from the items section below
- another_item
items:
my_item_1:
type: item
chance: 70
id: 276
data: 0
name: '&4My &9Item'
amount: 3
lore:
- '&3Lore &4Line &21'
- '&3Lore &4Line &12'
enchants:
- 'DAMAGE_ALL,5'
- 'FIRE_ASPECT,3'
nbt:
flags: # https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html
- HIDE_ENCHANTS
- HIDE_DESTROYS

another_item:
type: item
chance: 32
id: 364
data: 0
name: 'Another item'
amount: 64
lore:
enchants:
nbt:
flags:
- HIDE_UNBREAKABLE

token:
type: item
chance: 78.9
id: 339
data: 0
name: '&9Token'
amount: 1
lore:
- '&3This is a crate token'
- '&eRight click a crate to open it'
enchants:
- 'ARROW_INFINITE,10'
nbt:
- type: STRING
key: key1
value: value
- type: INT
key: key2
value: 12267
flags:

announcement:
type: command
chance: 100
commands:
- 'say &a%player has just opened an %envoy_type envoy!'
- 'say &9command 2 here'

holograms:
enabled: true
text: '&b%tier Envoy'

envoys-refilled-by-command-only: false #Should the envoys reset after a set amount of time or only be reset by a command?
envoy-refill-delay: 1800 #How often the envoys refill, in seconds

envoy-refill-minimum-players: # Require a minimum amount of players to be online to start envoy events
enabled: false
minimum-players: 10

envoy-auto-remove: # Should we remove envoys after a certain amount of time?
enabled: false
remove-time: 120 # in seconds

tell-if-already-opened: false #Tell the user if the envoy was previously opened

updates-per-second: 5 #How many envoys should be created per second when refilling?

random-location: #Envoys can be created at random locations each time
enabled: false #To enable random envoys, set this to true
amount: 50 #The amount of random envoys you would like created each time
min-x: -10000 # Minimum random X location
min-z: -10000 # Minimum random Z location
max-x: 10000 # Maximum random X location
max-z: 10000 # Maximum random Z location
always-on-top: true #If set to true, the envoys will always spawn at the highest block so they are not underground
minimum-y: 1 # The minimum Y coordinate the envoys will be spawned at
maximum-y: 255 # The maximum Y coordinate that envoys will be spawned at
disabled-worlds: #You can disable random envoys for specific worlds
- 'world1'
- 'exampleWorld'
broadcast-locations:
enabled: false #If set to true, the locations of random envoys will be broadcasted.
only-to-players-in-same-world: true
only-refill-random-location-envoys: false #If set to true, only random location envoys will be spawned every x seconds (set in envoy-refill-delay)
delete-old-envoys: true #If set to true, when new random envoys spawn, the old ones will be deleted.
worldguard-integration: #For help configuring this section, see the "Worldguard Integration" section at http://www.spigotmc.org/resources/20357
enabled: false
type: everywhere #Either "everywhere", "blacklist" or "whitelist"
blacklisted-regions: #Envoys WON'T spawn in these regions if type is set to "blacklist"
- region1
- region2
whitelisted-regions: #Envoys will only spawn in these regions if type set to "whitelist"
spawnregion1:
tier-selection: 'automatic' # Should we use the 'automatic' algorithm (use tier chances, all tiers in random-tiers available), or the 'manual' method (tiers & amounts specified in tiers section)
tiers:
amount: -1
world: world
spawnregion2:
tier-selection: 'manual' # Should we use the 'automatic' algorithm (use tier chances, all tiers in random-tiers available), or the 'manual' method (tiers & amounts specified in tiers section)
tiers:
tier1: 3 # Spawn 3 tier 1 envoys
tier2: 7 # Spawn 7 tier 2 envoys
world: world
random-tiers:
- tier1
- tier2

max-items: 5 #Max items in a chest
min-items: 1 #Minimum items in a chest
max-commands: 5 # Max commands executed on chest open
min-commands: 0 # Minimum commands executed on chest open

# Commands to be executed when an envoy spawns (not when it is opened)
# Available variables:
# %x - X coordinate of the envoy
# %y - Y coordinate of the envoy
# %z - Z coordinate of the envoy
# %world - Name of the world the envoy spawned in
# %tier - Name of the tier of the envoy
commands-on-spawn:
- 'broadcast &8>> &4A %tier envoy has spawned at %x %y %z in %world'

particles:
enabled: false # Set to true to enable particles
style: circle # The style in which particles should be spawned in

particle-type: REDSTONE # The type of particle. A list can be found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html

colour: # Only works for REDSTONE, SPELL_MOB and SPELL_MOB_AMBIENT particles.
enabled: true
colours: # Colour list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Color.html
- AQUA
- BLACK
- BLUE
- FUCHSIA
- GRAY
- GREEN
- LIME
- MAROON
- NAVY
- OLIVE
- ORANGE
- PURPLE
- RED
- SILVER
- TEAL
- WHITE
- YELLOW

styles: # Style configuration
circle: # Configuration for the circle style
particle-count: 10 # How many particles should be spawned?
radius: 2.0 # How far from the chest should the particles be spawned?

firework-on-open:
enabled: true #Should a firework be spawned when somebody opens an envoy?
power: 2 #Value between 1 and 5. Determines how big the firework is
flicker: false #Should the firework flicker?
trail: true #Should the firework have a trail
type: STAR #Any from this list: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/FireworkEffect.Type.html (BALL, BALL_LARGE, BURST, CREEPER)
colors: #A list of colours from here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Color.html
- RED
- WHITE
- YELLOW

delete-after-open: true #Should the envoy be deleted after it is opened?
broadcast-on-open: false #When a player opens an envoy, should the lang.broadcast-open-message message be broadcasted?

drop-item:
enabled: true
material: REDSTONE_TORCH_ON # https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
name: '&cCall envoy'
tier-color: 'c'
lore:
- '&cRight click this item'
- '&cto call an envoy'
broadcast-on-place: '%player called an envoy in at %x, %y, %z' # Message to be broadcasted when the player places the flare
broadcast-location: false # Should the location be broadcasted when the envoy is dropped
wait-time: 0 # How long until the envoy should be placed in seconds
disabled-regions:
- region1
- region2

refill-countdown:
60: '60 seconds until refill'
120: '120 seconds until refill'

start-refill-countdown-after-opened: false # Should we only refill envoys x minutes after they are opened?

refilled-message-worlds: # In which worlds should the lang.envoys-refilled message be announced?
- world
- world_nether
- world_the_end

enable-metrics: true

compass:
enabled: true # Should the compass feature be enabled?
always-on: false # Set to true if you want compass to always point to the nearest envoy, rather than being enabled by /envoy compass
refresh-interval: 10 # How often should we check where the nearest envoy is, in seconds

# Falling block chests
fall-from-sky:
enabled: true
y: 255
check-interval: 2