Cuboids and Portals

Cuboids & Portals System Guide

The Cuboid system in UltimateDonutSMP provides lightweight, high-performance 3D region selection and protection without needing WorldGuard. Cuboids are used for Spawn protection, AFK reward areas, Shard event zones, Random Teleport (RTP) boundaries, and Portal triggers.

---

Cuboid Management (/cuboid)

1. Selection Wand

Get the selection tool (Golden Hoe or Wooden Axe):

/cuboid wand

• Left-Click Block: Sets Position 1 (Corner 1).
• Right-Click Block: Sets Position 2 (Corner 2).

2. Creating & Deleting Cuboids

After selecting two corners:

/cuboid create <name>

Example: /cuboid create spawn_zone

To remove a cuboid:

/cuboid delete <name>

To view all defined cuboids:

/cuboid list

---

Binding Cuboids to Systems (/cuboid bind)

Cuboids can be bound to different server systems to enforce special features or protections:

/cuboid bind <cuboid_name> <spawn|shard|rtp-zone> <true|false>

Feature Binds Explained:

1. spawn Bind:

   • Protects the cuboid area against block breaking, building, and unauthorized PvP.
   • Restricts player flight (/fly) or allows flight depending on settings. Command: /cuboid bind spawn_zone spawn true

2. shard Bind:

   • Defines a active Shard Cuboid zone where players holding position gain passive Shards over time.
   • Activates PlaceholderAPI placeholders %economy_shard_cuboid_status% and %economy_shard_cuboid_display%. Command: /cuboid bind shard_arena shard true

3. rtp-zone Bind:

   • Defines the exact region where /rtp (Random Teleport) will pick safe destination locations. Command: /cuboid bind wilderness_bounds rtp-zone true

---

Portal Management (/portal)

The Portal system allows administrators to turn any Cuboid region into a seamless teleport trigger.

Portal Creation Syntax:

/portal create <portal_id> <cuboid_name> <destination_type> <destination_value>

Supported Destination Types:

• SPAWN: Teleports player to global server spawn.
• WARP: Teleports player to a defined warp location (<warp_name>).
• RTP: Triggers a random teleport upon entering the portal.
• LOCATION: Teleports player to precise coordinates (world,x,y,z,yaw,pitch).

Example Portal Commands:

# Create spawn portal
/portal create spawn_gate spawn_zone SPAWN

# Create nether warp portal
/portal create nether_gate nether_cuboid WARP nether_hub

# Create RTP portal trigger
/portal create rtp_gate rtp_trigger_cuboid RTP

Portal Administration:

• List all active portals: /portal list
• Change portal cuboid: /portal setcuboid <portal_id> <cuboid_name>
• Change portal destination: /portal setdestination <portal_id> <type> <value>
• Delete portal: /portal delete <portal_id>
• Reload portal engine: /portal reload