Průvodce nastavením serveru Vintage Story
Tento průvodce pokrývá nastavení a konfiguraci vašeho dedikovaného serveru Vintage Story hostovaného u Legion Hosting, včetně prvního spuštění, proměnných GPanel, správy verzí, konfigurace serveru, nastavení světa, připojení hráčů a správy uložených dat. Pro instalaci modů viz Instalace modů Vintage Story. Pro nastavení administrátora a příkazy viz Administrátorské příkazy Vintage Story.
První spuštění
Když poprvé spustíte svůj server Vintage Story z GPanel, server automaticky stáhne herní soubory z oficiálního API Vintage Story a vygeneruje výchozí svět. Toto úvodní spuštění může trvat několik minut, zatímco se soubory stahují a rozbalují.
- Přihlaste se do GPanel a vyberte svůj server Vintage Story.
- Před spuštěním zkontrolujte záložku Startup a potvrďte preferovanou větev verze (stable, unstable nebo pre-release).
- Klikněte na Start na záložce Console. Sledujte výstup konzole, kde se zobrazují zprávy o průběhu stahování a instalace herních souborů.
- Jakmile uvidíte zprávu oznamující, že server naslouchá připojením, server je připraven. Soubor
serverconfig.jsonbude automaticky vygenerován.
Startovací proměnné GPanel
Základní nastavení serveru se ovládají přes záložku Startup v GPanel. Zkontrolujte a upravte je před spuštěním serveru.
| Proměnná | Výchozí hodnota | Popis |
|---|---|---|
SERVER_PORT |
(přiřazeno) | Herní port, který hráči používají pro připojení. Je automaticky přiřazen systémem GPanel — zkontrolujte záložku Network pro váš přiřazený port. |
MAX_CLIENTS |
16 |
Maximální počet současně připojených hráčů. Lze nastavit až na 256. Měl by odpovídat zdrojům vašeho hostingového plánu. |
FILES_BRANCH |
stable |
Která větev vydání se má použít. Možnosti: stable, unstable nebo pre. Podrobnosti naleznete v sekci Správa verzí níže. |
RELEASE_VERSION |
latest |
Konkrétní verze k instalaci. Nastavte na latest pro vždy nejnovější vydání na zvolené větvi, nebo zadejte konkrétní číslo verze (např. 1.19.8) pro uzamčení na dané verzi. |
OPTIONS |
(prázdné) | Další argumenty příkazového řádku předávané procesu serveru při spuštění. Ponechte prázdné, pokud nepotřebujete specifické startovací parametry. |
SQLITE_TMPDIR |
(auto) | Dočasný adresář používaný SQLite pro databázové operace. Obvykle není potřeba měnit. |
Po aktualizaci startovacích proměnných restartujte server z GPanel, aby se změny projevily.
Správa verzí
Vintage Story nabízí tři větve vydání. Výběr větve se nastavuje pomocí startovací proměnné FILES_BRANCH v GPanel.
| Větev | Hodnota | Popis |
|---|---|---|
| Stable | stable |
Doporučená větev pro většinu serverů. Tato vydání jsou důkladně otestována a jsou nejspolehlivější pro dlouhodobé světy. |
| Unstable | unstable |
Beta vydání s novými funkcemi a změnami, které se stále testují. Mohou obsahovat chyby. Použijte tuto větev, pokud chcete předčasný přístup k novému obsahu a akceptujete určitou nestabilitu. |
| Pre-release | pre |
Rané vývojové sestavení. Jsou nejméně otestované a mohou mít značné problémy. Doporučeno pouze pro testovací účely — ne pro produkční servery. |
Uzamčení konkrétní verze
Ve výchozím nastavení je RELEASE_VERSION nastaven na latest, což znamená, že server stáhne a nainstaluje nejnovější dostupnou verzi na zvolené větvi při každém spuštění serveru (pokud je k dispozici novější verze). Pro zabránění automatickým aktualizacím a uzamčení serveru na konkrétní verzi:
- Přejděte na záložku Startup v GPanel.
- Změňte
RELEASE_VERSIONzlatestna přesné číslo verze, které chcete (např.1.19.8). - Restartujte server. Bude používat pouze uzamčenou verzi bez ohledu na novější vydání.
serverconfig.json
Hlavní konfigurační soubor serveru je serverconfig.json, umístěný v kořenovém adresáři serveru. Tento soubor je automaticky vygenerován při prvním spuštění. Před úpravou server zastavte a poté restartujte, aby se změny projevily.
- Zastavte server ze záložky Console v GPanel.
- Otevřete záložku Files a klikněte na
serverconfig.jsonpro úpravu. - Upravte nastavení, která potřebujete (viz tabulka níže).
- Uložte soubor a spusťte server.
Klíčová nastavení
| Nastavení | Příklad hodnoty | Popis |
|---|---|---|
ServerName |
"My Legion VS Server" |
Název zobrazený v herním prohlížeči serverů. Nastavte ho popisně, aby hráči mohli váš server snadno najít. |
WelcomeMessage |
"Welcome to the server!" |
Zpráva zobrazená hráčům při připojení. Podporuje základní formátování. |
MaxClients |
16 |
Maximální počet současně připojených hráčů. Měl by odpovídat startovací proměnné MAX_CLIENTS. |
Password |
"mysecretpass" |
Heslo vyžadované pro připojení k serveru. Pro veřejný server ponechte jako prázdný řetězec (""). |
AllowPvP |
true |
Nastavte na true pro povolení soubojů hráč proti hráči, nebo false pro server pouze s PvE. |
SpawnRadius |
50 |
Poloměr (v blocích) kolem spawnu světa, kde se mohou noví hráči objevit. Vyšší hodnota rozptýlí hráče více při připojení. |
MapSizeX |
1024000 |
Šířka světa v blocích. Výchozí hodnota vytváří velmi velký svět. Snížením omezíte, jak daleko mohou hráči cestovat ve směru východ-západ. |
MapSizeZ |
1024000 |
Hloubka světa v blocích. Výchozí hodnota vytváří velmi velký svět. Snížením omezíte, jak daleko mohou hráči cestovat ve směru sever-jih. |
WorldSeed |
"myseed123" |
Seed použitý pro generování světa. Stejný seed vytvoří stejný svět. Pro náhodný seed ponechte jako prázdný řetězec. |
Minimální příklad klíčových nastavení v serverconfig.json:
{
"ServerName": "My Legion VS Server",
"WelcomeMessage": "Welcome! Enjoy your stay.",
"MaxClients": 16,
"Password": "",
"AllowPvP": true,
"SpawnRadius": 50,
"MapSizeX": 1024000,
"MapSizeZ": 1024000,
"WorldSeed": ""
}
true/false) a za poslední položkou v objektu nebo poli nejsou čárky navíc. Pokud se server po úpravě nepodaří spustit, zkontrolujte syntaktické chyby JSON.
Konfigurace světa
Vintage Story generuje svůj svět na základě nastavení v serverconfig.json. Generování světa probíhá pouze při prvním spuštění s daným světem — změna nastavení generování po vytvoření světa zpětně nezmění existující terén.
Nastavení generování světa
- WorldSeed: Určuje rozložení terénu, umístění biomů a distribuci surovin. Nastavte konkrétní seed pro sdílení stejného rozložení světa s ostatními, nebo ho ponechte prázdný pro náhodně vygenerovaný svět.
- MapSizeX / MapSizeZ: Ovládají maximální hratelnou oblast. Menší hodnoty vytvoří kompaktnější svět a mohou snížit spotřebu zdrojů. Hráči, kteří dosáhnou okraje mapy, nebudou moci cestovat dál v daném směru.
- WorldConfig: Objekt
WorldConfigv souboruserverconfig.jsonumožňuje jemné ladění parametrů generování světa, jako je měřítko terénních útvarů, klimatické vzorce a geologické prvky. Jedná se o pokročilá nastavení — výchozí hodnoty fungují dobře pro většinu serverů.
WorldSeed, MapSizeX a MapSizeZ se projeví pouze při prvním generování světa. Pro použití nových nastavení generování musíte vytvořit nový svět (viz Správa uložených dat níže).
Výběr seedu
Seed může být libovolný textový řetězec nebo číslo. Hráči v komunitě Vintage Story sdílejí seedy pro zajímavá rozložení světa. Pokud chcete specifický typ terénu nebo místo spawnu, hledejte doporučené seedy na fórech nebo komunitních stránkách Vintage Story.
Jak se připojit
Hráči se připojují k vašemu serveru Vintage Story přes herní menu pro více hráčů.
Přímé připojení
- Spusťte Vintage Story a klikněte na Multiplayer z hlavního menu.
- Klikněte na Direct Connect.
- Zadejte IP adresu a herní port vašeho serveru ve formátu:
Zkontrolujte záložku Network v GPanel pro vaši přiřazenou IP a port.your.server.ip:port - Klikněte na Connect. Pokud má server heslo, zadejte ho po výzvě.
Prohlížeč serverů
- Spusťte Vintage Story a klikněte na Multiplayer z hlavního menu.
- Prohlížeč serverů načte seznam veřejných serverů. Pomocí vyhledávacího pole najděte svůj server podle názvu (hodnota
ServerNameze souboruserverconfig.json). - Klikněte na svůj server v seznamu a klikněte na Join.
Správa uložených dat
Data světa Vintage Story jsou uložena na vašem serveru a automaticky se ukládají během hraní.
Umístění dat světa
Soubory uloženého světa jsou uloženy v adresáři data/ na vašem serveru. Přesná cesta závisí na názvu vašeho světa. K těmto souborům můžete přistupovat přes záložku Files v GPanel nebo přes SFTP.
Zálohování vašeho světa
- Zastavte server pro zajištění čisté zálohy (žádné soubory se nezapisují uprostřed ukládání).
- Připojte se k serveru přes SFTP. Viz Jak nahrát soubory přes SFTP pro pokyny k připojení.
- Stáhněte celý adresář
data/na svůj lokální počítač. - Uložte zálohu na bezpečné místo. Zvažte uchování více datovaných záloh pro případ, že byste se potřebovali vrátit ke konkrétnímu bodu.
Reset světa
Pro spuštění zcela nového světa:
- Zastavte server ze záložky Console v GPanel.
- Zálohujte existující data světa, pokud si je chcete ponechat (viz výše).
- Přejděte do adresáře
data/ve správci souborů GPanel a smažte soubory uloženého světa. - Volitelně aktualizujte
WorldSeedv souboruserverconfig.jsonpro vygenerování jiného rozložení světa. - Spusťte server. Nový svět bude vygenerován od začátku s použitím vašich aktuálních nastavení konfigurace.
Související články
- Instalace modů Vintage Story
- Administrátorské příkazy Vintage Story
- Jak najít IP adresu a port vašeho serveru
- Jak nahrát soubory přes SFTP
- Průvodce spuštěním serveru
Potřebujete pomoc?
Pokud narazíte na problém, který tento průvodce nepokrývá, otevřete tiket podpory a uveďte IP adresu vašeho serveru, popis problému a jakýkoli relevantní výstup konzole z GPanel.