{"id":15141055,"url":"https://github.com/minetest-mods/teleport-request","last_synced_at":"2025-10-23T18:30:27.931Z","repository":{"id":19053621,"uuid":"22279904","full_name":"minetest-mods/teleport-request","owner":"minetest-mods","description":"A mod that allows players to request from another player to be teleported to them. Includes many more teleporting features.","archived":false,"fork":false,"pushed_at":"2024-01-16T21:41:56.000Z","size":401,"stargazers_count":7,"open_issues_count":2,"forks_count":17,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-01-30T20:12:25.493Z","etag":null,"topics":["intllib","lgpl","lua","minetest","minetest-mod","mod","teleport","teleport-request","tpr"],"latest_commit_sha":null,"homepage":"https://content.minetest.net/packages/Traxie21/tpr","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/minetest-mods.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING.LESSER","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-07-26T06:19:50.000Z","updated_at":"2023-10-23T19:54:22.000Z","dependencies_parsed_at":"2024-01-15T22:15:44.340Z","dependency_job_id":"a37042c9-6f18-45c4-9c47-6d349409f07a","html_url":"https://github.com/minetest-mods/teleport-request","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minetest-mods%2Fteleport-request","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minetest-mods%2Fteleport-request/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minetest-mods%2Fteleport-request/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minetest-mods%2Fteleport-request/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/minetest-mods","download_url":"https://codeload.github.com/minetest-mods/teleport-request/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237869178,"owners_count":19379282,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["intllib","lgpl","lua","minetest","minetest-mod","mod","teleport","teleport-request","tpr"],"created_at":"2024-09-26T08:43:55.654Z","updated_at":"2025-10-23T18:30:27.591Z","avatar_url":"https://github.com/minetest-mods.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Teleport Request\n\n[![LuaCheck status](https://github.com/minetest-mods/teleport-request/workflows/luacheck/badge.svg)](https://github.com/minetest-mods/teleport-request/actions)\n[![ContentDB](https://content.minetest.net/packages/Traxie21/tpr/shields/downloads/)](https://content.minetest.net/packages/Traxie21/tpr/)\n\nAllows players to send a request to other players to teleport to them. Includes many more teleporting features.\n\n## Installation\n\n- Unzip the archive, rename the folder to `tpr` and\nplace it in `.. minetest/mods/`\n\n- GNU/Linux: If you use a system-wide installation place\n    it in `~/.minetest/mods/`.\n\n- If you only want this to be used in a single world, place\n    the folder in `.. worldmods/` in your world directory.\n\nFor further information or help, see:\\\n\u003chttps://wiki.minetest.net/Installing_Mods\u003e\n\n## Privileges\n\nEach command needs a privilege. These are the following privileges:\n\n- `tp` is required in order to use all commands.\n- `tp_tpc` is required in order to use `/tpc`.\n- `tp_tpc` is required in order to use `/tpe`.\n- `tp_tpc` is required in order to use `/tpj`.\n- `interact` is required to use all commands.\n- `tp_admin` gives more control to admins:\n\n  - Admins can teleport to players even when they haven't decided to accept, or not.\n  - Admins can teleport players to him/her, if the `enable_immediate_teleport` setting is enabled.\n  - Admins can teleport to protected coordinates.\n\nPlayers can also teleport to coordinates, however, if the area is protected, the teleport will be denied.\n\n## How to use\n\nEach command does a function. \"**Example usage**\" is an example of how to use the command.\\\nNote there must be 2 players in order to make the commands to work: a player must send a request to another player.\n\nThere are two ways of sending a request:\n\n1. A request which teleports you to the specified player (command `/tpr \u003cplayer\u003e`).\n2. A request which teleports the specified player to you (command `/tphr \u003cplayer\u003e`).\n\nTo accept a request some sent you, you must use `/tpy`.\\\nThese are the following commands available in-game:\n\n``` /tpr [playername] ```\n\n- **Name:** Teleport Request\n- **Description:** Requests permission to teleport to another player, where [playername] is their exact name.\n- **Required privileges:** `interact, tp`\n- **Example usage:** `/tpr RobbieF` requests permission from RobbieF to teleport to them.\n- **Notes:** Usernames are case-sensitive. If you have the `tp_admin` privilege, you will immediately teleport to the specificed player (does not apply if `enable_immediate_teleport` setting is disabled, enabled by default).\n\n``` /tphr [playername] ```\n\n- **Name:** Teleport Here Request\n- **Description:** Request permission to teleport another player to you.\n- **Required privileges:** `interact, tp`\n- **Example usage:** `/tphr RobbieF` requests RobbieF to teleport to you.\n- **Notes:** Usernames are case-sensitive. If you have the `tp_admin` privilege, RobbieF will teleport to you immediately (does not apply if `enable_immediate_teleport` setting is disabled, enabled by default).\n\n``` /tpc [x,y,z] ```\n\n- **Name:** Teleport to Coordinates\n- **Description:** Teleport to coordinates.\n- **Required privileges:** `interact, tp_tpc, tp`\n- **Notes:** Honors area protection. If the area is protected, it must be owned by you in order to teleport to it, or you must have the `areas` privilege in order to teleport to those coordinates.\n\n``` /tpj [axis] [distance] ```\n\n- **Name:** Teleport Jump\n- **Description:** Teleport a specified distance along a single specified axis.\n- **Required privilege:** `interact\", tp, tp_tpc`\n- **Available options for *axis*:** x, y, z\n- **Example usage:** `/tpj y 10` teleport 10 nodes into the air.\n\n``` /tpe ```\n\n- **Name:** Teleport Evade\n- **Description:** In a sticky situation? Evade your enemy by teleporting to several nearby coordinates in random pattern. There's no knowing where you'll end up.\n- **Required privileges:** `interact, tp_tpc, tp`\n- **Example usage:** `/tpe` teleports you to a random number of random coordinates in an evasive pattern.\n\n``` /tpy ```\n\n- **Description:** Accept a user's request to teleport to you or teleport you to them.\n- **Required privileges:** `interact, tp`\n\n``` /tpn ```\n\n- **Description:** Deny a user's request to teleport to you or teleport you to them.\n- **Required privileges:** `interact, tp`\n\n## Configuring the mod\n\nOpen your `minetest.conf` located in your Minetest directory.\\\nSet the values of the settings you'd like to.\n\nAvailable options are:\n\n```conf\ntp.timeout_delay = 60\ntp.enable_immediate_teleport = true\ntp_enable_tpp_command = false\n```\n\nThose values are the default values of the mod.\\\nYou can also go to your Minetest, Settings tab, All settings, Mods, and you'll find `tpr` there.\\\nOr another way to do it, is changing the values in `settingtypes.txt`.\n\n## TODO\n\n- Add limitations to /tpc which only allow a user to teleport X number of blocks. Prevents users from teleporting to the edge of the world.\n- Assess value in changing all tpr-based chat commands to one global command such as /tp to reduce the chance of confusion between tps_admin and the original mod (and also make it so people don't have to remember so many commands).\n- Rewrite to place all chat commands into one single command much like how /teleport works.\n- Make evade respect land: no teleporting inside land, but instead make sure player is standing on surface or in water.\n\nIf you think something else should be added to this list, [submit an issue](https://github.com/minetest-mods/teleport-request/issues/new).\n\n## License\n\nSee [`LICENSE.txt`](LICENSE.txt) for full license information and [`AUTHORS.md`](AUTHORS.md) for all the contributors.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminetest-mods%2Fteleport-request","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminetest-mods%2Fteleport-request","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminetest-mods%2Fteleport-request/lists"}