Getting Started
Installation
- Download the latest plugin JAR from the downloads page
- Place the JAR file in your server's
plugins folder
- Restart your Hytale server
- The plugin will generate configuration files automatically
Requirements
- Hytale Server (Early Access or later)
- Java 17 or higher
- At least 2GB RAM recommended
Commands
All commands require the appropriate permissions. Use /hyclans help for in-game help.
/clan create
Create a new clan with the specified name.
Invite a player to join your clan.
/clan claim
Claim the chunk you're standing in for your clan.
/clan info [clan]
View information about your clan or another clan.
/clan leave
Leave your current clan.
/clan war
Declare war on another clan (requires leadership permission).
Permissions
HyClans uses a permission-based system. Grant permissions using your permission plugin.
| Permission |
Description |
Default |
| hyclans.user |
Basic clan commands |
true |
| hyclans.create |
Create new clans |
true |
| hyclans.claim |
Claim territory |
true |
| hyclans.admin |
Administrative commands |
op |
| hyclans.bypass |
Bypass clan restrictions |
op |
Configuration
The plugin generates a config.yml file in plugins/HyClans/ on first run.
Basic Settings
# Maximum clan name length
max-clan-name-length: 16
# Maximum clan tag length
max-clan-tag-length: 5
# Maximum players per clan
max-clan-size: 20
# Territory claim cost (in-game currency)
claim-cost: 1000
# War declaration cost
war-cost: 5000
Economy Settings
# Enable clan taxes
taxes-enabled: true
# Tax rate (percentage)
tax-rate: 5.0
# Tax collection interval (minutes)
tax-interval: 60
Troubleshooting
Common Issues
- Plugin not loading: Check server logs for errors. Ensure Java 17+ is installed.
- Commands not working: Verify permissions are set correctly.
- Database errors: Check file permissions on the plugins folder.
Getting Help
If you encounter issues not covered here, join our Discord server for support.