Aquesta guia cobreix com instal·lar el framework de modding Oxide/uMod o Carbon al vostre servidor de Rust, afegir plugins de la comunitat i gestionar-los via la consola. Per a la configuració general del servidor i les variables d'inici, consulteu la Guia de Configuració del Servidor de Rust.

Instal·lació d'Oxide/uMod o Carbon

Oxide (ara mantingut com a uMod) i Carbon són frameworks de modding per a Rust que us permeten instal·lar plugins creats per la comunitat. Aquests frameworks afegeixen funcionalitats com sistemes d'economia, kits personalitzats, recompenses per vots, zones de protecció PvE i molt més.

No necessiteu pujar cap fitxer manualment. El framework de modding s'instal·la automàticament establint una sola variable d'inici:

1. Atureu el servidor des de la pestanya Console de GPanel.
2. Inicieu sessió a GPanel i aneu a la pestanya Startup.
3. Trobeu la variable FRAMEWORK i establiu-la a:
   • oxide — per a Oxide/uMod (el framework més àmpliament utilitzat, amb la biblioteca de plugins més gran)
   • carbon — per al framework Carbon (una alternativa amb el seu propi ecosistema de plugins)
   • vanilla — per executar sense cap framework de modding
4. Inicieu el servidor. Els fitxers del framework es descarreguen i s'apliquen automàticament. En el primer inici amb Oxide, es genera l'estructura del directori oxide/.
5. Comproveu el registre de la consola per a una línia com Loaded plugin Oxide.Core per confirmar que Oxide està actiu.

Instal·lació de Plugins

Els plugins es distribueixen com a fitxers .cs (codi font C#). Oxide els compila al servidor en temps d'execució — no cal cap precompilació.

1. Descarregueu el fitxer .cs del plugin des de umod.org o una altra font de confiança.
2. Pengeu el fitxer .cs al directori oxide/plugins/ del vostre servidor utilitzant SFTP o el gestor de fitxers de GPanel. Per a ajuda amb SFTP, consulteu Com Pujar Fitxers via SFTP.
3. Si el servidor està en funcionament, el plugin serà detectat i compilat automàticament en uns segons. Veureu una sortida a la consola confirmant que s'ha carregat, p. ex. Loaded plugin MyPlugin v1.2.3 by Author.
4. Si el servidor no està en funcionament, el plugin es carregarà en el proper inici.

Estructura del Directori 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

Configuració de Plugins

La majoria de plugins generen un fitxer de configuració JSON a oxide/config/ la primera vegada que es carreguen. Per personalitzar un plugin:

1. Deixeu que el plugin es carregui almenys una vegada perquè generi el seu fitxer de configuració per defecte.
2. Atureu el servidor (o tingueu en compte que alguns plugins admeten la recàrrega de configuració en directe).
3. Obriu el fitxer de configuració del plugin a oxide/config/PluginName.json utilitzant el gestor de fitxers de GPanel o SFTP.
4. Editeu les opcions i deseu el fitxer.
5. Recarregueu el plugin amb oxide.reload PluginName o reinicieu el servidor.

Gestió de Plugins via Consola

Aquestes comandes es poden executar des de la consola de GPanel o via un client RCON. Per a la configuració de RCON, consulteu Accés RCON i Comandes d'Administrador de Rust.

Actualització de Plugins

Per actualitzar un plugin a una versió més nova:

1. Descarregueu el fitxer .cs actualitzat des de la pàgina del plugin a umod.org.
2. Pengeu el nou fitxer a oxide/plugins/, sobreescrivint el fitxer existent.
3. Si el servidor està en funcionament, Oxide detecta el canvi de fitxer i automàticament recompila i recarrega el plugin. Alternativament, executeu oxide.reload PluginName.
4. Comproveu la consola per a qualsevol error. Algunes actualitzacions de plugins poden requerir canvis al fitxer de configuració a oxide/config/.

Eliminació de Plugins

Per eliminar un plugin completament:

1. Executeu oxide.unload PluginName per descarregar el plugin mentre el servidor està en funcionament.
2. Elimineu el fitxer .cs de oxide/plugins/.
3. Opcionalment, elimineu el fitxer de configuració del plugin de oxide/config/ i els fitxers de dades de oxide/data/ si ja no els necessiteu.

Plugins Populars

Resolució de Problemes amb Plugins

Si els vostres plugins no es carreguen, comproveu el següent:

• Confirmeu que Oxide estigui instal·lat i actiu. A la pestanya Startup de GPanel, la variable FRAMEWORK ha d'estar establerta a oxide. El registre de la consola hauria de mostrar Loaded plugin Oxide.Core durant l'inici.
• Els fitxers de plugins han d'estar col·locats directament a oxide/plugins/ amb l'extensió exacta .cs. Els fitxers en subdirectoris o amb extensions incorrectes són ignorats.
• Comproveu la consola i oxide/logs/ per a errors de compilació. Un plugin amb un error de sintaxi fallarà en carregar-se i el missatge d'error descriurà el problema.
• Alguns plugins tenen dependències d'altres plugins (p. ex. molts plugins de botiga requereixen Economics). Instal·leu primer totes les dependències requerides.

Per a altres problemes comuns del servidor, consulteu Resolució de Problemes del Servidor de Rust.

Necessiteu Ajuda?

Si trobeu un problema no cobert en aquesta guia, el nostre equip de suport està disponible per ajudar-vos. Envieu un tiquet de suport i incloeu l'ID del vostre servidor, una descripció del problema i qualsevol sortida de consola rellevant.