#######################################################################
# GENERAL SETTINGS
#######################################################################
# Validate player names before creating heads
player-validation:
# Validation mode options:
# SERVER_ONLY - Only allow heads for players who joined this server
# MOJANG_API - Validate with Mojang API (recommended, fast)
# DISABLED - Allow any name (unsafe)
mode: "MOJANG_API"
# Cache validation results (recommended: true)
cache-results: true
# Duration (in minutes) to cache validation results
cache-duration: 5
# Player head drops
player-head-drops-enabled: true
# Mob head drops
mob-head-drops-enabled: false
# Allow mannequins to use player skins
allow_mannequin_skin: true
#######################################################################
# DROP CHANCE SETTINGS
#######################################################################
# Default drop chances by entity type
default-boss-drop-chance: 100.0
default-hostile-drop-chance: 5.0
default-passive-drop-chance: 2.0
# Looting enchantment bonus
looting-increases-drop-chance: true
looting-bonus-per-level: 5.0
# Specific mob drop chances (optional overrides)
mob-head-drop-chances:
spider: 10.0
cave_spider: 10.0
drowned: 15.0
blaze: 5.0
slime: 8.0
magma_cube: 8.0
enderman: 12.0
pig: 5.0
cow: 5.0
sheep: 5.0
chicken: 5.0
villager: 10.0
witch: 12.5
iron_golem: 7.5
snow_golem: 7.5
hoglin: 6.0
zoglin: 6.0
piglin_brute: 12.0
ravager: 20.0
warden: 2.0
vex: 10.0
breeze: 5.0
bogged: 10.0
evoker: 12.5
shulker: 8.0
silverfish: 5.0
stray: 15.0
illusioner: 12.5
creaking: 12.5
giant: 20.0
elder_guardian: 5.0
wither: 1.0
guardian: 8.0
zombified_piglin: 10.0
endermite: 5.0
phantom: 10.0
pillager: 10.0
allay: 5.0
armadillo: 5.0
axolotl: 5.0
wolf: 5.0
cod: 5.0
bee: 5.0
fox: 5.0
goat: 5.0
cat: 5.0
bat: 2.5
camel: 5.0
donkey: 5.0
frog: 5.0
glow_squid: 5.0
horse: 5.0
mooshroom: 5.0
mule: 5.0
ocelot: 5.0
parrot: 5.0
pufferfish: 5.0
rabbit: 5.0
salmon: 5.0
skeleton_horse: 5.0
sniffer: 5.0
squid: 5.0
strider: 5.0
tadpole: 2.5
tropical_fish: 5.0
turtle: 5.0
wandering_trader: 5.0
llama: 5.0
trader_llama: 5.0
zombie_villager: 10.0
zombie_horse: 5.0
panda: 5.0
dolphin: 5.0
polar_bear: 5.0
vindicator: 12.0
mannequin: 12.0
copper_golem: 13.0
happy_ghast: 39.0
#######################################################################
# HEAD DISPLAY SETTINGS
#######################################################################
# Head lore format
mob-head-lore-format: "§7Killed by: §c%killer%"
# Extra lore options
show-kill-location: false
show-kill-time: false
show-custom-name: true
#######################################################################
# SKIN & GEYSER COMPATIBILITY
#######################################################################
# Skin fetching from Mojang/third-party APIs
skin-fetching:
enabled: true
cache-duration-minutes: 60
timeout-seconds: 5
fallback-to-default: true
# Bedrock (Geyser) compatibility
bedrock-compatibility:
enabled: true
force-refresh-textures: true
use-mojang-fallback: true
geyser:
# Prefix for Bedrock clients
prefix: "."
#######################################################################
# SOUND & VISUAL EFFECTS
#######################################################################
head-sound-effects:
enabled: true # Enable head sound feature
random-sounds: true # Random sounds per entity
play-on-place: false # Play when head placed on noteblock
particles: true # Show particles when playing sounds
messages: false # Send chat messages when sounds play
volume: 1.0 # Volume (0.1–2.0)
pitch: 1.0 # Pitch (0.5–2.0)
#######################################################################
# ENTITY COLOR CODES
#######################################################################
entity-colors:
zombie: "§2"
skeleton: "§f"
creeper: "§a"
enderman: "§5"
wither: "§4"
ender_dragon: "§5"
mannequin: "§9"
# Auto color legend:
# §4 = Boss
# §c = Monster
# §b = Water
# §a = Others