Oxide (uMod) a Carbon: co to je, jak vybrat a nainstalovat

Čistý (vanilla) Rust server pluginy spouštět neumí. Potřebuje k tomu modovací framework: buď Oxide, nebo Carbon. Vysvětlíme, co framework dělá, jak se ty dva liší, který si vybrat, jak ho nainstalovat a co dělat po každé měsíční aktualizaci Rustu.

Co je modovací framework#

Framework je doplněk serveru, který se načte spolu s Rustem a otevře mu „dveře“ pro pluginy. Plugin je obyčejný textový soubor se zdrojovým kódem v jazyce C# a příponou .cs. Framework ho při načtení sám přeloží (zkompiluje) a spustí. Vy tedy nahráváte jen soubor .cs, nic dalšího nepřekládáte.

Co framework přináší:

• Hooky – místa ve hře, na která se pluginy „zavěsí“ (hráč se připojil, něco se postavilo, někdo vytěžil kámen…). Díky nim plugin může změnit skoro cokoli.
• Systém oprávnění – skupiny hráčů a práva typu kits.admin. Viz Oprávnění na Rust serveru.
• Konfigurace, data a překlady pluginů – každý plugin si vytvoří vlastní soubor nastavení (JSON), který upravujete vy.

Hráči si nic neinstalují. Všechno běží jen na serveru a hráč se připojuje stejným klientem Rustu jako na jakýkoli jiný server.

Oxide a uMod: proč dva názvy#

Oxide je dlouhodobě nejrozšířenější framework pro Rust. Projekt se v minulosti přejmenoval na uMod a pod tímto jménem dodnes běží web s pluginy umod.org (otevře se v novém okně). Samotný framework pro Rust se ale stále jmenuje Oxide: soubory ke stažení se jmenují Oxide.Rust.zip, příkazy začínají oxide. a v seznamu serverů je štítek „Oxide“. Hovorové „oxymod“ nebo „oxide mod“ je totéž.

Oxide stahujte z oficiálního repozitáře OxideMod/Oxide.Rust na GitHubu (otevře se v novém okně). Nová verze vychází často, typicky několikrát do měsíce a vždy po aktualizaci Rustu.

Carbon#

Carbon je novější framework (vznikl v roce 2022). Je postavený tak, aby spouštěl pluginy napsané pro Oxide, a to bez úprav. Pluginy tedy stahujete ze stejných míst a používají stejné soubory .cs.

Rozdíly oproti Oxide podle autorů Carbonu:

• Nemění soubory hry. Oxide přepisuje soubory ve složce RustDedicated_Data/Managed, Carbon má vše ve vlastní složce carbon.
• Aktualizuje se sám. Při startu serveru si stáhne verzi, která odpovídá nainstalovanému Rustu.
• Hooky jen podle potřeby. Volá jen ty hooky, které nějaký plugin opravdu používá, což šetří výkon.
• Vestavěné nástroje. Administrátorský panel ve hře (příkaz /cpanel), volitelné moduly (násobení těžby, velikost stacků, neviditelnost pro adminy, whitelist, automatický wipe) a profiler.

Carbon existuje ve dvou sestaveních: Release (plné, s moduly a panelem) a Minimal (jen spouštění pluginů). Pro začátek zvolte Release.

Srovnání#

Jak vybrat#

• Oxide zvolte, pokud chcete nejrozšířenější standard. Autoři pluginů ho testují jako první a většina návodů na internetu počítá s ním. Cenou je ruční aktualizace po každém updatu Rustu.
• Carbon zvolte, pokud chcete co nejméně práce s aktualizacemi, vestavěný admin panel a moduly. Když nějaký plugin na Carbonu nefunguje, dejte vědět autorovi pluginu nebo komunitě Carbonu.

Na jednom serveru smí běžet jen jeden framework. Oxide a Carbon dohromady server rozbijí.

Instalace#

Než začnete:

• Aktualizujte Rust server na nejnovější verzi. Verze frameworku musí odpovídat verzi hry.
• Udělejte zálohu, pokud server už nějaký svět má. Viz Zálohy herních serverů.
• Zjistěte operační systém serveru. Vlastní VPS a většina herních hostingů běží na Linuxu. Pro Windows a Linux se stahují jiné soubory.

curl -fL -o /opt/rust/oxide.zip https://github.com/OxideMod/Oxide.Rust/releases/latest/download/Oxide.Rust-linux.zip
unzip -o /opt/rust/oxide.zip -d /opt/rust/server

curl -fL -o /opt/rust/carbon.tar.gz https://github.com/CarbonCommunity/Carbon/releases/download/production_build/Carbon.Linux.Release.tar.gz
tar -xzf /opt/rust/carbon.tar.gz -C /opt/rust/server

Ověření#

Kde zadávat příkazy: v konzoli serveru (na herním hostingu záložka Konzole), přes RCON (viz Admin a RCON), nebo ve hře v konzoli F1, pokud jste na serveru admin.

