Skip to content

VITTHEO/Better-Homes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

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.

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

Screenshots / In-game images

  • homes player list
Capture d'écran 2026-05-11 103436
  • home editor
Capture d'écran 2026-05-11 103548
  • chat exemple
Capture d'écran 2026-05-11 103833

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

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.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

About

Better Homes is a complete, configurable and professional homes plugin for Bukkit/paper

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages