Server Arma Reforger: config.json a módy

Dedikovaný server Arma Reforger se zdarma stahuje přes SteamCMD (app id 1874900), existuje v nativních verzích pro Linux i Windows a celý se nastavuje jediným souborem JSON, který předáš parametrem -config. V tom souboru uvedeš podle ID scénář, který se má spustit, seznam módů ke stažení z vlastního Workshopu Bohemie, počet hráčů (až 128), crossplay a vzdálenosti vykreslování a také hesla pro admina a RCON. Server potřebuje UDP 2001 pro hru a UDP 17777 pro prohlížeč serverů, k tomu port pro RCON, pokud ho používáš, a realisticky 6 až 12 GB paměti podle scénáře a módů. Zbytek návodu rozebírá jednotlivé bloky tohoto souboru a chyby, kvůli kterým se server nezobrazí.

Reforger běží na jiném enginu (Enfusion) než Arma 3 a téměř nic se nepřenáší: žádný server.cfg, žádné složky @mod, žádné soubory .bikey, žádný Steam Workshop. Pokud přicházíš z Army 3, ber tohle jako úplně novou hru. Hledáš-li samotnou Armu 3, mrkni na návod k serveru a módům pro Arma 3.

Jak funguje server Reforger#

Server načte jeden scénář - Conflict na Everonu, Game Master, Combat Ops a podobně, nebo scénář z módu - a provozuje ho, dokud neskončí nebo se server nerestartuje. Hráči se připojují z PC (Steam), Xboxu a PlayStationu podle toho, které platformy povolíš.

Hostování Reforgeru se od starších her Bohemie liší ve třech věcech:

• Módy se stahují samy. V konfiguraci uvedeš ID módů, server je při startu stáhne z Arma Reforger Workshopu (služba Bohemie, ne Steam) a klienti hráčů si je stáhnou při připojení. Žádné ruční nahrávání, žádné soubory s klíči.
• Konfigurace je JSON. Je přísný: chybějící čárka nebo čárka navíc za poslední položkou a server odmítne nastartovat. Soubor před restartem zvaliduj.
• Scénáře se odkazují ID zdroje, tedy GUID ve složených závorkách následovaným cestou, ne přívětivým názvem.

Požadavky a spotřeba zdrojů#

Bohemia zveřejňuje minimální požadavky; skutečné servery potřebují víc a výběr scénáře znamená víc než počet hráčů.

• CPU. Enfusion využívá víc vláken lépe než engine Army 3, ale simulace se pořád opírá o hlavní vlákno, takže záleží na taktu. Snímkovou frekvenci omez parametrem -maxFPS, aby server netočil jádro na 100 % kvůli snímkům, které nikdo nepotřebuje.
• Paměť. Během dlouhé session v Conflictu roste, jak se staví základny a hromadí AI. Plánovaný restart ji udrží předvídatelnou.
• Disk. Instalace serveru jsou desítky gigabajtů a módy k tomu přidávají. S rozumným seznamem módů počítej s 30-50 GB; rychlé úložiště pomůže při dlouhém prvním stahování módů i při načítání scénáře.

AI je jako v každé Armě to nejdražší. Nastavení operating.aiLimit omezuje počet AI a je to nejúčinnější jednotlivý šroub pro server, který ve druhé hodině hry zápasí s výkonem. Jak poznat, jakého zdroje je nedostatek, vysvětluje CPU vs RAM pro herní servery.

Instalace a spouštěcí řádek#

Server se přes SteamCMD stahuje anonymně:

$ steamcmd +force_install_dir /home/reforger/server +login anonymous \    +app_update 1874900 validate +quit$ cd /home/reforger/server$ ./ArmaReforgerServer -config ./config.json -profile ./profile \    -maxFPS 60

Argumenty, na kterých záleží:

Ve Windows se binárka jmenuje ArmaReforgerServer.exe. V panelu se stejné argumenty skládají ze záložky Startup a config.json upravuješ ve správci souborů. O validate a aktualizacích obecně pojednává SteamCMD vysvětleno.

config.json: nejvyšší úroveň, porty a RCON#

Kompletní funkční soubor vypadá takto. Každý blok je vysvětlen níže.

