config.yml

# How to announce beheadings, options are GLOBAL, LOCAL, DIRECT, or OFF
# To customize per killed entity type, use `entity_type: 'MODE'`
behead-announcement:
  default: 'LOCAL'
  player: 'GLOBAL'
#  wither_skeleton: 'OFF'

# Announcement mode for players with the 'dropheads.silentbehead' permission
# Overrides the above setting; it is recommended to use 'DIRECT' or 'OFF'
silentbehead-announcement: OFF

# How far 'LOCAL' broadcasts can be heard
local-broadcast-distance: 200

# Whether 'LOCAL' broadcasts can be heard through a nether portal
local-broadcast-cross-dimension: true

# Replace player death message with behead message (if announcement is GLOBAL)
behead-announcement-replaces-player-death-message: true

# Replace Bukkit event message; can help with DiscordSRV compatibility
behead-announcement-replaces-player-death-event-message: false

# Replace death message sent to the owner of a pet when it is beheaded
behead-message-replaces-pet-death-message: true

# Whether to drop heads if not killed by a player
drop-for-nonplayer-kills: false

# Whether to drop heads if killed by a projectile weapon
drop-for-ranged-kills: false

# In vanilla, the main-hand item is used for looting even if shot from offhand
use-ranged-weapon-for-looting: true

# Whether to drop heads if last-damage-cause is not a valid entity
drop-for-indirect-kills: false
indirect-kill-threshold: '30s'

# Only drop player heads (you can also do this in 'head-drop-rates.txt'
# by making all mobs except players have a 0% chance of dropping heads)
player-heads-only: false

# Only drop "simple" mob heads (one per EntityType), without any unique
# texture features based on mob traits or subtype
simple-mob-heads-only: false

# Whether to keep entity heads updated with the latest vanilla textures
refresh-textures: true

# Whether to reset the item name for a head when refreshing its texture
refresh-item-names: false

# Whether to reset the item lore for a head when refreshing its texture
# This setting is ignored if 'save-custom-lore' is true
refresh-item-lores: false

# Whether heads should update to the player's current skin when mined/dropped
update-on-skin-change: false

# Whether to disable head item stacking (stack to 1 instead of 64)
# Note: Currently only affects custom (non-vanilla) heads
make-heads-unstackable: false

# Track mob spawn reasons, edits drop rates using 'spawn-cause-multipliers.txt'
track-mob-spawns: true

# Enable the mechanic where the first mob killed by a charged creeper's
# explosion will drop its head with 100% probability
# Note: This overrides 'drop-for-nonplayer-kills', but not 'player-heads-only'
charged-creeper-drops: true

# A Minecraft easter egg is that mobs named 'Dinnerbone' or 'Grumm' are
# upside down. If you want their heads to also be upside down, set to true
drop-grumm-heads: false

# Should shulker heads be oriented based on what side of a block they were
# attached to when they were killed?
drop-sideways-shulker-heads: false

# Should tamed dog and cats have their (colored) collar visible on their head?
drop-collared-heads: false

# Should heads of saddled mobs have altered textures (when applicable)?
drop-saddled-heads: false

# Should skeletal mob heads use hollow textures on the bottom?
# Note: This relies on HD textures, which Mojang might patch
hollow-skeletal-skulls: false

# Should slimes drop semi-transparent heads, similar to their ingame model?
# Note: This relies on HD textures, which Mojang doesn't always permit
transparent-slime-heads: false

# Enable plugin auto-updates (checks for new versions and head textures)
# Note: Disable if your console shows DropHeads errors on startup
update-plugin: true

# Whether head-textures.txt will be overwritten for each plugin update
# Set to false if you want to manually update textures (or set your own)
update-textures: true

# Run in debug mode (prints extra information to console)
debug-messages: false

# Shows information about a head when right-clicked by a player
# Note: The output head-click-info can be configured in translate.yml
head-click-listener: true
# Set to 0 for no limit on head click message frequency
head-click-max-rate-in-ticks: 5

# Saves lore of heads in GameProfile when placed (used by some other plugins)
# Only works for player-type heads, eg: won't work for minecraft:creeper_head
# WARNING: This feature is in BETA and is relatively untested
# WARNING: Lore will still get lost if the head is broken by a non-player
# WARNING: This setting overrides 'refresh-item-lores'
save-custom-lore: true

# Corrects custom lore and name when CTRL-copying a placed head in creative
fix-creative-nbt-copy: true

# Displays the type of head (eg: player, mob, HDB) in the head item's lore
# Note: Applies to custom player/mob heads, but not to WITHER_SKULL etc.
show-head-type-in-lore: true

# Adds support for DropHeads-namespaced heads in the vanilla `/give` command
# WARNING: This feature is in EARLY-BETA and may not end up being supported
substitute-dropheads-in-give-command: true

# Only drop heads if the killer used an axe; overrides 'must-use'
must-use-axe: false

# Drop chances are multiplied by this number for each level of looting
looting-multiplier: 1.1

# This number is added to the drop chance for each level of looting
looting-addition: 0.0

# Defer wither skeleton skull handling to vanilla Minecraft
# This bypasses 'head-drop-rates.txt', custom looting multiplier/addition,
# 'must-use-axe', 'drop-for-nonplayer-kills', and other DropHeads settings
# However, it does not bypass permissions such as 'dropheads.alwaysbehead'
vanilla-wither-skeleton-skulls: true

