Installation

2 min readUpdated Today

Overview

ML Radiation adds configurable radiation zones with a Geiger Counter UI system. Players accumulate radiation inside zones, take damage at thresholds, and use cure/immunity items for protection. Includes a 3D Geiger Counter prop with DUI rendering, battery system, vehicle/clothing protection, and persistent radiation tracking.

Quick Start

  1. Download from CFX Portal
  2. Extract to your resources folder as ml_radiation
  3. Add to server.cfg:
server.cfg
1ensure oxmysql
2ensure ox_lib
3ensure ml_bridge
4ensure ml_radiation
Load Order

ml_radiation must start AFTER ml_bridge. The folder must be named exactly ml_radiation.

Database

The table is created automatically on first start:

ml_player_radiation: Stores per-player radiation level (auto-saved every 5 minutes and on disconnect)

Item Registration

Register items from _INSTALL/ in your inventory system.

Geiger Counter items: If using Advanced mode (Config.RealTerminalItem = true), register all items in Config.AdvancedItems. If using Simple mode (Config.RealTerminalItem = false), register only the item in Config.SimpleMode.

Cure items: Register items listed in Config.CureItems.Items (e.g. antiradiation syringes)

Immunity items: Register items in Config.ImmunityItems.Items (e.g. iodine pills)

Battery recharge item: Register the item in Config.Battery.rechargeItem

Stream Assets

The resource includes a custom 3D Geiger Counter model (dgm_geiger.ytyp) in the stream/ directory. Loaded automatically via the manifest.

Verify

After starting, the console will print:

lua
1[ml_radiation] Resource started
2[ml_radiation] Developed by Micio Mods | miciomods.it

Use a registered Geiger Counter item to activate the UI.

  • Geiger Counter doesn't open. Verify the item is registered in your inventory and matches the name in Config.AdvancedItems or Config.SimpleMode.
  • Resource name error on startup. The folder must be named exactly ml_radiation.
  • Radiation is not saving. Check that oxmysql is running. Look for errors related to ml_player_radiation in the console.
  • No visual effects. If Config.HealthSystemIntegration = true, damage and visuals are handled by ml_healthsystem instead.