Minecraftプラグイン ClearLag

ClearLag と確認されたサーバーの情報

🔌 ClearLagg について

ClearLagg は Bukkit/Spigot サーバー向けの Minecraft プラグインで、エンティティを削除または制限し、エンティティ数が多い原因を特定・管理するための管理用ツールを提供することで、サーバー側のラグを軽減します。落ちているアイテムの定期的な削除に重点を置いており、設定可能な保護と警告により、重要なアイテムや名前付きアイテムを残しつつ不要なエンティティを削除できます。

🎯 目的

このプラグインの主な目的は、サーバーのパフォーマンス維持です。落ちているアイテムを自動または手動で削除し、エンティティに関連する機能(スポナー、Mob、チャンクの活動)を制御して、過剰なエンティティによる CPU とメモリへの負荷を下げます。

⚙️ 機能

  • 設定可能な間隔で落ちているアイテムを自動削除し、警告カウントダウンを表示。
  • 必要に応じて使える手動の削除コマンドとタイマーコマンド。
  • エンティティ数の計測と、過負荷または悪用されたチャンクを見つけるためのツール。
  • Mob スポナーを制限したり、Mob を制御された方法で倒したりするオプション。
  • チャンクをアンロードし、ガベージコレクション操作を試みるコマンド。
  • 設定可能な無視アイテム(名前付きアイテム、lore、特定のアイテム種別)で価値のあるドロップを保護。
  • 設定の再読み込みと、実行中のモジュール制御。
  • 自動更新機能(プラグイン設定で設定/無効化可能)。

🧩 対象ユーザー

ClearLagg は、Bukkit/Spigot サーバー(survival、SMP、factions、中規模/大規模サーバー)を運用していて、エンティティ数を管理し、必要に応じてまたは定期的にクリーンアップを行いたいサーバー管理者や運営者向けです。

🏗️ 使用例

  • 混雑した survival サーバーでメモリ使用量を安定させるため、X 分ごとに地面のアイテムを自動削除する。
  • 管理者が異常なエンティティ数のチャンクを見つけ、そのチャンクをアンロードするか、一定範囲のエンティティを削除してラグスパイクを止める。
  • メンテナンス中や大規模イベント中に Mob のスポーンを一時停止する。

⌨️ コマンド

コマンド説明権限アクセス
/lagg clearワールドから設定済みのエンティティカテゴリを削除します。lagg.clearAdmin
/lagg check [world1 world2...]エンティティ数を数えます(ワールドごとの合計を表示)。lagg.checkAdmin
/lagg reloadプラグイン設定とスケジューラーを再読み込みします。lagg.reloadAdmin
/lagg killmobs設定されたルールに従って Mob を倒します。lagg.killmobsAdmin
/lagg area <radius>指定した半径内のエンティティを削除します。lagg.areaAdmin
/lagg unloadchunks不要なチャンクのアンロードを試みます。lagg.unloadchunksAdmin
/lagg chunk [amount]ラグの原因になりそうなチャンクの特定を助けます。lagg.chunkAdmin
/lagg tpchunk <x> <z> <world>指定したチャンクへテレポートします。lagg.tpchunkAdmin
/lagg admin管理用モジュール制御にアクセスします。lagg.adminAdmin
/lagg gcメモリ解放(ガベージコレクション)を試みます。lagg.gcAdmin
/lagg tps現在のサーバー TPS を表示します。lagg.tpsAdmin
/lagg halt一部のサーバー機能(例: Mob スポーン)を一時的に無効化します。lagg.haltAdmin
/laggヘルプ / プラグイン情報を表示します。lagg.helpPlayer/Admin

🔐 権限

権限説明デフォルト
lagg.clear設定済みのエンティティを削除する clear コマンドの使用を許可します。指定なし
lagg.checkワールドをまたいでエンティティを数えることを許可します。指定なし
lagg.reloadプラグイン設定の再読み込みを許可します。指定なし
lagg.killmobsMob を倒すコマンドの実行を許可します。指定なし
lagg.area半径内のエンティティ削除を許可します。指定なし
lagg.unloadchunksプラグイン経由でチャンクのアンロードを許可します。指定なし
lagg.chunkラグの原因になりそうなチャンクの特定を許可します。指定なし
lagg.tpchunkチャンクへのテレポートを許可します。指定なし
lagg.adminモジュール管理コマンドへのアクセスを許可します。指定なし
lagg.gcプラグイン経由で GC の試行を実行することを許可します。指定なし
lagg.tpsプラグイン経由でサーバー TPS を表示することを許可します。指定なし
lagg.halt一部のサーバー機能の一時停止の切り替えを許可します。指定なし

⚙️ インストール

📥 セットアップ

  • 公式のプラグイン JAR をダウンロードし、サーバーの plugins/ ディレクトリに配置します。
  • プラグインが既定の設定ファイルを作成できるよう、サーバーを再起動します。
  • サーバーのコンソール/ログでプラグインが正しく読み込まれたことを確認します。
  • 生成された設定を編集して、クリーンアップ間隔、無視するアイテム、警告を調整します。変更を適用するには reload コマンドを使います。

🧠 技術メモ

  • ClearLagg は Bukkit/Spigot サーバー向けに配布されており、歴史的に Bukkit/Spigot ベースのサーバー版との互換性が広くあります。
  • このプラグインは初回起動時に設定ディレクトリ(例: /plugins/Clearlag/config.yml)を作成し、内蔵の自動更新動作を無効化するオプションを含みます。

🤝 このプラグインが役立つ場面

Bukkit/Spigot サーバーで、余分な落ちているアイテムを定期的に削除したり、エンティティが多いエリアを調査・制御したりするための、シンプルで設定しやすいツールが必要なら、ClearLagg は最小限のセットアップでエンティティ関連のラグを軽減するための管理コマンドと設定を提供します。

プラグイン ClearLag のサーバー

プラグイン ClearLag のページには、モニタリングがこのプラグインを確認したサーバー、使用されているプラットフォームとバージョンが表示されます。

プラグインはコマンド、経済、保護、アクセス権、ミニゲーム、連携、その他のメカニクスを追加できます。ClearLag の実際の役割はサーバーごとの設定によります。

データはサーバーの技術応答から自動生成されます。サーバーがプラグイン一覧を非公開にしている場合、ClearLag を使用していてもこのセクションに表示されないことがあります。

ClearLag を使用するサーバーの一覧を使って、プロジェクトを比較したり、対応バージョンを確認したり、公開サーバーでのプラグイン使用例を見つけたりできます。