SunBurn

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 ```