EasyHomes v1
Home management plugin for PaperMC with teleport delays, cooldowns, and limits 1.8-1.21
EasyHomes
A simple and efficient home management plugin for PaperMC servers (compatible with versions 1.8 to 1.21.10). Allows players to set, teleport to, and manage their homes with features like cooldowns, teleport delays, particle effects, and permission-based limits. Perfect for survival, role-playing, and competitive servers seeking a reliable and customizable home system.
Features
- Home Management: Set, teleport to, and delete homes with intuitive commands. Supports updating existing homes and listing all player homes.
- Teleportation System: Configurable delay (default 3 seconds) with automatic cancellation if the player moves or takes damage. Includes customizable particle effects (e.g., portals, flames) and sound effects (e.g., enderman teleport) for immersive gameplay.
- Title Display: Shows an on-screen countdown title during teleportation (e.g., "Teleporting... 2 seconds remaining"), keeping players engaged and informed.
- Cooldowns: Prevents command spamming with configurable cooldowns (default 60 seconds), adjustable per permission group (e.g., VIP players get shorter cooldowns).
- Combat Protection: Blocks teleportation during active combat (default 10 seconds after taking damage) to maintain fair PvP balance.
- Permission-Based Limits: Flexible home limits via permissions (e.g., easyhomes.limit.3 for 3 homes) or config file overrides. Supports unlimited homes for premium players.
- Tab Completion: Auto-suggests home names when typing commands, improving user experience and reducing errors.
- Admin Commands: Includes /easyhomes reload for admins to update configuration without server restarts.
- Multi-Version Support: Fully compatible with PaperMC 1.8.8 to 1.21.10, using backward-compatible APIs for broad server support.
- Lightweight & Optimized: Minimal server impact with efficient data storage and asynchronous operations.
Installation
- Download the latest easyhomes.jar from the Releases page.
- Place the JAR file in your server's plugins/ directory.
- Restart or reload your server.
- Configure the plugin in config.yml (see Configuration section below).
- Players can immediately start using commands – no additional setup required!
Commands
| /home [name] | Teleport to a home (or list all homes if no name provided) | easyhomes.home |
| /sethome <name> | Set a new home at your current location | easyhomes.sethome |
| /delhome <name> | Delete an existing home | easyhomes.delhome |
| /easyhomes reload | Reload the plugin configuration (admin only) | easyhomes.reload |
Aliases
- /h for /home
Permissions
| easyhomes.home | Use /home command | true |
| easyhomes.sethome | Use /sethome command | true |
| easyhomes.delhome | Use /delhome command | true |
| easyhomes.reload | Use /easyhomes reload | op |
| easyhomes.bypass.cooldown | Bypass teleport cooldowns | op |
| easyhomes.bypass.combat | Bypass combat restrictions | op |
| Custom limits (see config) | Set home limits (e.g., easyhomes.limit.5 for 5 homes) | varies |
Configuration
EasyHomes is highly customizable via config.yml. Key options include:
- Teleport Settings: Delay duration, particle types (e.g., PORTAL, FLAME), sound effects, and title messages.
- Cooldowns: Default cooldown and group-specific overrides (e.g., VIP: 30 seconds).
- Combat: Enable/disable protection and duration.
- Homes: Default limit and permission-based limits (e.g., unlimited for easyhomes.unlimited).
- Messages: All in-game messages are editable for customization or localization.
Example config snippet:
teleport:
delay: 3
particles:
enabled: true
type: "PORTAL"
cooldowns:
default: 60
homes:
default-limit: 1
limits:
- permission: "easyhomes.limit.3"
limit: 3
After changes, use /easyhomes reload to apply without restarting.
Examples
- Setting a Home: Player types /sethome mybase and receives confirmation.
- Teleporting: /home mybase shows a title countdown and teleports with portal particles.
- Combat Block: During PvP, teleport is blocked with a warning message.
- Admin Reload: Admin uses /easyhomes reload to update config instantly.
Requirements
- Server: PaperMC 1.8.8 or higher (recommended for best performance).
- Java: Version 8 or higher.
- Dependencies: None – standalone plugin using Paper API.
Compatibility
Tested on PaperMC 1.8.8 to 1.21.3. Compatible with Spigot/Bukkit using Paper API. Not tested on other platforms like Fabric or Forge.
Why Choose EasyHomes?
EasyHomes offers the perfect balance of simplicity and power. Unlike bloated plugins, it focuses on essential features with high customization. Ideal for small communities or large servers, it enhances player retention with smooth home management. Open-source on GitHub for transparency and community improvements.
Got questions? Join our Discord! https://discord.gg/3HqmtaRSrF
