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