Skip to content

Gameplay a svět ​

Hráči ​

Běžná volání pro hráče:

lua
Player.GetAll()
Player.GetName(peerId)
Player.GetSteamId(peerId)
Player.GetPos(peerId)
Player.GetHealth(peerId)
Player.Notify(peerId, message, kind)
Player.PlayEffect(peerId, prefabName)

Pozice, zdraví, stamina, inventář i rozhodnutí o oprávnění musí být autoritativní na serveru.

Kontejnery a equipment ​

Serverové změny; objevování na klientu i serveru

lua
local nearby = Container.FindNearby(x, y, z, 20, nil, 'vanilla')
local items = Container.GetAllItems(containerId)

Container.TransferFromPlayer(containerId, peerId, itemId, amount)
Container.TransferToPlayer(containerId, peerId, itemId, amount)

Stav kontejneru se persistuje podle world-scoped ID. Server umí objevit i měnit enrolled unloaded kontejnery bez živého Unity objektu.

Equipment API zpřístupňuje vybavené sloty a bezstavové take/give operace pro Lua-owned gear systémy:

lua
local equipped = Equipment.GetEquipped(peerId)
local item = Equipment.TakeEquipped(peerId, 'helmet')
Equipment.GiveItem(peerId, item, true)

UI ​

Client

lua
UI.ShowPanel('status', {
  title = 'Server status',
  rows = {
    { label = 'Event', value = 'Active' },
    { label = 'Players', value = '12' }
  }
})

UI.HidePanel('status')

Lehké panelové API je určené pro status a utility rozhraní. Browser-based NUI runtime není součástí aktuálního releasu.

Assety, itemy, recepty a mobové ​

Resources mohou deklarovat vlastní obsah v manifest.lua nebo ho registrovat přes runtime API:

lua
Asset.HasPrefab(prefabName)
AssetBundle.Load(relativePath)
AssetBundle.RegisterNetworkPrefab(relativePath, assetName, persistent)
AssetBundle.RegisterItem(relativePath, assetName, persistent)
Item.RegisterDerived(basePrefab, prefabName, definition, persistent)
Mob.RegisterDerived(basePrefab, prefabName, definition, persistent)
Recipe.Upsert(itemPrefab, definition)
World.SpawnNetworked(prefabName, x, y, z, rotationY)
World.DestroyNetworked(zdoId)

Pro obsah odkazovaný world savy nebo inventáři používejte persistent registration. Kompletní registrační cestu ukazuje gold_mining example.

Spravovaná zvířata ​

Server. Animal.* vytváří persistentní zvířata Valheimu podle stabilního resource-owned tagu. AI běží na aktuálním síťovém vlastníkovi:

lua
local player = Player.GetIdentity(peerId)
if player then
  local p = player.position
  local id = Animal.Ensure('Boar', 'pet:42', p.x + 2, p.y, p.z, 'Betty')
  Animal.SetHome(id, p.x, p.y, p.z, 7)
  Animal.Follow(id, peerId)
end

Životní cyklus doplňují Animal.Find, Animal.Get, Animal.Rename, Animal.Heal a Animal.Destroy. API kontroluje resource vlastnictví; oprávnění hráče a vzdálenost musí ověřit volající resource.

Vanilla množení, růst a loot jsou vypnuté. Zvířata přežijí stop resource i world save; klienti i server musí mít aktualizovaný engine. World.GetId() vrací world UID jako řetězec; Time.Unix() vrací UTC sekundy.

Viz ranch example a úplné API kontrakty.

Pozemky a ochrana přístupu ​

Serverová autorita / klientské ochranné snapshoty. Persistentní katalog spravuje aprts_landmark. Land.Get(id, peer) a Land.GetAt(peer) vracejí pozemek s efektivní úrovní access. Land.ContainsDisc(id, x, y, z, radius) ověří, že se celá kruhová ohrada vejde do polygonu v rovině XZ.

Před asynchronním zápisem ranče použijte Land.Reserve(id, peer, level) a při každém dokončení/chybě Land.Release(token). Aktualizace katalogu používá Land.BeginUpdate, ValidateUpdate, CommitUpdate a AbortUpdate. Land.SetUsage(ids) chrání používané pozemky před smazáním a změnou tvaru. Mezi rančem a pozemky nevytvářejte cyklické synchronní exporty.

Úrovně jsou kumulativní: 1 dveře/péče, 2 kontejnery, 3 stavění/opravy/bourání, 4 plné užívání. Pouze vlastník/admin mění klíče nebo vlastnictví. Nativní ochrana kontroluje i hráčské poškození staveb a přijímaná interakční RPC, ale neobchází wardy a není zárukou proti upraveným klientům.

Viz landmark setup a úplné kontrakty Land API.

Zóny ​

Client / Server; pro autoritativní gameplay vlastněné serverem

lua
Zone.CreateCircle('arena', x, y, z, 30)

AddEventHandler('zone:onEnter', function(zoneName, peerId)
  if zoneName == 'arena' then
    Player.Notify(peerId, 'Arena entered', 'TopLeft')
  end
end)

Kruhové i polygonové zóny vyvolávají enter a exit events a automaticky se odstraní při zastavení vlastnící resource.

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