Hướng dẫn này bao gồm thiết lập admin, tài nguyên phía máy chủ, bản đồ tùy chỉnh, quản lý phương tiện và khắc phục sự cố cho máy chủ BeamMP của bạn trên Legion Hosting. Để thiết lập máy chủ ban đầu, khóa xác thực và cấu hình cơ bản, xem Hướng Dẫn Thiết Lập Máy Chủ BeamMP.
Thiết Lập Admin
BeamMP không có hệ thống đăng nhập admin hay mật khẩu truyền thống. Thay vào đó, các lệnh admin được thực thi thông qua bảng điều khiển (console) máy chủ hoặc qua các plugin Lua phía máy chủ kiểm tra định danh người chơi.
Lệnh Console
Console máy chủ trong GPanel cung cấp quyền truy cập trực tiếp tới các lệnh máy chủ tích hợp sẵn. Nhập các lệnh trực tiếp vào ô nhập liệu của console:
| Lệnh | Mô tả |
|---|---|
kick <player_id> <reason> |
Đá một người chơi khỏi máy chủ kèm theo thông báo lý do tùy chọn. |
ban <player_name> |
Cấm một người chơi khỏi máy chủ. Người chơi bị cấm không thể kết nối lại. |
unban <player_name> |
Gỡ bỏ lệnh cấm của một người chơi, cho phép họ kết nối lại. |
list |
Liệt kê tất cả người chơi đang kết nối kèm theo ID của họ. |
say <message> |
Gửi một tin nhắn trò chuyện đến toàn bộ máy chủ từ console. |
status |
Hiển thị thông tin trạng thái máy chủ bao gồm số lượng người chơi và thời gian hoạt động. |
help |
Liệt kê tất cả các lệnh console khả dụng. |
list để xem những người chơi đang kết nối và ID của họ. Những ID này cần thiết cho các lệnh như kick.
Cấu Trúc Thư Mục Resources
BeamMP sử dụng thư mục Resources để tổ chức nội dung phía máy chủ. Thư mục này chứa hai thư mục con với các mục đích riêng biệt:
Resources/
Client/ <-- Client-side mods (maps, vehicles) synced to players
Server/ <-- Server-side Lua plugins (not sent to players)Tài Nguyên Client
Các tệp được đặt trong Resources/Client/ sẽ được người chơi tự động tải xuống khi họ kết nối. Điều này được dùng cho:
- Bản đồ tùy chỉnh — Các tệp .zip mod bản đồ mà người chơi cần để tải bản đồ của máy chủ.
- Phương tiện tùy chỉnh — Các tệp .zip mod phương tiện thêm xe mới hoặc chỉnh sửa xe hiện có.
- Các mod client khác — Bất kỳ mod BeamNG.drive nào cần hiện diện trên client.
Resources/Client/ đều được tải xuống bởi mọi người chơi tham gia. Các tệp lớn hoặc nhiều mod sẽ làm tăng đáng kể thời gian kết nối. Hãy giữ tài nguyên client gọn nhẹ để có trải nghiệm tốt nhất cho người chơi.
Tài Nguyên Server (Plugin Lua)
Thư mục Resources/Server/ chứa các plugin Lua phía máy chủ. Chúng chỉ chạy trên máy chủ và không được gửi tới người chơi. Mỗi plugin nằm trong thư mục con riêng của nó với một tệp main.lua:
Resources/
Server/
MyPlugin/
main.lua <-- Plugin entry point
AnotherPlugin/
main.luaCác plugin phía máy chủ có thể:
- Phản hồi các sự kiện của người chơi (tham gia, rời đi, tin nhắn trò chuyện, sinh ra phương tiện).
- Triển khai các lệnh tùy chỉnh được kích hoạt qua trò chuyện (ví dụ:
/tp,/give). - Quản lý quyền và giới hạn phương tiện.
- Thêm hệ thống kinh tế, dịch chuyển tức thời, hoặc các tính năng lối chơi tùy chỉnh khác.
- Ghi nhật ký hoạt động của người chơi và thực thi các quy tắc.
Thêm Bản Đồ Tùy Chỉnh
Để chạy một bản đồ tùy chỉnh (không phải mặc định) trên máy chủ BeamMP của bạn:
- Tải mod bản đồ dưới dạng tệp
.ziptừ một nguồn mod BeamNG.drive (ví dụ: kho mod BeamNG.drive). - Dừng máy chủ của bạn trong GPanel.
- Tải tệp
.ziplênResources/Client/thông qua tab Files hoặc SFTP. Không giải nén tệp zip. - Cập nhật biến khởi động
MAP(hoặcMaptrongServerConfig.toml) thành đường dẫn bản đồ chính xác cho bản đồ tùy chỉnh. Đường dẫn này thường có định dạng/levels/map_name/info.json— hãy kiểm tra tài liệu của mod để biết đường dẫn chính xác. - Khởi động máy chủ.
Map không khớp với đường dẫn thực tế bên trong tệp .zip của mod, máy chủ sẽ không tải được bản đồ. Hãy kiểm tra tài liệu của mod hoặc xem xét cấu trúc của tệp .zip để tìm đường dẫn /levels/ chính xác.
Resources/Client/ mà người chơi chưa có. Người chơi không cần cài đặt mod bản đồ thủ công.
Quản Lý Phương Tiện
Việc quản lý phương tiện trên các máy chủ BeamMP được kiểm soát thông qua thiết lập MaxCars và tùy chọn thông qua các plugin Lua phía máy chủ.
Thiết Lập MaxCars
Thiết lập MaxCars trong ServerConfig.toml (hoặc biến khởi động MAX_CARS) kiểm soát số lượng phương tiện mà mỗi người chơi có thể sinh ra đồng thời:
1— Mỗi người chơi có thể có một phương tiện tại một thời điểm (được khuyến nghị cho các máy chủ lớn hơn).2–3— Cho phép người chơi có một vài phương tiện, hữu ích cho các máy chủ nhỏ hơn hoặc các buổi gặp gỡ xe.- Các giá trị cao hơn làm tăng tải máy chủ theo tỷ lệ.
Mod Phương Tiện Tùy Chỉnh
Để thêm phương tiện tùy chỉnh vào máy chủ của bạn:
- Tải mod phương tiện dưới dạng tệp
.zip. - Đặt nó vào
Resources/Client/. - Khởi động lại máy chủ. Người chơi sẽ tự động tải xuống mod phương tiện khi kết nối.
Hạn Chế Phương Tiện Qua Plugin
Để kiểm soát chi tiết hơn (ví dụ: cấm phương tiện cụ thể, giới hạn loại phương tiện), bạn sẽ cần một plugin Lua phía máy chủ. Những plugin này có thể chặn các sự kiện sinh ra phương tiện và cho phép hoặc từ chối chúng dựa trên các quy tắc tùy chỉnh. Hãy kiểm tra diễn đàn BeamMP để tìm các plugin quản lý phương tiện.
Cài Đặt và Quản Lý Plugin
Các plugin Lua phía máy chủ mở rộng chức năng của máy chủ. Dưới đây là cách cài đặt và quản lý chúng:
Cài Đặt Plugin
- Tải các tệp plugin (thường là một thư mục chứa
main.luavà có thể có các tệp khác). - Dừng máy chủ của bạn.
- Tải thư mục plugin lên
Resources/Server/thông qua tab Files hoặc SFTP. - Đảm bảo cấu trúc thư mục chính xác:
Resources/Server/PluginName/main.lua. - Khởi động máy chủ. Console sẽ hiển thị các thông báo khi plugin được tải.
Gỡ Bỏ Plugin
- Dừng máy chủ của bạn.
- Xóa thư mục plugin khỏi
Resources/Server/. - Khởi động máy chủ.
Khắc Phục Sự Cố
Lỗi Khóa Xác Thực
- Xác minh khóa được dán chính xác trong biến khởi động
AUTH_KEY— không có khoảng trắng thừa hoặc ngắt dòng. - Đảm bảo khóa chưa bị thu hồi hoặc hết hạn trên BeamMP Keymaster.
- Mỗi khóa chỉ có thể được sử dụng trên một máy chủ tại một thời điểm. Nếu bạn đang sử dụng cùng một khóa ở nơi khác, nó sẽ bị lỗi.
- Console sẽ hiển thị các lỗi xác thực khi khởi động nếu khóa không hợp lệ.
Người Chơi Không Thể Kết Nối
- Xác nhận máy chủ đã khởi động hoàn toàn và hiển thị trực tuyến trong GPanel.
- Kiểm tra xem người chơi có đang sử dụng trình khởi chạy BeamMP, chứ không phải trình khởi chạy BeamNG.drive tiêu chuẩn.
- Nếu máy chủ được đặt thành
Private = true, người chơi phải sử dụng kết nối trực tiếp với IP và port chính xác. Xem Cách Tìm IP và Port Máy Chủ Của Bạn. - Đảm bảo phiên bản trình khởi chạy BeamMP của người chơi tương thích với phiên bản máy chủ. Trình khởi chạy lỗi thời có thể không kết nối được.
- Nếu máy chủ đầy (đã đạt
MaxPlayers), người chơi bổ sung không thể tham gia cho đến khi có người rời đi.
Sự Cố Đồng Bộ Mod
- Nếu người chơi bị kẹt khi tải xuống hoặc nhận được lỗi về việc thiếu mod, hãy xác minh rằng các tệp .zip mod trong
Resources/Client/không bị hỏng. - Tải lại và tải lên lại tệp mod nếu tệp .zip bị hỏng.
- Các tệp mod rất lớn có thể gây hết thời gian chờ (timeout) cho người chơi có kết nối chậm. Hãy cân nhắc gỡ bỏ các mod lớn không cần thiết.
- Đảm bảo các tệp .zip mod không bị lồng nhau (tức là một tệp .zip nằm trong một thư mục bên trong một tệp .zip khác).
Vấn Đề Hiệu Năng Với Nhiều Người Chơi/Phương Tiện
- Giảm
MaxCarsxuống1cho mỗi người chơi. - Giảm
MaxPlayersnếu máy chủ liên tục bị giật lag. - Chuyển sang bản đồ đơn giản hơn (Grid Map hoặc Industrial) để có hiệu năng tốt hơn với số lượng người chơi cao.
- Gỡ bỏ các mod client không cần thiết khỏi
Resources/Client/để giảm thời gian tải xuống và mức sử dụng bộ nhớ. - Kiểm tra biểu đồ sử dụng tài nguyên của GPanel — nếu CPU hoặc RAM liên tục ở mức giới hạn, hãy cân nhắc nâng cấp gói máy chủ của bạn. Mở một ticket hỗ trợ để thảo luận các tùy chọn.
Máy Chủ Không Xuất Hiện Trong Trình Duyệt
- Đảm bảo
Privateđược đặt thànhfalsetrong cấu hình của bạn. - Xác minh khóa xác thực hợp lệ và không được sử dụng bởi máy chủ khác.
- Đợi 1–2 phút sau khi khởi động để máy chủ đăng ký với backend của BeamMP.
- Kiểm tra console để tìm bất kỳ lỗi nào liên quan đến kết nối máy chủ chính (master server).
Bài Viết Liên Quan
- Hướng Dẫn Thiết Lập Máy Chủ BeamMP — Thiết lập ban đầu, khóa xác thực, cấu hình và hướng dẫn kết nối
- Cách Tìm IP và Port Máy Chủ Của Bạn
- Cách Tải Tệp Lên Qua SFTP
- Hướng Dẫn Khởi Động Máy Chủ — Hướng dẫn chung để khởi động bất kỳ máy chủ game nào trên Legion Hosting
Cần Thêm Trợ Giúp?
Nếu bạn gặp phải các 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. Mở một ticket tại legionhosting.net/submitticket.php kèm theo thông tin chi tiết về máy chủ của bạn, mô tả vấn đề và bất kỳ thông báo lỗi liên quan nào từ console GPanel.
