Prejsť na obsah
Aktuálny kupón:zľava 10 %Uplatniť v objednávke

Oxide (uMod) a Carbon: čo to je, ako vybrať a nainštalovať

Čo je modovací framework pre Rust, čím sa líšia Oxide a Carbon, ktorý zvoliť, ako ho nainštalovať, overiť a čo urobiť po každej aktualizácii Rustu.

  • začiatočník
  • ~20 min
  • Aktualizované 1. 10. 2026

Čistý (vanilla) Rust server pluginy spúšťať nevie. Potrebuje na to modovací framework: buď Oxide, alebo Carbon. Vysvetlíme, čo framework robí, ako sa tie dva líšia, ktorý si vybrať, ako ho nainštalovať a čo robiť po každej mesačnej aktualizácii Rustu.

Čo budete potrebovať

  • Rust server, ktorý sa bez frameworku normálne spustí
  • Prístup k súborom servera (správca súborov, SFTP alebo SSH na vlastnej VPS)
  • Možnosť server vypnúť a znova spustiť
  • Asi 20 minút

Rust u StormHostu

Rust servery u nás pripravujeme. Návod platí aj pre Rust server na vlastnej VPS (postup inštalácie).

Čo je modovací framework#

Framework je doplnok servera, ktorý sa načíta spolu s Rustom a otvorí mu „dvere“ pre pluginy. Plugin je obyčajný textový súbor so zdrojovým kódom v jazyku C# a príponou .cs. Framework ho pri načítaní sám preloží (skompiluje) a spustí. Vy teda nahrávate iba súbor .cs, nič ďalšie neprekladáte.

Čo framework prináša:

  • Hooky – miesta v hre, na ktoré sa pluginy „zavesia“ (hráč sa pripojil, niečo sa postavilo, niekto vyťažil kameň…). Vďaka nim môže plugin zmeniť takmer čokoľvek.
  • Systém oprávnení – skupiny hráčov a práva typu kits.admin. Pozrite Oprávnenia na Rust serveri.
  • Konfigurácia, dáta a preklady pluginov – každý plugin si vytvorí vlastný súbor nastavení (JSON), ktorý upravujete vy.

Hráči si nič neinštalujú. Všetko beží iba na serveri a hráč sa pripája rovnakým klientom Rustu ako na akýkoľvek iný server.

Záložka Modded v zozname serverov

Oxide aj Carbon v predvolenom nastavení označia server ako modded. Hráči ho potom nájdu v záložke Modded a v detaile servera uvidia štítok Oxide, alebo Carbon. Ak pluginy menia hrateľnosť (rýchlejšia ťažba, kity, teleporty), nechajte server v Modded – hráči tam také servery hľadajú.

Oxide a uMod: prečo dva názvy#

Oxide je dlhodobo najrozšírenejší framework pre Rust. Projekt sa v minulosti premenoval na uMod a pod týmto menom dodnes beží web s pluginmi umod.org (otvorí sa v novom okne). Samotný framework pre Rust sa ale stále volá Oxide: súbory na stiahnutie sa volajú Oxide.Rust.zip, príkazy začínajú oxide. a v zozname serverov je štítok „Oxide“. Hovorové „oxymod“ alebo „oxide mod“ je to isté.

Oxide sťahujte z oficiálneho repozitára OxideMod/Oxide.Rust na GitHube (otvorí sa v novom okne). Nová verzia vychádza často, typicky niekoľkokrát do mesiaca a vždy po aktualizácii Rustu.

Carbon#

Carbon je novší framework (vznikol v roku 2022). Je postavený tak, aby spúšťal pluginy napísané pre Oxide, a to bez úprav. Pluginy teda sťahujete z rovnakých miest a používajú rovnaké súbory .cs.

Rozdiely oproti Oxide podľa autorov Carbonu:

  • Nemení súbory hry. Oxide prepisuje súbory v priečinku RustDedicated_Data/Managed, Carbon má všetko vo vlastnom priečinku carbon.
  • Aktualizuje sa sám. Pri štarte servera si stiahne verziu, ktorá zodpovedá nainštalovanému Rustu.
  • Hooky iba podľa potreby. Volá iba tie hooky, ktoré nejaký plugin skutočne používa, čo šetrí výkon.
  • Vstavané nástroje. Administrátorský panel v hre (príkaz /cpanel), voliteľné moduly (násobenie ťažby, veľkosť stackov, neviditeľnosť pre adminov, whitelist, automatický wipe) a profiler.

Carbon existuje v dvoch zostaveniach: Release (plné, s modulmi a panelom) a Minimal (iba spúšťanie pluginov). Na začiatok zvoľte Release.

Porovnanie#

