Skip to content

Bezpečnost a oprávnění ​

Valheim Lua Engine poskytuje server-side ACE kontroly, ale validaci vstupů i rozhodnutí o autorizaci stále vlastní kód resource.

Omezení příkazů ​

Předáním true vynutíte command.<commandName>:

lua
RegisterCommand('spawn_boss', function(source, args)
  -- Spustí se až po úspěšné serverové ACE kontrole.
end, true)

Předáním ACE jména použijete explicitní oprávnění:

lua
RegisterCommand('event_start', function(source)
  -- Start eventu.
end, 'events.manage')

Konfigurace ACE ​

Granty a principals přidejte do server.cfg:

ini
add_ace group.admin command allow
add_ace group.moderator events.manage allow
add_principal identifier.steam:76561198000000000 group.admin

ACE granty jsou hierarchické. command i command.* pokrývají command.spawn_boss. Aktuální runtime podporuje allow; pravidla deny se odmítají s varováním.

Stávající skupiny v permissions.json zůstávají podporované. Pravidla ze server.cfg se přidávají jako runtime overlay.

Ochrana síťových událostí ​

RegisterNetEvent umožní vzdálenému volajícímu dosáhnout na handler. Samo o sobě ho ale neautorizuje.

Pro každou serverovou síťovou událost:

  1. uložte a ověřte source
  2. podle potřeby zkontrolujte Player.HasPermission nebo IsPlayerAceAllowed
  3. ověřte všechny argumenty a omezte číselné rozsahy
  4. pozici a identitu hráče zjišťujte na serveru
  5. změny provádějte pouze přes serverová API
lua
RegisterNetEvent('admin:give_coins', function(targetPeer, amount)
  local adminPeer = source

  if not IsPlayerAceAllowed(adminPeer, 'inventory.give') then
    return
  end

  local safeAmount = math.floor(tonumber(amount) or 0)
  if safeAmount < 1 or safeAmount > 100 then
    return
  end

  Inventory.AddItem(targetPeer, 'Coins', safeAmount)
end)

Nedůvěřujte klientskému stavu

Upravený klient může volat registrované events přímo. Skrytí příkazu nebo UI prvku na klientovi není autorizační mechanismus.

Lua resources pro Valheim postavené na server-authoritative runtime.