Haven
Haven is a homes plugin for Paper. Players can save locations, find them in a clickable list, and teleport back later. It works with the default settings, and server owners can adjust home limits, teleport timing, messages, and sounds.
Features
- Named homes with limits set through permissions
- A home list grouped by world. Click a name to teleport
- An optional teleport warmup that can cancel when a player changes block or takes damage
- An optional cooldown applied only after a successful teleport
- Confirmation before replacing an existing home
- Home name tab completion
Commands
| Command | Alias | Description |
|---|---|---|
/sethome [name] |
Save a home at your location. The default name is home |
|
/home [name] |
Teleport to a home | |
/delhome <name> |
/removehome |
Delete a home |
/homes |
/listhomes |
List your homes |
/haven reload |
Reload the config and messages |
Permissions
The player commands are available to everyone by default.
| Permission | Default | Purpose |
|---|---|---|
haven.home |
Everyone | Use /home |
haven.sethome |
Everyone | Use /sethome |
haven.delhome |
Everyone | Use /delhome |
haven.homes |
Everyone | Use /homes |
haven.homes.<n> |
Not set | Set a home limit of <n> |
haven.homes.unlimited |
Operators | Remove the home limit |
haven.bypass.warmup |
Operators | Skip the teleport warmup |
haven.bypass.cooldown |
Operators | Skip the teleport cooldown |
haven.admin.reload |
Operators | Use /haven reload |
For example, grant haven.homes.5 to one rank and haven.homes.10 to another. If a player has more than one limit permission, the highest limit applies. Lowering a limit does not delete existing homes.
Configuration
Use config.yml to set home limits, teleport timing, and sounds. Each option is explained in the file. You can replace individual sounds, use sounds from a resource pack, or turn sounds off.
Haven’s home and teleport messages use MiniMessage and can be edited in messages.yml. Run /haven reload to apply changes to both files.
PlaceholderAPI
PlaceholderAPI is optional. These placeholders work while the player is online:
| Placeholder | Value |
|---|---|
%haven_homes_used% |
Number of saved homes |
%haven_homes_max% |
Home limit |
%haven_homes_free% |
Remaining home slots |
%haven_homes_list% |
Saved home names |
Use a PlaceholderAPI build compatible with your Paper version.
Requirements
Haven supports Paper 1.18.2 through 26.3. Use Java 17 for Paper 1.18 and 1.19, Java 21 for 1.20 and 1.21, and Java 25 for 26.x.
Storage and metrics
Homes are stored in one YAML file per player. Stop the server before editing these files by hand.
Haven uses bStats for anonymous usage statistics. You can disable bStats in plugins/bStats/config.yml.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Haven v1.2.0 1.2.0 |
1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
paper
|
Download |
|
Haven v1.1.0 1.1.0 |
1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
paper
|
Download |
|
Haven v1.0.0 1.0.0 |
1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
|
paper
|
Download |