連携機能
各サーバーは、設定グループの下に統合機能を持っています:Discord、公開ステータスページ、ワンクリック招待、そしてオプションのチャットボットタブ(管理者のみ)。このページではDiscordについて説明します。招待とステータスページではそれら2つについて、チャットボットについては独自のページで説明しています。
Discord通知
Section titled “Discord通知”パネルは、Webhookを介してサーバーイベントをDiscordチャンネルに転送します。ボットやOAuthは不要です。
- Discordで:サーバー設定 → 連携機能 → Webhook → 新しいWebhook。チャンネルを選択し、Webhook URLをコピーします。
- パネルで、サーバーの設定 → Discordタブを開き、Webhook URLをWebhook URLに貼り付け、カードをオンにして保存します。URLは暗号化されて保存されます(APIキーと同じ保管庫に)。
- テスト送信を使用して、正しく機能するか確認します。

保存されているURLを置き換えるには、新しいURLを貼り付けて保存します。現在のURLを維持するには、フィールドを空白のままにします。保存されているURLはマスク表示されます(トークンは非表示)。
送信される内容
Section titled “送信される内容”通知は、切り替え可能なカテゴリにグループ化されています。すべてデフォルトでオンになっています。
| カテゴリ | イベント |
|---|---|
| 開始/停止 | サーバー起動、サーバー停止 |
| クラッシュ | クラッシュ、クラッシュループ検出、新しいクラッシュレポート |
| バックアップ | バックアップ作成、バックアップ復元 |
| アップデート | アップデート適用、アップデートロールバック、アップデート失敗 |
| キック/BAN | プレイヤーキック、プレイヤーBAN |
| アラート | サーバーを静かに壊れた状態にするもの(下記参照) |
アラートカテゴリ
Section titled “アラートカテゴリ”アラートは、「人間による対応が必要なもの」チャンネルで、以前はパネルでしか見えなかった条件に対応します:
| イベント | 意味 |
|---|---|
oom |
メモリ不足のためコンテナが停止しました。 |
unhealthy |
プロセスは起動していますが、mc-healthプローブが失敗しています:稼働しているが機能していないサーバーです。 |
startup-stalled |
ログに「完了」が表示されずに約10分間起動し続けています(修正すべき問題の診断付き、可能な場合)。 |
stop-failed |
正常な停止が効果を発揮せず、コンテナがまだ実行中です。 |
schedule-failed |
スケジュールされた再起動/バックアップ/コマンドが失敗しました。 |
quota-exceeded |
厳格モードのディスククォータに違反したため、サーバーは停止しました。 |
offline-after-restart |
パネル再起動前は起動していましたが、現在は起動しておらず、自動起動しません。 |
port-change-failed |
ポート変更が失敗し、サーバーを古いポートに戻せなかったため、ダウンしています。 |
auto-restart-gave-up |
クラッシュしたサーバーは、他のアクションが長すぎたため再起動されませんでした。 |
配信の仕組み
Section titled “配信の仕組み”バックグラウンドブリッジが15秒ごとにイベントログをポーリングし、マッピングされた行を転送します。Webhook POSTが一時的に失敗した場合、その行はドロップされるのではなく、後続のポーリングで再試行されます。数回の試行が失敗した後、その行はスキップされ、配信失敗はサーバーごとに1時間に1回まで記録されます。パネル再起動後、ブリッジはまだ配信されていないイベントを送信しますが、2時間以上前のイベントは送信しません。最初の実行時には、最新のイベントから開始します。