Čeština
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.