TeleportRequest

Ask a friend to warp over, they say yes, and nobody gets ambushed.

TeleportRequest lets your players ask to teleport to each other with a yes or no prompt, a combat block, cooldowns, and an optional point cost per warp.

Think of every teleport as a small guided trip. One player asks for the ride, the other agrees, and only then does the warp fire. Nobody is dragged somewhere without saying yes, and nobody hops across the map to wriggle out of a fight, because TeleportRequest locks teleport for a while after anybody takes or deals damage. Cooldowns keep it fair and you can charge points for the trip if you like.

Supported Features

• Both directions: one command sends you to a player, the other calls a player to you, and both need a yes first.
• Nobody moves without agreeing: there are no surprise pulls, so a teleport can never be used to drag somebody somewhere.
• A combat block: once a player takes or deals damage, teleport locks for the seconds you set, so it is no escape hatch.
• A wait between trips: each player has a cooldown, and your VIP group can have a shorter one.
• An optional warmup: hold the mover still for a moment first, and if either player is hit during it the trip cancels and any points come back.
• Leave the mount behind: a teleport can be blocked while a player is riding, so mounts do not come along for the ride.
• A distance limit: cap how far apart two players may be for a warp, or leave it off entirely.
• Charge for the ride: take ArkShop points per teleport, charged when the other player accepts and refunded if the warp falls over.
• Requests clear themselves: one nobody answers times out on its own, so your players are not haunted by old invitations.
• Discord log: post each completed teleport to a channel through a webhook.
• Rename the lot: every command word lives in config.json, so you set the words your server already uses.
• Prompts in your language: name a language in the config and the ask, the accept and the refusal all come from a plain text file you can edit.

Console & RCON Commands

Command	What It Does	Where
TeleportRequest.Reload	Reload the config without a server restart.	Both
TeleportRequest.ClearCooldown <eos>	Clear one player's teleport cooldown.	Console
TeleportRequest.TestDiscord	Send a test post to the Discord webhook.	Console

Player Commands

The command names come from config.json, so change them or switch one off there.

Command	What It Does
/tpa <player>	Ask to teleport to a player.
/tphere <player>	Ask a player to come to you.
/tpaccept [name]	Accept a request. Add a name to pick one when several are waiting.
/tpdeny [name]	Turn a request down.
/tpcancel	Cancel the requests you sent out.

Permissions

Node	What It Unlocks
TeleportRequest.Use	Lets a player use teleport at all.
TeleportRequest.VIP	Gives that group the shorter cooldown.

With no Permissions plugin installed I fail open, so everybody may teleport on the normal cooldown. Install it when you want to hold teleport back to certain groups, or to sell a shorter wait.

Config

To see every configuration option, visit our docs. To edit your config files the easy way, open our configuration editor.

Requirements

• AsaApi v2.01 or newer
• A Windows server running ArkAscendedServer through the AsaApi loader
• ArkShop or WShop (optional, only needed when a warp costs points)
• Permissions (optional, works without it, only needed to gate use and the VIP cooldown)
• A Discord webhook (optional, works without it)

Installation

1. Unzip the download and drop the TeleportRequest folder into ArkApi/Plugins/. Keep the folder named TeleportRequest, because AsaApi wants it to carry the same name as the DLL inside it.
2. Open TeleportRequest/config.json and set your command words, your cooldowns and your combat block.
3. Save the file and restart the server through AsaApiLoader.exe.
4. Watch ArkApi.log for the loaded line.
5. Ask a friend to test one warp with you before you announce it to the server.

Support & Help

Lost on the road somewhere? Come and find me in the Discord and we will walk through it together: https://discord.gg/8GGaEzWk9p

Frequently Asked Questions

What does TeleportRequest do?

TeleportRequest lets your players teleport to each other, but only with a yes. One player asks, the other agrees, and then the warp fires. A combat block, a cooldown and an optional point cost keep it from turning into a free escape button.

How do I install TeleportRequest?

Take the TeleportRequest folder from the zip, place it in your server's ArkApi/Plugins/ folder, set your rules in config.json, and restart. The loaded line in ArkApi.log tells you it came up.

Can players teleport out of a fight?

No, and that is the point of the combat block. Once a player takes or deals damage, teleport locks for the seconds you set. Put that number at zero if you would rather have no block at all.

What happens to the points when a warp fails?

The asker pays at the moment the other player accepts, not when the request goes out. If the warp then fails, or a hit during the warmup cancels it, the points go straight back. Nobody pays for a trip that never happened.

What if two people ask me at the same time?

Both requests sit side by side until they time out. Type the accept command with a name to pick one, and the deny command takes a name the same way. With only one waiting, the plain command answers it.

Does it work without ArkShop or Permissions?

Yes, it travels light. A points shop only matters when you charge for a warp, and either ArkShop or WShop can take the fare, so you name yours in the config. Permissions only matters when you gate who may teleport or hand out the VIP cooldown. With none of them installed, teleports are free and open to everybody.

Was any AI content used in the making of this?

The source code itself was fully created by myself. I do use ChatGPT occasionally to generate product images, and I do use ChatGPT to generate the website descriptions. I do this because I don't speak native English perfectly. I am natively from Sweden, so I use GPT to help translate and write product descriptions. I also will sometimes use GPT to write better English logs. Majority of my Free plugins are open source, so you can review the code yourself and freely fork and edit it to your liking.