modmain.lua

-- Axogc Platform mod entry.
--
-- Topology: a DST "cluster" runs N shards (typically Forest=Master + Caves=Slave).
-- HTTP bridge work is per-cluster, so it must run exactly once — on the Master.
-- Slave shards early-return below; they still load the mod files (the game
-- decides per-shard), but exit before doing anything.
--
-- Module loading: DST mods do not expose `require` for files under the mod
-- folder. We use modimport, which evaluates each file in the mod sandbox.
-- Shared state lives in GLOBAL.AxoPlatform; every module top-locals
--   local Platform = GLOBAL.AxoPlatform
-- and appends its public functions onto it. Load order below = dependency
-- order; a module may only call into modules listed above it.

if not GLOBAL.TheNet:GetIsServer() then return end
if not GLOBAL.TheNet:GetIsMasterSimulation() then return end

GLOBAL.AxoPlatform = GLOBAL.AxoPlatform or {}
local Platform = GLOBAL.AxoPlatform
Platform.MODNAME = modname

-- Expose commonly-used Lua globals to every modimported file. The DST mod
-- sandbox (CreateEnvironment in scripts/mods.lua) only auto-injects
-- pairs / ipairs / print / math / table / type / string / tostring / require
-- / Class — everything else (pcall, tonumber, os, ...) must come via GLOBAL.
-- Assigning here sets them on the shared `env` table so every later
-- modimport sees them as bare names.
pcall    = GLOBAL.pcall
tonumber = GLOBAL.tonumber
os       = GLOBAL.os

-- Pull deployment-specific values from the per-cluster modoverrides.lua.
-- The option names match the entries declared in modinfo.lua. Admins set
-- real values like:
--   ["axogc-platform"] = {
--     enabled = true,
--     configuration_options = {
--       base_url = "https://www.axogc.net",
--       token    = "abcdef...",
--     },
--   }
-- Missing config is tolerated here — settings.lua / init.lua catch the
-- empty-string case and log a clear "bridge disabled" warning.
Platform.BASE_URL = (GetModConfigData("base_url") or ""):gsub("/+$", "")
Platform.TOKEN    = GetModConfigData("token") or ""

modimport("scripts/platform/settings.lua")
modimport("scripts/platform/util.lua")
modimport("scripts/platform/transport/http.lua")
modimport("scripts/platform/transport/poll.lua")
modimport("scripts/platform/stats/axes.lua")
modimport("scripts/platform/observation/stats.lua")
modimport("scripts/platform/observation/walk_sampler.lua")
modimport("scripts/platform/chat/chat.lua")
modimport("scripts/platform/commands/bind.lua")
modimport("scripts/platform/handlers/notify.lua")
modimport("scripts/platform/handlers/broadcast.lua")
modimport("scripts/platform/handlers/kick.lua")
modimport("scripts/platform/handlers/chat_from_web.lua")
modimport("scripts/platform/handlers/stats_fetch.lua")
modimport("scripts/platform/handlers/whitelist.lua")
modimport("scripts/platform/handlers/metrics_list.lua")
modimport("scripts/platform/handlers/leaderboard_fetch.lua")
modimport("scripts/platform/handlers/admin_command.lua")
modimport("scripts/platform/handlers/dispatch.lua")
modimport("scripts/platform/rank/snapshot.lua")
modimport("scripts/platform/observation/events.lua")
modimport("scripts/platform/init.lua")

-- Per-player init: fires when each player entity spawns. The handler
-- subscribes per-player events (death / killed / builditem).
AddPlayerPostInit(function(inst)
    Platform.on_player_post_init(inst)
end)

-- World postinit: world entity exists, safe to schedule periodic tasks and
-- subscribe to world-level events (ms_playerjoined / ms_playerleft).
AddPrefabPostInit("world", function(inst)
    Platform.on_world_post_init(inst)
end)

-- /bind <CODE>: register as a real DST user command (instead of intercepting
-- chat). Client-side parsing keeps the verification code out of public chat.
-- See scripts/platform/commands/bind.lua for the rationale and the handler.
AddUserCommand("bind", {
    prettyname = "绑定平台账号",
    desc = "Bind your in-game name to your platform account.",
    permission = GLOBAL.COMMAND_PERMISSION.USER,
    slash = true,
    usermenu = false,
    servermenu = false,
    params = { "code" },
    paramsoptional = { false },
    vote = false,
    serverfn = function(params, caller)
        -- serverfn runs on the master sim (this shard). caller is the
        -- player entity issuing the command.
        if caller and params and params.code then
            Platform.bind_handle(caller, params.code)
        end
    end,
})