Better Homes 1.1.1 improves support for modern Java and Bedrock clients. GUI menus now include visible item headers, a direct **Public Homes** button, and hide technical item data where the server supports it. Safe teleportation now provides `strict`, `normal`, and `relaxed` levels; the default `normal` level works better for underground bases while avoiding dangerous and air/void floors.

# 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**