Valheim adminlist, bannedlist a permittedlist vysvětleně

Dedikovaný Valheim server nemá žádný konfigurační soubor ani systém oprávnění - jen tři prosté textové soubory v adresáři s uloženými daty. adminlist.txt říká, kdo smí kickovat, banovat a ukládat. bannedlist.txt říká, kdo se nesmí připojit. permittedlist.txt, pokud v něm něco je, jmenuje jediné lidi, kteří se připojit smějí. Každý soubor obsahuje jedno ID hráče na řádek: holé 17místné SteamID64 na serveru jen pro Steam, nebo ID s prefixem platformy, například Steam_76561198012345678 nebo Xbox_2535412345678901, na crossplay serveru. Řádky začínající // jsou komentáře. To je celý systém a skoro každý problém s ním je špatné ID nebo špatný soubor.

Tento článek popisuje, kde soubory leží, formáty ID, jak spolehlivě zjistit ID hráče, kdy se změny projeví a jak provozovat soukromý server se seznamem povolených, aniž by ses zamkl venku. Příkazy, které může admin použít po zapsání do seznamu, jsou v doprovodném článku admin příkazy konzole Valheimu.

Co který soubor dělá#

Asymetrie v posledním sloupci je to, co si zapamatovat. Prázdný seznam banů nezabanuje nikoho a prázdný seznam adminů neudělá nikoho adminem, ale prázdný seznam povolených nikoho nezamkne venku - vypíná seznam povolených. Ve chvíli, kdy je v permittedlist.txt jediné ID, se server stává serverem jen pro povolené, pro všechny.

Co soubory nedělají:

• Žádné hodnosti. Admin je admin. Neexistuje úroveň moderátora, který může kickovat, ale ne banovat.
• Žádné cheaty. Zápis do adminlist.txt neodemkne devcommands, spawn ani god na vanilla dedikovaném serveru. K tomu je potřeba mód; viz ServerDevcommands.
• Žádné obcházení wardů. Admin nemůže otevřít cizí zamčené dveře jen proto, že je admin. Warda je samostatný systém, popsaný v článku wardy a griefing ve Valheimu.
• Žádné bany podle IP v souboru, který čekáš. Příkaz ban přijímá jméno, IP nebo ID, ale spoléhat bys měl na ID. IP adresy se mění; ID ne.

Kde soubory leží#

Tři soubory vytvoří server při prvním startu v adresáři s uloženými daty vedle složky worlds_local - ne ve složce, kam je server nainstalovaný. Tohle zaskočí skoro každého, kdo je hledá vedle valheim_server.x86_64.

Pokud server běží s -savedir /srv/valheim/data, seznamy jsou v /srv/valheim/data, ne ve výchozím umístění. Dvě kopie souborů - jedna ve výchozí cestě z dřívějšího testu, druhá pod -savedir - jsou častým zdrojem věty „přidal jsem se a nestalo se nic“. Zkontroluj spouštěcí řádek serveru kvůli -savedir a soubory uprav v tomto adresáři. Valheim savedir a umístění souborů mapuje všechny složky podrobně.

Čerstvě vytvořený soubor obsahuje jen řádek s komentářem:

// List admin players ID  ONE per line

Další dva mají stejnou hlavičku se slovy „banned“ a „permitted“. Komentář nech a ID přidávej na řádky pod ním.

Steam ID a ID s prefixem platformy#

Formát ID závisí na tom, jak byl server spuštěn.

Server jen pro Steam (bez -crossplay): hráči jsou identifikováni svým SteamID64, 17místným číslem začínajícím 7656119. Ne jménem profilu, ne vlastní URL, ne kratším SteamID3 ve tvaru [U:1:...].

Crossplay server (-crossplay): hráči jsou identifikováni ID s prefixem platformy. Hráči na Steamu jsou Steam_ následované jejich SteamID64. Hráči na Xboxu a Microsoft Store jsou Xbox_ následované jejich uživatelským ID na Xboxu.

// List admin players ID  ONE per line// Steam-only server: bare SteamID6476561198012345678// Crossplay server: prefixed formsSteam_76561198012345678Xbox_2535412345678901

Z toho plynou dvě praktická pravidla:

• Při pochybnostech přidej u hráčů na Steamu oba tvary. Řádek, který nic neodpovídá, se ignoruje, takže mít v souboru 76561198012345678 i Steam_76561198012345678 neuškodí a přežije den, kdy někdo crossplay zapne nebo vypne.
• Xbox ID nikdy nehádej. Není to gamertag a není to nic, co si hráč snadno vyhledá. Přečti ho z logu serveru.

