Better Homes

Better Homes is a complete, configurable and professional homes plugin for Bukkit, Spigot and Paper servers.

Created by Vit Theo, Better Homes gives players a clean home system with commands, GUI menus, teleport safety, cooldowns, permissions, public/shared homes and a solid YAML storage backend.

Version 1.1.0

Better Homes 1.1.0 adds a dedicated, paginated public homes GUI. Players can run /homeplayer <player> to browse a particular player's public homes, or /homeplayer to browse every public home they can access. The new permissions betterhomes.publichomes and betterhomes.version are enabled by default. /betterhomes:version displays the installed version and official project pages.

Highlights

• Complete homes system with named homes
• Modern inventory GUI with pagination
• Safe teleport checks
• Teleport delay and cooldown
• Cancel teleport on movement, damage or combat
• Configurable home limits
• Per-world home support
• Public and shared homes
• Admin commands for player home management
• Fully configurable messages
• Configurable GUI items, titles, sounds and effects
• YAML storage by default
• Clean architecture ready for future SQLite/MySQL support
• Built for broad Bukkit/Spigot/Paper compatibility

Player Commands

Command	Description
/sethome [name]	Create a home at your current location
/home [name]	Teleport to one of your homes
/home <player>:<name>	Teleport to a public/shared home
/delhome [name]	Delete one of your homes
/homes [page]	List homes and open the GUI
/homeplayer [player]	Open public homes for one player, or all players when omitted
/betterhomes:version	Display plugin version and official links

Admin Commands

Command	Description
/betterhomes reload	Reload configuration and messages
/betterhomes info	Display plugin information
/betterhomes sethomeplayer <player> <name>	Create a home for another player
/betterhomes delhomeplayer <player> <name>	Delete a player's home
/betterhomes listhomes <player>	List a player's homes
/betterhomes clearhomes <player>	Clear all homes of a player
/betterhomes givehome <player> <name>	Create a home for a player from your position
/betterhomes rename <old> <new>	Rename one of your homes
/betterhomes move <name>	Move a home to your current position
/betterhomes share <home> <player>	Share a home with a player
/betterhomes unshare <home> <player>	Remove shared access
/betterhomes public <home> <on/off>	Toggle public access

Permissions

Permission	Description
betterhomes.use	Allows basic plugin usage
betterhomes.sethome	Allows /sethome
betterhomes.home	Allows /home
betterhomes.delhome	Allows /delhome
betterhomes.gui	Allows GUI usage
betterhomes.publichomes	Allows /homeplayer and the public homes GUI
betterhomes.version	Allows /betterhomes:version
betterhomes.bypass.cooldown	Bypasses teleport cooldown
betterhomes.bypass.limit	Bypasses home limits
betterhomes.admin	Grants admin permissions
betterhomes.reload	Allows /betterhomes reload
betterhomes.others	Allows managing other players' homes
betterhomes.rename	Allows renaming homes
betterhomes.list	Allows listing homes
betterhomes.teleport.instant	Bypasses teleport delay
betterhomes.teleport.safely	Allows safe teleport adjustment
betterhomes.world.<worldname>	Allows homes in a specific world
betterhomes.limit.<number>	Gives a custom home limit

GUI Features

Better Homes includes a clean inventory interface designed for regular server use:

• Main homes menu
• Page selector menu
• Home edit menu
• Delete confirmation menu
• Buttons for teleport, move, rename, public toggle and delete
• Configurable icons and item lore
• Configurable rows, titles, sounds and filler items
• Pagination for players with many homes

Teleport Safety

The teleport system is designed to prevent common home-related issues:

• Configurable warmup delay
• Configurable cooldown
• Movement cancellation
• Damage cancellation
• Combat cancellation
• Safe destination search
• Block danger checks for lava, fire, cactus and similar hazards
• World whitelist/blacklist support
• Optional per-world permission checks

Storage

Better Homes uses YAML storage by default. Player homes are saved automatically and loaded on startup.

The internal storage layer is interface-based, making it easy to add SQLite or MySQL support later without rewriting the home system.

Configuration

The plugin generates:

• config.yml
• messages.yml
• homes.yml

You can configure:

• Home limits
• Teleport delay
• Teleport cooldown
• Safe teleport behavior
• GUI layout
• GUI icons
• Sounds
• Effects
• Messages
• Allowed or blocked worlds
• Shared/public home behavior
• Command behavior

Compatibility

Better Homes is compiled against the Bukkit 1.8.8 API and avoids direct usage of modern-only API calls.

Material, sound, title and effect handling uses compatibility helpers and fallback names, which makes the plugin suitable for a wide range of Bukkit, Spigot and Paper versions.

Installation

1. Download BetterHomes.jar.
2. Put it in your server's plugins folder.
3. Restart your server.
4. Edit plugins/BetterHomes/config.yml and messages.yml.
5. Run /betterhomes reload or restart the server again.

Why Better Homes?

Better Homes is built for server owners who want more than a basic /home command. It provides a complete home management experience with a professional structure, strong configuration options and a user-friendly GUI.

It is lightweight, dependency-free and designed to stay stable on active servers.

Support

If you need help, find a bug or want to suggest a feature, contact the author or open a discussion on the resource page.

Author

Vit Theo