EasyHomes v1.3

The Problem With Basic Home Plugins

You install a home plugin. It works fine for 50 players. Then you grow to 200 players and everything starts lagging. Database queries block the main thread. Players teleport during PvP and abuse combat. There's no economy integration. WorldGuard conflicts break everything.

Your home plugin becomes your performance bottleneck.

Basic home plugins treat homes like a simple feature. But when you run a real server with hundreds of players, active PvP, land claiming, and economy systems, you need professional-grade infrastructure.

Every teleport delay that blocks your main thread is TPS you're losing. Every combat escape through /home is a frustrated PvP player. Every missing economy integration is lost monetization potential.

The Solution: Performance-First Architecture

EasyHomes isn't another simple home plugin. It's a complete teleportation infrastructure system built with enterprise-grade patterns that scale from 10 players to 1000+ players without touching your TPS.

MySQL storage with HikariCP pooling. Guava cache with intelligent TTL. Async operations everywhere. Combat tag system that actually works. Economy integration with distance-based costs. Per-permission limits from 1 to unlimited. WorldGuard compatibility without conflicts.

1. 
   
2. MySQL + Cache Layer - HikariCP connection pooling with Guava cache (5-minute TTL)
   
3. 100% Async Operations - Zero main thread blocking, ever
   
4. Combat Tag System - Configurable duration, blocks teleportation during PvP
   
5. Economy Integration - Vault support with fixed costs, distance pricing, and refund system
   
6. Per-Permission Limits - 1, 3, 5, 10, 15, 25, 50, or unlimited homes
   
7. WorldGuard Integration - Build permission checks, blocked regions, safe zones
   
8. PlaceholderAPI Support - 9 placeholders for scoreboards and chat integration
   
9. Debug System - File logging, performance tracking, command history
   

What Makes This Different

Two-Tier Storage System (Not Just Files)

Most home plugins use YAML and call it a day. EasyHomes uses professional database architecture:

1. 
   
2. MySQL Primary Storage - HikariCP connection pool with 10 connections
   
3. Guava Cache Layer - In-memory cache with 300-second TTL, auto-eviction at 10,000 players
   
4. YAML Fallback - Automatic fallback if MySQL unavailable (zero downtime)
   
5. Async Everything - All database operations run off main thread
   
6. Connection Pooling - Reuses connections, prevents exhaustion
   

Your TPS stays locked at 20 even when 50 players teleport home simultaneously. This is how professional plugins handle scale.

Combat Tag System That Actually Works

Tired of players escaping PvP with /home? EasyHomes includes professional combat tracking:

1. 
   
2. Configurable combat tag duration (default: 10 seconds)
   
3. Blocks ALL teleportation during combat (not just homes)
   
4. Bypass permission for staff (easyhomes.bypass.combat)
   
5. PlaceholderAPI integration shows remaining combat time
   
6. Action bar warnings when trying to teleport during combat
   
7. Works with ANY damage source (PvP, PvE, environmental)
   

No more combat logging. No more PvP abuse. Just fair combat mechanics.

Economy Integration With Distance Pricing

Turn homes into a monetization opportunity with Vault integration:

1. 
   
2. Teleportation Costs - Fixed base cost per teleport (configurable)
   
3. Distance-Based Pricing - Additional cost per block traveled (0.1 per block default)
   
4. Home Creation Costs - Charge players to set new homes (500 default)
   
5. Refund System - Configurable refund percentage when deleting homes (50% default)
   
6. Bypass Permission - VIP/staff can skip costs (easyhomes.bypass.cost)
   

Example: Teleporting 1000 blocks costs base (100) + distance (1000 x 0.1 = 100) = 200 total. This creates economic strategy where home placement matters.

Per-Permission Limit System

Fine-grained control over who gets how many homes:

1. 
   
2. easyhomes.limit.1 - 1 home (default players)
   
3. easyhomes.limit.3 - 3 homes (donors)
   
4. easyhomes.limit.5 - 5 homes (VIP tier 1)
   
5. easyhomes.limit.10 - 10 homes (VIP tier 2)
   
6. easyhomes.limit.15 - 15 homes (VIP tier 3)
   
7. easyhomes.limit.25 - 25 homes (Premium)
   
8. easyhomes.limit.50 - 50 homes (Elite)
   
9. easyhomes.unlimited - Unlimited homes (staff)
   

Create seven monetization tiers with one permission system. Highest permission always takes priority.

Teleport Delay With Visual Feedback

Professional teleportation experience with full customization:

1. 
   
2. Configurable delay (0-60 seconds)
   
3. Cancel on movement (prevent teleport while moving)
   
4. Title and subtitle countdown ("Teleporting... 3 seconds remaining")
   
5. Particle effects at start and destination (PORTAL, FLAME, END_ROD, etc.)
   
6. Sound effects (ENDERMAN_TELEPORT or any Minecraft sound)
   
7. Action bar progress tracking
   

Players see and feel the teleportation happening. Not just instant warps with zero feedback.

