Povučeno
Hot reload plugina
Alat za razvoj koji je ponovo učitavao pojedinačne plugine umesto celog gamemode-a. Na njemu su se četiri meseca gradile nove funkcije, a onda je povučen.
- Uloga
- Dizajn i implementacija
- Tehnologije
- Lua (GLua), interni delovi NutScripta
- Kontekst
- Lokalni razvojni workflow
- Status
- Povučeno
Problem
Svaka izmena bilo kog fajla u gamemode-u ponovo je učitavala ceo gamemode, pa mi se lokalni server zamrzavao na dvadesetak sekundi svaki put kad sam hteo nešto da testiram, čak i za izmenu od jednog karaktera. Kroz ceo dan iteracija, to je mnogo čekanja.
Kako je radilo
- Plugini su premešteni van foldera gamemode-a, gde engine može sam da osveži pojedinačan fajl.
- Zaštitna linija na vrhu svakog plugin fajla hvatala je to osvežavanje i umesto toga ponovo učitavala plugine kroz moj sopstveni loader.
- Loader je preslikavao onaj iz frameworka: biblioteke, frakcije, klase, kod interfejsa, entitete, oružja, efekte, jezike, pod-plugine i iteme.
- Tabele plugina su se ponovo koristile između učitavanja, pa je stanje ostajalo sačuvano, a event handleri su se zamenjivali umesto da se dupliraju.
- Posle učitavanja ponovo je pokretao startne evente frameworka, uz listu izuzetaka za plugine koji nisu podnosili da se to izvrši dvaput.
- Profilisanje je pokazalo da je ponovno građenje spawn menija glavni izvor lagova, pa je ono isključeno tokom ponovnog učitavanja.
-- The one line at the top of every plugin file:
--
-- if (HR and HR()) then return end
--
-- When the engine refreshes a single plugin file, this hands the reload to my
-- loader and stops the stale copy from running on its own.
local function hotreloadPlugins()
if (HR_HOTRELOADING) then return end
HR_HOTRELOADING = true
hr.plugin.loadFromDir("plugins-hr") -- mirrors the framework's own loader (omitted)
-- Rebuilding the spawn menu was the main lag source, so it's suppressed during reloads.
hook.Add("SpawnMenuEnabled", "hotreload-lagfix", function() return false end)
-- Replay the framework's start-up events, skipping plugins on the
-- opt-out list that can't handle running them twice.
local skipped = {}
for uniqueID in pairs(skipInitializedPlugins) do
local plugin = nut.plugin.list[uniqueID]
local fn = hook.GetTable()["InitializedPlugins"][plugin]
if (fn) then
hook.Remove("InitializedPlugins", plugin)
skipped[plugin] = fn
end
end
hook.Run("InitializedPlugins")
for plugin, fn in pairs(skipped) do
hook.Add("InitializedPlugins", plugin, fn)
end
hook.Remove("SpawnMenuEnabled", "hotreload-lagfix")
hook.Run("InitializedItems")
HR_HOTRELOADING = nil
end
function HR()
-- Only plugins from the hot-reload folder are handled.
local src = debug.getinfo(2, "S").source
if (src and not string.find(src, "hotreload%-plugins")) then return end
-- Re-entrancy: never start a reload while one is running, while the loader
-- is including plugin files itself, or right after a full gamemode reload.
if (HR_HOTRELOADING) then return end
if (HR_PLUGIN_LOADING or HR_PLUGINS_ALREADY_LOADED) then return end
hotreloadPlugins()
return true
end
-- A full gamemode reload loads the plugins once, then blocks the per-file
-- guard for a second so every plugin file doesn't trigger its own reload.
hook.Add("OnReloaded", "hotreload-gm-reload", function()
if (HR_PLUGINS_ALREADY_LOADED) then return end
timer.Simple(0, hotreloadPlugins)
HR_PLUGINS_ALREADY_LOADED = true
timer.Create("hotreload-gm-reload", 1, 1, function()
HR_PLUGINS_ALREADY_LOADED = false
end)
end)Šta je sve izneo
Od februara do juna 2025. na njemu sam napravio većinu novih funkcija, između ostalog evente frakcija, blokade tokom sukoba, kriminalna skrovišta, torbe za oružje, barikade, obijanje brava i prvu verziju teških krivičnih dela.
Zašto je povučen
Slaba tačka mu je bio otisak u kodu. Svakom fajlu koji je trebalo da podržava hot reload bila je potrebna ta jedna zaštitna linija, pa je olakšica za moj lični workflow postala deo codebase-a koji održavaju svi ostali. Posle problema sa kompatibilnošću s jednim pluginom koji je pri pokretanju radio neobične stvari, vlasnik i ja smo se dogovorili da ga povučemo.
Da ga pravim ponovo, učinio bih ga nevidljivim za sam kod: file watcher samo za razvoj, koji plugine ponovo učitava spolja, van gamemode-a, bez ikakvih dodataka u plugin fajlovima.