OxideCarbon
Pluginy z umod.orgÁno, natívneÁno, väčšina pluginov pre Oxide funguje bez zmien
Kam sa inštalujePrepíše súbory hry v RustDedicated_Data/ManagedVlastný priečinok carbon v koreni servera, súbory hry nemení
Po aktualizácii RustuMusíte nahrať novú verziu Oxide (aktualizácia hry ho prepíše)Aktualizuje sa sám pri štarte, stačí aktualizovať Rust
Výkon (podľa autorov Carbonu)Všetky hooky aktívneHooky sa zapínajú, iba keď ich plugin potrebuje
Vstavané nástrojeŽiadne, všetko riešia pluginyAdmin panel, moduly, profiler, webový panel
Priečinok s pluginmioxide/pluginscarbon/plugins
Konfigurácia pluginovoxide/configcarbon/configs (pozor, množné číslo)
Dáta, preklady, logyoxide/data, oxide/lang, oxide/logscarbon/data, carbon/lang, carbon/logs
Predpona príkazovoxide. alebo skrátene o.c.
Predvolené skupiny oprávnenídefault, admindefault, admin, moderator
Štítok v zozname serverovOxideCarbon

Ako vybrať#

  • Oxide zvoľte, ak chcete najrozšírenejší štandard. Autori pluginov ho testujú ako prvý a väčšina návodov na internete počíta s ním. Cenou je ručná aktualizácia po každom update Rustu.
  • Carbon zvoľte, ak chcete čo najmenej práce s aktualizáciami, vstavaný admin panel a moduly. Keď nejaký plugin na Carbone nefunguje, dajte vedieť autorovi pluginu alebo komunite Carbonu.

Na jednom serveri smie bežať iba jeden framework. Oxide a Carbon dohromady server rozbijú.

Inštalácia#

Skôr než začnete:

  • Aktualizujte Rust server na najnovšiu verziu. Verzia frameworku musí zodpovedať verzii hry.
  • Urobte zálohu, ak server už nejaký svet má. Pozrite Zálohy herných serverov.
  • Zistite operačný systém servera. Vlastná VPS a väčšina herných hostingov beží na Linuxe. Pre Windows a Linux sa sťahujú iné súbory.

Oxide

  1. Server vypnite. Nahrávanie súborov do bežiaceho servera môže poškodiť dáta.
  2. Otvorte stránku Oxide.Rust – Releases (otvorí sa v novom okne) a pri najnovšom vydaní, ktoré nie je označené ako „Pre-release“, rozbaľte časť Assets.
  3. Stiahnite súbor podľa systému servera:
    • Oxide.Rust-linux.zip pre Linux,
    • Oxide.Rust.zip pre Windows.
  4. Rozbaľte archív v počítači. Vnútri je jediný priečinok RustDedicated_Data.
  5. Nahrajte priečinok RustDedicated_Data z archívu do koreňového priečinka servera, teda tam, kde je súbor RustDedicated (na Windows RustDedicated.exe) a pôvodný priečinok RustDedicated_Data. Keď sa program spýta, potvrďte prepísanie existujúcich súborov.
  6. Server spustite. Pri prvom štarte Oxide vytvorí v koreni servera priečinok oxide s podpriečinkami plugins, config, data, lang a logs.

Na vlastnej VPS s Linuxom to urobíte príkazmi (cesty zodpovedajú návodu Vlastný Rust server na VPS):

bash
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/oxide.zip … – stiahne poslednú stabilnú Linux verziu Oxide do domovského priečinka používateľa rust. -f ukončí príkaz chybou, keď súbor neexistuje, -L nasleduje presmerovanie GitHubu na skutočný súbor.
  • unzip -o … -d /opt/rust/server – rozbalí archív do koreňa servera; -o prepíše existujúce súbory bez pýtania.

Spúšťajte to ako používateľ, pod ktorým server beží (v návode rust, z roota sa naň prepnete príkazom su - rust), aby nové súbory patrili jemu. Program unzip musí byť nainštalovaný (apt install unzip).

Správca súborov nevie rozbaliť archív

Ak správca súborov vášho hostingu archívy nerozbaľuje, nahrajte rozbalené súbory cez SFTP (FileZilla, WinSCP). Priečinky sa nahrajú aj so štruktúrou.