# Replace Zombie_Pigman heads with Zombified_Piglin heads in 1.16+
update-zombie-pigman-heads: true

# Replaces player-model piglin heads with the vanilla ones added in 1.19.3+
# Requires 'refresh-textures' to also be set to true.
update-piglin-heads: true

# Updates internal texture keys for mob heads when refreshed
# Can improve stacking for legacy heads (from older versions of the plugin)
replace-redirected-texture-keys: false

# Whether to use material types for zombie, creeper, skeleton & wither skulls
# If this is false, all heads will be forced to use the player_head type
prefer-vanilla-heads: true

# Whether Iron Golems will drop "cracked" heads which can be repaired
# to the normal texture by placing them and clicking on them with iron ingots
cracked-iron-golem-heads: false

# Whether to replace the noteblock sound with the ambient mob sound when the
# noteblock played has a custom mob head on top of it, options are:
# OFF - no custom noteblock sounds
# LISTENER - sounds are chosen when a noteblock event occurs (recommended)
# ITEM_META - custom sounds are encoded into every head item's NBT
noteblock-mob-sounds: 'OFF'

# A list of mob heads a player can wear to avoid provoking endermen
endermen-camouflage-heads: []

# How the head item from a beheading should be handled, options are:
# EVENT - add the head to normally dropped loot,
# SPAWN - spawn the head separately from the event,
# PLACE - place the head on the ground if spot is available (within 3 blocks)
# PLACE_BY_KILLER - same as PLACE but checks if killer has build permissions
# PLACE_BY_VICTIM - same as PLACE but checks if victim has build permissions
# GIVE - try to put the head directly into the killer's inventory
# You can do multiple of these in a list; i.e., ['GIVE', 'SPAWN'] will try to
# give a head to the killer, but will drop the item if their inventory is full
head-item-drop-mode: 'EVENT'

head-place-overwrite-blocks: ['AIR', 'WATER', 'SHORT_GRASS']

# (Optional) Require using listed hand-held items in order to get head drops
# If this list is empty, any weapon can be used to get heads
must-use:
#  - IRON_SWORD
#  - DIAMOND_AXE
#  - WOODEN_HOE

# (Optional) Give listed hand-held items a different chance of beheading
# The number is multiplier in drop chance when using the given tool
# Eg: 2.0 = twice as likely, 1.5 = 50% more likely, 0.1 = 10% as likely, etc.
specific-tool-multipliers:
  AIR: 2
  SHEARS: 2
  GOLDEN_AXE: 2
  NETHERITE_AXE: 1.6
  DIAMOND_AXE: 1.5
  IRON_AXE: 1.4
  STONE_AXE: 1.3
  WOODEN_AXE: 1.2
  DIAMOND_SWORD: 1.2
  IRON_SWORD: 1.1

# (Optional) Modify behead chance based on how long a mob type has been alive
# Format is `X: V`, where if the mob has been alive for X or more time, then
# the drop rate is multiplied by V similar to specific-tool-multipliers)
# Default unit is ticks; other units: s[ec], m[in], h[r], d[ay], w[eek], y[r]
time-alive-multipliers:
  # Example: this will prevent player beheads if they have been alive < 1min
  player:
    0s: 0.0
    1m: 1.0
  # Example: for all other mobs, this will make heads more common as they age
  default:
    3h: 1.1
    2d: 2.0
    1w: 3.0
    30w6d11h55m33s: 10.0

# Set drop chance multipliers for custom permission groups
custom-droprate-multiplier-permissions:
#  dropheads.group.droprate2x: 2.0
#  dropheads.group.droprate150percent: 1.5

# Changes the death `Event Priority` that DropHeads registers at
# Low values => DropHeads runs BEFORE other plugins; high values => runs AFTER
# Possible values: [LOWEST, LOW, NORMAL, HIGH, HIGHEST, MONITOR]
death-listener-priority: LOW

# Attempt to replace headA with headB whenever possible (server-wide)
# The head on the left is replaced with the one on the right when updated
replace-heads:
  'PIG_ZOMBIE': 'ZOMBIFIED_PIGLIN'
#  'WOLF': 'WOLF|PALE'
#  'WOLF|GRUMM': 'WOLF|PALE|GRUMM'

# Forcibly assign a DropHeads mob type (id) for heads with a matching texture
assign-dropheads-keys-to-recognized-textures: false

# Similar to the above setting, but more effect (much higher performance cost)
assign-dropheads-keys-to-recognized-uuids: false

# Whether to send usage statistics to bStats
bstats-enabled: true

# Whether to enable logging for certain events
# Placeholders: TIMESTAMP, VICTIM(_UUID), KILLER(_UUID), ITEM, SENDER, HEAD.
log:
  enable: true
  filename: 'dropheads-log.txt'
  log-mob-behead: true
  log-mob-behead-format: '${TIMESTAMP},mob decapitated,${VICTIM},${KILLER},${ITEM}'
  log-player-behead: true
  log-player-behead-format: '${TIMESTAMP},player decapitated,${VICTIM},${KILLER},${ITEM}'
  log-head-command: true
  log-head-command-format: '${TIMESTAMP},gethead command,${SENDER},${HEAD}'

# Performance settings, edit at your own risk
message-json-limit: 15000
weapon-tellraw-component-cache-size: 5
async-offline-profile-requests: false
head-click-enable-profile-requests: true
spawnhead-command-entity-select-limit: 100