Crossplay stránka věci - proč prefixy existují a co dalšího se mění, když provoz nese PlayFab - je v článku Valheim crossplay a hráči na Xboxu.

Zjištění ID hráče#

Existují tři způsoby, od nejspolehlivějšího po nejméně spolehlivý.

Z logu serveru

Nech hráče připojit se jednou, i když pak bude odmítnut. Server zapisuje každé připojení s ID ve tvaru, který používají soubory se seznamy. Na serveru jen pro Steam vypadají řádky takto:

Got connection SteamID 76561198012345678Got handshake from client 76561198012345678

Na crossplay serveru nesou řádky o připojení místo toho ID s prefixem platformy. Zkopíruj ID přesně tak, jak ho log ukazuje. Je to jediná metoda, která dá správný tvar pro jakýkoli režim serveru, a jediná metoda pro hráče na Xboxu.

Ze Steamu

SteamID64 hráče na Steamu se objeví v URL jeho profilu, pokud si nenastavil vlastní: steamcommunity.com/profiles/76561198012345678. Pokud vlastní URL má, převede ho web pro vyhledání SteamID. Dej pozor, abys zkopíroval SteamID64, tedy to dlouhé číslo, ne jiný z formátů, které takové weby také ukazují.

Od hráče

Hráči ti své SteamID64 mohou říct, ale lidé dlouhá čísla čtou chybně. Ber to jako křížovou kontrolu proti logu, ne jako jediný zdroj.

Pravidla formátu a časté chyby#

Soubory jsou jednoduché, proto jsou chyby vždy stejné:

• Jedno ID na řádek. Žádné čárky, žádné mezery mezi ID, nic za ID na stejném řádku. Komentář na stejném řádku jako ID může zabránit shodě toho řádku; komentáře dávej na vlastní řádky.
• Žádná jména. Bjorn v adminlist.txt nedělá nic. Jméno napiš na řádek s komentářem nad ID, pokud si chceš pamatovat, o koho jde.
• Přesný pravopis prefixu. Steam_, s velkým S a podtržítkem. steam_ ani Steam: neodpovídá.
• Konce řádků a kódování. Soubory upravené na Windows a nahrané na Linux mají konce řádků CRLF. Hra to v praxi zvládá, ale zatoulaný byte-order mark nebo „chytré“ formátování textového procesoru ne. Použij prostý textový editor nebo editor souborů v panelu.
• Správný název souboru. adminlist.txt, bannedlist.txt, permittedlist.txt, vše malými písmeny. adminlist.txt.txt je windowsovská klasika se skrytou příponou.

Úhledný soubor, který se snadno udržuje, vypadá takto:

// List permitted players ID ONE per line// Bjorn - server owner76561198012345678Steam_76561198012345678// Astrid76561198087654321Steam_76561198087654321// Leif - XboxXbox_2535412345678901

Kdy se změny projeví#

Server soubory sleduje a za běhu je znovu načítá, takže přidání admina nebo banu při běžném provozu nevyžaduje restart. Příkazy ban a unban zapisují do bannedlist.txt samy, takže soubor a server zůstávají v souladu, ať změnu uděláš jakkoli.

Co znamená „projeví se“, se u každého souboru liší:

• Seznam adminů. Hráč je brán jako admin pro příkazy, které zadá po načtení. Pokud jsou příkazy nově přidaného admina odmítány, ať se znovu připojí.
• Seznam banů. Přidání ID odmítne další připojení daného hráče. Někdo, kdo už na serveru je, není samotnou úpravou souboru vyhozen; vykopni ho, nebo použij příkaz ban, který ho vykopne i zapíše ban.
• Seznam povolených. Platí při připojení, stejně jako seznam banů. Zapnutí seznamu povolených neodpojí lidi, kteří už hrají a nejsou v něm; odmítnuti budou až příště.

Pokud se změna zdánlivě neprojevila, zkontroluj v tomto pořadí: upravil jsi soubor v adresáři, který server skutečně používá, ID je ve správném tvaru a soubor se uložil. Restart je poslední možnost, která potvrdí, že se soubor vůbec čte - pokud restart změnu také nepromítne, server čte jiný soubor.

Provoz soukromého serveru se seznamem povolených#

Seznam povolených je nejsilnější řízení přístupu, jaké má vanilla Valheim. Heslo se dá sdílet, zveřejnit nebo uhodnout; seznam povolených váže vstup na konkrétní účty. Pro partu kamarádů je správné nastavení obojí dohromady. Whitelist versus heslo obhajuje tento přístup napříč hrami.

