Complete Reflex module

We will build HealthWarning. The server observes local Agent health and the client displays a warning. The client sends a threshold; the server validates it and returns authoritative state only.

Structure

HealthWarning/
├── module.json
├── config.json
└── scripts/
    ├── main.lua
    └── server.lua

module.json must contain "IsReflex": true.

config.json

This is a regular module configuration using the Config format:

[
  {
    "label": "Show warning",
    "key": "Enabled",
    "type": "bool",
    "value": true
  },
  {
    "label": "Health threshold",
    "key": "Threshold",
    "type": "number",
    "value": 30,
    "min": 1,
    "max": 100
  }
]

scripts/main.lua

local ServerState = {
    health = 0,
    low = false
}

local LastEnabled = nil
local LastThreshold = nil

local function SendSettings()
    LastEnabled = Config.Enabled
    LastThreshold = Config.Threshold

    Network:SendTable({
        kind = "set_settings",
        enabled = Config.Enabled,
        threshold = Config.Threshold
    })

    Network:SendTable({
        kind = "request_state"
    })
end

Network:OnTableReceived(function(data)
    if data.kind == "health_state" then
        ServerState.health = tonumber(data.health) or 0
        ServerState.low = data.low == true
    end
end)

Scheduler:Schedule(0.5, SendSettings)

Scheduler:OnFrame(function()
    if LastEnabled ~= Config.Enabled
        or LastThreshold ~= Config.Threshold then
        SendSettings()
    end

    if Config.Enabled and ServerState.low then
        ImGui:DrawText(
            "LOW HEALTH: " .. tostring(ServerState.health),
            Rect.new((Screen.Width - 360) * 0.5, 90, 360, 48),
            24,
            Color.new(1, 0.25, 0.2, 1),
            TextAnchor.MiddleCenter
        )
    end
end)

scripts/server.lua

local State = {
    enabled = true,
    threshold = 30,
    health = -1,
    low = false
}

local function SendState()
    Network:SendTable({
        kind = "health_state",
        health = State.health,
        low = State.low
    })
end

Network:OnTableReceived(function(data)
    if data.kind == "set_settings" then
        local threshold = tonumber(data.threshold)

        if threshold ~= nil then
            State.threshold = math.max(1, math.min(100, threshold))
        end

        State.enabled = data.enabled == true
    elseif data.kind == "request_state" then
        SendState()
    end
end)

Scheduler:OnTick(function()
    local agent = Agents:GetLocalAgent()
    local health = 0
    local low = false

    if agent ~= nil and agent.Health ~= nil then
        health = agent.Health.CurrentHealth
        low = State.enabled
            and agent.Health.IsAlive
            and health <= State.threshold
    end

    if health ~= State.health or low ~= State.low then
        State.health = health
        State.low = low
        SendState()
    end
end)

Important details

• the client owns settings and presentation;
• the server clamps the threshold to 1…100;
• state is sent only when it changes;
• API objects never cross Network;
• both sides have safe defaults before synchronization.

Select HealthWarning as the active Reflex module and enter a custom server after saving the files.

Example reference: Network, Scheduler, Agent, Config, and ImGui.