Čeština
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:
- stejná verze enginu je na serveru i klientech
- jsou zapnuté jen resources, které chcete
- admin přístup a omezené příkazy jsou bezpečně nastavené
- 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í:
- jednou spusťte server, aby se vytvořily konfigurační soubory
- otevřete
BepInEx/config/ValheimLua/server.cfg - nahraďte placeholdery
txadmin_useratxadmin_password - 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_chestResource 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 mobagear_panel: extra equip sloty s persistencí a lehkým UIinventory_native_test: referenční resource pro inventory revision a transaction workflowpersistent_chest: persistence kontejneru vlastněného resource s JSON nebo MySQL backendemquest_event_demo: příklad questů a event flowzone_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 allowACE 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:
- aktualizujte balíček na serveru
- zajistěte, aby klienti aktualizovali na stejnou verzi Valheim Lua Engine
- přečtěte changelog kvůli breaking nebo provozním změnám
- ověřte, že váš
ensureseznam a přihlašovací údaje stále odpovídají zamýšlenému nastavení - 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: