Skip to content

Rychlý start pro správce serveru ​

Tato stránka je pro lidi, kteří provozují Valheim server s už nainstalovaným Valheim Lua Engine z Thunderstore. Pokud chcete psát Lua resources, přejděte místo toho na Začínáme.

Co skutečně spravujete ​

Jako správce serveru obvykle řešíte čtyři věci:

  1. stejná verze enginu je na serveru i klientech
  2. jsou zapnuté jen resources, které chcete
  3. admin přístup a omezené příkazy jsou bezpečně nastavené
  4. persistence a WebAdmin jsou použitelné v produkci

Pro provoz balíčku nemusíte znát, jak je C# plugin zkompilovaný.

Instalace a první spuštění ​

Nainstalujte Valheim Lua Engine přes Thunderstore kompatibilní mod manager.

Po instalaci balíček umístí engine a ukázkové resources do adresářů Valheim a BepInEx pluginů. Při prvním spuštění:

  1. jednou spusťte server, aby se vytvořily konfigurační soubory
  2. otevřete BepInEx/config/ValheimLua/server.cfg
  3. nahraďte placeholdery txadmin_user a txadmin_password
  4. rozhodněte, které resources mají být aktivní pomocí ensure <resource_name>

Server i připojení klienti musí používat stejnou verzi Valheim Lua Engine.

Zapněte jen resources, které chcete ​

Ukázkové resources jsou nainstalované v BepInEx/plugins/ValheimLua/resources.

Zapnutí resource v server.cfg:

ini
ensure gear_panel
ensure persistent_chest

Resource vypnete odstraněním nebo zakomentováním její ensure řádky.

Přibalené resources a k čemu se hodí:

  • gold_mining: ukázka vlastního naleziště rudy, itemu, odvozeného meče, receptu a odvozeného moba
  • gear_panel: extra equip sloty s persistencí a lehkým UI
  • inventory_native_test: referenční resource pro inventory revision a transaction workflow
  • persistent_chest: persistence kontejneru vlastněného resource s JSON nebo MySQL backendem
  • quest_event_demo: příklad questů a event flow
  • zone_quest_demo: příklad quest progressu řízeného zónami

WebAdmin a provozní operace ​

WebAdmin je určený pro každodenní provoz, správu resources a vizuální editaci workflow.

Používejte ho pro:

  • start, stop a restart resources
  • logy, konzolový stream a runtime health kontroly
  • Visual Flow Builder (Webflow): vizuální návrh, testování a ukládání Lua event workflow přímo v prohlížeči
  • kontrolu oprávnění a konfiguraci convarů
  • profiling CPU, paměti a front i diagnostiku
  • administraci inventáře offline hráčů a stav quest systému

Nenechávejte výchozí WebAdmin přihlašovací údaje. Nahraďte txadmin_user a txadmin_password v server.cfg.

Oprávnění a omezené příkazy ​

Valheim Lua Engine podporuje FiveM-style ACE oprávnění.

Typický vzor:

ini
add_principal identifier.steam.1234567890 group.admin
add_ace group.admin command.vle_admin allow

ACE používejte pro vše, co má zůstat jen adminům, zejména pro příkazy, které mění stav hráče, spawnují obsah nebo zpřístupňují administrační nástroje.

Volby persistence ​

Runtime podporuje:

  • JSON persistence jako výchozí volbu
  • volitelnou MySQL persistence pro sdílená nebo větší serverová data

Pokud chcete jen provozovat přibalené příklady nebo menší Lua systémy, JSON je nejjednodušší výchozí cesta. Na MySQL přejděte ve chvíli, kdy potřebujete externí úložiště, sdílené administrační workflow nebo robustnější provozní model.

Vestavěný quest systém je samostatný: je data-driven, ve výchozím stavu vypnutý a při zapnutí vyžaduje MySQL. Konfiguraci a schéma najdete v Quest systému.

Aktualizace balíčku ​

Při aktualizaci z Thunderstore:

  1. aktualizujte balíček na serveru
  2. zajistěte, aby klienti aktualizovali na stejnou verzi Valheim Lua Engine
  3. přečtěte changelog kvůli breaking nebo provozním změnám
  4. ověřte, že váš ensure seznam a přihlašovací údaje stále odpovídají zamýšlenému nastavení
  5. restartujte server a ověřte start resources v logu nebo ve WebAdminu

Pokud resource přináší nový obsah nebo změněné chování, projděte před jejím zapnutím v produkci odpovídající ukázkovou dokumentaci.

Když chcete upravovat gameplay ​

Jakmile přejdete od provozu přibalených resources k vlastnímu vývoji, začněte tady:

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