☢️ Alexy's Radiation Lib — Zones, Radiations & Emissions

RadioLib is a STALKER/Stalcraft-inspired radiation system for Forge 1.20.1. It is not plug-and-play: it needs configuring, and is aimed at server admins who want a radiation system on a modded server.

The mod is the engine (radiation, zones, damage, sync); the content (loot, quests, balance) is left to you, via config and KubeJS.

You can find a detailed "wiki" in the ./config/radlib/wiki.txt that explains every command, feature and KubeJS api usage.

Features

Three radiation types

rad (ionizing), bio (contamination), and psy (psychic). Each has its own damage type, decay rate, and debuff effects. All of them bypass armor — only configured anti-rad gear reduces them.

Zones

Define radioactive areas with a selection wand, as boxes or per-block contact hazards (e.g. seagrass, magma). There are 6 tiers, from 0 (faint background) to 5 (kills an unprotected player in seconds). A toggle key (default ALT+Z) shows zones as colored wireframes.

Bunkers

Safe zones that block radiation intake and protect from emissions while you are inside them.

Emissions

A timed, server-wide event. During it the sky is replaced by a custom skybox, clouds are hidden, fog thickens, ambient sounds play, and a warning shows above the hotbar. Players who are not in a bunker take lethal damage after a short exposure. Timings are set per command and synced to clients.

Attributes / gear

Radiation resistance, dose tolerance, and recovery are attributes you assign to armor or Curios via config. There are also negative attributes for items that irradiate the wearer.

Geiger counter

A Curios item that plays a ticking sound whose intensity follows the radiation tier at your position.

Anti-rad consumables

Any food or drink can be configured to remove dose, grant temporary resistance, or speed up decay.

Debuffs

Per-type poisoning stages (low to acute) with configurable damage, chance, and potion effects. Configuration is in JSON (comments supported), and a wiki.txt reference is generated into the config folder.

For servers

• KubeJS API — a facade plus events (emission phase, death by radiation, zone enter/exit, stage change) for scripting loot, quests, auto-emissions, zone gating, etc.
• Multiplayer — zones sync to clients automatically; the server is authoritative for damage.
• Commands — zones, bunkers, emissions, and dose management are handled through /radiation.

Quick start

1. Install the mod (Forge 1.20.1) with Curios.
2. /radiation tool give, select two corners, then /radiation zone create rad 4 wasteland.
3. Press ALT+Z to view the zone.
4. /radiation emission start 30 60 to test an emission.