Sunburn

Sunburn — a plugin that makes players vulnerable to sunlight, just like zombies.

Key Features

• 🔥 Players ignite in direct sunlight when standing under the open sky.
• ⛑ Helmets protect from sun damage but gradually lose durability.
• 🎭 Any other head-slot item may drop to the ground with a configurable chance, leaving the player exposed and burning.
• 🌑 Burning depends on light level: by default, players are safe at SunLight < 15. This threshold is configurable.
• 🌊 Being in water provides full protection from the sun.
• ⚙️ Flexible configuration:
  • adjustable burn duration
  • multiple shadow detection modes (SKYLIGHT, ANYLIGHT, MATERIALCONFIG)
  • customizable lists of helmets and transparent blocks
  • configurable drop chance for non-helmet head-slot items

Commands

/sunburn on — activates sunburn
/sunburn off — deactivates sunburn
/sunburn status — shows the current config parameters in chat
/sunburn reload — reloads the config
/sb — alias for /sunburn

You must have OP to execute these commands.

Default config

#   _____ _    _ _   _ ____  _    _ _____  _   _ 
#  / ____| |  | | \ | |  _ \| |  | |  __ \| \ | |
# | (___ | |  | |  \| | |_) | |  | | |__) |  \| |
#  \___ \| |  | | . ` |  _ <| |  | |  _  /| . ` |
#  ____) | |__| | |\  | |_) | |__| | | \ \| |\  |
# |_____/ \____/|_| \_|____/ \____/|_|  \_\_| \_|

# Main plugin configuration

cooldown-tick-period: 60
# Ticks: 20 - 100
# Defines how frequently the sun strikes
# CAUTION! May reduce performance on lower values!

burning-duration: 100
# Ticks: 0 - 500
# Defines how long the player will burn after each sun strike
# BE AWARE - if player is already burning, this may do nothing

sun-burn-mode: SKYLIGHT
# Mode: SKYLIGHT / ANYLIGHT / MATERIALCONFIG
# Defines how plugin decides if the player is in shadow
# ---
# SKYLIGHT
# Only sky light level matters
# This is set by default
# ---
# ANYLIGHT
# Any light source matters
# This may be too much, be careful
# ---
# MATERIALCONFIG
# Now player is in shadow if there is any opaque block above him
# If all blocks above the player are transparent - he is exposed to the sun strike
# You can change which block is transparent manually (check 'settings' folder)
# In this folder there are 'transparent-materials.yml' and 'transparent-tags.yml'
# ---

min-light-level: 15
# Integer: 0 - 16
# Defines the minimum level of light required to damage the player
# If set to 16 - it never damages; if set to 0 - it damages anywhere
# This parameter does nothing if MATERIALCONFIG mode is set

player-damage: 0
# Integer: 0 - 100
# Defines how much damage player will receive on each sun strike
# BE AWARE - this is direct damage, it does not include potential damage by fire

helmet-damage: 1
# Integer: 0 - 50
# Defines how much damage equipped helmet will receive on each sun strike
# You can manually change list of items that are considered as helmets ('settings' folder)
# In this folder there is "helmet-materials.yml', check its content

non-helmet-drop-chance: 3.5
# Percentage: 0 - 100 (may be decimal, up to 4 digits accuracy)
# Defines how likely equipped non-helmet will drop on each sun strike
# If less than 0 - any non-helmet item (pumkin, player's head, etc.) does not defend from the sun!
# If set to 0 - any non-helmet item defends from the sun unless taken off
# You can manually change list of items that are considered as 'non-protecting' ('settings' folder)
# In this folder there is "helmet-materials.yml', check its content
# Items marked as 'non-protecting' WILL NOT defend from the sun, even if this config is enabled
# Such items will not be dropped from the head slot either (no matter what the drop chance is)
# Items marked as 'perm-protecting' WILL defend from the sun and have no chance to be dropped

water-defence: false
# Boolean: true / false
# Permanently blocks any sun damage if player is in water

Material Config

materials:
  - GLASS
  - WHITE_STAINED_GLASS
  - LIGHT_GRAY_STAINED_GLASS
  - GRAY_STAINED_GLASS
  - BLACK_STAINED_GLASS
  - BROWN_STAINED_GLASS
  - RED_STAINED_GLASS
  - ORANGE_STAINED_GLASS
  - YELLOW_STAINED_GLASS
  - LIME_STAINED_GLASS
  - GREEN_STAINED_GLASS
  - CYAN_STAINED_GLASS
  - LIGHT_BLUE_STAINED_GLASS
  - BLUE_STAINED_GLASS
  - PURPLE_STAINED_GLASS
  - MAGENTA_STAINED_GLASS
  - PINK_STAINED_GLASS
  - GLASS_PANE
  - WHITE_STAINED_GLASS_PANE
  - LIGHT_GRAY_STAINED_GLASS_PANE
  - GRAY_STAINED_GLASS_PANE
  - BLACK_STAINED_GLASS_PANE
  - BROWN_STAINED_GLASS_PANE
  - RED_STAINED_GLASS_PANE
  - ORANGE_STAINED_GLASS_PANE
  - YELLOW_STAINED_GLASS_PANE
  - LIME_STAINED_GLASS_PANE
  - GREEN_STAINED_GLASS_PANE
  - CYAN_STAINED_GLASS_PANE
  - LIGHT_BLUE_STAINED_GLASS_PANE
  - BLUE_STAINED_GLASS_PANE
  - PURPLE_STAINED_GLASS_PANE
  - MAGENTA_STAINED_GLASS_PANE
  - PINK_STAINED_GLASS_PANE
  - CHAIN
  - IRON_BARS
  - COPPER_GRATE
  - EXPOSED_COPPER_GRATE
  - WEATHERED_COPPER_GRATE
  - OXIDIZED_COPPER_GRATE
  - WAXED_COPPER_GRATE
  - WAXED_EXPOSED_COPPER_GRATE
  - WAXED_WEATHERED_COPPER_GRATE
  - WAXED_OXIDIZED_COPPER_GRATE
  - LIGHTNING_ROD
  - END_ROD
  - TORCH
  - SOUL_TORCH
  - REDSTONE_TORCH
  - LANTERN
  - SOUL_LANTERN
  - CONDUIT
  - COBWEB
  - STRING
  - TRIPWIRE_HOOK
  - REDSTONE_WIRE
  - SMALL_AMETHYST_BUD
  - MEDIUM_AMETHYST_BUD
  - LARGE_AMETHYST_BUD

Helmet config

helmet-materials:
  - LEATHER_HELMET
  - CHAINMAIL_HELMET
  - IRON_HELMET
  - GOLDEN_HELMET
  - DIAMOND_HELMET
  - NETHERITE_HELMET
  - TURTLE_HELMET
non-protecting-materials: copy-from-transparent-materials

perm-protecting-materials:
  - BEDROCK