Configuration Guide

Config file path: plugins/DeathMark/config.yml
Run /deathMark reload after editing to apply the changes

I. Full Config

# Language file
language: zh_CN
# Maximum number of marks
maxMark: 5
# Time required to reduce 1 mark (in minutes) (child nodes can be freely extended and modified, permission format: DeathMark.markTask.vip1)
markTask:
  # Time for default players
  default: 3
  # vip1 time, requires permission DeathMark.markTask.vip1
  vip1: 2
  # vip2 time, requires permission DeathMark.markTask.vip2
  vip2: 1
  # vip3 time, requires permission DeathMark.markTask.vip3
  vip3: 1
# Worlds where death does not add marks
whiteList:
  - "spawn"
# Whether to enable the death penalty based on conditions
condition:
  - ""
# Attribute buff granted per mark level, extend it based on your maximum mark count
# Configured by attribute type, supported types: attribute_plus / sx_attribute / AttributeSystem / MythicLib / potionEffect
# Multiple types can be configured at the same time and all take effect; types whose plugin is not installed are skipped automatically
# potionEffect format: potion_name:level:duration(tick):hide_particles
#   Example: WEAKNESS:1:3600:false means level 1 Weakness, lasting 3600 ticks (3 minutes), with particles shown
#   The 4th segment can be omitted, particles are hidden by default when omitted; only writing true hides them
#   The 3rd segment must be a number, writing a non-number falls back to the default 1728000 ticks (24 hours)
# Attribute type format: attribute_name: value  Example: "Health: -1"
markAttrBuff:
  1:
    # Death notification
    message: "&7You have died, current death mark level: &a1&7, gained level 1 negative potion effect (disappears after 3 minutes)"
    # Death debuff
    buff:
      potionEffect:
        - "WEAKNESS:1:3600:false"
  2:
    message: "&7You have died, current death mark level: &a2&7, gained level 2 negative potion effect (downgraded after 3 minutes)"
    buff:
      potionEffect:
        - "WEAKNESS:2:3600:false"
        - "HUNGER:2:3600:false"
  3:
    message: "&7You have died, current death mark level: &a3&7, gained level 3 negative potion effect (downgraded after 3 minutes)"
    buff:
      potionEffect:
        - "WEAKNESS:3:3600:false"
        - "HUNGER:3:3600:false"
        - "SLOWNESS:3:3600:false"
  4:
    message: "&7You have died, current death mark level: &a4&7, gained level 4 negative potion effect (downgraded after 3 minutes)"
    buff:
      potionEffect:
        - "WEAKNESS:4:3600:false"
        - "HUNGER:4:3600:false"
        - "SLOWNESS:4:3600:false"
        - "MINING_FATIGUE:4:3600:false"
  5:
    message: "&7You have died, current death mark level: &a5&7, gained level 5 negative potion effect (downgraded after 3 minutes)"
    buff:
      potionEffect:
        - "WEAKNESS:5:3600:false"
        - "HUNGER:5:3600:false"
        - "SLOWNESS:5:3600:false"
        - "MINING_FATIGUE:5:3600:false"
        - "UNLUCK:5:3600:false"
# Death drop config
deathDrop:
  # Whether to enable death drops
  enable: false
  # Money drop config (requires Vault)
  money:
    # Whether to enable money drops
    enable: true
    # Drop type: fixed | random | percentage
    type: "random"
    # Fixed amount (used when type is fixed)
    fixedAmount: 100.0
    # Random range (used when type is random)
    randomMin: 50.0
    randomMax: 200.0
    # Percentage (used when type is percentage, 0.1 means 10%)
    percentage: 0.1
  # Experience level drop config
  experience:
    # Whether to enable experience drops
    enable: true
    # Drop type: fixed | random | percentage
    type: "random"
    # Fixed level count (used when type is fixed)
    fixedLevels: 2
    # Random level range (used when type is random)
    randomMin: 1
    randomMax: 3
    # Percentage (used when type is percentage, 0.2 means 20%)
    percentage: 0.2
# Enable update notifications, recommended
isCheckUpdate: true
# Send update notifications when an OP logs in
isCheckUpdateToOpMsg: true

II. Per-Level Mark Config

markAttrBuff configures the death notification and negative effects for each mark level. Levels can be extended freely.

markAttrBuff:
  1:
    # Death notification
    message: "&7You have died, current death mark level: &a1&7, gained level 1 negative potion effect (disappears after 3 minutes)"
    # Death debuff
    buff:
      potionEffect:
        - "WEAKNESS:1:3600:false"

Node	Description
message	Message sent on death, supports color codes
buff	Negative effects applied on death, grouped by type

III. Buff Types and Format

Entries under buff are grouped by attribute type. Multiple types can be configured at the same time and all take effect; types whose plugin is not installed are skipped automatically.

Type	Description
potionEffect	Vanilla potion effects
attribute_plus	AttributePlus
sx_attribute	SX-Attribute
AttributeSystem	AttributeSystem
MythicLib	MythicLib / MMOItems

potionEffect format

potion_name:level:duration(tick):hide_particles

WEAKNESS:1:3600:false

1. WEAKNESS potion name, see PotionEffectType
2. 1 potion level
3. 3600 duration, in ticks, 3600 ticks is about 3 minutes
4. false whether to hide particles, only writing true hides them

The 4th segment can be omitted, particles are hidden by default when omitted
The 3rd segment must be a number, writing a non-number falls back to the default 1728000 ticks (24 hours)

Attribute type format

attribute_name: value

Health: -1

Attribute buff entries must follow the format of the corresponding attribute plugin