Troubleshooting

A stage doesn't load / doesn't appear in the Journal

Check that order and stage_translation_key are both present - they are the only two required fields. Check the server log for a JSON parsing error; a required field with no default (only order and stage_translation_key) will fail the whole file silently otherwise.

Two stages have the same order

Both will be treated as unlocked/locked together, and the Guide will list both. This is usually a mistake - give each stage a unique order.

An item/block still works after being listed in locked_items / locked_blocks_to_mine

Confirm the player is not in Creative mode (Creative always bypasses locks by design). Confirm the ID is spelled correctly and namespaced (minecraft: prefix for vanilla items).

A boss can be damaged before its "unlock stage" is reached

The lock only applies to the stage immediately before the boss's own stage. A boss at order: 2 is only locked while the world is below order: 1 - it becomes damageable the moment order: 1 is cleared, even before order: 2 itself is reached. This is intentional (you must be able to fight the boss to reach its stage).

A player can still enter a locked dimension

Only genuine portal travel is intercepted. Command-based teleports and third-party mod teleport mechanisms are not covered.

An ore's optical disguise doesn't update immediately after unlocking

Confirm the client actually received the updated stage order - a fresh chunk render is triggered automatically on stage change, but a very laggy connection could delay this by a moment.

A boss drops normal loot instead of loot bags

Check that it was killed by a player, that it isn't listed in the verox_rpg_prog:no_loot_bag tag, and that loot bags are enabled in the config.

A territory doesn't punish me

Territories only punish while their stage is locked, i.e. at least two stages away. If the stage is the current goal, entering is allowed - only building and mining are blocked. Use /rpg_prog stage get to check the world's stage.

I can't place torches inside a structure

Protection blocks every block placement inside the structure until its stage is cleared, including torches. Set "protect_structures": false on the territory if this is too strict for your pack.

The border doesn't show up

The border appears within about 12 blocks of a protected structure and only for structures in already loaded chunks near the player. It is never shown for cleared stages or for structures without protection on the current goal.

A raid never starts

Check that raids.enabled is true, that the raid's stage is the current goal (not cleared, not locked), that the time of day matches trigger.time and that you're not in Creative mode. With the defaults, a raid triggers on average only once per 20 minutes of matching time - use /rpg_prog raid start to test it directly.

A raid ends immediately with a victory

None of its mobs could spawn - usually because they come from a mod that isn't installed. Add required_mods to the top of the raid file so it isn't loaded without that mod.