# QuickHearth<\/p>\n
A new take on homes and tpa teleports! QuickHearth is a server-side homes and teleport mod for Minecraft 26.1.x Fabric. This will allow server players to save spots (as a home), return to them with a click, share teleports with friends, and snap back to spawn. Designed for survival servers that want a friendlier GUI than larger teleport command bundles, with rank-aware home limits that scale as players progress. LuckPerms friendly! <\/p>\n
<\/p>\n
Works on dedicated servers and in single-player worlds. Vanilla clients connecting to a dedicated server need nothing extra installed.<\/p>\n
This mod also uses SGUI by Patbox. This is already pre-bundled. <\/p>\n
## What it adds<\/p>\n
– A chest-style home picker GUI. Run `\/home` and click a slot to teleport. Shift-click a slot to delete the home.
\n– Custom icons for each home. Whatever you hold when running `\/sethome` becomes that home’s slot icon. Use a custom-named banner with patterns, a player head, a flower, or anything else to label your homes visually.
\n
\n– `\/spawn` for instant return to world spawn.
\n– `\/tpa`, `\/tpahere` (alias `\/tpr`), `\/tpaccept`, `\/tpdeny`, and `\/tpatoggle` for teleport requests between players.
\n– Rank-aware home limits. Admins give different ranks different home counts via LuckPerms and grant individual bonus homes as rewards via a vanilla scoreboard objective. The two layers stack.<\/p>\n
## Commands<\/p>\n
### Homes<\/p>\n
`\/sethome` saves your current location as “home” (the default name).<\/p>\n
`\/sethome The item in your main hand when you run `\/sethome` becomes that home’s slot icon in the picker. Empty hand falls back to a plain white banner. Re-running `\/sethome` with the same name overwrites both the location and the icon.<\/p>\n `\/home` opens the home picker, a 27-slot chest GUI showing all your homes. Click a slot to teleport. Shift-click to delete.<\/p>\n `\/home `\/home help` prints the command list in chat.<\/p>\n `\/homes` is the same as `\/home` (opens the picker).<\/p>\n `\/delhome ### Spawn<\/p>\n `\/spawn` teleports you to world spawn.<\/p>\n ### Teleport requests<\/p>\n `\/tpa `\/tpahere `\/tpaccept` accepts the most recent pending request directed at you.<\/p>\n `\/tpdeny` declines it.<\/p>\n `\/tpatoggle` blocks incoming teleport requests until you toggle it back on. Persists across server restarts.<\/p>\n Pending requests expire automatically after 60 seconds.<\/p>\n ## Teleport behavior<\/p>\n All teleports share these rules:<\/p>\n – 3-second warmup. Countdown appears in chat. Moving cancels the teleport. ## Home limits<\/p>\n A player’s maximum number of homes is calculated as:<\/p>\n `max_homes = LuckPerms meta “homes-max” + scoreboard “homes_bonus”`<\/p>\n The two layers are independent. Rank changes do not reset bonus grants, and bonus grants do not depend on LuckPerms at all.<\/p>\n ### Setting up LuckPerms ranks (optional)<\/p>\n Install LuckPerms-Fabric in your `mods\/` folder, then set the home count per group:<\/p>\n “` Or per individual user, to override their group:<\/p>\n “` If LuckPerms is not installed, or no `homes-max` value is set, the rank base falls back to 1.<\/p>\n ### Granting bonus homes (no LuckPerms required)<\/p>\n QuickHearth auto-creates a dummy scoreboard objective named `homes_bonus` on first server start. Admins grant extra homes per player using the vanilla scoreboard command:<\/p>\n “` The scoreboard value is added to the rank base. So a member (rank base 3) with `homes_bonus = 2` can save up to 5 homes.<\/p>\n ### Worked example<\/p>\n | Player | Rank | LP `homes-max` | `homes_bonus` | Total | The picker GUI title shows usage as `Homes (used\/max)` so players can see at a glance how many slots they have left.<\/p>\n ## Permission nodes<\/p>\n Every command is allowed by default. To restrict a command for a group, set its node to false in LuckPerms.<\/p>\n – `quickhearth.command.home` Example, to revoke `\/tpa` from the default group:<\/p>\n “` If LuckPerms is not installed, permission gating falls back to vanilla OP level checks.<\/p>\n","protected":false},"excerpt":{"rendered":" QuickHearth is a server side homes GUI that allows your players to set homes and to request to teleport to others, or request others to teleport to them. This reworks \/spawn \/home \/homes \/tpa and \/tpr<\/p>\n","protected":false},"featured_media":127860,"template":"","meta":{"_minecraft_slug":"quickhearth","_minecraft_project_id":"uHKsq2pr","_minecraft_author":"nickisashkir","_minecraft_license":"MIT","_minecraft_downloads":17,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"quickhearth.zip","_minecraft_size_bytes":152599,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T14:09:02.882745Z","_minecraft_date_created":"2026-05-02T22:45:47.298329Z","_minecraft_date_modified":"2026-04-27T01:52:28.422649Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/quickhearth","_minecraft_icon_attachment_id":127860,"_minecraft_imported_at":"2026-06-07T12:35:11+00:00","_minecraft_import_hash":"c1a8b95378c22be037ca546688a79e1d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,89,869],"mod_loader":[99],"minecraft_version":[83,167,163],"class_list":["post-127859","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-game-mechanics","mod_category-transportation","mod_loader-fabric","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– 30-second cooldown after a successful teleport before another can start.
\n– Only one teleport can be queued at a time.<\/p>\n
\n\/lp group default meta set homes-max 2
\n\/lp group member meta set homes-max 3
\n\/lp group veteran meta set homes-max 5
\n“`<\/p>\n
\n\/lp user Steve meta set homes-max 4
\n“`<\/p>\n
\n\/scoreboard players add Steve homes_bonus 2
\n\/scoreboard players set Steve homes_bonus 5
\n\/scoreboard players reset Steve homes_bonus
\n“`<\/p>\n
\n|—|—|—|—|—|
\n| Alice | newcomer | 2 | 0 | 2 |
\n| Bob | member | 3 | 1 (event prize) | 4 |
\n| Carol | veteran | 5 | 2 (gifted) | 7 |
\n| Dave | (no LP) | 1 (default) | 3 (granted) | 4 |<\/p>\n
\n– `quickhearth.command.sethome`
\n– `quickhearth.command.delhome`
\n– `quickhearth.command.homes`
\n– `quickhearth.command.spawn`
\n– `quickhearth.command.tpa`
\n– `quickhearth.command.tpahere` (covers `\/tpr` too)
\n– `quickhearth.command.tpaccept`
\n– `quickhearth.command.tpdeny`
\n– `quickhearth.command.tpatoggle`<\/p>\n
\n\/lp group default permission set quickhearth.command.tpa false
\n“`<\/p>\n