Skip to content
ホスティング · サーバー構成

ops.json、banned-players.json、その他のリスト

サーバーのサービスJSONファイル:オペレーター、BAN、ホワイトリスト、ニックネームキャッシュ — それぞれの内容と手動編集するタイミング。

更新日 2026年8月13日

サーバーはプレイヤーリストをルートの JSON ファイルに保存します。通常はコマンドで管理しますが、ファイルを直接開いたほうが速いこともあります。

ファイル内容
ops.jsonオペレーター、アクセスレベル、bypassesPlayerLimit
whitelist.jsonホワイトリスト
banned-players.jsonニックネームと UUID による BAN
banned-ips.jsonIP による BAN
usercache.jsonニックネーム → UUID の対応キャッシュ

ops.json の例

[
  {
    "uuid": "8a1b...",
    "name": "Steve",
    "level": 4,
    "bypassesPlayerLimit": true
  }
]

編集時のルール

  • サーバーを停止している間だけ編集してください。 稼働中のサーバーはリストをメモリ上に保持しており、シャットダウン時にファイルを上書きするため、編集内容は失われます。
  • 形式は厳密です。余分なカンマが 1 つあるだけでファイル全体が壊れ、サーバーは空のオペレーターリストで起動します。
  • UUID はニックネームと一致している必要があります。プレミアムサーバーでは UUID は永続的ですが、ニックネームログインのサーバーではニックネームから計算されるため、online-mode を変更するとすべてのリストが実質的に一致しなくなります。

online-mode の変更

これは「オペレーターや保護がすべて消えた」という問題の最も一般的な原因です。プレイヤーの UUID が変わり、古いエントリが誰も指さなくなるためです。詳細はニックネームログインをご覧ください。

プラグイン

権限管理プラグインや BAN プラグインはデータを別途(ファイルまたは MySQL)保存し、バニラのリストを無視します — LuckPerms、BAN とミュート。

Minecraftホスティングオフラインでもサーバーが稼働サーバーを作成