Tämä opas käsittelee, kuinka asennat Oxide/uMod- tai Carbon-modaustyökalun Rust-palvelimellesi, lisäät yhteisön laajennuksia ja hallitset niitä konsolin kautta. Yleisestä palvelimen määrityksestä ja käynnistysmuuttujista löydät tietoa Rust-palvelimen määritysoppaasta.

Oxide/uMod- tai Carbon-työkalun asentaminen

Oxide (nykyään ylläpidetty nimellä uMod) ja Carbon ovat Rustin modaustyökaluja, joiden avulla voit asentaa yhteisön rakentamia laajennuksia. Nämä työkalut lisäävät ominaisuuksia, kuten talousjärjestelmiä, mukautettuja varustepaketteja, äänestyspalkintoja, PvE-suoja-alueita ja paljon muuta.

Sinun ei tarvitse ladata tiedostoja manuaalisesti. Modaustyökalu asennetaan automaattisesti asettamalla yksi käynnistysmuuttuja:

1. Pysäytä palvelin GPanelin Console-välilehdeltä.
2. Kirjaudu GPaneliin ja siirry Startup-välilehdelle.
3. Etsi FRAMEWORK-muuttuja ja aseta sen arvoksi:
   • oxide — Oxide/uMod-työkalulle (yleisimmin käytetty työkalu, jolla on suurin laajennuskirjasto)
   • carbon — Carbon-työkalulle (vaihtoehto, jolla on oma laajennusekosysteeminsä)
   • vanilla — palvelimen ajamiseen ilman modaustyökalua
4. Käynnistä palvelin. Työkalun tiedostot ladataan ja otetaan käyttöön automaattisesti. Ensimmäisellä käynnistyksellä Oxiden kanssa luodaan oxide/-hakemistorakenne.
5. Tarkista konsolilokista rivi kuten Loaded plugin Oxide.Core varmistaaksesi, että Oxide on aktiivinen.

Laajennusten asentaminen

Laajennukset jaetaan .cs-tiedostoina (C#-lähdekoodi). Oxide kääntää ne palvelimella ajon aikana — esikääntämistä ei tarvita.

1. Lataa laajennuksen .cs-tiedosto osoitteesta umod.org tai muusta luotettavasta lähteestä.
2. Lataa .cs-tiedosto palvelimesi oxide/plugins/-hakemistoon käyttäen SFTP:tä tai GPanelin tiedostonhallintaa. Apua SFTP:n käyttöön löydät artikkelista Tiedostojen lataaminen SFTP:n kautta.
3. Jos palvelin on käynnissä, laajennus havaitaan ja käännetään automaattisesti muutamassa sekunnissa. Konsolissa näkyy lataamisen vahvistava tuloste, esim. Loaded plugin MyPlugin v1.2.3 by Author.
4. Jos palvelin ei ole käynnissä, laajennus latautuu seuraavalla käynnistyksellä.

Oxiden hakemistorakenne

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

Laajennusten määrittäminen

Useimmat laajennukset luovat JSON-määritystiedoston hakemistoon oxide/config/ ensimmäisellä latauskerralla. Laajennuksen mukauttaminen:

1. Anna laajennuksen latautua vähintään kerran, jotta se luo oletusmääritystiedostonsa.
2. Pysäytä palvelin (tai huomaa, että jotkin laajennukset tukevat määrityksen lataamista uudelleen lennossa).
3. Avaa laajennuksen määritystiedosto oxide/config/PluginName.json käyttäen GPanelin tiedostonhallintaa tai SFTP:tä.
4. Muokkaa asetuksia ja tallenna tiedosto.
5. Lataa laajennus uudelleen komennolla oxide.reload PluginName tai käynnistä palvelin uudelleen.

Laajennusten hallinta konsolin kautta

Nämä komennot voidaan suorittaa GPanelin konsolista tai RCON-asiakasohjelman kautta. RCON-määrityksestä löydät tietoa artikkelista Rustin RCON-käyttö ja ylläpitäjän komennot.

Laajennusten päivittäminen

Laajennuksen päivittäminen uudempaan versioon:

1. Lataa päivitetty .cs-tiedosto laajennuksen sivulta osoitteessa umod.org.
2. Lataa uusi tiedosto hakemistoon oxide/plugins/ ja korvaa olemassa oleva tiedosto.
3. Jos palvelin on käynnissä, Oxide havaitsee tiedostomuutoksen ja kääntää sekä lataa laajennuksen automaattisesti uudelleen. Vaihtoehtoisesti suorita komento oxide.reload PluginName.
4. Tarkista konsolista mahdolliset virheet. Jotkin laajennuspäivitykset saattavat vaatia muutoksia määritystiedostoon hakemistossa oxide/config/.

Laajennusten poistaminen

Laajennuksen poistaminen kokonaan:

1. Suorita komento oxide.unload PluginName poistaaksesi laajennuksen käytöstä palvelimen ollessa käynnissä.
2. Poista .cs-tiedosto hakemistosta oxide/plugins/.
3. Voit halutessasi poistaa laajennuksen määritystiedoston hakemistosta oxide/config/ ja datatiedostot hakemistosta oxide/data/, jos et enää tarvitse niitä.

Suositut laajennukset

Laajennusongelmien vianmääritys

Jos laajennuksesi eivät lataudu, tarkista seuraavat:

• Varmista, että Oxide on asennettu ja aktiivinen. GPanelin Startup-välilehdellä FRAMEWORK-muuttujan arvon on oltava oxide. Konsolilokissa pitäisi näkyä Loaded plugin Oxide.Core käynnistyksen aikana.
• Laajennustiedostot on sijoitettava suoraan hakemistoon oxide/plugins/ täsmälleen .cs-tunnisteella. Alihakemistoissa olevat tai väärillä tunnisteilla varustetut tiedostot ohitetaan.
• Tarkista konsolista ja hakemistosta oxide/logs/ käännösvirheet. Syntaksivirheen sisältävä laajennus ei lataudu, ja virheilmoitus kuvaa ongelman.
• Joillakin laajennuksilla on riippuvuuksia muihin laajennuksiin (esim. monet kauppalaajennukset vaativat Economicsin). Asenna kaikki vaaditut riippuvuudet ensin.

Muista yleisistä palvelinongelmista löydät tietoa artikkelista Rust-palvelimen vianmääritys.

Tarvitsetko apua?

Jos kohtaat ongelman, jota ei käsitellä tässä oppaassa, tukitiimimme auttaa mielellään. Lähetä tukipyyntö ja liitä mukaan palvelimesi tunnus, ongelman kuvaus sekä mahdollinen olennainen konsolituloste.