Debug Commands

Debug commands

MSL adds one command tree for diagnosing structure problems in game. Both toggles need gamemaster permission, so op yourself or run them from the server console.

/moogs_structures debug [on|off|status]
/moogs_structures debug keepjigsaws [on|off|status]

Leaving off the argument toggles the flag rather than setting it.

debug

Turns on extra logging for version-aware pool elements. That is currently all it affects: which template a versioned_single_pool_element resolved to, and when no version range matched so it used the fallback instead.

Timing matters here. Those messages are written when template pools are decoded, which happens as the world loads, not while you play. Turning the flag on mid-session logs nothing, because the pools have already been read.

In singleplayer you can turn it on, quit to title, and load back in. The flag lives in memory and survives that. On a dedicated server a restart clears the flag before pools are decoded, so there is currently no way to catch these messages there.

Both messages go to the log at info level, not to chat. Fallbacks are silent by default because falling back is normal, so you have to opt in to see them.

keepjigsaws

Leaves jigsaw blocks in place instead of replacing them with their final_state. You can then stand in a generated structure and read each jigsaw's name, target and pool directly.

Only affects structures generated or placed after you turn it on. Anything already in the world keeps whatever it generated with.

Making /locate search further

Not a command, but related. Structures in the larger_locate_search structure tag get a much wider /locate structure search, out to 2000 chunks, which matters for rare structures that vanilla's default radius gives up on.

data/moogs_structures/tags/worldgen/structure/larger_locate_search.json

{ "values": ["mns:mega_fortress"] }

Written into MSL's namespace listing your own structure ids, the same as the basalt and delta tags. A wider search takes longer to run, so use it for genuinely rare structures rather than everything.

Gotchas

• Neither flag is saved. Both reset to off when the server restarts.
• keepjigsaws leaves jigsaw blocks in the world for good. They are real blocks once placed, so a world you explored with it on keeps them until you remove them yourself. Use a test world.
• Debug logging goes to the log file, not to chat, so have the console or latest.log open.

See also

• versioned_single_pool_element, the only thing debug currently reports on.
• Nether jigsaw structures for the other MSL structure tags.