Wiki Release: 2026.09.5 · UltimateNexus: 1.0.0 · Documentation branch: 1

UltimateNexus troubleshooting#

Nexus creation fails or commands break during creation#

Finish/cancel the active wand/chat creation flow before using unrelated commands. Verify both selected points, minimum distance/volume and that the creator has not timed out.

Structure objective takes no damage#

Confirm the objective type is STRUCTURE or HYBRID, the correct structure/totem is selected and the event is actually running. Vanilla block breaking is intentionally cancelled; objective damage is handled by the Nexus structure listener/packet path.

Structure can be mined like normal terrain#

That is not expected for an active objective. Verify the block belongs to the spawned Nexus structure and that the structure listener/packet integration is active. Do not fix it by making the whole arena globally unbreakable unless that is your intended gameplay.

Boss/guardians do not take damage#

Run /unexus objective <nexus> view and verify objective type/entity settings. If shield is true, the boss can intentionally be protected while guardians remain. Also verify EntityWizard/packet entity support when the configured entity path requires it.

Boss/guardians are immobile or stack together#

Check movement enabled, speed/chase/wander settings and separation radius/strength. Verify the selected entity type can behave correctly on the current Minecraft version/integration.

Boss life shown by UI is wrong#

Compare objective manager maximum life with the configured boss life/per-Nexus value. Use the objective view command rather than assuming the default 500 applies to every existing Nexus.

HYBRID appears stuck#

Identify the current objective stage: guardians, boss, structure or complete. A shielded boss or unfinished prior stage can make the next stage intentionally unavailable.

Event reaches time limit but winner is unexpected#

Check maximum-time end action and the configured winner-on-time behavior. Test timeout separately from normal objective destruction.

Temporary structure/entity remains after stop or restart#

Use /unexus stop, then verify cleanup. The plugin has startup stale-structure cleanup logic; if stale objects remain, capture logs and objective/render mode before deleting files manually.

Fake structure works visually but hits do not register#

Verify the packet path/PacketEvents integration and render mode. PHYSICAL and FAKE structures use different hit paths.

Warp does not work#

Check player warp setting, permission, target location and the default 3 second delay. Movement/combat during that delay may cancel the teleport depending on the runtime flow.

Scheduler does not start#

Verify manual /unexus start, scheduler timezone, exact identifier and minimum players. Do not debug schedule timing until the event itself starts manually.