{  "bindAddress": "0.0.0.0",  "bindPort": 2001,  "publicAddress": "",  "publicPort": 2001,  "a2s": {    "address": "0.0.0.0",    "port": 17777  },  "rcon": {    "address": "0.0.0.0",    "port": 19999,    "password": "a-long-random-rcon-password",    "permission": "admin",    "maxClients": 2  },  "game": {    "name": "Everon Conflict | EU | Comms",    "password": "",    "passwordAdmin": "a-different-long-password",    "admins": [],    "scenarioId": "{ECC61978EDCC2B5A}Missions/23_Campaign.conf",    "maxPlayers": 64,    "visible": true,    "crossPlatform": true,    "supportedPlatforms": ["PLATFORM_PC", "PLATFORM_XBL"],    "gameProperties": {      "serverMaxViewDistance": 2500,      "serverMinGrassDistance": 50,      "networkViewDistance": 1500,      "disableThirdPerson": false,      "fastValidation": true,      "battlEye": true    },    "mods": []  },  "operating": {    "lobbyPlayerSynchronise": true,    "playerSaveTime": 120,    "aiLimit": -1,    "slotReservationTimeout": 60,    "joinQueue": { "maxSize": 0 }  }}

Síťové klíče:

K publicAddress jedna poznámka: na serveru s přímočarou veřejnou adresou může obvykle zůstat prázdná, ale pokud prohlížeč ukazuje tvůj server se soukromou nebo špatnou adresou, nastav tam výslovně veřejnou IP. Za NAT je publicPort externí port a bindPort interní.

RCON v Reforgeru používá protokol BattlEye RCon přes UDP, takže s ním fungují známé nástroje pro RCON z Army. permission je admin (plná kontrola) nebo monitor (jen čtení). maxClients omezuje počet souběžných spojení RCON; pole blacklist a whitelist mohou omezit, které příkazy jsou povolené. Protokol není šifrovaný, takže s portem zacházej tak, jak popisuje RCON bezpečně: dlouhé unikátní heslo, omezení podle zdrojové adresy, kde to jde, nebo ho z konfigurace úplně vynech, pokud RCON nepoužíváš.

Blok game: identita, scénář a platformy#

`name`, `password`, `passwordAdmin`. Název v prohlížeči, heslo pro připojení (u veřejného serveru prázdné) a heslo, které se používá s #login v chatu. Admin heslo drž dlouhé a nepoužívej stejné jako u RCON.

`admins`. Seznam identifikátorů hráčů, kterým se dají práva admina. Přijímá identity ID hráče u Bohemie a u hráčů ze Steamu jejich SteamID64. Identity ID se zobrazí v logu serveru, když se hráč připojí, takže odtud ho spolehlivě zkopíruješ.

`scenarioId`. Scénář k načtení jako odkaz na zdroj:

{ECC61978EDCC2B5A}Missions/23_Campaign.conf    Conflict - Everon{59AD59368755F41A}Missions/21_GM_Eden.conf     Game Master - Everon

Tyhle dva jsou stabilní už dlouho, ale s každou větší aktualizací přibyly nové terény a oficiální scénáře, každý s vlastním ID. Nekopíruj seznamy ze starých příspěvků. Spusť server jednou s -listScenarios a použij, co vypíše - ten výstup zahrnuje i scénáře z módů ve tvé konfiguraci, což je jediný způsob, jak správně získat ID scénáře z módu.

`maxPlayers`. 1 až 128, výchozí 64. Conflict je navržený na vysoké počty; Game Master a Combat Ops se hrají mnohem líp s menším počtem.

`visible`. Jestli se server zobrazuje v prohlížeči. Pro soukromý server na akci, kam se lidé připojují podle adresy, nastav false.

`crossPlatform` a `supportedPlatforms`. Když je crossPlatform true, mohou se připojit platformy uvedené v supportedPlatforms: PLATFORM_PC, PLATFORM_XBL (Xbox) a PLATFORM_PSN (PlayStation). Když platformu vynecháš, na server se nedostane. Hráči na konzolích umí načíst jen módy dostupné na jejich platformě, takže seznam módů, který funguje pro hráče na PC, může konzole nenápadně vyřadit; chceš-li, aby crossplay něco znamenal, ověř na Workshopu dostupnost každého módu na jednotlivých platformách.

gameProperties a operating: výkon a chování#

gameProperties řídí, co server po klientech chce vykreslovat a simulovat:

networkViewDistance je ten, který má skutečnou cenu pro server. Každý objekt v jeho dosahu se replikuje ke každému hráči, takže jeho zvýšení na serveru s 64 hráči v Conflictu zvedne zároveň šířku pásma i zátěž CPU. Nech ho blízko výchozí hodnoty, pokud vaše komunita nehraje dalekonosné obrněnce a vrtulníky a nezměřil jsi, kolik to stojí. serverMinGrassDistance nastavená kolem 50 uzavře trik „vypni trávu a uvidíš všechny ležet v poli“, který veřejné servery pálí.

operating pokrývá chování serveru:

Novější verze podporují i ukládání postupu scénáře, nastavované v bloku persistence (interval automatického ukládání a identifikátor hive). Je mladší než zbytek souboru a mezi vydáními se měnil, takže než se na něj spolehneš u dlouho běžící kampaně v Conflictu, zkontroluj aktuální dokumentaci Bohemie, a zálohy složky profilu si dělej v každém případě sám.

Jaký typ scénáře zvolit pro svou skupinu#

Scénář rozhoduje téměř o všem na serveru - pro koho je, kolik hráčů potřebuje a kolik stojí provoz - takže ho vyber dřív, než začneš cokoli ladit.

• Conflict je rozsáhlý trvalý režim: dvě frakce stavějí základny, dobývají území a zásobují frontu. Potřebuje dost hráčů, aby fungoval. Pod zhruba dvacet hráčů působí mapa prázdně a jedna strana obvykle začne převažovat jako sněhová koule. Při dlouhé session je také nejnáročnější na paměť, protože se hromadí základny, vozidla a AI.
• Game Master dává jednomu nebo více hráčům kontrolu nad scénářem: v reálném čase spawnují AI, cíle a události pro ostatní. Hodí se pro organizované skupiny, které pořádají vlastní operace, a je to zátěž s největším rozptylem: Game Master, který v jednom městě spawne dvě stě AI, právě způsobil serveru nejhorší večer. Na serverech Game Master nastav aiLimit i tehdy, když svému týmu věříš.
• Combat Ops a další oficiální co-op scénáře jsou kratší strukturované mise proti AI pro malé skupiny. Provoz je lehký a nevyžadují žádnou průběžnou údržbu.
• Scénáře z módů sahají od malých výcvikových map po kompletní přestavby. Ber každý jako novou hru: na stránce módu si přečti očekávaný počet hráčů a závislosti.

Rozumný model pro komunitu je jeden veřejný server s Conflictem a, pokud je poptávka, menší server Game Master chráněný heslem pro plánované operace. Provozovat oba na jednom stroji jde s různými porty a složkami profilu, ale každý server potřebuje vlastní paměť a samotný Conflict ve špičce zabere většinu středně velkého tarifu.

Módy z Workshopu Reforgeru#

Módy se uvádějí v game.mods. Server každý stáhne do složky profilu při startu; připojující se klienti stáhnou stejnou sadu.

"mods": [  {    "modId": "0123456789ABCDEF",    "name": "Example Weapons Pack",    "version": "1.0.12"  },  {    "modId": "FEDCBA9876543210",    "name": "Example Map"  }]

Pole:

• `modId` je 16místné hexadecimální ID ze stránky módu na Workshopu (na reforger.armaplatform.com nebo v herním Workshopu). Je to jediné pole, které mód identifikuje. ID výše jsou zástupná.
• `name` je informativní. Zobrazuje se v lozích a pomáhá lidem číst soubor.
• `version` je volitelná. Když ji vynecháš, server při každém startu vezme nejnovější verzi. Když ji nastavíš, server tu verzi zafixuje - což je správná volba pro server, kde se módy nesmějí pod rukama měnit.
• Závislosti se řeší automaticky: uvedeš mód, který chceš, a jeho povinné módy se stáhnou také.

Daň za automatické stahování je, že nezafixovaný mód se může přes noc aktualizovat, server novou verzi převezme při dalším restartu a mód se rozbije. U každého serveru, na který se lidé spoléhají, verze fixuj, aktualizuj záměrně a po aktualizaci testuj. Co dělat, když aktualizace módu všechno rozbije a jak udržet modovaný server čistý platí tady úplně stejně jako v jakékoli jiné hře.

Scénář z módu se vybírá přesně jako oficiální: přidej mód, jednou nastartuj s -listScenarios a zkopíruj jeho ID scénáře do scenarioId.

Porty, admini a každodenní provoz#