WorldGuard Integration Without Conflicts

Unlike basic plugins that break with WorldGuard, EasyHomes cooperates:

1. 
   
2. Build Permission Checks - Verifies player can build before allowing /sethome
   
3. Blocked Regions - Configure regions where homes cannot be set (spawn, pvp_arena, etc.)
   
4. Safe Zone Compatibility - Respects WorldGuard flags
   
5. Auto-Detection - Automatically uses WorldGuard if present, works fine without it
   

No conflicts. No bypass exploits. Just proper integration.

PlaceholderAPI For Scoreboard Integration

Nine placeholders for displaying home data anywhere:

1. 
   
2. %easyhomes_count% - Current home count
   
3. %easyhomes_limit% - Maximum allowed homes
   
4. %easyhomes_available% - Remaining home slots
   
5. %easyhomes_list% - Comma-separated home names
   
6. %easyhomes_cooldown% - Remaining cooldown time
   
7. %easyhomes_combat% - Remaining combat tag time
   
8. %easyhomes_has_homes% - true/false
   
9. %easyhomes_in_combat% - true/false
   
10. %easyhomes_at_limit% - true/false
    

Display home stats in TAB lists, scoreboards, chat formats, or anywhere else.

Debug System For Troubleshooting

When something goes wrong, you need diagnostic tools:

1. 
   
2. Toggle debug mode with /easyhomes debug on/off
   
3. File logging to plugins/EasyHomes/logs/ directory
   
4. Performance tracking for database operations
   
5. Command execution history
   
6. Cache hit/miss statistics
   
7. Connection pool status monitoring
   

No more guessing. See exactly what's happening under the hood.

Feature Breakdown

Core Home Management

1. 
   
2. Create homes with custom names (alphanumeric + underscore)
   
3. Teleport to homes with /home <name>
   
4. List all homes with /home (no arguments)
   
5. Delete homes with /delhome <name>
   
6. Automatic home count tracking
   
7. Name validation prevents exploits
   
8. Case-insensitive home names
   
9. Instant home creation (no delay)
   

Storage Layer

1. 
   
2. MySQL primary storage with HikariCP connection pooling
   
3. Configurable connection pool size (default: 10 connections)
   
4. 5-second connection timeout
   
5. SSL support (optional)
   
6. Automatic schema creation
   
7. YAML fallback when MySQL unavailable
   
8. Guava cache with 300-second TTL
   
9. Maximum 10,000 players in cache
   
10. Automatic cache eviction
    
11. 100% async database operations
    

Teleportation System

1. 
   
2. Configurable delay (0-60 seconds)
   
3. Movement cancellation (cancel TP when player moves)
   
4. Title and subtitle countdown with time remaining
   
5. Particle effects at start and destination locations
   
6. Six particle types (PORTAL, FLAME, END_ROD, ENCHANTMENT_TABLE, SPELL_WITCH)
   
7. Configurable particle amount (1-100)
   
8. Sound effects on teleportation
   
9. Volume and pitch control
   
10. Action bar progress tracking
    
11. Safe location verification
    

Cooldown System

1. 
   
2. Default cooldown for all players (configurable)
   
3. Per-group cooldown overrides (VIP: 30s, Premium: 15s, Admin: 0s)
   
4. Permission-based: easyhomes.cooldown.<group>
   
5. Bypass permission: easyhomes.bypass.cooldown
   
6. PlaceholderAPI integration shows remaining time
   
7. Action bar warnings when on cooldown
   
8. Separate tracking per player
   

Combat Tag System

1. 
   
2. Configurable duration (1-300 seconds, default: 10s)
   
3. Blocks teleportation during combat
   
4. Tracks ANY damage source (PvP, PvE, environmental)
   
5. Bypass permission for staff
   
6. PlaceholderAPI integration (%easyhomes_combat%)
   
7. Action bar warnings when attempting teleport during combat
   
8. Automatic expiration after duration
   
9. Per-player tracking
   

Economy Integration

1. 
   
2. Vault API integration
   
3. Fixed teleportation cost (configurable)
   
4. Distance-based pricing (cost per block)
   
5. Home creation costs (pay to set homes)
   
6. Refund system on home deletion
   
7. Configurable refund percentage (0-100%)
   
8. Bypass permission: easyhomes.bypass.cost
   
9. Balance validation before teleportation
   
10. Transaction messages with cost breakdown
    

WorldGuard Integration

1. 
   
2. Build permission verification before sethome
   
3. Blocked regions list (prevent homes in specific regions)
   
4. Safe zone compatibility
   
5. Region flag respect
   
6. Automatic detection and integration
   
7. Works without WorldGuard (optional dependency)
   
8. No conflicts with other region plugins
   

PlaceholderAPI

1. 
   
2. Nine placeholders for home data
   
3. Real-time value updates
   
4. Boolean placeholders (true/false)
   
5. Integer placeholders (counts, limits)
   
6. String placeholders (home lists)
   
