Esta guía cubre cómo instalar el framework de modding Oxide/uMod o Carbon en tu servidor de Rust, agregar plugins de la comunidad y gestionarlos a través de la consola. Para la configuración general del servidor y variables de inicio, consulta la Guía de Configuración del Servidor de Rust.

Instalación de Oxide/uMod o Carbon

Oxide (ahora mantenido como uMod) y Carbon son frameworks de modding para Rust que te permiten instalar plugins creados por la comunidad. Estos frameworks agregan funcionalidades como sistemas de economía, kits personalizados, recompensas por votos, zonas de protección PvE y mucho más.

No necesitas subir ningún archivo manualmente. El framework de modding se instala automáticamente configurando una única variable de inicio:

1. Detén tu servidor desde la pestaña Console de GPanel.
2. Inicia sesión en GPanel y ve a la pestaña Startup.
3. Encuentra la variable FRAMEWORK y establécela en:
   • oxide — para Oxide/uMod (el framework más ampliamente usado, con la mayor biblioteca de plugins)
   • carbon — para el framework Carbon (una alternativa con su propio ecosistema de plugins)
   • vanilla — para ejecutar sin ningún framework de modding
4. Inicia el servidor. Los archivos del framework se descargan y aplican automáticamente. En el primer inicio con Oxide, se genera la estructura del directorio oxide/.
5. Revisa el registro de la consola en busca de una línea como Loaded plugin Oxide.Core para confirmar que Oxide está activo.

Instalación de Plugins

Los plugins se distribuyen como archivos .cs (código fuente C#). Oxide los compila en el servidor en tiempo de ejecución — no se requiere precompilación.

1. Descarga el archivo .cs del plugin desde umod.org u otra fuente confiable.
2. Sube el archivo .cs al directorio oxide/plugins/ en tu servidor usando SFTP o el gestor de archivos de GPanel. Para ayuda con SFTP, consulta Cómo Subir Archivos vía SFTP.
3. Si el servidor está en ejecución, el plugin será detectado y compilado automáticamente en unos segundos. Verás una salida en la consola confirmando que se cargó, por ejemplo Loaded plugin MyPlugin v1.2.3 by Author.
4. Si el servidor no está en ejecución, el plugin se cargará en el próximo inicio.

Estructura del Directorio 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ón de Plugins

La mayoría de los plugins generan un archivo de configuración JSON en oxide/config/ la primera vez que se cargan. Para personalizar un plugin:

1. Deja que el plugin se cargue al menos una vez para que genere su archivo de configuración predeterminado.
2. Detén tu servidor (o ten en cuenta que algunos plugins soportan recarga de configuración en vivo).
3. Abre el archivo de configuración del plugin en oxide/config/PluginName.json usando el gestor de archivos de GPanel o SFTP.
4. Edita las configuraciones y guarda el archivo.
5. Recarga el plugin con oxide.reload PluginName o reinicia el servidor.

Gestión de Plugins vía Consola

Estos comandos se pueden ejecutar desde la consola de GPanel o vía un cliente RCON. Para la configuración de RCON, consulta Acceso RCON y Comandos de Administración de Rust.

Actualización de Plugins

Para actualizar un plugin a una versión más nueva:

1. Descarga el archivo .cs actualizado desde la página del plugin en umod.org.
2. Sube el nuevo archivo a oxide/plugins/, sobrescribiendo el archivo existente.
3. Si el servidor está en ejecución, Oxide detecta el cambio de archivo y automáticamente recompila y recarga el plugin. Alternativamente, ejecuta oxide.reload PluginName.
4. Revisa la consola en busca de errores. Algunas actualizaciones de plugins pueden requerir cambios en el archivo de configuración en oxide/config/.

Eliminación de Plugins

Para eliminar un plugin completamente:

1. Ejecuta oxide.unload PluginName para descargar el plugin mientras el servidor está en ejecución.
2. Elimina el archivo .cs de oxide/plugins/.
3. Opcionalmente elimina el archivo de configuración del plugin de oxide/config/ y los archivos de datos de oxide/data/ si ya no los necesitas.

Plugins Populares

Solución de Problemas con Plugins

Si tus plugins no se están cargando, verifica lo siguiente:

• Confirma que Oxide esté instalado y activo. En la pestaña Startup de GPanel, la variable FRAMEWORK debe estar establecida en oxide. El registro de la consola debe mostrar Loaded plugin Oxide.Core durante el inicio.
• Los archivos de plugins deben colocarse directamente en oxide/plugins/ con la extensión exacta .cs. Los archivos en subdirectorios o con extensiones incorrectas son ignorados.
• Revisa la consola y oxide/logs/ en busca de errores de compilación. Un plugin con un error de sintaxis no se cargará y el mensaje de error describirá el problema.
• Algunos plugins tienen dependencias de otros plugins (por ejemplo, muchos plugins de tienda requieren Economics). Instala todas las dependencias requeridas primero.

Para otros problemas comunes del servidor, consulta Solución de Problemas del Servidor de Rust.

¿Necesitas Ayuda?

Si encuentras un problema no cubierto en esta guía, nuestro equipo de soporte está disponible para ayudar. Envía un ticket de soporte e incluye tu ID de servidor, una descripción del problema y cualquier salida de consola relevante.