Skip to content

Klient a server ​

Každá synchronizovaná resource může mít klientské VM, serverové VM nebo oboje. Síťovou hranici berte jako trust boundary.

Vyberte vlastnickou stranu ​

ČinnostStrana
Vstup, lokální UI, vizuální náhledyKlient
Změny inventáře nebo kontejneruServer
Oprávnění a odměnyServer
Persistentní stavServer
Notifikace lokálnímu hráčiKlient nebo server mířící na klienta

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

lua
-- client.lua
RegisterCommand('claim_reward', function()
  TriggerServerEvent('rewards:claim', 'daily')
end, false)
lua
-- server.lua
RegisterNetEvent('rewards:claim', function(rewardId)
  local peerId = source

  if rewardId ~= 'daily' then
    return
  end

  if not Player.HasPermission(peerId, 'rewards.claim') then
    return
  end

  local revision = Inventory.GetRevision(peerId)
  Inventory.AddItem(peerId, 'Coins', 10, 1, revision)
end)

Serverový handler ověří požadovanou odměnu, zkontroluje oprávnění a provede změnu. Nikdy bez ověření na serveru nepřebírejte od klienta item prefab, množství, výsledek permission checku, pozici ani identitu hráče.

Hodnota source ​

Uvnitř handleru síťové události je globální source peer ID odesílatele. Uložte si ji dřív, než spustíte asynchronní práci:

lua
RegisterNetEvent('profile:load', function()
  local peerId = source

  MySQL.single('SELECT title FROM profiles WHERE steam_id = @id', {
    ['@id'] = Player.GetSteamId(peerId)
  }, function(row)
    if row then
      TriggerClientEvent('profile:title', peerId, row.title)
    end
  end)
end)

Lokální events a exports ​

TriggerEvent používejte pro volnější propojení práce na stejné straně. Exports používejte pro synchronní kontrakt mezi resources:

lua
-- provider/server.lua
exports('getMultiplier', function()
  return 1.25
end)

-- consumer/server.lua
local multiplier = exports['provider'].getMultiplier() or 1

Exports neumí překročit hranici klient/server.

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