SpigotVIP BetterDrops 2.10.1

BetterDrops now supports Spigot 1.14!

Recommended ProtocolLib build for 1.14: Download
Recommended ProtocolLib build for 1.8 - 1.13: Download

About



All dropped items will be shown as being held by invisible armor stands.

No lag. No duplication bugs.
Focused on performance, extremely low timings.
Custom item names (including renamed items) are supported.
Requires ProtocolLib.

Features

• Supports Minecraft 1.8, 1.9, 1.10, 1.11, 1.12, 1.13, and 1.14.
  
• All 3D items are clientside. This means that there are no duplication bugs, because the drops still exist on the server and aren't being overridden, they're just being hidden from the client.
  
• Since the armor stands are clientside, this means that you can still remove the drops using the same commands, such as "/remove drop 50". The items despawn after a few minutes as they usually would.
  
• Does not cause any server lag, most of the plugin's work is done asynchronously, so it won't interrupt the main thread. The server does not tick the armor stands that this plugin uses, only the drops are ticked.
  
• Items will merge. (This depends on Spigot's built-in item merge-radius in spigot.yml; item merging is detected, not performed by BetterDrops)
• Items are affected by physics. (They can flow in water!)
• Does not conflict with other plugins (WorldGuard, MoneyMobs, etc) since it doesn't create or destroy any entities server-side.
  
• You can configure limits for the maximum amount of 3D drops in an area in order to prevent clientside FPS lag.
• Works with ProtocolSupport. Clients running 1.7.10 or below will see regular vanilla drops (Armor stands were added in 1.8)
• If you want, you can disable the armor stands and name tags will be rendered above regular floating items.

Configuration
The configuration can be reloaded using /drops reload.
Changed settings will immediately take effect when the configuration is reloaded.
Code (Text):
# If disabled, regular vanilla drops will be shown using the custom name tags provided by BetterDrops.
enable-better-drops: true

# List of enabled worlds.
worlds: ['*']

# Pick up items by clicking on them?
click-pickup: false
# The maximum left click pickup targeting distance in blocks.
click-pickup-block-distance: 7
# The maximum block distance of items around the targeted block which can be picked up.
click-pickup-item-distance: 3

# Force players to click on items to pick them up?
# This will prevent players from picking up items normally by walking over them.
force-click-pickup: false

# Force click pickup can work in two ways:
# - Teleporting the item and allowing the player to pick it up normally
# (this will work as long as you don't have another plugin blocking item pickup)
# - Removing the item from the world and directly adding it to the player's inventory
# (incompatible with plugins which spawn drops that can't be picked up (e.g. shop plugins that use drops for displaying items), may cause duplication bugs with those plugins installed)

# Leaving this set to true is recommended.
force-click-pickup-teleport: true

# Teleport items away from adjacent horizontal blocks? This prevents 3D items from glitching into walls.
wall-fix: false

# Show name tags for drops?
show-item-names: true

# Show item amounts if there is more than one item in a stack?
show-item-amount: true
# You can change the format here, "%d" will be replaced with the number.
item-amount-suffix-format: ' (%d)'

# The item name format can be changed here. This can be used to add prefixes, suffixes, and colors to all item names.
item-name-format: '%s'

# If a dropped item has a custom name already defined, it will be used instead.
# This applies for the dropped entity, not the item itself.
custom-names: true

# The 'view distance' in blocks for item drops.
tracking-range: 64

# Drops can be replaced after they have lived for a certain amount of ticks.
minimum-drop-lifetime: 0

# Here you can limit the amount of 3D drops in an area.
# Stacked items don't represent extra drops.
# The distance can be set to 0 to disable the check.
limit-distance: 16
limit-max: 100

# If enabled, the plugin will use small armor stands, resulting in smaller items.
small-items: false

# Use 3D drops in water?
water: true

# Handle CrackShot grenades/bombs?
crackshot: true

# https://www.spigotmc.org/resources/shop-a-simple-intuitive-shop-plugin.9628/
ignore_shop_items: true

# https://dev.bukkit.org/bukkit-plugins/quickmarket/
ignore_quickmarket_items: true

# https://dev.bukkit.org/bukkit-plugins/quickshop/
ignore_quickshop_items: true

# https://www.spigotmc.org/resources/pickupmoney.11334/
# If true, item-name-format will not be applied to dropped money.
pickupmoney_no_format: true

# Custom item names.
# Any item names in this list will override everything else.
# A list of materials is available here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
# Format: <Material[~data]:name>...
custom-item-names: []

# custom-item-names:
# - 'STONE_SWORD:&8Stone Sword'
# - 'IRON_SWORD:&7Iron Sword'
# - 'DIAMOND_SWORD:&bDiamond Sword'

# Should custom item names defined in this configuration override an item's existing custom name?
custom-names-override-existing-names: false

# Custom item directions.
# The three numbers are pitch, yaw, and roll.
# Providing '#' as a value will use a random value from 0 to 360.
# The fourth number (optional) is the Y position offset.

# For reference, these are the default directions (non-small items):
# Blocks: 345,315,0
# Tools: #,180,90
# Non-solid blocks: 0,#,0

# Format: <Material[~data]itch,yaw,roll[,yOffset]>
custom-item-directions: []

# custom-item-directions:
# - 'IRON_AXE~1:0,80,90,0'
# - 'DIAMOND_PICKAXE~1:0,180,90'
# - 'WOOD_SWORD:170,#,90'

# If this list is not empty, only items in this list will be affected by the plugin.
# Format: <Material[~data]>
item-whitelist: []

# item-whitelist:
# - 'STONE'
# - 'STONE~1'

# Any items in this list will never be affected by the plugin.
item-blacklist: []
Custom item names in action:


If you add 'DIAMOND_SWORD:200,0,0' as a custom item direction, you will get this:


API
You can prevent BetterDrops from replacing an item by adding item metadata.

Code (Text):
item.setMetadata("betterdrops_ignore", new FixedMetadataValue(plugin, true));
Commands

• /drops reload: Reloads the configuration. Permission betterdrops.reload.
• /drops toggle-nametags: Players can use this command to toggle whether they can see nametags. Does not affect other players. Permission betterdrops.toggle-nametags, true by default.
• /drops toggle: Players can use this command to toggle whether they can see 3D drops. Permission betterdrops.toggle.

Known Issues
The invisible armor stands will block interaction (left clicks and right clicks will sometimes be blocked by a dropped item).
Unfortunately this can not be fixed, armor stands will always have a hitbox even if they are invisible.

I can't guarantee compatibility with plugins like ViaVersion. The Minecraft protocol has changed significantly from 1.8 to 1.14 and any incompatibilities may result in items not being rendered properly (at best) and, at worst, clients can crash as a result of protocol errors if they are not running the same version as the server.

License
You can use this plugin on multiple servers that you own, however, redistribution is not allowed.

Look below for more images!