Wiki


Homefreely - Advanced Home Teleport Plugin
Homefreely is a feature-rich Minecraft Bukkit home teleport plugin that supports multiple homes, permission groups, coordinate setting, safety checks, and PlaceholderAPI integration.

Core Features
✨ Main Features

• Multiple Homes Support - Players can set multiple home locations
  
  
• Permission Group System - Different groups can have different home limits
  
  
• Coordinate Setting - Support for precise home placement via coordinates
  
  
• Safety Checks - Intelligent detection of unsafe locations to prevent players from getting stuck in dangerous areas
  
  
• PlaceholderAPI - Complete placeholder support for displaying home information in other plugins
  
  
• Hot Reload - Update configuration without restarting the server
  
  
• Backward Compatibility - Support for migrating data from older versions
  

Advanced Features

• World Restrictions - Limit specific permission groups to specific worlds
  
  
• Economy Integration - Support for home setting costs (requires Vault)
  
  
• Confirmation System - Require player confirmation for dangerous locations
  
  
• Range Limiting - Limit maximum distance for coordinate setting
  
  
• Hostile Mob Detection - Automatically detect hostile mobs nearby
  

Quick Start
1. Install Plugin
# Download plugin
Download Homefreely-1.1.0.jar

# Place in server
Copy file to plugins/ folder

# Start server
Start or restart your Minecraft server
2. Basic Configuration
Plugin automatically generates configuration files on first startup:

• plugins/Homefreely/config.yml - Main configuration file
  
  
• plugins/Homefreely/homes.yml - Home data file
  

3. Basic Usage
# Set home
/sethome home

# Teleport to home
/home home

# View all homes
/homelist

# Delete home
/delhome home
File Structure
Homefreely/
├── config.yml # Main configuration file
├── homes.yml # Home data file
├── README.md # This documentation
├── CONFIG.md # Detailed configuration guide
├── COMMANDS.md # Command usage guide
├── PERMISSIONS.md # Permission system guide
└── API.md # Developer API documentation
Permission Group Examples
Group Max Homes Special Permissions
default 1 home Basic features
vip 3 homes More homes
premium 5 homes World restrictions
admin Unlimited homes All permissions
Usage Recommendations
Newbie Servers

• Use default configuration
  
  
• Give all players home.set permission
  
  
• Limit each player to 1-2 homes
  

Medium Servers

• Create VIP permission groups with 3-5 homes
  
  
• Enable safety check features
  
  
• Use PlaceholderAPI to display home information
  

Large Servers

• Set up multiple permission tiers
  
  
• Enable economy system integration
  
  
• Configure world restriction rules
  
  
• Use database storage (future version support)
  

Common Questions
Q: What versions does the plugin support? A: Supports Minecraft 1.13 and above

Q: Is PlaceholderAPI required? A: No, but PlaceholderAPI support is available for additional features

Q: How to backup home data? A: Backup the plugins/Homefreely/homes.yml file

Q: Does it support MySQL? A: Current version uses YAML file storage, database support will be added in future versions