Carbon

  1. Server vypnite.
  2. Otvorte stránku Carbon – Releases (otvorí sa v novom okne) a nájdite vydanie Production Build (stabilná verzia pre bežný Rust).
  3. Stiahnite súbor podľa systému servera:
    • Carbon.Linux.Release.tar.gz pre Linux,
    • Carbon.Windows.Release.zip pre Windows.
  4. Rozbaľte archív do koreňového priečinka servera (tam, kde je RustDedicated alebo RustDedicated.exe). Priečinok carbon z archívu musí skončiť priamo v koreni servera a súbory z koreňa archívu tiež v koreni servera: na Linuxe libdoorstop.so a carbon.sh, na Windows winhttp.dll a doorstop_config.ini.
  5. Iba na Linuxe: Carbon sa zavádza cez premenné prostredia. V spúšťacom skripte servera preto pred spustením RustDedicated načítajte súbor carbon/tools/environment.sh (podrobne v návode pre VPS). Na hernom hostingu to zariaďuje poskytovateľ; keď Carbon nepodporuje, nenačíta sa.
  6. Server spustite. Carbon si pri štarte stiahne aktualizácie pre vašu verziu Rustu a vytvorí v priečinku carbon podpriečinky pre pluginy, konfigurácie a logy.

Na vlastnej VPS s Linuxom:

bash
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
  • curl -fL -o /opt/rust/carbon.tar.gz … – stiahne stabilné (production) zostavenie Carbonu pre Linux.
  • tar -xzf … -C /opt/rust/server – rozbalí archív (-x), ktorý je komprimovaný gzipom (-z), zo súboru (-f) do priečinka servera (-C).

Overenie#

Oxide

  1. Sledujte konzolu pri štarte. Objavia sa riadky s načítaním Oxide a jeho rozšírení.

  2. Do konzoly servera zadajte:

    text
    oxide.version

    Uvidíte verziu a vetvu, napríklad:

    Výstuptext
    Oxide.Rust Version: 2.0.<CISLO_VERZE>
    Oxide.Rust Branch: master

    V hre v konzole F1 má výpis inú podobu: Server is running Oxide … and Rust ….

  3. Skontrolujte, že v koreni servera vznikol priečinok oxide s podpriečinkom plugins.

Carbon

  1. Sledujte konzolu pri štarte. Carbon vypisuje priebeh načítania a prípadné sťahovanie aktualizácie.

  2. Do konzoly servera zadajte:

    text
    c.version

    Príkaz vypíše verziu Carbonu a verziu Rustu, na ktorej beží.

  3. Skontrolujte, že v priečinku carbon sú podpriečinky plugins, configs a logs a súbor config.json.

Kde zadávať príkazy: v konzole servera (na hernom hostingu záložka Konzola), cez RCON (pozrite Admin a RCON), alebo v hre v konzole F1, ak ste na serveri admin.

Po každej aktualizácii Rustu#

Facepunch vydáva veľkú aktualizáciu Rustu raz mesačne, obvykle prvý štvrtok v mesiaci večer (predvolený čas wipe časovača je 19:00 londýnskeho času, teda 20:00 nášho času). Medzitým občas vyjdú menšie opravy. Po aktualizácii hry musí prísť aj zodpovedajúca verzia frameworku.

Oxide

  1. Počkajte, kým na GitHube (otvorí sa v novom okne) vyjde nová verzia Oxide (obvykle krátko po aktualizácii Rustu).
  2. Server vypnite.
  3. Aktualizujte Rust (na hostingu aktualizáciou alebo preinštalovaním hry, na VPS cez SteamCMD).
  4. Nahrajte Oxide znova rovnakým postupom ako pri inštalácii. Aktualizácia hry prepíše súbory v RustDedicated_Data/Managed čistou verziou a Oxide tým zmizne.
  5. Server spustite a overte oxide.version.

Priečinok oxide s pluginmi, konfiguráciou a dátami zostáva, aktualizácia hry ho nemaže.

Carbon

  1. Server vypnite.
  2. Aktualizujte Rust.
  3. Server spustite. Carbon pri štarte porovná svoju verziu s verziou Rustu a sám si stiahne správne zostavenie. Autori vydávajú stabilnú verziu pre mesačnú aktualizáciu zhruba hodinu pred vydaním Rustu.
  4. Overte c.version.

Veľké aktualizácie môžu rozbiť aj pluginy

Po mesačnej aktualizácii sa môže zmeniť kód hry, s ktorým plugin pracuje. Ak plugin hlási chybu kompilácie, skontrolujte na jeho stránke, či vyšla nová verzia. Mesačná aktualizácia navyše obvykle znamená aj nový svet (force wipe), pozrite Wipe Rust servera.

Prechod z Oxide na Carbon#

