Hướng dẫn này bao gồm các lệnh console headless, quản lý thế giới, vai trò người dùng, NeosModLoader và khắc phục sự cố cho máy chủ chuyên dụng NeosVR của bạn. NeosVR là một metaverse VR mạng xã hội với các công cụ sáng tạo mạnh mẽ. Để thiết lập ban đầu, cấu hình Config.json và hướng dẫn kết nối, xem Hướng Dẫn Thiết Lập Máy Chủ NeosVR.
1. Truy Cập Console
Quản lý máy chủ headless NeosVR của bạn thông qua tab Console trong GPanel. Tất cả các lệnh được nhập trực tiếp vào console.
2. Các Lệnh Console Headless
Quản Lý Thế Giới
| Lệnh | Mô tả |
|---|---|
worlds | Liệt kê tất cả các thế giới đang chạy với chỉ số của chúng. |
focus <world_index> | Chuyển tiêu điểm sang một thế giới cụ thể theo chỉ số. |
startWorldURL <record_url> | Bắt đầu một thế giới mới từ một URL record của Neos. |
startWorldTemplate <template> | Bắt đầu một thế giới từ một mẫu tích hợp sẵn (ví dụ SpaceWorld). |
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. |
Quản Lý Phiên
| Lệnh | Mô tả |
|---|---|
sessionURL | Hiển thị URL phiên cho thế giới đang được tập trung. |
sessionID | Hiển thị ID phiên cho thế giới đang được tập trung. |
name <new_name> | Đổi tên phiên của thế giới đang được tập trung. |
accessLevel <level> | Đổi cấp độ truy cập: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Đặt số lượng người dùng tối đa cho phiên. |
hideFromListing <true/false> | Bật/tắt khả năng hiển thị trong trình duyệt phiên công khai. |
description <text> | Đặt mô tả phiên. |
Quản Lý Người Dùng
| Lệnh | Mô tả |
|---|---|
users | Liệt kê tất cả 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. |
ban <username> | Cấm một người dùng khỏi thế giới. |
silence <username> | Làm im lặng một người dùng (tắt tiếng giọng nói của họ). |
unsilence <username> | Bỏ im lặng một người dùng đã bị tắt tiếng trước đó. |
respawn <username> | Hồi sinh một người dùng tại điểm hồi sinh của thế giới. |
role <username> <role> | Gán một vai trò cho người dùng (xem Phần 3). |
Điều Khiển Máy Chủ
| Lệnh | Mô tả |
|---|---|
status | Hiển thị trạng thái máy chủ và mức sử dụng tài nguyên. |
shutdown | Tắt máy chủ headless một cách an toàn. |
gc | Buộc thu gom rác để giải phóng bộ nhớ. |
tickRate <rate> | Đổi tick rate của máy chủ trong khi đang chạy. |
3. Vai Trò Người Dùng
NeosVR sử dụng một hệ thống phân cấp vai trò cho các quyền hạn trong thế giới:
| Vai trò | Mô tả |
|---|---|
Admin | Toàn quyền kiểm soát thế giới. Có thể sửa đổi bất cứ điều gì, quản lý người dùng và thay đổi các cài đặt thế giới. |
Builder | Có thể tạo và chỉnh sửa các đối tượng trong thế giới. |
Moderator | Có thể đá/cấm người dùng và quản lý các cài đặt phiên. |
Guest | Quyền truy cập cơ bản. Có thể tương tác với các đối tượng hiện có nhưng không thể xây dựng. |
Spectator | Quyền chỉ xem. Không thể tương tác với thế giới. |
Gán vai trò qua console: role <username> Admin
Bạn cũng có thể đặt các vai trò mặc định trong Config.json bằng cài đặt defaultUserRoles.
4. NeosModLoader
NeosModLoader cho phép tải các mod do cộng đồng tạo vào máy chủ headless.
- Đặt ENABLE_MODLOADER thành
truetrong các biến Startup của GPanel. - Tải mod từ NeosModLoader GitHub.
- Tải lên các tệp mod
.dllvào thư mụcnml_mods/qua SFTP. - Khởi động lại máy chủ để tải các mod.
5. Khắc Phục Sự Cố
Máy Chủ Không Khởi Động
- Xác minh STEAM_USER và STEAM_PASS của bạn là chính xác.
- Đảm bảo SRCDS_BETAPASS (mật khẩu beta headless) được cập nhật từ Neos Patreon Discord.
- Nếu sử dụng Steam Guard 2FA, hãy cung cấp mã trong STEAM_AUTH và khởi động lại ngay lập tức.
Thế Giới Không Tải Được
- Kiểm tra rằng
Config.jsonlà JSON hợp lệ (không có dấu phẩy thừa, dấu ngoặc đúng). - Xác minh
loginCredentialvàloginPasswordđược đặt chính xác trongConfig/Config.json. - Đảm bảo URL thế giới hoặc tên preset là hợp lệ.
Người Dùng Không Thể Tham Gia
- Kiểm tra rằng
accessLevelkhông được đặt thànhPrivatetrừ khi có chủ ý. - Xác minh
maxUserschưa đạt đến giới hạn. - Đảm bảo headless đã đăng nhập (kiểm tra đầu ra console để xác nhận đăng nhập).
Bài Viết Liên Quan
Cần Trợ Giúp?
Nếu bạn gặp sự cố với máy chủ NeosVR không được đề cập ở đây, hãy mở một ticket hỗ trợ và bao gồm IP máy chủ, mô tả vấn đề, và bất kỳ thông báo lỗi liên quan nào từ GPanel console.
