Hướng dẫn này trình bày các lệnh console headless, quản lý phiên, cài đặt mod loader, và khắc phục sự cố cho máy chủ Resonite của bạn. Để biết về cài đặt ban đầu, xem Hướng Dẫn Cài Đặt Máy Chủ Headless Resonite.
1. Các Lệnh Console Headless
Máy chủ headless Resonite chấp nhận các lệnh thông qua console GPanel. Máy chủ phản hồi lệnh shutdown để tắt một cách nhẹ nhàng.
| Lệnh | Mô Tả |
|---|---|
worlds |
Liệt kê tất cả các phiên thế giới đang hoạt động. |
focus <world_index> |
Tập trung vào một thế giới cụ thể để ra lệnh. |
status |
Hiển thị trạng thái của thế giới đang được tập trung. |
users |
Liệt kê người dùng trong thế giới đang được tập trung. |
kick <username> |
Đá một người dùng khỏi thế giới đang được tập trung. |
ban <username> |
Cấm một người dùng khỏi thế giới đang được tập trung. |
silence <username> |
Tắt tiếng một người dùng trong thế giới đang được tập trung. |
unsilence <username> |
Bật tiếng lại một người dùng. |
respawn <username> |
Hồi sinh một người dùng về điểm gốc của thế giới. |
role <username> <role> |
Đặt vai trò của một người dùng (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Đổi tên phiên đang được tập trung. |
accessLevel <level> |
Thay đổi ai có thể tham gia (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Thay đổi số người dùng tối đa cho thế giới đang được tập trung. |
save |
Lưu thế giới đang được tập trung. |
close |
Đóng thế giới đang được tập trung. |
restart |
Khởi động lại thế giới đang được tập trung. |
invite <username> |
Mời một người dùng vào thế giới đang được tập trung. |
message <text> |
Gửi một tin nhắn đến thế giới đang được tập trung. |
shutdown |
Tắt toàn bộ máy chủ headless một cách nhẹ nhàng. |
2. Cấp Độ Truy Cập
Kiểm soát ai có thể tham gia các phiên thế giới của bạn bằng thiết lập accessLevel:
| Cấp Độ | Mô Tả |
|---|---|
| Anyone | Mở cho tất cả người dùng Resonite. |
| RegisteredUsers | Chỉ các tài khoản Resonite đã đăng ký. |
| Contacts | Chỉ những người dùng trong danh sách liên hệ của tài khoản headless. |
| ContactsPlus | Các liên hệ và liên hệ của các liên hệ. |
| Private | Chỉ theo lời mời. |
3. Vai Trò Người Dùng
Gán vai trò để kiểm soát những gì người dùng có thể làm trong thế giới của bạn:
| Vai Trò | Mô Tả |
|---|---|
| Admin | Toàn quyền kiểm soát thế giới. |
| Builder | Có thể xây dựng và chỉnh sửa đối tượng. |
| Moderator | Có thể đá/cấm người dùng và kiểm duyệt chat. |
| Guest | Quyền truy cập người dùng tiêu chuẩn. |
| Spectator | Có thể quan sát nhưng không tương tác. |
Đặt vai trò mặc định trong Config.json bằng cách dùng defaultUserRoles hoặc gán cho từng người dùng bằng lệnh console role.
4. Nhiều Thế Giới
Máy chủ headless có thể lưu trữ nhiều thế giới đồng thời. Thêm các mục bổ sung vào mảng startWorlds trong Headless/Config/Config.json:
"startWorlds": [
{
"isEnabled": true,
"sessionName": "World 1",
"maxUsers": 16,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld"
},
{
"isEnabled": true,
"sessionName": "World 2",
"maxUsers": 8,
"accessLevel": "Contacts",
"loadWorldPresetName": "Grid"
}
]
Dùng focus 0 và focus 1 trong console để chuyển đổi giữa các thế giới.
5. Mod Loader
Resonite hỗ trợ các mod thông qua ResoniteModLoader. Để bật:
- Đặt
ENABLE_MODLOADERthànhtruetrong tab Startup. - Cài đặt lại hoặc khởi động lại máy chủ -- các file DLL của mod loader sẽ được tải xuống tự động.
- Đặt các file DLL của mod vào thư mục
rml_mods/qua SFTP. - Khởi động lại máy chủ để tải các mod.
Các file của mod loader:
Libraries/ResoniteModLoader.dll-- Mod loader chính.rml_libs/0Harmony.dll-- Phụ thuộc bắt buộc.rml_mods/-- Đặt các file DLL mod của bạn tại đây.
6. Khắc Phục Sự Cố
- Máy chủ không khởi động: Xác minh thông tin đăng nhập trong
Config.jsonlà chính xác. Máy chủ headless phải xác thực bằng một tài khoản Resonite hợp lệ. - Thế giới không xuất hiện trong trình duyệt: Kiểm tra
hideFromPublicListingkhông được đặt thànhtrue. Đảm bảoaccessLevelcho phép những người dùng đang tìm kiếm. - "World running..." không xuất hiện: Kiểm tra lỗi trong console. Tên thế giới preset có thể không chính xác.
- Mod không tải: Xác minh
ENABLE_MODLOADERlàtruevà các file DLL mod nằm trongrml_mods/. Kiểm tra console để xem lỗi của mod loader. - Sử dụng tài nguyên cao: Giảm
tickRatetrongConfig.jsonhoặc giảmmaxConcurrentAssetTransfers. Nội dung phức tạp do người dùng tạo có thể tiêu tốn nhiều tài nguyên.
Bài Viết Liên Quan
- Hướng Dẫn Cài Đặt Máy Chủ Headless Resonite
- Cách Tìm IP và Port Máy Chủ Của Bạn
- Cách Tải File Lên Qua SFTP
Cần Trợ Giúp?
Nếu bạn cần thêm hỗ trợ, hãy mở một ticket hỗ trợ kèm theo thông tin máy chủ và bất kỳ thông báo lỗi nào từ console GPanel.