Skip to main content

Configuration

The configuration file for Nexal Heads. Located at plugins/Nexal Heads/config.yml.

config.yml
# ══════════════════════════════════════════════════════════
#                   NEXAL HEADS CONFIG
# ══════════════════════════════════════════════════════════

# Drop chance percentage (0-100)
# When a player is killed by another player, this is the base chance
# that their head will drop
drop-chance: 10

# Looting enchantment bonus per level (added to base chance)
# For example, with Looting III and base 10%, total chance is 25%
looting-bonus-per-level: 5

# Whether head drops are currently enabled
# Set to false to disable head drops globally without removing the plugin
enabled: true

# World blacklist - worlds where heads won't drop
# Players killed in these worlds will never drop their heads
blacklisted-worlds:
  - "spawn"
  - "hub"

# Permission-based chance modifiers
# Players with permission "nexalheads.chance.<key>" get this chance instead of the base chance
# For example, a player with "nexalheads.chance.vip" has 25% drop chance
# A player holding several tiers gets the highest one. The permissions are false by default,
# operators included: grant them through your permissions plugin
# Values must be plain numbers (25, not "25%")
permission-chances:
  vip: 25
  mvp: 40
  elite: 60

# Head item customization
head:
  # Display name format for dropped heads
  # Placeholders: %victim%, %killer%, %date%, %time%
  display-name: "<gradient:#FF69B4:#FF85C8><bold>%victim%'s Head</bold></gradient>"

  # Lore format for dropped heads
  # Placeholders: %victim%, %killer%, %date%, %time%
  lore:
    - ""
    - "<gradient:#AAAAAA:#BBBBBB>● Victim »</gradient> <white>%victim%</white>"
    - "<gradient:#AAAAAA:#BBBBBB>● Killer »</gradient> <white>%killer%</white>"
    - "<gradient:#AAAAAA:#BBBBBB>● Date »</gradient> <gradient:#FF9DCE:#FFB8DC>%date%</gradient>"
    - "<gradient:#AAAAAA:#BBBBBB>● Time »</gradient> <gradient:#FF9DCE:#FFB8DC>%time%</gradient>"
    - ""

  # Additional lore lines shown only when economy is enabled
  economy-lore:
    - "<gradient:#2ECC71:#52D68A>● Value »</gradient> <white>$%balance%</white>"
    - ""
    - "<gradient:#FFC107:#FFCD38>Right-click to claim!</gradient>"

# Storage type: "json" or "sql"
# JSON stores everything in data.json, SQL uses a MySQL database
storage:
  type: json
  sql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: ""

# Economy settings (requires Vault)
# When enabled, heads display a percentage of the victim's balance
# and can be right-clicked to steal that amount
economy:
  enabled: false
  # Percentage of victim's balance shown on head (0-100)
  balance-percentage: 10
  # How often head lore updates with current balance (in ticks, 20 = 1 second)
  update-interval: 20

Configuration Options​

Below is a reference of the main configuration sections:

drop-chance​

══════════════════════════════════════════════════════════ NEXAL HEADS CONFIG ══════════════════════════════════════════════════════════

Drop chance percentage (0-100) When a player is killed by another player, this is the base chance that their head will drop

looting-bonus-per-level​

Looting enchantment bonus per level (added to base chance) For example, with Looting III and base 10%, total chance is 25%

enabled​

Whether head drops are currently enabled Set to false to disable head drops globally without removing the plugin

blacklisted-worlds​

World blacklist - worlds where heads won't drop Players killed in these worlds will never drop their heads

permission-chances​

Permission-based chance modifiers Players with permission "nexalheads.chance.<key>" get this chance instead of the base chance For example, a player with "nexalheads.chance.vip" has 25% drop chance A player holding several tiers gets the highest one. The permissions are false by default, operators included: grant them through your permissions plugin Values must be plain numbers (25, not "25%")

Head item customization

storage​

Storage type: "json" or "sql" JSON stores everything in data.json, SQL uses a MySQL database

economy​

Economy settings (requires Vault) When enabled, heads display a percentage of the victim's balance and can be right-clicked to steal that amount