7. Time-based placeholders (cooldowns, combat)
   
8. Automatic registration on plugin load
   

Administration

1. 
   
2. Reload configuration with /easyhomes reload
   
3. Debug mode toggle for troubleshooting
   
4. File logging to dedicated logs directory
   
5. Performance metrics tracking
   
6. Cache statistics monitoring
   
7. Database connection pool status
   
8. Permission-based access control
   

Commands & Permissions

Player Commands

/home [name]           - Teleport to home or list homes
/sethome <name>        - Create home at current location
/delhome <name>        - Delete home

Admin Commands

/easyhomes reload      - Reload configuration
/easyhomes debug <on|off> - Toggle debug mode

Basic Permissions

easyhomes.*               - All permissions (default: op)
easyhomes.home            - Use /home command (default: true)
easyhomes.sethome         - Use /sethome command (default: true)
easyhomes.delhome         - Use /delhome command (default: true)
easyhomes.reload          - Reload configuration (default: op)
easyhomes.debug           - Toggle debug mode (default: op)

Bypass Permissions

easyhomes.bypass.cooldown - Skip teleport cooldowns
easyhomes.bypass.combat   - Teleport during combat
easyhomes.bypass.cost     - Skip economy costs

Home Limit Permissions

easyhomes.limit.1         - 1 home
easyhomes.limit.3         - 3 homes
easyhomes.limit.5         - 5 homes
easyhomes.limit.10        - 10 homes
easyhomes.limit.15        - 15 homes
easyhomes.limit.25        - 25 homes
easyhomes.limit.50        - 50 homes
easyhomes.unlimited       - Unlimited homes

Cooldown Group Permissions

easyhomes.cooldown.vip     - VIP cooldown (30s default)
easyhomes.cooldown.premium - Premium cooldown (15s default)
easyhomes.cooldown.admin   - Admin cooldown (0s default)

Requirements & Compatibility

Required

1. 
   
2. Paper/Spigot 1.8+ - Recommended 1.13+ for full color support
   
3. Java 8+ - Java 17+ recommended for optimal performance
   

Optional

1. 
   
2. Vault - Economy integration (costs, refunds)
   
3. PlaceholderAPI - Placeholder support for scoreboards
   
4. WorldGuard 7.0+ - Region integration and build checks
   
5. MySQL - Professional database storage (YAML fallback available)
   

Compatible With

1. 
   
2. All Vault-compatible economy plugins
   
3. All major permission plugins (LuckPerms, GroupManager, PermissionsEx)
   
4. WorldGuard, GriefPrevention, Towny, Lands
   
5. BungeeCord/Velocity networks (shared MySQL database)
   
6. Essentials, CMI (no conflicts)
   

Who Is This For?

Growing Servers (50-500 Players)
Your basic home plugin is starting to lag. You need MySQL and caching to scale without performance loss.

PvP Servers
Combat tag system prevents home escapes. Players can't abuse teleportation to avoid death. Fair PvP mechanics.

Economy Servers
Monetize home slots through permissions. Charge for teleportation. Create VIP tiers with different limits. Distance pricing adds strategic value to home placement.

Survival Networks
MySQL support allows shared home database across multiple servers. Players keep homes when switching between survival worlds.

Monetized Servers
Seven permission tiers (1, 3, 5, 10, 15, 25, 50 homes) create natural donation progression. Economy costs generate money sinks.

Professional Networks
Debug system, performance metrics, and cache monitoring provide operational visibility. Built for admins who need diagnostic tools.

Why Server Owners Choose EasyHomes

"It Actually Handles Scale"
MySQL with HikariCP pooling and Guava cache means zero performance degradation from 10 to 1000 players. Async operations prevent main thread blocking.

"Combat Tag That Works"
Finally, a home plugin that prevents PvP abuse out of the box. No more angry players complaining about combat logging.

"Economy Integration Done Right"
Distance-based pricing creates strategic depth. Home placement matters. Refund system prevents loss on mistakes. Bypass permissions for VIP.

"Seven Monetization Tiers"
Per-permission limits (1-50 homes) create natural donation progression. Players upgrade permissions as they expand their territory.

"Professional Debug Tools"
When something goes wrong, file logging and performance tracking show exactly what happened. No more blind troubleshooting.

"Zero Conflicts"
Works with Essentials, WorldGuard, Vault, PlaceholderAPI without breaking anything. Soft dependencies mean it degrades gracefully.

Stop Losing TPS To Your Home Plugin

Every main thread block from database queries is server performance you're wasting. Every combat escape through /home is a frustrated PvP player. Every missing economy integration is lost revenue.

This isn't about adding homes. It's about professional infrastructure.

Give your server MySQL-backed storage that scales. Combat tag that prevents abuse. Economy integration that creates monetization opportunities. Performance monitoring that shows what's actually happening.

Your players deserve teleportation that doesn't lag. Your PvP community deserves fair combat. Your server deserves professional-grade systems.

Professional home management starts with proper architecture.