Linking realms

From GunchoWiki

Linking realms makes it possible for players to walk from a room in one realm to a room in another (or climb, or fall, etc.), as if both rooms were part of the same realm. This is a less mimesis-breaking way to travel between realms than using @teleport.

Linking is accomplished with a special phrase which tells the server to transfer the player from the current realm to another realm.

Players cannot carry or push objects through a link. All of their possessions will be left behind when they move through the link.

[edit] Simple Links

To make a link from your realm to another, write an action rule like so:

Instead of climbing the ladder, send the player to "The Outer Realm".

Instead of going north in the Basement, send the player to "Closet".

The full name of the destination realm must be given in quotes. The player will appear at the first room defined in the destination realm.

If the action that triggers the rule is a "going" action, then both realms will automatically display an appropriate message for the player's movement, like "Vaporware appears from the south". Otherwise, they'll show a default message.

It's also possible for a link to affect someone other than the person doing the action:

Banishing is an action applying to one thing. Understand "banish [a PC]" as banishing.
Carry out banishing: send the noun to "The Outer Realm".

[edit] Linking to Specific Rooms

A realm may define entrances which allow you to link to specific places inside it, instead of always sending players to the first room defined. To link to an entrance, put the entrance name before the realm name, separated by an at-sign:

Instead of going up in the Dungeon Mouth, send the player to "woods@The Outer Realm".

Entrances are not the same as rooms! You can only link to rooms that have been chosen as entrances, and the entrance name might not be the same as the room name. Check the destination realm's wiki page to be sure you have the right entrance name (or check its Table of Entrances if you can view the source code).

[edit] Troubleshooting

A player might receive an error message when trying to go through a link for a few reasons: for example, if the link uses an incorrect entrance name, or if the destination link is full.

The errors usually indicate what went wrong. If they say the transfer failed "mysteriously", that generally means the destination realm is broken somehow and it isn't responding to the server's messages.

Walking through a link is normally a little slower than walking between rooms in the same realm. If the destination realm hasn't been used since the last time it was changed, it may take several seconds to go through the link while the realm is activated.