Po každé aktualizaci Rustu#

Facepunch vydává velkou aktualizaci Rustu jednou měsíčně, obvykle první čtvrtek v měsíci večer (výchozí čas wipe časovače je 19:00 londýnského času, tedy 20:00 našeho času). Mezitím občas vyjdou menší opravy. Po aktualizaci hry musí přijít i odpovídající verze frameworku.

Přechod z Oxide na Carbon#

Carbon umí převzít konfigurace, data, překlady i oprávnění z Oxide. Postup podle dokumentace Carbonu:

1. Server vypněte.
2. Vypněte vše, co by Oxide automaticky instalovalo nebo aktualizovalo (například volbu „instalovat Oxide“ u poskytovatele nebo krok ve vlastním spouštěcím skriptu).
3. Vraťte soubory hry do čisté podoby: proveďte ověření souborů hry (SteamCMD s parametrem validate, na hostingu „ověřit soubory“ nebo přeinstalaci hry bez mazání dat). Tím zmizí soubory, které Oxide přepsal.
4. Nainstalujte Carbon podle návodu výše.
5. Server spusťte. Carbon při prvním startu najde zbytky Oxide a automaticky zkopíruje konfigurace, data, překlady, uživatele a skupiny do své složky. Rozšíření Oxide (soubory Oxide.Ext.*.dll ve RustDedicated_Data/Managed) přesune do carbon/extensions.
6. Ověřte c.version a příkazem c.plugins zkontrolujte, že se pluginy načetly.

Pokud automatický převod neproběhl (běží jen jednou), převeďte data ručně:

• obsah složky oxide zkopírujte do carbon kromě složky config,
• obsah oxide/config zkopírujte do carbon/configs,
• soubory Oxide.Ext.*.dll přesuňte z RustDedicated_Data/Managed do carbon/extensions.

Po převodu už složku oxide nepotřebujete. Příkazy s předponou oxide. a o. v Carbonu nefungují, používejte c. (například c.grant místo oxide.grant).

Když něco nefunguje#

Příkaz oxide.version server nezná#

Oxide se nenačetl. Nejčastější příčiny:

• Soubory jsou o úroveň vedle: nahráli jste celou složku archivu a vzniklo například Oxide.Rust/RustDedicated_Data/…. Složka RustDedicated_Data z archivu musí přepsat tu původní v kořeni serveru.
• Na Linux server jste nahráli Windows verzi (Oxide.Rust.zip) nebo naopak.
• Po nahrání Oxide proběhla aktualizace hry, která soubory přepsala (viz další bod).

Po restartu Oxide zmizel#

Spouštěcí skript nebo hosting při každém startu aktualizuje a ověřuje soubory hry. Ověření vrátí soubory do čisté podoby a Oxide z nich odstraní. Vypněte automatickou aktualizaci při startu, nebo po ní Oxide pokaždé nahrajte znovu.

Server po instalaci frameworku padá při startu#

Verze frameworku neodpovídá verzi hry. Aktualizujte Rust i framework na nejnovější verze. U Oxide stahujte vydání, které vyšlo po poslední aktualizaci Rustu. Podrobnosti najdete v logu serveru a ve složce oxide/logs nebo carbon/logs.

Carbon se na Linuxu nenačte, server běží jako vanilla#

Spouštěcí skript nenačítá carbon/tools/environment.sh před spuštěním RustDedicated. Doplňte řádek source podle návodu pro VPS. Dokumentace Carbonu upozorňuje, že v některých prostředích (hlavně v Dockeru) je navíc potřeba nastavit export TERM=xterm.

Mám nainstalovaný Oxide i Carbon#

Oba frameworky dohromady fungovat nemohou. Vypněte server, ověřte soubory hry (validate), nechte jen jeden z nich a postupujte podle části Přechod z Oxide na Carbon.

Plugin funguje na Oxide, ale na Carbonu ne#

Zkontrolujte, že máte nejnovější verzi pluginu i Carbonu. Chybový výpis najdete v konzoli a v carbon/logs. Pokud chyba trvá, nahlaste ji autorovi pluginu nebo komunitě Carbonu a přiložte výpis.

Chci, aby server nebyl v záložce Modded#

V Carbonu příkaz c.whymodded vypíše, proč je server označený jako modded, a c.gocommunity provede změny potřebné pro záložku Community. V Oxide je označení řízené volbou "Modded" v souboru oxide/oxide.config.json. Pokud ale pluginy mění hratelnost, nechte server v Modded.

Další zdroje#

• Oxide: instalace (oficiální dokumentace) (otevře se v novém okně)
• Oxide.Rust – vydání na GitHubu (otevře se v novém okně)
• Carbon: instalace (otevře se v novém okně)
• Carbon: přechod z Oxide (otevře se v novém okně)
• Carbon na wiki Facepunche (otevře se v novém okně)
• Pluginy pro Rust na umod.org (otevře se v novém okně)