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

Objectives and structures#

UltimateNexus 1.0.0 exposes three objective types through ObjectiveType: STRUCTURE, BOSS and HYBRID.

STRUCTURE objective#

The Nexus uses its selected structure/totem as the objective. Players attack the objective to reduce Nexus life; vanilla block breaking is cancelled so the structure is treated as an event objective rather than ordinary terrain.

Use /unexus settotem and /unexus structure to manage the structure data used by the event.

Structure render mode#

/unexus objective <nexus> render <PHYSICAL|FAKE|AUTO> controls rendering:

• PHYSICAL — real server blocks represent the structure.
• FAKE — client-side/packet structure rendering is used where supported.
• AUTO — lets the runtime choose the appropriate path.

The configuration contains separate visual feedback for structure damage, critical feedback, destroy effects and a short physical REDSTONE_BLOCK flash.

BOSS objective#

BOSS uses an entity objective. The supplied defaults configure a WITHER boss with independent life and movement/chase/attack settings.

Use:

• /unexus objective <nexus> boss <ENTITY_TYPE>
• /unexus objective <nexus> guardians <ENTITY_TYPE> <count> [life]
• /unexus objective <nexus> radius <blocks>
• /unexus objective <nexus> shield <true|false>

The supplied default guardian type is WITHER_SKELETON, count 4, life 100, and shield_boss: true, so the boss can be protected until guardians are defeated.

HYBRID objective#

HYBRID uses both structure and boss paths. The runtime tracks objective stages including GUARDIANS, BOSS, STRUCTURE and COMPLETE.

When debugging HYBRID, identify the current stage before assuming the next objective is broken. For example, a shielded boss is intentionally not damageable while guardians remain.

Structure library#

/unexus structure exposes structure administration such as list, view, download, set, wand and other supported actions. Structure files are stored under the configured structures/ folder. The default totem identifier is totem.

The plugin includes cleanup logic that checks stale structures after startup. Test restart cleanup on a disposable Nexus before using complex production structures.

EntityWizard#

EntityWizard is optional integration used by the entity/packet path. /unexus objective <nexus> view reports whether EntityWizard is active. If packet-backed boss/guardian behavior fails while structure mode works, verify this integration before changing objective data.