# TeleHome<\/p>\n
A lightweight **Paper\/Spigot plugin** for Minecraft that lets players save their favorite locations and teleport back to them instantly \u2014 or with a configurable countdown delay.<\/p>\n
Built for **Paper 1.21+ and 26.2.1** on **Java 21**.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \ud83c\udfe0 **Set unlimited named homes** \u2014 `\/sethome castle`, `\/sethome mine`, `\/sethome farm`…
\n– \u26a1 **Teleport back anytime** \u2014 `\/home castle` returns you with exact position, facing direction, and pitch.
\n– \ud83d\udcbe **Persistent storage** \u2014 homes are saved per-player (by UUID) and survive restarts, name changes, and world reloads.
\n– \u23f1 **Configurable teleport delay** \u2014 instant or countdown teleport (e.g. 3 seconds).
\n– \ud83d\udeb6 **Move-to-cancel** \u2014 optionally cancel teleport if the player moves during the countdown.
\n– \ud83c\udf0d **Multi-world support** \u2014 homes remember which world they belong to.
\n– \ud83c\udfa8 **Fully customizable messages** via `config.yml`.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
Drop it into your server’s `plugins\/` folder.
\n Start (or restart) your server.
\n Configuration is generated at `plugins\/TeleHome\/config.yml`.<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
\/sethome \/home Home name rules: letters, numbers, underscores, and dashes. Max 32 characters.<\/p>\n —<\/p>\n \ud83d\udd10 Permissions<\/p>\n Permission – Default Setting – Description<\/p>\n telehome.sethome – true – Allows players to set homes —<\/p>\n \u2699\ufe0f Configuration<\/p>\n “`Delay in seconds before the player is teleported after using \/home. If true, the teleport will be cancelled if the player moves during the delay. Messages (supports legacy & color codes) \/home \/delhome \/listhome Shared \ud83d\udcbe Data Storage<\/p>\n Homes are stored in plugins\/TeleHome\/homes.yml, keyed by player UUID:<\/p>\n e5f1d2a7-…-…: Because UUIDs are used instead of usernames, homes persist through Mojang name changes.<\/p>\n —<\/p>\n \ud83e\uddea Tested On<\/p>\n Paper 1.21+, 26.2.1 —<\/p>\n \ud83d\uddfa Roadmap<\/p>\n Planned features for future releases:<\/p>\n [X] \/delhome Got a suggestion? Open an issue!<\/p>\n —<\/p>\n \ud83d\udc1b Issues & Contributions<\/p>\n Bugs \/ feature requests: open an issue —<\/p>\n \ud83d\udcc4 License<\/p>\n This project is licensed under the MIT License \u2014 see the LICENSE file for details.<\/p>\n —<\/p>\n \u2764\ufe0f Credits<\/p>\n Built with Paper API.<\/p>\n","protected":false},"excerpt":{"rendered":" A lightweight Paper\/Spigot plugin that lets players save and teleport to personal homes with \/sethome and \/home. Supports configurable teleport delay, move-cancel, and persistent storage across restarts.<\/p>\n","protected":false},"featured_media":152785,"template":"","meta":{"_minecraft_slug":"telehome","_minecraft_project_id":"DaJ48hXV","_minecraft_author":"ripsnortntear","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":4,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"telehome.zip","_minecraft_size_bytes":18835,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:21:53.588464Z","_minecraft_date_created":"2026-05-03T04:34:58.115211Z","_minecraft_date_modified":"2026-04-25T13:04:52.410259Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/telehome","_minecraft_icon_attachment_id":152785,"_minecraft_imported_at":"2026-06-09T05:54:14+00:00","_minecraft_import_hash":"2d16046ba8a0f9fb115e703521169fc5","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,869,92],"mod_loader":[130,132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-152784","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n Set a home at your current location
\n telehome.sethome<\/p>\n
\n Teleport to one of your homes
\n telehome.home<\/p>\n
\n telehome.home – true – Allows players to teleport to homes<\/p>\n
\nSet to 0 for instant teleport.
\n teleport-delay-seconds: 3<\/p>\n
\n cancel-on-move: true<\/p>\n
\n messages:
\n home-set: “&aHome ‘&e%name%&a’ has been set!”
\n home-not-found: “&cNo home found with the name ‘&e%name%&c’.”
\n teleporting: “&aTeleporting to ‘&e%name%&a’ in &e%seconds% &aseconds. Don’t move!”
\n teleported: “&aTeleported to ‘&e%name%&a’!”
\n teleport-cancelled: “&cTeleport cancelled because you moved!”
\n world-missing: “&cThe world for that home no longer exists.”
\n usage-sethome: “&cUsage: \/sethome
\n usage-home: “&cUsage: \/home
\n players-only: “&cOnly players can use this command.”<\/p>\n
\n teleporting: “&aTeleporting to ‘&e%name%&a’ in &e%seconds% &aseconds. Don’t move!”
\n teleported: “&aTeleported to ‘&e%name%&a’!”
\n teleport-cancelled: “&cTeleport cancelled because you moved!”
\n usage-home: “&cUsage: \/home
\n home-deleted: “&aHome ‘&e%name%&a’ has been deleted.”
\n usage-delhome: “&cUsage: \/delhome
\n no-homes: “&eYou have no homes set. Use &f\/sethome
\n list-header: “&6— Your Homes (&e%count%&6) —”
\n list-entry: “&7- &e%name% &7(&f%world%&7 @ &f%x%&7, &f%y%&7, &f%z%&7)”
\n list-footer: “&7Use &f\/home
\n home-not-found: “&cNo home found with the name ‘&e%name%&c’.”
\n world-missing: “&cThe world for that home no longer exists.”
\n players-only: “&cOnly players can use this command.”
\n“`
\n—<\/p>\n
\n castle:
\n world: world
\n x: 123.5
\n y: 64.0
\n z: -452.3
\n yaw: 90.0
\n pitch: 0.0<\/p>\n
\n Java 21<\/p>\n
\n [X] \/listhomes \u2014 list your homes
\n [X] Tab completion for home names
\n [ ] Per-rank home limits (permission-based)
\n [ ] Teleport cooldowns
\n [ ] Cross-world teleport toggle
\n [ ] Optional cost system (economy integration)
\n [ ] Bed\/respawn-home integration<\/p>\n
\n Pull requests: welcome! Please target the main branch and describe your changes clearly.<\/p>\n