warp sharing - PneumatiCraft/OpenWarp GitHub Wiki

Though the public/private distinction works well for most servers, many users want a kind of middle ground - a warp that is available to a small group of players, but not the server as a whole. A public warp would be too open; a private warp is restricted to a single user.

To this end, OpenWarp supports shared warps: private warps that are made visible to some other users without being fully public. Shared warps are created as private warps by one player, then shared individually with other players using the command:

/warp share {warp name} {player name}

If the receiving player (the "invitee") is online at the time, they'll receive a message about the new warp they can access. Players will also notice a third row show up in their warp listings, containing "invited" warps; these warps are shared from other users. Invitees access shared warps by running:

/warp {inviter}:{shared warp}

Notice that shared warps, unlike public or private warps, have a user's name prefixed; this is the name of the inviter, and is required for accessing shared warps.

Once done sharing the warp, the inviting player can remove the invitee by running:

/warp unshare {warp name} {player name}

Some caveats of warp sharing are:

• They must be accessed using the inviter's name; the normal warp search algorithm doesn't check shared warps by default.
• They can only be removed by the original inviter; an invitee cannot uninvite themself from a warp.
• Only private warps can be shared. (There's no point in sharing public warps.)

Let's say a server has three players: Ann, Bob, and Chris. Ann has built a redstone structure for automated melon farming, and has created a private warp for its location:

/warp set melonator private

Now Bob wants to check out the Melonator and try to improve its redstone circuits. Ann wants to show Bob the Melonator, but not publicize it to Chris, who likes stealing melons. Ann can run:

/warp share melonator Bob

If Bob is online, he'll get a message saying that Ann has shared the warp melonator with him. Either way, the next time he logs on, Bob can run:

/warp Ann:melonator

He'll be teleported to Ann's Melonator, where he helps out with the circuits. During this entire process, Chris still doesn't know about the Melonator.

Once Bob is done helping Ann out, he can warp back home, and Ann can remove his warp by running:

/warp unshare Bob melonator

Bob will receive another message (if he's logged on), and the melonator warp is fully private again.