Skip to content

Struktura resource ​

Každá resource je samostatná složka vlastněná jedním Lua runtime na každé aktivní straně.

Minimální layout ​

text
my_resource/
  manifest.lua
  client.lua
  server.lua
  resource.cfg
  data/
    settings.json
  assets/
    content.bundle

Povinný je jen manifest.lua. Skripty a soubory se načítají v pořadí deklarace.

Direktivy manifestu ​

lua
manifest_version '1.0.0'
name 'my_resource'
author 'Server Team'
version '1.0.0'
description 'An example gameplay resource'

client_scripts {
  'client/main.lua',
  'client/ui.lua'
}

server_scripts {
  'server/main.lua',
  'server/storage.lua'
}

files {
  'data/settings.json',
  'assets/item_icon.png'
}

asset_bundle 'assets/content.bundle'

Asset bundles jsou automaticky zahrnuté mezi synchronizované soubory. Serverové skripty jsou ze synchronizace ke klientům vyloučené.

Deklarativní vlastní obsah ​

Resources mohou při načítání manifestu registrovat obsah:

lua
derived_items {{
  base = 'SwordBlackmetal',
  prefab = 'ExampleSword',
  persistent = true,
  name = 'Example Sword',
  damage = { slash = 90 },
  recipe = {
    amount = 1,
    enabled = true,
    craftingStation = 'forge',
    minStationLevel = 2,
    resources = {
      { item = 'Iron', amount = 10 }
    }
  }
}}

Pro AssetBundle prefaby, bundle item, odvozený item, recept a odvozeného moba v jedné resource se podívejte na gold_mining example.

Konfigurace resource ​

Globální convars jsou v server.cfg. Hodnoty lokální pro resource patří do resource.cfg:

ini
set reward_amount "5"
setr display_name "Public event"

Čtení v Lua:

lua
local rewardAmount = GetResourceConvarInt('reward_amount', 1)
local displayName = GetResourceConvar('display_name', 'Event')

sets používejte jen pro secrety vlastněné enginem, například MySQL connection string. Tajné hodnoty nejsou dostupné přes Lua getter funkce.

Lifecycle ​

Zastavení resource odstraní její event handlery, příkazy, exports, naplánované úlohy, pending MySQL operace i načtené AssetBundles. Runtime ID neukládejte do persistent storage; hodnoty začínající na instance: nebo object: jsou platné jen v aktuálním procesu hry.

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