Carbon vie prevziať konfigurácie, dáta, preklady aj oprávnenia z Oxide. Postup podľa dokumentácie Carbonu:

  1. Server vypnite.
  2. Vypnite všetko, čo by Oxide automaticky inštalovalo alebo aktualizovalo (napríklad voľbu „inštalovať Oxide“ u poskytovateľa alebo krok vo vlastnom spúšťacom skripte).
  3. Vráťte súbory hry do čistej podoby: vykonajte overenie súborov hry (SteamCMD s parametrom validate, na hostingu „overiť súbory“ alebo preinštalovanie hry bez mazania dát). Tým zmiznú súbory, ktoré Oxide prepísal.
  4. Nainštalujte Carbon podľa návodu vyššie.
  5. Server spustite. Carbon pri prvom štarte nájde zvyšky Oxide a automaticky skopíruje konfigurácie, dáta, preklady, používateľov a skupiny do svojho priečinka. Rozšírenia Oxide (súbory Oxide.Ext.*.dll v RustDedicated_Data/Managed) presunie do carbon/extensions.
  6. Overte c.version a príkazom c.plugins skontrolujte, že sa pluginy načítali.

Ak automatický prevod neprebehol (beží iba raz), preveďte dáta ručne:

  • obsah priečinka oxide skopírujte do carbon okrem priečinka config,
  • obsah oxide/config skopírujte do carbon/configs,
  • súbory Oxide.Ext.*.dll presuňte z RustDedicated_Data/Managed do carbon/extensions.

Po prevode už priečinok oxide nepotrebujete. Príkazy s predponou oxide. a o. v Carbone nefungujú, používajte c. (napríklad c.grant namiesto oxide.grant).

Keď niečo nefunguje#

Príkaz oxide.version server nepozná#

Oxide sa nenačítal. Najčastejšie príčiny:

  • Súbory sú o úroveň vedľa: nahrali ste celý priečinok archívu a vzniklo napríklad Oxide.Rust/RustDedicated_Data/…. Priečinok RustDedicated_Data z archívu musí prepísať ten pôvodný v koreni servera.
  • Na Linux server ste nahrali Windows verziu (Oxide.Rust.zip) alebo naopak.
  • Po nahraní Oxide prebehla aktualizácia hry, ktorá súbory prepísala (pozrite ďalší bod).

Po reštarte Oxide zmizol#

Spúšťací skript alebo hosting pri každom štarte aktualizuje a overuje súbory hry. Overenie vráti súbory do čistej podoby a Oxide z nich odstráni. Vypnite automatickú aktualizáciu pri štarte, alebo po nej Oxide zakaždým nahrajte znova.

Server po inštalácii frameworku padá pri štarte#

Verzia frameworku nezodpovedá verzii hry. Aktualizujte Rust aj framework na najnovšie verzie. Pri Oxide sťahujte vydanie, ktoré vyšlo po poslednej aktualizácii Rustu. Podrobnosti nájdete v logu servera a v priečinku oxide/logs alebo carbon/logs.

Carbon sa na Linuxe nenačíta, server beží ako vanilla#

Spúšťací skript nenačítava carbon/tools/environment.sh pred spustením RustDedicated. Doplňte riadok source podľa návodu pre VPS. Dokumentácia Carbonu upozorňuje, že v niektorých prostrediach (hlavne v Dockeri) treba navyše nastaviť export TERM=xterm.

Mám nainštalovaný Oxide aj Carbon#

Oba frameworky dohromady fungovať nemôžu. Vypnite server, overte súbory hry (validate), nechajte iba jeden z nich a postupujte podľa časti Prechod z Oxide na Carbon.

Plugin funguje na Oxide, ale na Carbone nie#

Skontrolujte, že máte najnovšiu verziu pluginu aj Carbonu. Chybový výpis nájdete v konzole a v carbon/logs. Ak chyba trvá, nahláste ju autorovi pluginu alebo komunite Carbonu a priložte výpis.

Chcem, aby server nebol v záložke Modded#

V Carbone príkaz c.whymodded vypíše, prečo je server označený ako modded, a c.gocommunity vykoná zmeny potrebné pre záložku Community. V Oxide je označenie riadené voľbou "Modded" v súbore oxide/oxide.config.json. Ak ale pluginy menia hrateľnosť, nechajte server v Modded.

Zhrnutie

  • Framework (Oxide alebo Carbon) je podmienka pre pluginy. Hráči nič neinštalujú.
  • Oxide je najrozšírenejší, Carbon spúšťa rovnaké pluginy, aktualizuje sa sám a má vstavané nástroje.
  • Na serveri smie byť iba jeden framework.
  • Oxide sa nahráva do koreňa servera cez priečinok RustDedicated_Data, Carbon ako priečinok carbon (na Linuxe navyše environment.sh).
  • Overenie: oxide.version, alebo c.version.
  • Po každej aktualizácii Rustu nahrajte znova Oxide; Carbon sa aktualizuje sám.

Hľadanie v návodoch