Alexy's Radiation Lib

☢️ 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 requires configuration and is aimed at server admins who want a customizable radiation system for their modded server.

The mod provides 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 radiation types bypass armor — only configured anti-radiation gear reduces them.

Zones

Define radioactive areas using a selection wand as boxes or per-block contact hazards (e.g. seagrass, magma). There are 6 tiers, from 0 (faint background radiation) to 5 (kills an unprotected player in seconds).

A toggle key (default: ALT+Z) displays zones as colored wireframes.

Bunkers

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

Emissions

A timed, server-wide event. During an emission:

• The sky is replaced with a custom skybox
  
• Clouds are hidden
  
• Fog thickens
  
• Ambient sounds play
  
• A warning appears above the hotbar
  

Players outside a bunker take lethal damage after a short exposure. Timings are configured per command and synced to clients.

Attributes / Gear

Radiation resistance, dose tolerance, and recovery are configurable attributes assignable to armor or Curios. Negative attributes can also be applied to items that irradiate the wearer.

Geiger Counter

A Curios item that emits ticking sounds whose intensity scales with the radiation tier at your location.

Anti-rad consumables

Any food or drink can be configured to:

• Reduce radiation dose
  
• Grant temporary resistance
  
• Accelerate decay
  

Debuffs

Per-type poisoning stages (low to acute) with configurable damage, chance, and potion effects.

Configuration is handled via JSON (comments supported), and a wiki.txt reference file is generated in the config folder.

---

For Servers

• KubeJS API — includes a facade and events (emission phases, radiation death, zone enter/exit, stage changes) for scripting loot, quests, auto-emissions, zone gating, and more.
  
• Multiplayer — zones sync automatically to clients; the server remains authoritative for damage.
  
• Commands — zones, bunkers, emissions, and dose management are handled via /radiation.
  

Compatibility

• Optional: Curios (for the Geiger counter), KubeJS