Skip to main content

Configuration

SpawnFilter's config file lives at config/spawnfilter.toml and is generated on first run.

The default file looks like this:

[spawnfilter]
# Individual blocks the player cannot spawn on
blocked_blocks = [
    "minecraft:water",
    "minecraft:lava",
    "minecraft:magma_block"
]

# Block tags whose member blocks the player cannot spawn on
# Use the # prefix convention to denote tags, mirroring Minecraft tag syntax
blocked_tags = [
    "#minecraft:fire",
    "#minecraft:wool",
    "#c:fluids",
    "#minecraft:leaves"
]

Adding Your Own Blocks

Add any block ID or tag ID you want to the relevant list.

  • Individual blocks use the normal mod_id:block_name format (for example minecraft:cactus).
  • Block tags use the #mod_id:tag_name format. The # prefix is required, same as you would use in a datapack.

Modded blocks work fine as long as the target mod is installed on the server.

Reload Behavior

The config gets re-resolved when the server starts and when datapacks reload (/reload). If you change tags via a datapack, the changes take effect without a server restart.