Jak ho nastavit, aniž by ses zamkl venku:

1. Ujisti se, že se každý člen alespoň jednou připojil, takže jeho ID jsou v logu.
2. Sestav soubor se všemi ID, u hráčů na Steamu s oběma tvary, než ho uložíš.
3. Nejdřív zapiš sebe. Admini nejsou vyjmuti: být v adminlist.txt ti neumožní projít seznamem povolených, na kterém nejsi.
4. Ulož a pak nech jednoho člověka, který na seznamu není, zkusit se připojit, aby ses ujistil, že je odmítnut.

Heslo si nech i se seznamem povolených. Nic nestojí a zabrání tomu, aby jediným klíčem byl napadený účet uvedeného hráče. A pokud má být server stejně soukromý, zvaž -public 0, aby zůstal mimo seznam komunit - popsáno v článku Valheim server není v seznamu.

Častá chyba je nový člen: dostane heslo, nemůže se připojit a nikdo si na seznam povolených nevzpomene. Přidej na začátek permittedlist.txt komentář jako připomínku pro toho, kdo ho bude spravovat příště, a nové hráče přidávej dřív, než se poprvé pokusí připojit.

Správa seznamů na hostovaném serveru#

Na hostovaném panelu leží soubory tam, kam panel mapuje adresář s uloženými daty, a upravuješ je ve správci souborů nebo přes SFTP, ne na konzoli. Na RE:NODE otevře správce souborů Valheim serveru seznamy v editoru v prohlížeči, uloží je na místě a běžící server změnu převezme; SFTP a správce souborů popisuje úpravy přes SFTP, pokud preferuješ místní editor. Živá konzole ukazuje řádky o připojení, takže můžeš ID hráče zkopírovat odtud, zatímco se zkouší připojit.

Vlastní oprávnění panelu jsou samostatná vrstva a vyplatí se je používat vedle seznamů. Kamarád, který spravuje bany, nepotřebuje přístup k fakturaci ani k celému stromu souborů: podúčtům lze přidělit přístup jen ke konzoli nebo jen k souborům. To omezuje škody ze sdíleného přihlášení, riziko popsané v článku zabezpečení admin účtů herních serverů.

Bany, odvolání a vedení záznamů#

Vanilla Valheim nevede žádný důvod, datum ani záznam o tom, kdo koho zabanoval. Pokud má tvůj server víc než hrstku hráčů, veď si to sám:

• Dej nad každý ban řádek s komentářem se jménem, datem, důvodem a tím, kdo banoval.
• Drž kopii bannedlist.txt někde mimo server, aby obnova nebo přeinstalace tiše nezrušila všechny bany.
• Domluvte se mezi adminy, kdy je ban dočasný a kdo ho ruší.

// List banned players ID  ONE per line// 2026-10-11 Ulf - burned the shared longhouse, banned by Bjorn, review in 30 days76561198011112222Steam_76561198011112222

Měj na paměti, že příkazy ban a unban soubor přepisují a nedá se spoléhat na to, že ručně psané komentáře takový zásah přežijí napříč verzemi. Pokud si poznámky vedeš v souboru, drž i kopii mimo server a když na důvodu záleží, upravuj raději soubor ručně než příkazy. Řešení cheaterů a seznamy banů jde hlouběji do pravidel pro veřejné komunity.

FAQ#

Musím po úpravě adminlist.txt restartovat server?

Normálně ne - server soubory za běhu znovu načítá. Pokud jsou příkazy nově přidaného admina odmítány, ať se znovu připojí, a pokud to nepomůže, zkontroluj, že jsi soubor upravil ve skutečném adresáři serveru s uloženými daty.

Proč je moje SteamID v adminlist.txt, a přesto nejsem admin?

Buď je ID ve špatném tvaru pro režim serveru - holé SteamID na crossplay serveru potřebuje prefix Steam_ - nebo má překlep, nebo to není soubor, který server čte. Zkopíruj ID z řádku o připojení v logu serveru.

Můžu zabanovat někoho podle jména v bannedlist.txt?

Ne. Soubor obsahuje jen ID. V konzoli můžeš napsat ban se jménem připojeného hráče a server ban zapíše za tebe.

Zahrnuje permittedlist.txt adminy automaticky?

Ne. Každý hráč, který se má připojit, včetně adminů, potřebuje své ID v seznamu povolených, jakmile v něm cokoli je.

Jak seznam povolených zase vypnu?

Odstraň všechna ID z permittedlist.txt a nech jen řádky s komentáři, nebo soubor vyprázdni. Prázdný seznam povolených znamená, že se smí připojit kdokoli s heslem.