Welcome to the official documentation for
NexHomes. Here you will find everything you need to install, configure, and manage the plugin on your server.
Installation Guide
- Download: Get the latest version of NexHomes.jar from the version history.
- Upload: Place the jar file into your server's plugins folder.
- Dependencies:
- Required: None! (NexHomes works out of the box).
- Optional:
- Restart: Restart your server to generate the configuration files.
⚙️ Configuration (config.yml)
The
config.yml file allows you to customize almost every aspect of the plugin
Code (YAML):
# NexHomes Configuration
# Language (tr, en, es)
# Select the default language for the plugin.
language
: en
# Database Settings
# Choose between SQLITE (local file) or MYSQL (remote database).
database:
type
: SQLITE
# Options: SQLITE, MYSQL
host
: localhost
port
: 3306
database
: nexhomes
username
: root
password
:
""
table-prefix
:
"nexhomes_"
# Teleport Settings
teleport:
warmup
: 3
# Seconds to wait before teleporting (0 to disable)
cooldown
: 10
# Seconds to wait between teleports
safe-teleport
: true
# Prevents teleporting into lava/void
# Economy Settings (Requires Vault)
economy:
enabled
: true
costs:
sethome
: 100.0
teleport
: 10.0
icon
: 500.0
# Blacklist Settings
# Prevent setting homes in specific worlds or WorldGuard regions.
blacklist:
worlds
:
-
"spawn_world"
-
"event_world"
regions
:
-
"spawn"
-
"pvp_arena"
# Home Limits (Permission Based)
# Define limits for specific permission groups.
limits:
default
: 3
vip
: 5
mvp
: 10
️ Permissions
Permission Node
Description
Recommended Rank
nexhomes.use Allows basic usage (/sethome,
/home, etc.)
Player
nexhomes.limit.default Grants the default home limit (Configurable).
Player
nexhomes.limit.vip Grants the VIP home limit.
VIP
nexhomes.limit.unlimited Allows setting unlimited homes.
Admin / Owner
nexhomes.bypass.warmup Bypasses the teleport warmup delay.
VIP / Admin
nexhomes.bypass.cooldown Bypasses the teleport cooldown.
VIP / Admin
nexhomes.admin Full access to all admin commands.
Admin
Hex Colors & Formatting
NexHomes uses the
MiniMessage format for advanced text styling. You can use these formats in home names and language files.
- Standard Colors: <red>, <blue>, <green>, etc.
- Hex Colors: <#ff0000>Red, <#00ff00>Green
- Gradients: <gradient:red:blue>My Cool Home</gradient>
- Decorations: <bold>, <italic>, <underlined>
Example Command:
/sethome <gradient:gold:yellow>MyVilla
Migration (Importing Data)
Moving from another plugin? NexHomes makes it easy.
Supported Plugins:
How to Import:
- Ensure both NexHomes and Essentials are installed.
- Run the command: /nexhomes import Essentials
- Wait for the process to complete.
- (Optional) Remove Essentials if you no longer need it for homes.
❓ FAQ
Q: Does this work on 1.8?
A: No, NexHomes is designed for modern Minecraft versions (1.16+) to support advanced features like Hex colors and persistent data containers.
Q: Can I use MySQL to sync homes across servers?
A: Yes! Set
database.type to MYSQL in
config.yml and use the same database credentials on all servers.
Q: My GUI icons are not showing up?
A: Ensure you are using valid material names for your Minecraft version. If you updated the server version, some item names might have changed.