Troubleshooting
Common issues and solutions for AdvanceMMO.
Plugin Won't Load
Issue: Plugin fails to enable
Possible Causes:
- Incompatible server version
- Missing dependencies
- Corrupted plugin file
- Java version too old
Solutions:
- Check server version compatibility
- Install required dependencies (Vault, etc.)
- Re-download the plugin
- Update Java to version 11 or higher
Database Issues
Issue: Database connection errors
Possible Causes:
- Incorrect database credentials
- Database server not running
- Network connectivity issues
- Insufficient database permissions
Solutions:
- Verify database credentials in config.yml
- Check MySQL/MariaDB server status
- Test database connection
- Grant proper permissions to database user
Performance Issues
Issue: Server lag or performance problems
Possible Causes:
- Too many database queries
- HUD updating too frequently
- Large player database
- Inefficient configuration
Solutions:
- Increase HUD update interval
- Use MySQL instead of SQLite for large servers
- Optimize database tables
- Disable unused features
Command Issues
Issue: Commands not working
Possible Causes:
- Missing permissions
- Command conflicts
- Plugin not enabled
Solutions:
- Check player permissions
- Check for command conflicts with other plugins
- Verify plugin is enabled
- Check console for errors
GUI Issues
Issue: GUIs not opening or displaying incorrectly
Possible Causes:
- Inventory conflicts
- Resource pack issues
- Client-side mods interfering
Solutions:
- Close other inventories first
- Check for conflicting plugins
- Test without resource packs
- Check client mods
Data Loss
Issue: Player data missing or reset
Possible Causes:
- Database corruption
- Incorrect database configuration
- Plugin update issues
Solutions:
- Restore from backup
- Check database connection
- Verify database tables exist
- Check plugin logs
Getting Help
If you can't resolve an issue:
- Check the console for error messages
- Review the latest.log file
- Check plugin documentation
- Search for similar issues online
- Contact support with:
- Server version
- Plugin version
- Error messages
- Steps to reproduce
Useful Commands
| Command | Description |
|---|---|
/advancemmo reload |
Reload plugin configuration |
/advancemmo version |
Check plugin version |
/advancemmo debug |
Enable debug mode |
Important: Always backup your server and database before making changes or updates!