Commands & permissions

All commands live under one root, /brecherhyperspacerifts. There are no player commands: players use the items and blocks of the mod directly.

Permission level	Who	Access
2	Operators (/op default)	The root command and all administrative branches below
4	Owners / console	Everything above plus forced spawns and the diagnostic branches, which are hidden from sources below level 4

Commands that teleport or place things at your position (allocate, home, rift spawn without coordinates, arenas place) must be run by a player, not the console.

Administrative commands (level 2)

Command	What it does
/brecherhyperspacerifts status	Shows the active feature posture, the selected balance profile and content fingerprints. Use it to confirm which configuration the server is really running.
/brecherhyperspacerifts rift spawn <tier>	Places a rift of the given tier at your position. The tier is fading, stable, unstable, volatile or chaotic, or the numbers 1 to 5. Refused if the spot breaks the normal ambient placement rules; the message says why.
/brecherhyperspacerifts rift spawn <tier> <x y z>	Same, at the given coordinates in the current dimension. The chunk must be loaded.
/brecherhyperspacerifts rift dump	Lists every tracked rift with its ID, state, tier, expiry and position.
/brecherhyperspacerifts rift reconcile	Re-checks the tracked rifts against the world and repairs the index.
/brecherhyperspacerifts convergence list	Lists active Convergences and those in their post-victory Seal window, with HP, participants and the admission count.
/brecherhyperspacerifts weakened list	Lists live Weakened Legendaries with their position, time remaining and Seal attempts.
/brecherhyperspacerifts weakened expire <entityId>	Force-expires a stuck Weakened Legendary record and its entity.
/brecherhyperspacerifts altar reset <x y z>	Clears a stuck Convergence Altar: removes its active raid link and its cooldown.
/brecherhyperspacerifts arenas	Lists the arena catalog with validation results.
/brecherhyperspacerifts arenas validate <arenaId>	Validates a single arena entry.
/brecherhyperspacerifts arenas place <arenaId> [rotation]	Builds a preview of the arena in the raid world and teleports you into it. Rotation is 0 to 3.
/brecherhyperspacerifts arenas clear	Removes the arena preview and returns you home.
/brecherhyperspacerifts arenas roll <tier|convergence> [count]	Rolls the arena choice count times (default 100, up to 10000) and shows the distribution.
/brecherhyperspacerifts arenas marker <type>	Places an arena authoring marker at your position for arena builders (player spawn, boss spawn or exit; the type tab-completes).

Region tools (advanced, level 2)

These manage the internal raid arena regions. They are meant for recovering from problems, not routine use.

Command	What it does
/brecherhyperspacerifts allocate <raidId>	Allocates an arena region for the given ID and teleports you into it.
/brecherhyperspacerifts home	Sends you back out of the raid world to your home position.
/brecherhyperspacerifts clear <raidId>	Releases the arena region of the raid. If the raid is still running, it is aborted through its normal shutdown instead of removing the arena underneath it.

Permission level 4 commands

Command	What it does
/brecherhyperspacerifts rift spawn <tier> force and rift spawn <tier> <x y z> force	Spawns a rift while skipping the ambient placement rules. It never places into an unloaded chunk or on top of an existing rift.

Debug and diagnostic commands (level 4)

Debug commands are for testing and troubleshooting. They can change world and player state. Do not run them on a live server unless you know what they do, and take a backup first. They are registered in every build but hidden from anyone below level 4.

Command	What it does
/brecherhyperspacerifts debug hp <tier> [players]	Reports the boss HP for a tier at a party size of 1 to 100. Read-only.
/brecherhyperspacerifts debug roster [species]	Reports the boss roster, or the entry for one species. Read-only.
/brecherhyperspacerifts debug crystal attune <species>	Attunes the Legendary Crystal in your main hand to a species, for example articuno.
/brecherhyperspacerifts debug crystal charge <0-100>	Sets the charge of the Crystal in your main hand.
/brecherhyperspacerifts debug remnant [species] [ticks]	Places a Legendary Remnant two blocks in front of you.
/brecherhyperspacerifts debug weakened [species] [ticks]	Places a sealable Weakened Legendary in front of you, with you as the participant.
/brecherhyperspacerifts debug close-raid <raidId>	Aborts an active raid. The raid ID is shown by convergence list.

Other debug and rift subcommands that tab-complete at level 4 are development and test fixtures. They are not supported on a live server.

Routine checks

• status after every restart or configuration change.
• rift dump to see how many rifts exist and when they expire.
• convergence list and weakened list when a player reports a stuck Convergence or Seal. Use weakened expire and altar reset to clear it.
• rift spawn <tier> to give a player a rift when testing, for example rift spawn stable.

For the settings behind these commands see Configuration.