Panduan ini menjelaskan cara menginstal framework modding Oxide/uMod atau Carbon di server Rust Anda, menambahkan plugin komunitas, dan mengelolanya melalui konsol. Untuk konfigurasi server umum dan variabel startup, lihat Panduan Konfigurasi Server Rust.

Menginstal Oxide/uMod atau Carbon

Oxide (kini dikelola sebagai uMod) dan Carbon adalah framework modding untuk Rust yang memungkinkan Anda menginstal plugin buatan komunitas. Framework ini menambahkan fitur seperti sistem ekonomi, kit khusus, hadiah vote, zona perlindungan PvE, dan masih banyak lagi.

Anda tidak perlu mengunggah file apa pun secara manual. Framework modding diinstal secara otomatis dengan mengatur satu variabel startup:

1. Hentikan server Anda dari tab Console di GPanel.
2. Masuk ke GPanel dan buka tab Startup.
3. Temukan variabel FRAMEWORK dan atur ke:
   • oxide — untuk Oxide/uMod (framework yang paling banyak digunakan, dengan pustaka plugin terbesar)
   • carbon — untuk framework Carbon (alternatif dengan ekosistem plugin tersendiri)
   • vanilla — untuk menjalankan tanpa framework modding apa pun
4. Jalankan server. File framework diunduh dan diterapkan secara otomatis. Pada start pertama dengan Oxide, struktur direktori oxide/ akan dibuat.
5. Periksa log konsol untuk baris seperti Loaded plugin Oxide.Core untuk memastikan Oxide aktif.

Menginstal Plugin

Plugin didistribusikan sebagai file .cs (sumber C#). Oxide mengkompilasinya di server saat runtime — tidak diperlukan pra-kompilasi.

1. Unduh file plugin .cs dari umod.org atau sumber tepercaya lainnya.
2. Unggah file .cs ke direktori oxide/plugins/ di server Anda menggunakan SFTP atau file manager GPanel. Untuk bantuan dengan SFTP, lihat Cara Mengunggah File melalui SFTP.
3. Jika server sedang berjalan, plugin akan terdeteksi dan dikompilasi secara otomatis dalam beberapa detik. Anda akan melihat output di konsol yang mengonfirmasi plugin telah dimuat, mis. Loaded plugin MyPlugin v1.2.3 by Author.
4. Jika server tidak berjalan, plugin akan dimuat pada startup berikutnya.

Struktur Direktori 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

Mengonfigurasi Plugin

Sebagian besar plugin menghasilkan file konfigurasi JSON di oxide/config/ saat pertama kali dimuat. Untuk menyesuaikan plugin:

1. Biarkan plugin dimuat setidaknya sekali agar menghasilkan file konfigurasi default-nya.
2. Hentikan server Anda (atau perhatikan bahwa beberapa plugin mendukung reload konfigurasi secara langsung).
3. Buka file konfigurasi plugin di oxide/config/PluginName.json menggunakan file manager GPanel atau SFTP.
4. Edit pengaturan dan simpan file.
5. Muat ulang plugin dengan oxide.reload PluginName atau restart server.

Mengelola Plugin melalui Konsol

Perintah-perintah ini dapat dijalankan dari konsol GPanel atau melalui klien RCON. Untuk pengaturan RCON, lihat Akses RCON dan Perintah Admin Rust.

Memperbarui Plugin

Untuk memperbarui plugin ke versi yang lebih baru:

1. Unduh file .cs yang diperbarui dari halaman plugin di umod.org.
2. Unggah file baru ke oxide/plugins/, menimpa file yang ada.
3. Jika server sedang berjalan, Oxide mendeteksi perubahan file dan secara otomatis mengkompilasi ulang serta memuat ulang plugin. Atau, jalankan oxide.reload PluginName.
4. Periksa konsol untuk kesalahan apa pun. Beberapa pembaruan plugin mungkin memerlukan perubahan pada file konfigurasi di oxide/config/.

Menghapus Plugin

Untuk menghapus plugin sepenuhnya:

1. Jalankan oxide.unload PluginName untuk membongkar plugin saat server sedang berjalan.
2. Hapus file .cs dari oxide/plugins/.
3. Secara opsional hapus file konfigurasi plugin dari oxide/config/ dan file data dari oxide/data/ jika Anda tidak lagi memerlukannya.

Plugin Populer

Memecahkan Masalah Plugin

Jika plugin Anda tidak dimuat, periksa hal-hal berikut:

• Konfirmasikan Oxide terinstal dan aktif. Di tab Startup GPanel, variabel FRAMEWORK harus diatur ke oxide. Log konsol seharusnya menampilkan Loaded plugin Oxide.Core selama startup.
• File plugin harus ditempatkan langsung di oxide/plugins/ dengan ekstensi .cs yang tepat. File di subdirektori atau dengan ekstensi yang salah akan diabaikan.
• Periksa konsol dan oxide/logs/ untuk kesalahan kompilasi. Plugin dengan kesalahan sintaks akan gagal dimuat dan pesan kesalahan akan menjelaskan masalahnya.
• Beberapa plugin memiliki dependensi pada plugin lain (mis. banyak plugin toko memerlukan Economics). Instal semua dependensi yang diperlukan terlebih dahulu.

Untuk masalah server umum lainnya, lihat Pemecahan Masalah Server Rust.

Butuh Bantuan?

Jika Anda mengalami masalah yang tidak tercakup dalam panduan ini, tim dukungan kami siap membantu. Kirim tiket dukungan dan sertakan ID server Anda, deskripsi masalah, dan output konsol yang relevan.