Tento průvodce popisuje, jak nainstalovat modovací framework Oxide/uMod nebo Carbon na váš server Rust, přidávat komunitní pluginy a spravovat je přes konzoli. Obecnou konfiguraci serveru a startovací proměnné najdete v Průvodci konfigurací serveru Rust.

Instalace Oxide/uMod nebo Carbon

Oxide (nyní spravovaný jako uMod) a Carbon jsou modovací frameworky pro Rust, které umožňují instalaci komunitních pluginů. Tyto frameworky přidávají funkce jako ekonomické systémy, vlastní kity, odměny za hlasování, PvE ochranné zóny a mnoho dalšího.

Nemusíte ručně nahrávat žádné soubory. Modovací framework se nainstaluje automaticky nastavením jediné startovací proměnné:

1. Zastavte server ze záložky Console v GPanel.
2. Přihlaste se do GPanel a přejděte na záložku Startup.
3. Najděte proměnnou FRAMEWORK a nastavte ji na:
   • oxide — pro Oxide/uMod (nejrozšířenější framework s největší knihovnou pluginů)
   • carbon — pro framework Carbon (alternativa s vlastním ekosystémem pluginů)
   • vanilla — pro provoz bez modovacího frameworku
4. Spusťte server. Soubory frameworku se stáhnou a aplikují automaticky. Při prvním spuštění s Oxide se vygeneruje adresářová struktura oxide/.
5. Zkontrolujte v logu konzole řádek jako Loaded plugin Oxide.Core, abyste potvrdili, že Oxide je aktivní.

Instalace pluginů

Pluginy jsou distribuovány jako soubory .cs (zdrojový kód C#). Oxide je kompiluje na serveru za běhu — předkompilace není nutná.

1. Stáhněte soubor pluginu .cs z umod.org nebo z jiného důvěryhodného zdroje.
2. Nahrajte soubor .cs do adresáře oxide/plugins/ na vašem serveru pomocí SFTP nebo správce souborů v GPanel. Nápovědu k SFTP najdete v článku Jak nahrávat soubory přes SFTP.
3. Pokud server běží, plugin bude automaticky detekován a zkompilován během několika sekund. V konzoli uvidíte potvrzení o načtení, např. Loaded plugin MyPlugin v1.2.3 by Author.
4. Pokud server neběží, plugin se načte při dalším spuštění.

Adresářová struktura Oxide

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

Konfigurace pluginů

Většina pluginů vygeneruje konfigurační soubor ve formátu JSON v oxide/config/ při prvním načtení. Pro přizpůsobení pluginu:

1. Nechte plugin načíst alespoň jednou, aby vygeneroval svůj výchozí konfigurační soubor.
2. Zastavte server (nebo si uvědomte, že některé pluginy podporují živé načtení konfigurace).
3. Otevřete konfigurační soubor pluginu v oxide/config/PluginName.json pomocí správce souborů v GPanel nebo přes SFTP.
4. Upravte nastavení a uložte soubor.
5. Znovu načtěte plugin příkazem oxide.reload PluginName nebo restartujte server.

Správa pluginů přes konzoli

Tyto příkazy lze spouštět z konzole GPanel nebo přes RCON klienta. Nastavení RCON najdete v článku Přístup k RCON a administrátorské příkazy pro Rust.

Aktualizace pluginů

Pro aktualizaci pluginu na novější verzi:

1. Stáhněte aktualizovaný soubor .cs ze stránky pluginu na umod.org.
2. Nahrajte nový soubor do oxide/plugins/ a přepište existující soubor.
3. Pokud server běží, Oxide detekuje změnu souboru a automaticky plugin překompiluje a znovu načte. Případně spusťte oxide.reload PluginName.
4. Zkontrolujte konzoli, zda neobsahuje chyby. Některé aktualizace pluginů mohou vyžadovat změny konfiguračního souboru v oxide/config/.

Odebrání pluginů

Pro úplné odebrání pluginu:

1. Spusťte oxide.unload PluginName pro odstraněni pluginu z paměti, zatímco server běží.
2. Smažte soubor .cs z oxide/plugins/.
3. Volitelně smažte konfigurační soubor pluginu z oxide/config/ a datové soubory z oxide/data/, pokud je již nepotřebujete.

Oblíbené pluginy

Řešení problémů s pluginy

Pokud se vaše pluginy nenačítají, zkontrolujte následující:

• Potvrďte, že Oxide je nainstalován a aktivní. Na záložce Startup v GPanel musí být proměnná FRAMEWORK nastavena na oxide. V logu konzole by se během spuštění mělo zobrazit Loaded plugin Oxide.Core.
• Soubory pluginů musí být umístěny přímo v oxide/plugins/ s přesnou příponou .cs. Soubory v podadresářích nebo s nesprávnými příponami jsou ignorovány.
• Zkontrolujte konzoli a oxide/logs/, zda neobsahují chyby kompilace. Plugin se syntaktickou chybou se nenačte a chybová zpráva popíše problém.
• Některé pluginy mají závislosti na jiných pluginech (např. mnoho obchodních pluginů vyžaduje Economics). Nejprve nainstalujte všechny požadované závislosti.

Další běžné problémy se serverem najdete v článku Řešení problémů se serverem Rust.

Potřebujete pomoc?

Pokud narazíte na problém, který tento průvodce nepokrývá, náš tým podpory je připraven pomoci. Odešlete tiket podpory a uveďte ID vašeho serveru, popis problému a jakýkoli relevantní výstup konzole.