QuickHearth

QuickHearth

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!

Works on dedicated servers and in single-player worlds. Vanilla clients connecting to a dedicated server need nothing extra installed.

This mod also uses SGUI by Patbox. This is already pre-bundled.

What it adds

• A chest-style home picker GUI. Run /home and click a slot to teleport. Shift-click a slot to delete the home.
• 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.

• /spawn for instant return to world spawn.
• /tpa, /tpahere (alias /tpr), /tpaccept, /tpdeny, and /tpatoggle for teleport requests between players.
• 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.

Commands

Homes

/sethome saves your current location as “home” (the default name).

/sethome <name> saves with a custom name like “basecamp” or “iron-farm”. Names accept letters, numbers, underscores, and hyphens, up to 24 characters.

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.

/home opens the home picker, a 27-slot chest GUI showing all your homes. Click a slot to teleport. Shift-click to delete.

/home <name> teleports directly to a home, with tab-completion.

/home help prints the command list in chat.

/homes is the same as /home (opens the picker).

/delhome <name> deletes a home, with tab-completion.

Spawn

/spawn teleports you to world spawn.

Teleport requests

/tpa <player> asks the target if you can teleport to them. They see a chat prompt to /tpaccept or /tpdeny.

/tpahere <player> (alias /tpr) asks the target to teleport to you instead.

/tpaccept accepts the most recent pending request directed at you.

/tpdeny declines it.

/tpatoggle blocks incoming teleport requests until you toggle it back on. Persists across server restarts.

Pending requests expire automatically after 60 seconds.

Teleport behavior

All teleports share these rules:

• 3-second warmup. Countdown appears in chat. Moving cancels the teleport.
• 30-second cooldown after a successful teleport before another can start.
• Only one teleport can be queued at a time.

Home limits

A player’s maximum number of homes is calculated as:

max_homes = LuckPerms meta "homes-max" + scoreboard "homes_bonus"

The two layers are independent. Rank changes do not reset bonus grants, and bonus grants do not depend on LuckPerms at all.

Setting up LuckPerms ranks (optional)

Install LuckPerms-Fabric in your mods/ folder, then set the home count per group:

/lp group default meta set homes-max 2
/lp group member meta set homes-max 3
/lp group veteran meta set homes-max 5

Or per individual user, to override their group:

/lp user Steve meta set homes-max 4

If LuckPerms is not installed, or no homes-max value is set, the rank base falls back to 1.

Granting bonus homes (no LuckPerms required)

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:

/scoreboard players add Steve homes_bonus 2
/scoreboard players set Steve homes_bonus 5
/scoreboard players reset Steve homes_bonus

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.

Worked example

| Player | Rank | LP homes-max | homes_bonus | Total |
|—|—|—|—|—|
| Alice | newcomer | 2 | 0 | 2 |
| Bob | member | 3 | 1 (event prize) | 4 |
| Carol | veteran | 5 | 2 (gifted) | 7 |
| Dave | (no LP) | 1 (default) | 3 (granted) | 4 |

The picker GUI title shows usage as Homes (used/max) so players can see at a glance how many slots they have left.

Permission nodes

Every command is allowed by default. To restrict a command for a group, set its node to false in LuckPerms.

• quickhearth.command.home
• quickhearth.command.sethome
• quickhearth.command.delhome
• quickhearth.command.homes
• quickhearth.command.spawn
• quickhearth.command.tpa
• quickhearth.command.tpahere (covers /tpr too)
• quickhearth.command.tpaccept
• quickhearth.command.tpdeny
• quickhearth.command.tpatoggle

Example, to revoke /tpa from the default group:

/lp group default permission set quickhearth.command.tpa false

If LuckPerms is not installed, permission gating falls back to vanilla OP level checks.