Envoys - The Ultimate Supply Drop Plugin 5.4.10

Random locations, tiers, holograms, simple in-game config editing, Placeholder API support and more
Envoys is not for sale on MCMarket due to this bug. Please purchase on Spigot instead!

Envoys now works with 1.13 (and 1.14), whilst maintaining backwards compatibility with versions from 1.8 upwards.

We have a Discord support server! Click here (or on the image) to join it!

By purchasing this plugin, you agree to our Terms of Service (TOS) and License (PPLv1) listed at the bottom of this resource page.

Test Server
perkelle.com:26005 | Everyone has envoys.* | Envoy tiers are tier1 and tier2
banner.png





Envoys is a very configurable envoy/supply drop plugin. You can set locations for envoys (Loot chests) which will respawn every x seconds with loot configurable in the configuration file or, you can let them spawn randomly around your worlds.
Features
  • Highly configurable
  • Detailed documentation
  • (Multiple!) Commands as prizes
  • Simple in-game editing GUI
  • Different tiers of envoy
  • Random locations
  • Chances
  • Holograms
  • Remaining envoys deleted on refill
  • Worldguard integration
  • Fireworks on open
  • PlaceholderAPI support (including PlaceholderAPI cloud)
  • Flares
  • Pre-set locations
  • Efficient refill algorithm
  • Easy to add items
  • Random spawning in a pre-set zone
  • Notify the player if the envoy has already been looted (set lang.already-opened to "" to disable)
  • Delete envoys on open / refill
  • Option to start refill countdown after envoy is opened
  • (Partial) NBT support (See below for more information)
  • Comprehensive developer API
  • Update checker
  • Active development

Trial / Lite version
If you wish to test the basic features of the plugin (only pre-set locations + item rewards), I released a Lite version here.


Commands
/envoy - About command
/envoy create - Creates a new location for envoys to spawn at, at your current location
/envoy remove [ID] - Removes an envoy, the IDs are all listed in the configuration file with their locations
/envoy refill - Force refill all envoys and generate new if you have random locations on
/envoy amount - Displays how many envoys there are
/envoy list - Displays all envoy IDs, worlds, X positions, Y positions and Z positions
/envoy additem [Name] [Chance] - Adds the item in your hand to your config
/envoy reload - Reloads the configuration
/envoy savedata - Saves the data file (envoys.yml)
/envoy current - Shows the user a list of the current envoys on the ground
/envoy giveflare [Name] [Tier] - Gives a flare to a user that calls in a certain tier envoy
/envoy edit - Opens the envoy editing GUI

Permissions
envoys.* - Gives you access to all permissions
envoys.create - Gives you permission to use /envoy create
envoys.remove - Gives you permission to use /envoy remove [ID]
envoys.refill - Gives you permission to use /envoy refill
envoys.amount - Gives you permission to use /envoy amount
envoys.list - Gives you permission to use /envoy list
envoys.help - Gives you permission to use /envoy help
envoys.additem - Gives you permission to use /envoy additem
envoys.reload - Gives you permission to use /envoy reload
envoys.savedata - Gives you permission to use /envoy savedata
envoys.currentenvoys - Gives you permission for /envoy current
envoys.giveflare - Gives you permission for /envoy giveflare
envoys.edit - Gives you permission for /envoy edit

Documentation: https://github.com/Dot-Rar/Envoys/wiki

The Envoys wiki is extremely detailed. If you have further queries, feel free to open a ticket or send me a PM.


Questions & Bugs
If you have any questions or find any bugs, you can join our support server here: https://discord.gg/ENcFqWV

We also have a Trello board so you can see what I am working on: https://trello.com/b/RmVQnkRd/envoys

TOS

  • All purchases are final
  • You will not share this resource
  • You will only run this resource on 1 network
  • The resource is provided "as-is" without warranty
  • I am not obligated to update this resource or provide support for it (This doesn't mean I will not though)
License
Premium Plugin License Version 1 (PPLv1)

0. ADDITIONAL DEFINITIONS
"This license" refers to version 1 of the Premium Plugin License (PPL), this edition is refered to as PPLv1

“Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.

"This software" refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations.

"This plugin" refers to this software, and or any parts of it

To “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work.

"End user" refers to anyone who installs the software on their server, any licensees of this software or anyone who downloads this laptop

"The author" refers to the author of this software

"Server" refers to the end user's game server (typically Minecraft), no matter what modifications have been applied to it

1. PERMISSIONS
This license allows the end user to use features of this plugin commercially and to modify it for private use.

Distribution permissions are covered in 2. DISTRIBUTION

You must make an honest assessment on what you are doing is breaking this license agreement

2. DISTRIBUTION
This license does not allow copies or modifications to be distributed by anyone, other than the author.
All distributed copies or modifications must be distributed on this page: https://www.spigotmc.org/resources/20357/

3. LIABILITY
The author is never liable for any damages

The end user is always liable for all damages (including, but not limited to, loss of data, losses sustained or a failure to operate with other software)

4. WARRANTY
This software is distributed without warranty, to the extent permitted by law.

This software is provided "as is", without warranty of any kind, either expressed or implied.

5. LAWS
This software is applicable to the local laws of England.

6. AGREEMENT
The end user automatically agrees to this license by running this software on their server.

Wiki: https://github.com/Dot-Rar/Envoys/wiki

Discord support server: https://discord.gg/ENcFqWV

YAML:
#DO NOT TOUCH
config-version: 44

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 an envoy at %world, %x, %y, %z' #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'

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:

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

    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

    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

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
  custom-y: 200 #If always-on-top is set to false, the envoys will be spawned at this y level
  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:
        amount: 3 #ignores the "amount" value up there ^^^^^^^^^^^^
  world: world
      spawnregion2:
        amount: 5
        world: world
  random-tiers:
  - tier1
  - tier2

max-items: 5 #Max items in a chest
min-items: 1 #Minimum items in a chest

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

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

Latest updates

  1. v5.4.10

    Changelog since v5.4.3: Don't display refill announcements if the minimum player threshold...
  2. v5.4.3

    v5.4.3 changelog: Make start-refill-countdown-after-opened apply to random locations v5.4.2...
  3. v5.4.1

    v5.3.9: Add some extra checks to see if config-version was damaged v5.4.0: Load chunks async...

Author

Perkelle

Owner
Author
Perkelle
Downloads
31
Type
Digital product
License duration
Unlimited
Price
50000.00 GBP
Views
4,064
First release
Last update
Rating
0.00 star(s) 0 ratings
Top
You need to upgrade!
Our dark style is reserved for our Premium members. Upgrade here.