Skip to content

If-Master/HeadHunter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 

Repository files navigation

HeadHunter

With this plugin you are able to config both player heads and mob heads following information will be both how to activate it and the permissions related to it

Current version: 2.0.9 API-version: 1.21

Activating is as simple as placing it in your plugins folder. Following is the config of this plugin it will be updated accordingly:

#######################################################################
# 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
  skeleton: 0
  wither_skeleton: 0 # This could cause the item to drop twice one with the lore other with basic minecraft stats
  ender_dragon: 0
  creeper: 0
  piglin: 0
  zombie_nautilus: 30.1
  nautilus: 30.1
  parched: 10.0
  camel_husk: 1.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

Permissions:

  headhunter.update:
    description: Allows updaing the plugin
    default: op
  headhunter.reload:
    description: Allows reloading the plugin configuration
    default: op
  headhunter.spawn:
    description: Allows spawning heads with commands
    default: op
  headhunter.purchased:
    description: Allows spawning heads with commands (Console)
    default: op

  headhunter.*:
    description: Gives access to all HeadHunter permissions
    default: op
    children:
      headhunter.reload: true
      headhunter.spawn: true
      headhunter.update: true
      headhunter.purchased: true

Known issues:

  1. Texture ain't shown on bedrock clients - With Geyser ( Gonna work on that for a future update )

About

A plugin that drops player and mob heads when killed

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages