このガイドでは、Legion Hosting 上の Onset 専用サーバーの管理者セットアップ、コンソールコマンド、Lua パッケージシステム、プレイヤーおよび車両の管理、データベース設定について説明します。サーバーの初期セットアップについては、Onset サーバーセットアップガイドを参照してください。
管理者のセットアップ
Onset は、ゲームモードパッケージ内の Lua スクリプトを通じて管理者権限を処理します。組み込みの管理者システムを持つ多くのゲームとは異なり、Onset では、誰が昇格された権限を持ち、それらの権限が何を許可するかを定義するためにパッケージに依存しています。
ほとんどのコミュニティ製ゲームモードパッケージには管理者システムが含まれています。通常、管理者のセットアップには以下が含まれます。
- GPanel で File Manager を開きます
- パッケージディレクトリ（例:
packages/mygamemode/）に移動します - 管理者設定ファイルを探します（多くの場合
config.lua、admins.lua、または JSON 設定ファイル） - 管理者リストに自分の Steam64 ID またはゲーム内プレイヤー ID を追加します
- ファイルを保存し、サーバーを再起動します
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}サーバーコンソールコマンド
Onset は、インストールされているパッケージに関係なく機能する組み込みのサーバーコンソールコマンドを提供します。これらは GPanel コンソールで直接入力できます。
| コマンド | 説明 |
|---|---|
help |
利用可能なすべてのコンソールコマンドを一覧表示します |
stop |
サーバーを正常に停止します |
restart |
サーバーを再起動します |
players |
接続中のすべてのプレイヤーをその ID とともに一覧表示します |
kick <playerid> [reason] |
プレイヤーをサーバーからキックします |
ban <playerid> [reason] |
プレイヤーをサーバーから BAN します |
unban <steamid> |
指定された Steam ID の BAN を解除します |
package reload <name> |
サーバーを再起動せずにパッケージを再読み込みします |
package start <name> |
現在実行されていないパッケージを開始します |
package stop <name> |
実行中のパッケージを停止します |
package list |
読み込まれているすべてのパッケージとそのステータスを一覧表示します |
パッケージシステム（Lua スクリプティング）
Onset のゲームプレイは、Lua で書かれたパッケージによって完全に定義されます。各パッケージは、サーバー側および/またはクライアント側で実行される Lua スクリプトを含む packages/ ディレクトリ内のフォルダです。
パッケージの構造
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/ディレクトリにアップロードします - File Manager で
server_config.jsonを開きます - パッケージフォルダ名を
"packages"配列に追加します - GPanel を通じてサーバーを再起動します
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}"packages" 配列内のパッケージは、リストされた順序で読み込まれます。あるパッケージが別のパッケージに依存している場合は、依存先が先にリストされていることを確認してください。
プレイヤー管理
組み込みのキックおよび BAN コマンドに加えて、ほとんどのゲームモードパッケージは追加のプレイヤー管理機能を提供します。パッケージが提供する一般的なコマンドには以下が含まれます。
| コマンド（パッケージ依存） | 説明 |
|---|---|
/tp <player> |
別のプレイヤーのところへテレポートします |
/bring <player> |
別のプレイヤーを自分の場所にテレポートさせます |
/goto <x> <y> <z> |
特定のワールド座標へテレポートします |
/setadmin <player> <level> |
プレイヤーの管理者レベルを設定します（パッケージが階層をサポートしている場合） |
/announce <message> |
サーバー全体へのアナウンスを送信します |
車両管理
Onset には、パッケージで拡張できる組み込みの車両システムがあります。管理者は、サーバーの乱雑さを防ぐために、スポーンした車両を管理する必要がよくあります。
- 車両のスポーン — ほとんどの RP パッケージでは、管理者が
/car <model>などのコマンドで車両をスポーンできます - 車両のクリーンアップ — 一部のパッケージには、放置された車両の自動デスポーンや
/destroyvehiclesなどの管理者コマンドが含まれています - 車両の制限 — スポーンされたエンティティが多すぎることによるラグを防ぐため、プレイヤーごとの最大車両数を設定します
データベース（MariaDB）
Onset は、永続的なデータストレージのために MariaDB/MySQL データベース接続をサポートしています。これは、ロールプレイやその他のゲームモードパッケージで、プレイヤーデータ、インベントリ、プロパティなどを保存するために使用されます。
データベース設定は、パッケージの設定ファイル内で処理されます。一般的なセットアップは次のとおりです。
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}トラブルシューティング
| 問題 | 解決策 |
|---|---|
| サーバーは起動するがゲームプレイが利用できない | 少なくとも 1 つのゲームモードパッケージをインストールし、server_config.json にリストする必要があります。素の Onset サーバーには組み込みのゲームプレイがありません。 |
| パッケージの読み込みに失敗する | GPanel コンソールで Lua のエラーメッセージを確認します。よくある原因: package.json の欠落、Lua ファイルの構文エラー、または依存関係の欠落。 |
| データベース接続エラー | データベースの認証情報を確認し、データベースが存在することを確認し、MariaDB サービスが実行されていることを確認します。コンソールログから接続をテストします。 |
| サーバーがブラウザに表示されない | server_config.json で "visible": true が設定されていることを確認します。また、クエリポートとしてポート 7776（TCP）にアクセスできることを確認します。 |
| 高いレイテンシまたはラグ | streamdistance の値を下げ、CPU 使用率が高い場合は tickrate を下げ、パッケージ内の非効率な Lua スクリプトを確認します。 |
関連記事
サポートが必要ですか？
Onset サーバーで問題が発生している場合や、さらにサポートが必要な場合は、当社のサポートチームがお手伝いします。サポートチケットを送信していただければ、できるだけ早くご返信いたします。
