این راهنما راهاندازی ادمین، دستورات کنسول، سیستم پکیج Lua، مدیریت بازیکنان و وسایل نقلیه و پیکربندی دیتابیس برای سرور اختصاصی Onset شما در Legion Hosting را پوشش میدهد. برای راهاندازی اولیه سرور، به راهنمای راهاندازی سرور Onset مراجعه کنید.
راهاندازی ادمین
Onset دسترسیهای ادمین را از طریق اسکریپتنویسی Lua در پکیجهای حالت بازی مدیریت میکند. برخلاف بسیاری از بازیها که سیستم ادمین داخلی دارند، Onset به پکیجهای شما متکی است تا مشخص کنند چه کسی دسترسیهای بالاتر دارد و آن دسترسیها چه امکاناتی را فراهم میکنند.
بیشتر پکیجهای حالت بازی ساخته شده توسط جامعه شامل یک سیستم ادمین هستند. معمولاً راهاندازی ادمین شامل مراحل زیر است:
- File Manager را در GPanel باز کنید
- به دایرکتوری پکیج خود بروید (مثلاً
packages/mygamemode/) - فایل پیکربندی ادمین را پیدا کنید (معمولاً
config.lua،admins.luaیا یک فایل پیکربندی JSON) - Steam64 ID یا شناسه بازیکن درون بازی خود را به لیست ادمین اضافه کنید
- فایل را ذخیره کنید و سرور را ریستارت کنید
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}دستورات کنسول سرور
Onset دستورات کنسول داخلی سرور ارائه میدهد که بدون توجه به پکیجهای نصبشده کار میکنند. این دستورات را میتوان مستقیماً در کنسول GPanel وارد کرد.
| دستور | توضیحات |
|---|---|
help |
لیست تمام دستورات کنسول موجود |
stop |
توقف سرور به صورت ملایم |
restart |
ریستارت سرور |
players |
لیست تمام بازیکنان متصل با شناسه آنها |
kick <playerid> [reason] |
اخراج یک بازیکن از سرور |
ban <playerid> [reason] |
بن کردن یک بازیکن از سرور |
unban <steamid> |
حذف بن برای Steam ID مشخصشده |
package reload <name> |
بارگذاری مجدد یک پکیج بدون ریستارت سرور |
package start <name> |
شروع یک پکیج که در حال حاضر اجرا نمیشود |
package stop <name> |
توقف یک پکیج در حال اجرا |
package list |
لیست تمام پکیجهای بارگذاریشده و وضعیت آنها |
سیستم پکیج (اسکریپتنویسی Lua)
گیمپلی Onset به طور کامل توسط پکیجهای نوشتهشده به زبان Lua تعریف میشود. هر پکیج یک پوشه در داخل دایرکتوری packages/ است که شامل اسکریپتهای Lua است که در سمت سرور و/یا سمت کلاینت اجرا میشوند.
ساختار پکیج
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 scriptsنصب پکیجها
- پکیج را از انجمنهای جامعه Onset یا مخازن GitHub دانلود کنید
- از طریق SFTP به سرور خود متصل شوید
- پوشه پکیج را در دایرکتوری
packages/آپلود کنید - فایل
server_config.jsonرا در File Manager باز کنید - نام پوشه پکیج را به آرایه
"packages"اضافه کنید - سرور را از طریق GPanel ریستارت کنید
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" به ترتیبی که لیست شدهاند بارگذاری میشوند. اگر یک پکیج به پکیج دیگری وابسته است، مطمئن شوید که وابستگی اول لیست شده باشد.
مدیریت بازیکنان
فراتر از دستورات داخلی kick و ban، بیشتر پکیجهای حالت بازی ویژگیهای مدیریت بازیکن اضافی ارائه میدهند. دستورات رایج ارائهشده توسط پکیجها شامل:
| دستور (وابسته به پکیج) | توضیحات |
|---|---|
/tp <player> |
تلپورت به بازیکن دیگر |
/bring <player> |
تلپورت بازیکن دیگر به موقعیت شما |
/goto <x> <y> <z> |
تلپورت به مختصات خاص جهان |
/setadmin <player> <level> |
تنظیم سطح ادمین بازیکن (اگر پکیج از سطوح پشتیبانی کند) |
/announce <message> |
ارسال اعلان سراسری سرور |
مدیریت وسایل نقلیه
Onset دارای یک سیستم وسایل نقلیه داخلی است که پکیجها میتوانند آن را گسترش دهند. ادمینها معمولاً باید وسایل نقلیه تولید شده را مدیریت کنند تا از شلوغی سرور جلوگیری شود.
- تولید وسایل نقلیه — بیشتر پکیجهای RP به ادمینها اجازه میدهند وسایل نقلیه را از طریق دستوراتی مانند
/car <model>تولید کنند - پاکسازی وسایل نقلیه — برخی پکیجها شامل حذف خودکار وسایل نقلیه رها شده یا دستورات ادمین مانند
/destroyvehiclesهستند - محدودیت وسایل نقلیه — حداکثر وسایل نقلیه به ازای هر بازیکن را پیکربندی کنید تا از لگ ناشی از تعداد زیاد موجودیتهای تولید شده جلوگیری شود
دیتابیس (MariaDB)
Onset از اتصالات دیتابیس MariaDB/MySQL برای ذخیرهسازی دادههای پایدار پشتیبانی میکند. این توسط پکیجهای roleplay و سایر حالتهای بازی برای ذخیره دادههای بازیکن، موجودیها، داراییها و موارد بیشتر استفاده میشود.
پیکربندی دیتابیس در فایلهای پیکربندی پکیج شما انجام میشود. یک راهاندازی معمولی:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}عیبیابی
| مشکل | راهحل |
|---|---|
| سرور شروع میشود اما گیمپلی در دسترس نیست | شما به حداقل یک پکیج حالت بازی نصبشده و لیستشده در server_config.json نیاز دارید. سرور Onset بدون پکیج، گیمپلی داخلی ندارد. |
| پکیج بارگذاری نمیشود | کنسول GPanel را برای پیامهای خطای Lua بررسی کنید. دلایل رایج: نبود package.json، خطاهای نحوی در فایلهای Lua، یا نبود وابستگیها. |
| خطاهای اتصال دیتابیس | اطلاعات دیتابیس خود را تأیید کنید، مطمئن شوید دیتابیس وجود دارد و بررسی کنید که سرویس MariaDB در حال اجراست. اتصال را از لاگهای کنسول بررسی کنید. |
| سرور در مرورگر قابل مشاهده نیست | اطمینان حاصل کنید که "visible": true در server_config.json تنظیم شده است. همچنین بررسی کنید که پورت 7776 (TCP) برای پورت کوئری قابل دسترسی باشد. |
| تأخیر بالا یا لگ | مقدار streamdistance را کاهش دهید، اگر استفاده CPU بالاست tickrate را کم کنید و اسکریپتهای Lua ناکارآمد در پکیجهای خود را بررسی کنید. |
مقالات مرتبط
- راهنمای راهاندازی سرور Onset
- نحوه یافتن IP و پورت سرور
- نحوه آپلود فایلها از طریق SFTP
- شروع کار با سرور جدید شما
نیاز به کمک دارید؟
اگر با مشکلاتی در سرور Onset خود مواجه هستید یا نیاز به کمک بیشتری دارید، تیم پشتیبانی ما اینجاست تا کمک کند. یک تیکت پشتیبانی ارسال کنید و ما در اسرع وقت به شما پاسخ خواهیم داد.
