BlockHome

Features

• Multiple named homes. Players set homes like /sethome base and /sethome farm, then teleport with /home farm. Tab-completion works for home names.
• Rank-based home limits. Give each rank a different number of homes with a LuckPerms node like blockhome.limit.10. Players with no limit node get the default from the config (3).
• TPA system. Players can ask to teleport to someone (/tpa) or ask someone to come to them (/tpahere). The other player accepts or denies, and requests expire after 60 seconds by default.
• /back. Returns players to where they were before their last teleport, or to their death point.
• Warmup and cooldown. A configurable countdown (default 3 seconds) cancels if the player moves or takes damage. A configurable cooldown (default 5 seconds) stops teleport spam. Both can be bypassed by permission.
• Fully customizable messages. Every message, colour and prefix is editable in config.yml.
• Lightweight and safe. Homes are stored per player UUID in a simple homes.yml, so name changes don't lose homes. Pending requests, cooldowns and warmups are cleaned up when a player logs out.

Commands
Command Aliases Description Permission
/sethome [name] Saves a home at your location (default name home). Reusing a name overwrites it. blockhome.sethome
/home [name] Teleports you to a home. With no name it uses your only home, or home, or lists your homes. blockhome.home
/delhome <name> Deletes one of your homes. blockhome.delhome
/homes Lists your homes and your limit (e.g. 2/5). blockhome.homes
/tpa <player> Asks to teleport to a player. blockhome.tpa
/tpahere <player> Asks a player to teleport to you. blockhome.tpahere
/tpaccept /tpyes Accepts the request sent to you. blockhome.tpaccept
/tpdeny /tpno Denies the request sent to you. blockhome.tpaccept
/tpcancel Cancels the request you sent. blockhome.tpa
/back Returns to your previous location or death point. blockhome.back
/blockhome reload Reloads config.yml and homes.yml. blockhome.admin
LuckPerms Permissions
Player permissions (all granted by default):

Node Grants
blockhome.sethome /sethome
blockhome.home /home
blockhome.delhome /delhome
blockhome.homes /homes
blockhome.tpa /tpa and /tpcancel
blockhome.tpahere /tpahere
blockhome.tpaccept /tpaccept and /tpdeny
blockhome.back /back, and saving death locations
Home limits (rank perks):

Node Effect
blockhome.limit.<number> Allows that many homes, from 1 to 100. If a player has several, the highest wins.
blockhome.limit.unlimited No home limit.
Bypass and admin (operators only by default):

Node Effect
blockhome.bypass.warmup Teleports instantly with no countdown.
blockhome.bypass.cooldown No teleport cooldown.
blockhome.admin Allows /blockhome reload.
Example LuckPerms setup:


/lp group default permission set blockhome.limit.3 true
/lp group vip permission set blockhome.limit.8 true
/lp group mvp permission set blockhome.limit.15 true
/lp group vip permission set blockhome.bypass.warmup true
/lp group admin permission set blockhome.limit.unlimited true
/lp group admin permission set blockhome.admin true

# Block a feature for a group:
/lp group default permission set blockhome.tpahere false
Configuration (config.yml)
Setting Default Meaning
default-home-limit 3 Homes for players with no limit permission
teleport-warmup-seconds 3 Countdown before teleporting (0 = instant)
teleport-cooldown-seconds 5 Delay between teleports (0 = none)
cancel-on-move true Cancel the warmup if the player moves
cancel-on-damage true Cancel the warmup if the player takes damage
tpa-timeout-seconds 60 How long a TPA request stays valid
All chat messages are in the same file, so you can translate or restyle them.

Installation

1. Drop BlockHome-1.0.0.jar into your server's plugins folder.
2. Restart the server. A full restart is safer than /reload.
3. Edit plugins/BlockHome/config.yml to taste.
4. Set your rank home limits in LuckPerms.

Notes

• /back locations are kept in memory and reset when the server restarts.
• Homes in a world that no longer exists can't be used until the world is back.