The Rift Between Us

Core Mechanic

A home-portal system inspired by Path of Exile / Diablo. Each player maintains up to two rifts simultaneously: a Home Rift anchored at a chosen location, and an Adventure Rift left behind when they return home. Rifts persist across logouts and server restarts, and survive death.

Commands & Keybind

/rift — Context-sensitive portal action

Behaves identically to the keybind. Determines what to do based on your current situation (see Context Actions below).

Keybind — key.categories.rifts → key.rifts.rift (unbound by default)

Same behavior as /rift. Sends the rift action to the server on press.

Context Actions

Both the command and keybind evaluate conditions in priority order:

Channeling rules:

• Moving more than ~0.1 blocks during the 4-second channel cancels it ("Rift channeling interrupted.")
• Already channeling blocks a new action from starting
• The message is refreshed every tick, keeping it visible on the action bar throughout

Erase by Crouching

Crouching within 4 blocks of one of your own rifts (same dimension) for 4 seconds without moving erases it.

• If both rifts are within 4 blocks, the closer one is erased
• Moving or standing back up cancels it ("Rift channeling interrupted.")
• Cannot start erase channeling while already channeling a portal action

Restrictions

• Nearby rift use — to proceed through another player's rift, you must be within 6 blocks of their Home Rift, they must be online, and they must have an active Adventure Rift
• Teleport fallback — if you use the return-home action with no Home Rift set, it falls back to your bed spawn point, or the world spawn if none exists

Companion Teleportation

When any rift teleportation occurs (all three variants):

• Your mount (if riding one) teleports with you and you are automatically re-mounted at the destination
• Tamed animals you own (anything implementing Tameable) within 12 blocks of your current position teleport to the destination as well
• Pets already counted as the mount are not teleported twice

Multiplayer Sync

• Rift creation and removal broadcast a packet to all connected players in real time
• On join: the connecting player receives a single bulk packet with all current rifts; their own rifts are simultaneously announced to everyone else
• Client only renders rifts in the current dimension — rifts in other dimensions are hidden
• Client rift state is cleared on disconnect to prevent stale data when joining a different server

Visuals

• Rifts render as animated billboards (always face the camera), centered 1.5 blocks above the rift's block position
• 4-frame sprite animation cycling every 4 ticks
• Fully bright — unaffected by world lighting
• Only rendered in the correct dimension