So I noticed there was a small issue with the heads and these entities mentioned, and in the new update it will use the default minecraft head for those entities if they are killed add these lines if you want them to have seperate values:

wither_skeleton: 0 # This could cause the item to drop twice one with the lore other with basic minecraft stats
skeleton: 0
ender_dragon: 0
creeper: 0
piglin: 0


Again I do apologize for the inconvenience

A issue that I may have accidently caused was the fact of the plugin causing errors when the user kills an entity. that has been fixed


Update Notes will be added soon to the github

Added support for the main file to work on 1.21.9 and older versions, it ain't locked into one version, this will automaticly check if the entity is able to be created.

Randomized also the sounds

New config you can find here
Site and Online Config Editor

If the thing doesn't work here's the link;
https://sites.google.com/view/ifmasters-plugins/mc-plugins/configs/headhunter

For the previous version, you can download the version through the github.

This update will add the following entities

Mannequins, Copper Golems, Happy Ghasts

Add these to the config;

allow_mannequin_skin: true



in mob-head-drop-chances:

mannequin: 12.0 # depends it won't really check this but it will somewhat not work if it ain't there
copper_golem: 13.0
happy_ghast: 39.0

You are now able to spawn in offline users skins, But make sure to add these into your config;


skin-fetching:
enabled: true
cache-duration-minutes: 60
timeout-seconds: 5
fallback-to-default: true

bedrock-compatibility: # Note like it will not really disply in their inventory due to the fact of Geyser has no official way to texture it in their inventory sadly
enabled: true
force-refresh-textures: true
use-mojang-fallback: true



The full config should look something like this;

player-validation:
# Validation mode options:
# SERVER_ONLY - Only allow heads for players who have joined this server
# MOJANG_API - Check Mojang API to validate real Minecraft accounts (fastest, no server requirement)
# DISABLED - Allow any player name (no validation)
mode: "MOJANG_API"

# Cache validation results to improve performance (recommended: true)
cache-results: true

# How long to cache validation results in minutes (recommended: 5-15)
cache-duration: 5

skin-fetching:
enabled: true
cache-duration-minutes: 60
timeout-seconds: 5
fallback-to-default: true

bedrock-compatibility: # Note like it will not really disply in their inventory due to the fact of Geyser has no official way to texture it in their inventory sadly
enabled: true
force-refresh-textures: true
use-mojang-fallback: true


# Enable/disable player head drops on player death
player-head-drops-enabled: true

# Enable/disable mob head drops on mob death
mob-head-drops-enabled: false


geyser:
# Enter the prefix for the bedrock clients
prefix: "."

# sound settings
head-sound-effects:
# Enable/disable the noteblock sound replacement feature
enabled: true

# Play sound when head is placed on noteblock
play-on-place: false

# Show particle effects when sounds play
particles: true

# Send chat messages when animal sounds play
messages: false

# Volume for the animal sounds (0.1 to 2.0)
volume: 1.0

# Pitch for the animal sounds (0.5 to 2.0)
pitch: 1.0

# Drop chances for mob heads (percent)
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

So with this update you can expect significant performance improvements, including:

• 50–70% fewer GC allocations during serialization
• 30–40% faster mob head creation thanks to cached computations
• 60–80% reduction in file I/O operations
• 20–30% lower memory usage through more efficient cleanup
• Optimized Entity head spawning ( 70 ish iterations to 1 lookup) | direct HashMap lookup
• Player Name Validations checking added (Optional you can turn it off too )

Just make sure to add these lines to the config;
```
player-validation:
# Validation mode options:
# SERVER_ONLY - Only allow heads for players who have joined this server
# MOJANG_API - Check Mojang API to validate real Minecraft accounts (fastest, no server requirement)
# DISABLED - Allow any player name (no validation)
mode: "MOJANG_API"

# Cache validation results to improve performance (recommended: true)
cache-results: true

# How long to cache validation results in minutes (recommended: 5-15)
cache-duration: 5
```

and remove the previous Geyser info and place this in that plac:e
```
geyser:
# Enter the prefix for the bedrock clients
prefix: "."

```

Yeah so the issue where the users couldn't spawn in "_" entities such as "cave_spider" and etc has been fixed, there has also been a Texture change. And the tutorial video