Všechno je UDP. Server, který běží, ale není v seznamu, je ve většině případů problém s portem A2S; server, který je v seznamu, ale nejde se k němu připojit, je port hry nebo špatná publicAddress. Proč existuje dotazovací port zvlášť, vysvětluje porty herních serverů.

Admini se přihlašují z chatu příkazem #login následovaným passwordAdmin (hráči uvedení v admins se poznají jako admini). Přihlášení admini dostanou herní nástroje a chatové příkazy pro vyhazování, bany a restarty; sada příkazů se s aktualizacemi Reforgeru rozrostla, takže příkazy s # opisuj z oficiálního seznamu pro svou verzi, ne ze starého návodu. RCON dává stejnou kontrolu na dálku.

Rutina, která drží server Reforgeru zdravý:

1. Restartuj podle plánu. Denně, v hodinu, kdy nikdo nehraje. Vyčistí nahromaděnou AI a růst paměti a převezme změny konfigurace. Důvody jsou v rozvrzích restartů, které pomáhají.
2. Aktualizuj záměrně. Po aktualizaci Reforgeru se musí server aktualizovat, než se někdo připojí, a módy mohou čekat, až autoři vydají opravy. Aktualizuj server, zkontroluj módy a teprve pak nastartuj.
3. Zálohuj konfiguraci a profil. config.json je malý a drahocenný. Profil obsahuje logy a případný uložený postup. V panelu zálohuj před každou aktualizací a když se něco pokazí, obnov jedním klikem.
4. Po každé změně si přečti log. Chyby JSON, neúspěšná stahování módů i špatná ID scénářů jsou při startu popsány jasně. S hledáním řádku, na kterém záleží, pomůže čtení konzole.

Řešení potíží#

Server se hned ukončí. Neplatný JSON. Obvyklý viník je čárka za poslední položkou seznamu nebo objektu. Pošli soubor přes validátor JSON.

„Scenario not found“ nebo se načte špatný scénář. scenarioId je s překlepem, patří módu, který není v seznamu, nebo je ze starší verze. Použij -listScenarios.

Není v prohlížeči serverů. Port A2S je zavřený nebo špatný, visible je false, nebo publicAddress oznamuje špatnou adresu.

Hráči na konzolích se nemohou připojit. crossPlatform je false, jejich platforma není v supportedPlatforms, nebo některý mód ze seznamu není na jejich platformě dostupný.

Stažení módu při startu selže. Špatné modId, zafixovaná version, kterou autor odstranil, nebo dočasný výpadek Workshopu. Log mód jmenuje.

FPS serveru po hodině v Conflictu klesá. Hromadí se AI a objekty. Nastav aiLimit, zkontroluj networkViewDistance a naplánuj restarty.

Hráči vidí různé vzdálenosti vykreslování. Je to očekávané - serverMaxViewDistance je strop, ne cíl. Klienti si vybírají až do této hodnoty.

FAQ#

Je server Arma Reforger stejný jako u Army 3?

Ne. Jiný engine, jiné soubory, jiný systém módů. Reforger používá jediný config.json, módy stahuje automaticky z Workshopu Bohemie a nemá server.cfg, složky @mod ani podpisové klíče.

Kolik hráčů pojme server Arma Reforger?

Až 128, nastavuje se pomocí maxPlayers. Zda tvůj server tolik hráčů zvládne simulovat, závisí na scénáři, počtu AI a CPU; většina veřejných serverů s Conflictem běží s 64 a více hráči na výkonném hardwaru.

Kde najdu ID scénáře?

Nastartuj server s -listScenarios. Vypíše ID každého dostupného scénáře včetně těch z módů ve tvé konfiguraci. Zkopíruj celý řetězec se závorkami a cestou.

Musím módy nahrávat na server?

Ne. Uveď ID každého módu v game.mods a server ho při startu stáhne z Workshopu Reforgeru. Hráči stáhnou stejné módy při připojení.

Mohou se na modovaný server připojit hráči z PlayStationu a Xboxu?

Jen pokud je každý mód na serveru dostupný na jejich platformě, a jen když je zapnutý crossPlatform a jejich platforma je uvedena v supportedPlatforms. Než slíbíš crossplay, ověř dostupnost módů.

Potřebuje Reforger k hostování účet nebo token Steamu?

Server se přes SteamCMD stahuje anonymně a žádný token herního serveru nepotřebuje. Módy jdou z Workshopu Bohemie, ke kterému se server dostane bez tvého účtu Steam.