Spawn Check Debugger

Summary

Check the effective mob spawn table at your current position and export the result as CSV. A lightweight Forge debug utility for modpack makers, server operators, and mod developers.

Description

Spawn Check Debugger is a small Forge debug utility for inspecting mob spawn entries at the current command source position.

It is designed for modpack makers, server operators, and mod developers who want to answer questions like:

• Is this mob included in the effective spawn table here?
• What is its spawn weight compared with the other entries in the same mob category?
• Which mobs are currently listed for this biome, dimension, or structure context?
• Can I export the result and compare it later?

This mod does not change mob spawning. It only reads and reports the spawn entries returned by Minecraft for the current position.

Commands

/spawncheck
/spawncheck list
/spawncheck minecraft:zombie
/spawncheck zombie
/spawncheck export
/spawncheck export minecraft:zombie

Command overview

The command requires operator/admin permission level 2.

Because the command uses the command source position, it can also be useful with /execute positioned ... run spawncheck ....

CSV Export

CSV files are written to:

<game directory>/spawncheckdebugger/

Example file name:

spawncheck-20260614-210000-all.csv
spawncheck-20260614-210000-minecraft_zombie.csv

CSV columns:

dimension,x,y,z,biome,spawn_group,entity,weight,total_weight,percent,min_group_size,max_group_size,meaning

The CSV output is intentionally kept in English so it is stable and easy to process with scripts or spreadsheets.

What does the percentage mean?

The displayed percentage is:

entry_weight / total_weight_in_the_same_MobCategory * 100

It is not the final real-world spawn probability.

Actual spawning still depends on many other conditions, including:

• light level
• block and surface conditions
• mob caps
• difficulty
• player distance
• entity-specific spawn checks
• vanilla and modded spawn logic

For example, an entity can be present in the spawn table but still fail to spawn because its normal spawn conditions are not satisfied.

Localization

Included languages:

• English (en_us)
• Japanese (ja_jp)

The command logic is server-side. For the best localized chat messages on a multiplayer server, install the mod on both the server and the client. If the mod is installed only on the server, clients without the language files may see translation keys instead of localized text.

Requirements

• Minecraft 1.20.1
• Forge 47.x
• Java 17

Intended use

This is mainly a development and debugging tool. It is especially useful when building or troubleshooting modpacks with custom biomes, structures, dimensions, or mob spawn settings.

Spawn Check Debugger / 日本語説明

概要

現在位置の有効Mobスポーンテーブルを確認し、結果をCSV出力できる Forge 用デバッグ支援Modです。 Modpack制作者、サーバー管理者、Mod開発者向けです。

説明

Spawn Check Debugger は、現在のコマンド実行位置におけるMobスポーン候補を確認するための、小さな Forge 用デバッグ支援Modです。

次のような確認をしたいときに使えます。

• このMobは、この場所の有効スポーンテーブルに含まれているか？
• 同じMobカテゴリ内で、どのくらいのスポーンweightを持っているか？
• このバイオーム、ディメンション、構造物コンテキストでは、どのMobが候補になっているか？
• 結果をCSVに出力して、あとから比較できるか？

このModは Mobのスポーンを変更しません。現在位置に対して Minecraft が返すスポーン候補を読み取り、表示するだけです。

コマンド

/spawncheck
/spawncheck list
/spawncheck minecraft:zombie
/spawncheck zombie
/spawncheck export
/spawncheck export minecraft:zombie

コマンド概要

このコマンドには、OP/admin 権限レベル 2 が必要です。

コマンド実行位置を参照するため、/execute positioned ... run spawncheck ... のような使い方にも向いています。

CSV出力

CSVファイルは次の場所に出力されます。

<game directory>/spawncheckdebugger/

ファイル名の例:

spawncheck-20260614-210000-all.csv
spawncheck-20260614-210000-minecraft_zombie.csv

CSVカラム:

dimension,x,y,z,biome,spawn_group,entity,weight,total_weight,percent,min_group_size,max_group_size,meaning

CSV出力は、スクリプトや表計算ソフトで扱いやすいように英語固定にしています。

表示されるパーセントの意味

表示されるパーセントは次の値です。

entry_weight / total_weight_in_the_same_MobCategory * 100

これは 実際の最終スポーン確率そのものではありません。

実際にMobがスポーンするかどうかは、ほかにも多くの条件に左右されます。

• 明るさ
• ブロックや足場の条件
• mob cap
• 難易度
• プレイヤーとの距離
• Mobごとの固有スポーン判定
• Vanillaや他Modによるスポーンロジック

たとえば、スポーンテーブルに含まれていても、そのMobの通常の出現条件を満たしていなければ実際にはスポーンしません。

言語対応

対応言語:

• English (en_us)
• 日本語 (ja_jp)

コマンド処理自体はサーバー側で動作します。マルチプレイでチャット表示を正しくローカライズしたい場合は、サーバーとクライアントの両方にModを導入してください。サーバーのみに導入した場合、クライアント側に言語ファイルがないため、翻訳キーがそのまま表示される可能性があります。

必要環境

• Minecraft 1.20.1
• Forge 47.x
• Java 17

想定用途

このModは主に開発・検証用のツールです。カスタムバイオーム、構造物、ディメンション、Mobスポーン設定を含むModpackの制作や調査に向いています。