ozHomes

A modern, high-performance homes plugin for Paper and Purpur 1.21+. Featuring classic inventory GUIs, native Minecraft dialogue interfaces, customizable home icons, flexible player limits, asynchronous storage, and seamless LuckPerms integration.

✨ Features

🏠 Modern Home Management

• Create, teleport to, rename, relocate, and delete homes with ease.
• Choose between classic inventory menus and native Minecraft dialogue interfaces.
• Customize home icons with all 16 Minecraft bed colors.
• Confirmation screens to prevent accidental home deletion.
• Support for named homes and slot-based navigation.

🎨 Customizable Interfaces

• Clean, paginated inventory menus with configurable borders and indicators.
• Native Minecraft dialogue menus with interactive buttons and home grids.
• Customizable messages and visual elements using Adventure MiniMessage.
• Clear indicators for available, occupied, and locked home slots.

🚀 Teleportation System

• Instant teleports or configurable warmup delays.
• Animated BossBars, ActionBars, particles, and sound effects.
• Configurable cancellation on movement or damage.
• Customizable cooldowns and teleport restrictions.

🔐 Flexible Home Limits

• Configure home limits up to 90 homes per player.
• Support for LuckPerms metadata-based limits.
• Permission-based home limits for different ranks.
• Separate permissions for cooldown, movement, and world restriction bypasses.

⚡ Performance & Storage

• Asynchronous database operations to minimize main-thread workload.
• SQLite storage for local setups.
• MySQL support for networked servers.
• HikariCP connection pooling for efficient database management.
• Automated backups with configurable intervals and compression.
• Administrative backup and restore utilities.

🔌 Integrations & Developer Support

• PlaceholderAPI support for displaying home information.
• LuckPerms integration for rank-based home progression.
• Administrative tools for inspecting and managing player homes.
• Support for managing homes belonging to online and offline players.
• Developer API with asynchronous CompletableFuture endpoints.

⌨️ Commands

Command	Description
/home [name|slot]	Teleport to a home or open the home menu
/sethome [name]	Create a home
/delhome [name|slot]	Delete a home
/homes	Open the homes interface
/homes reload	Reload configuration files and messages
/homes admin <player>	Manage another player's homes
/ozhomes backup	Create a backup

🔑 Permissions

Permission	Description
ozhomes.use	Access basic home commands
ozhomes.homes.<1-90>	Set a numerical home limit
ozhomes.homes.*	Access all configured home slots
ozhomes.admin	Access administrative tools
ozhomes.reload	Reload plugin configurations
ozhomes.bypass.cooldown	Bypass teleport warmup delays
ozhomes.bypass.movement	Bypass movement cancellation
ozhomes.bypass.world	Bypass disabled-world restrictions

🧩 Placeholders

PlaceholderAPI integration provides home-related placeholders, including:

• %ozhomes_count% — Current number of homes.
• %ozhomes_max% — Maximum homes available.
• %ozhomes_list% — List of the player's homes.

📦 Requirements & Compatibility

• Server software: Paper / Purpur
• Minecraft version: 1.21+
• Java: 21
• PlaceholderAPI: Optional
• LuckPerms: Optional

⚙️ Configuration

Customize home limits, teleport settings, interface styles, messages, database connections, backup schedules, and other plugin options to suit your server.

ozHomes — Simple home management, powerful customization, and performance-focused design.