Hướng dẫn này bao gồm thiết lập quản trị, các lệnh console, hệ thống gói Lua, quản lý người chơi và phương tiện, và cấu hình cơ sở dữ liệu cho máy chủ Onset dedicated của bạn trên Legion Hosting. Để biết cách thiết lập máy chủ ban đầu, hãy xem Hướng Dẫn Thiết Lập Máy Chủ Onset của chúng tôi.
Thiết Lập Quản Trị
Onset xử lý quyền quản trị thông qua kịch bản Lua bên trong các gói chế độ chơi của bạn. Không giống nhiều trò chơi có hệ thống quản trị tích hợp sẵn, Onset dựa vào các gói của bạn để xác định ai có quyền nâng cao và những quyền đó cho phép làm gì.
Hầu hết các gói chế độ chơi của cộng đồng đều bao gồm một hệ thống quản trị. Thông thường, việc thiết lập quản trị bao gồm:
- Mở File Manager trong GPanel
- Điều hướng đến thư mục gói của bạn (ví dụ:
packages/mygamemode/) - Tìm tệp cấu hình quản trị (thường là
config.lua,admins.lua, hoặc một tệp cấu hình JSON) - Thêm Steam64 ID hoặc ID người chơi trong trò chơi của bạn vào danh sách quản trị
- Lưu tệp và khởi động lại máy chủ
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}Lệnh Console Máy Chủ
Onset cung cấp các lệnh console máy chủ tích hợp sẵn hoạt động bất kể các gói đã cài đặt. Các lệnh này có thể được nhập trực tiếp trong console GPanel.
| Lệnh | Mô Tả |
|---|---|
help |
Liệt kê tất cả các lệnh console có sẵn |
stop |
Dừng máy chủ một cách an toàn |
restart |
Khởi động lại máy chủ |
players |
Liệt kê tất cả người chơi đang kết nối cùng với ID của họ |
kick <playerid> [reason] |
Đá một người chơi khỏi máy chủ |
ban <playerid> [reason] |
Cấm một người chơi khỏi máy chủ |
unban <steamid> |
Gỡ bỏ lệnh cấm cho Steam ID được chỉ định |
package reload <name> |
Tải lại một gói mà không cần khởi động lại máy chủ |
package start <name> |
Khởi động một gói hiện không đang chạy |
package stop <name> |
Dừng một gói đang chạy |
package list |
Liệt kê tất cả các gói đã tải và trạng thái của chúng |
Hệ Thống Gói (Kịch Bản Lua)
Lối chơi của Onset được xác định hoàn toàn bởi các gói được viết bằng Lua. Mỗi gói là một thư mục bên trong thư mục packages/ chứa các kịch bản Lua chạy ở phía máy chủ và/hoặc phía máy khách.
Cấu Trúc Gói
packages/
mygamemode/
package.json <-- Package metadata and file declarations
server/
main.lua <-- Server-side entry point
commands.lua <-- Custom command handlers
client/
main.lua <-- Client-side entry point
ui.lua <-- User interface scriptsCài Đặt Gói
- Tải gói từ các diễn đàn cộng đồng Onset hoặc các kho lưu trữ GitHub
- Kết nối tới máy chủ của bạn qua SFTP
- Tải thư mục gói lên thư mục
packages/ - Mở
server_config.jsontrong File Manager - Thêm tên thư mục gói vào mảng
"packages" - Khởi động lại máy chủ thông qua GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" được tải theo thứ tự chúng được liệt kê. Nếu một gói phụ thuộc vào một gói khác, hãy đảm bảo gói phụ thuộc được liệt kê trước.
Quản Lý Người Chơi
Ngoài các lệnh kick và ban tích hợp sẵn, hầu hết các gói chế độ chơi đều cung cấp các tính năng quản lý người chơi bổ sung. Các lệnh do gói cung cấp phổ biến bao gồm:
| Lệnh (Phụ Thuộc Vào Gói) | Mô Tả |
|---|---|
/tp <player> |
Dịch chuyển tới một người chơi khác |
/bring <player> |
Dịch chuyển một người chơi khác đến vị trí của bạn |
/goto <x> <y> <z> |
Dịch chuyển tới các tọa độ thế giới cụ thể |
/setadmin <player> <level> |
Đặt cấp độ quản trị của người chơi (nếu gói hỗ trợ phân cấp) |
/announce <message> |
Gửi thông báo trên toàn máy chủ |
Quản Lý Phương Tiện
Onset có một hệ thống phương tiện tích hợp sẵn mà các gói có thể mở rộng. Quản trị viên thường cần quản lý các phương tiện đã được sinh ra để ngăn tình trạng máy chủ bị lộn xộn.
- Sinh phương tiện — Hầu hết các gói RP cho phép quản trị viên sinh phương tiện qua các lệnh như
/car <model> - Dọn dẹp phương tiện — Một số gói bao gồm tính năng tự động xóa các phương tiện bị bỏ rơi hoặc các lệnh quản trị như
/destroyvehicles - Giới hạn phương tiện — Cấu hình số phương tiện tối đa cho mỗi người chơi để ngăn lag do quá nhiều thực thể được sinh ra
Cơ Sở Dữ Liệu (MariaDB)
Onset hỗ trợ các kết nối cơ sở dữ liệu MariaDB/MySQL để lưu trữ dữ liệu bền vững. Tính năng này được sử dụng bởi các gói roleplay và các gói chế độ chơi khác để lưu trữ dữ liệu người chơi, kho đồ, tài sản và nhiều thứ khác.
Cấu hình cơ sở dữ liệu được xử lý bên trong các tệp cấu hình của gói. Một thiết lập điển hình:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}Khắc Phục Sự Cố
| Vấn Đề | Giải Pháp |
|---|---|
| Máy chủ khởi động nhưng không có lối chơi nào | Bạn cần ít nhất một gói chế độ chơi được cài đặt và liệt kê trong server_config.json. Một máy chủ Onset trống không có lối chơi tích hợp sẵn. |
| Gói không tải được | Kiểm tra console GPanel để tìm các thông báo lỗi Lua. Nguyên nhân phổ biến: thiếu package.json, lỗi cú pháp trong các tệp Lua, hoặc thiếu các thành phần phụ thuộc. |
| Lỗi kết nối cơ sở dữ liệu | Xác minh thông tin đăng nhập cơ sở dữ liệu của bạn, đảm bảo cơ sở dữ liệu tồn tại và kiểm tra rằng dịch vụ MariaDB đang chạy. Kiểm tra khả năng kết nối từ nhật ký console. |
| Máy chủ không hiển thị trong trình duyệt | Đảm bảo "visible": true được đặt trong server_config.json. Đồng thời xác minh rằng port 7776 (TCP) có thể truy cập được cho query port. |
| Độ trễ cao hoặc lag | Giảm giá trị streamdistance, giảm tickrate nếu mức sử dụng CPU cao, và kiểm tra các kịch bản Lua không hiệu quả trong các gói của bạn. |
Bài Viết Liên Quan
- Hướng Dẫn Thiết Lập Máy Chủ Onset
- Cách Tìm IP và Port Máy Chủ Của Bạn
- Cách Tải Tệp Lên Qua SFTP
- Bắt Đầu Với Máy Chủ Mới Của Bạn
Cần Trợ Giúp?
Nếu bạn đang gặp sự cố với máy chủ Onset của mình hoặc cần thêm trợ giúp, đội ngũ hỗ trợ của chúng tôi luôn sẵn sàng giúp đỡ. Gửi một yêu cầu hỗ trợ và chúng tôi sẽ phản hồi bạn sớm nhất có thể.
