ChorusHome

ChorusHome

Safe, fast and fully customizable homes for Paper 26.2.

ChorusHome gives your players multiple named homes with rank-based limits, public homes, clickable lists and safe teleportation. Every message is editable and supports hex colors, so it fits the look of your server in seconds. No dependencies, no database, no setup headaches.

Features

• Multiple named homes per player with limits per rank (chorushome.limit.)
• Public homes that other players can visit with /home :
• Clickable /homes list with hover tooltips
• Teleport delay with action bar countdown, cooldown, cancel on move and cancel on damage
• Safe teleport: finds a nearby safe spot instead of dropping players into lava, void or walls
• Every message is editable in messages.yml, with hex colors (&#c084fc, #c084fc, short #ecc), legacy & codes and MiniMessage gradients
• Configurable sounds, disabled worlds, name length and default home name
• Admin tools to list, teleport to and delete homes of any player, even offline ones
• Tab completion for every command
• Lightweight, no dependencies, safe asynchronous saving with automatic backup
• Missing config and message keys are added automatically after updates

Commands

Command · Description · Permission
/sethome [name] · Set a home (or move an existing one) · chorushome.sethome
/home [name] · Teleport to a home · chorushome.home
/home : · Teleport to a public home · chorushome.home.public
/delhome · Delete a home · chorushome.delhome
/homes · List your homes · chorushome.homes
/renamehome · Rename a home · chorushome.rename
/publichome [on\ · off] · Make a home public or private · chorushome.public
/chorushome help · Show the help · none
/chorushome reload · Reload config and messages · chorushome.admin.reload
/chorushome list · List the homes of a player · chorushome.admin.list
/chorushome tp · Teleport to any home instantly · chorushome.admin.teleport
/chorushome delete · Delete a home of a player · chorushome.admin.delete

Aliases: /removehome, /rmhome, /listhomes, /homerename, /sharehome, /chome

Permissions

Permission · Default · Description
chorushome.sethome · everyone · Use /sethome
chorushome.home · everyone · Use /home
chorushome.home.public · everyone · Visit public homes of other players
chorushome.delhome · everyone · Use /delhome
chorushome.homes · everyone · Use /homes
chorushome.rename · everyone · Use /renamehome
chorushome.public · everyone · Use /publichome
chorushome.limit. · none · Home limit, for example chorushome.limit.10. The highest value wins
chorushome.limit.unlimited · op · No home limit
chorushome.bypass.cooldown · op · Ignore the teleport cooldown
chorushome.bypass.delay · op · Ignore the teleport delay
chorushome.bypass.limit · op · Ignore the home limit
chorushome.bypass.world · op · Use homes in disabled worlds
chorushome.admin · op · All admin commands
chorushome.* · op · Everything

Configuration

settings:
default-home-name: home
max-name-length: 16
allow-overwrite: true
limits:
default: 3
disabled-worlds: []
teleport:
delay: 3
cooldown: 10
cancel-on-move: true
move-tolerance: 0.5
cancel-on-damage: true
safe-teleport:
enabled: true
radius: 3
teleport-anyway: false
sounds:
enabled: true
set-home: entity.experience_orb.pickup
teleport: entity.enderman.teleport
countdown: block.note_block.hat
cancel: block.note_block.bass

Set delay or cooldown to 0 to disable them. Set any sound to an empty value to mute it. Home names can contain letters, numbers, - and _.

Messages and colors

Every message lives in messages.yml. You can use:

• Hex colors: &#c084fc, #c084fc or the short form #ecc
• Legacy codes: &l, &o, &r and the classic &0-&f
• MiniMessage tags such as text
• Placeholders written as {home}, {count}, {limit}, {seconds}, {player}, {world}, {x}, {y}, {z}, {old}, {new} and {prefix}

Set a message to an empty string to hide it. Use /chorushome reload to apply changes without restarting.

Built to avoid the usual problems

• Homes inside lava, walls or the void are never used: players are moved to the closest safe spot
• Chunks are loaded before teleporting, so players never fall through the world
• Home names are case-insensitive, so Base and base can never clash
• Homes keep working if a world is renamed, and give a clear message if a world is missing
• Data is written atomically with a backup file, so a crash cannot wipe your homes
• Teleport delay cannot be abused: moving, taking damage, logging out or double commands cancel or block the warm-up
• Admins can manage homes of offline players

Installation

1. Download ChorusHome-1.0.0.jar and put it in your plugins folder.
2. Start the server once to generate config.yml and messages.yml.
3. Adjust the files to your liking and run /chorushome reload.

Requirements

• Paper 26.2 (or a compatible fork) and Java 25
• Folia is not supported

Support

Found a bug or have a suggestion? Open an issue on the project page and include your server version and the relevant part of the console.

Made by Controll3r24.