Hướng dẫn này trình bày cách cài đặt framework mod Oxide/uMod hoặc Carbon trên máy chủ Rust của bạn, thêm các plugin do cộng đồng phát triển và quản lý chúng qua console. Để biết về cấu hình máy chủ chung và các biến khởi động, hãy xem Hướng dẫn Cấu hình Máy chủ Rust.

Cài đặt Oxide/uMod hoặc Carbon

Oxide (hiện được duy trì với tên uMod) và Carbon là các framework mod cho Rust cho phép bạn cài đặt các plugin do cộng đồng xây dựng. Các framework này bổ sung những tính năng như hệ thống kinh tế, bộ trang bị tùy chỉnh, phần thưởng bình chọn, vùng bảo vệ PvE và còn nhiều hơn nữa.

Bạn không cần tải lên bất kỳ tệp nào theo cách thủ công. Framework mod được cài đặt tự động bằng cách thiết lập một biến khởi động duy nhất:

1. Dừng máy chủ của bạn từ thẻ Console trong GPanel.
2. Đăng nhập vào GPanel và đi đến thẻ Startup.
3. Tìm biến FRAMEWORK và đặt nó thành:
   • oxide — cho Oxide/uMod (framework được sử dụng rộng rãi nhất, với thư viện plugin lớn nhất)
   • carbon — cho framework Carbon (một lựa chọn thay thế với hệ sinh thái plugin riêng)
   • vanilla — để chạy mà không có framework mod nào
4. Khởi động máy chủ. Các tệp framework được tải xuống và áp dụng tự động. Trong lần khởi động đầu tiên với Oxide, cấu trúc thư mục oxide/ sẽ được tạo ra.
5. Kiểm tra nhật ký console để tìm một dòng như Loaded plugin Oxide.Core nhằm xác nhận Oxide đang hoạt động.

Cài đặt Plugin

Các plugin được phân phối dưới dạng tệp .cs (mã nguồn C#). Oxide biên dịch chúng trên máy chủ trong thời gian chạy — không cần biên dịch trước.

1. Tải tệp .cs của plugin từ umod.org hoặc một nguồn đáng tin cậy khác.
2. Tải tệp .cs lên thư mục oxide/plugins/ trên máy chủ của bạn bằng SFTP hoặc trình quản lý tệp của GPanel. Để được trợ giúp về SFTP, hãy xem Cách Tải Tệp Lên qua SFTP.
3. Nếu máy chủ đang chạy, plugin sẽ được phát hiện và biên dịch tự động trong vòng vài giây. Bạn sẽ thấy kết quả đầu ra trong console xác nhận rằng nó đã được nạp, ví dụ Loaded plugin MyPlugin v1.2.3 by Author.
4. Nếu máy chủ không chạy, plugin sẽ được nạp trong lần khởi động tiếp theo.

Cấu trúc Thư mục 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

Cấu hình Plugin

Hầu hết các plugin tạo ra một tệp cấu hình JSON trong oxide/config/ vào lần đầu tiên chúng được nạp. Để tùy chỉnh một plugin:

1. Hãy để plugin được nạp ít nhất một lần để nó tạo ra tệp cấu hình mặc định.
2. Dừng máy chủ của bạn (hoặc lưu ý rằng một số plugin hỗ trợ tải lại cấu hình trực tiếp).
3. Mở tệp cấu hình của plugin tại oxide/config/PluginName.json bằng trình quản lý tệp của GPanel hoặc SFTP.
4. Chỉnh sửa các thiết lập và lưu tệp.
5. Tải lại plugin bằng oxide.reload PluginName hoặc khởi động lại máy chủ.

Quản lý Plugin qua Console

Các lệnh này có thể được chạy từ console của GPanel hoặc thông qua một ứng dụng khách RCON. Để thiết lập RCON, hãy xem Truy cập RCON và Các lệnh Quản trị cho Rust.

Cập nhật Plugin

Để cập nhật một plugin lên phiên bản mới hơn:

1. Tải tệp .cs đã cập nhật từ trang của plugin trên umod.org.
2. Tải tệp mới lên oxide/plugins/, ghi đè lên tệp hiện có.
3. Nếu máy chủ đang chạy, Oxide phát hiện sự thay đổi của tệp và tự động biên dịch lại cũng như tải lại plugin. Ngoài ra, bạn có thể chạy oxide.reload PluginName.
4. Kiểm tra console để tìm bất kỳ lỗi nào. Một số bản cập nhật plugin có thể yêu cầu thay đổi tệp cấu hình trong oxide/config/.

Gỡ bỏ Plugin

Để gỡ bỏ hoàn toàn một plugin:

1. Chạy oxide.unload PluginName để gỡ nạp plugin trong khi máy chủ đang chạy.
2. Xóa tệp .cs khỏi oxide/plugins/.
3. Tùy chọn, xóa tệp cấu hình của plugin khỏi oxide/config/ và các tệp dữ liệu khỏi oxide/data/ nếu bạn không cần chúng nữa.

Các Plugin Phổ biến

Khắc phục Sự cố Plugin

Nếu các plugin của bạn không nạp, hãy kiểm tra những điều sau:

• Xác nhận Oxide đã được cài đặt và đang hoạt động. Trong thẻ Startup của GPanel, biến FRAMEWORK phải được đặt thành oxide. Nhật ký console sẽ hiển thị Loaded plugin Oxide.Core trong quá trình khởi động.
• Các tệp plugin phải được đặt trực tiếp trong oxide/plugins/ với phần mở rộng .cs chính xác. Các tệp trong thư mục con hoặc có phần mở rộng sai sẽ bị bỏ qua.
• Kiểm tra console và oxide/logs/ để tìm lỗi biên dịch. Một plugin có lỗi cú pháp sẽ không nạp được và thông báo lỗi sẽ mô tả vấn đề.
• Một số plugin có phụ thuộc vào các plugin khác (ví dụ, nhiều plugin cửa hàng yêu cầu Economics). Hãy cài đặt tất cả các phụ thuộc cần thiết trước.

Để biết các sự cố máy chủ phổ biến khác, hãy xem Khắc phục Sự cố Máy chủ Rust.

Cần Trợ giúp?

Nếu bạn gặp phải một vấn đề không được đề cập trong hướng dẫn này, đội ngũ hỗ trợ của chúng tôi luôn sẵn sàng trợ giúp. Gửi một ticket hỗ trợ và kèm theo ID máy chủ của bạn, mô tả về vấn đề và bất kỳ kết quả đầu ra console liên quan nào.