Troubleshooting
This guide will help you solve common issues with our Minecraft plugin.
Common Issues
Plugin Won't Load
Symptoms:
- Plugin doesn't appear in the
/plugins
list - Error messages in the console during server startup
Possible Causes and Solutions:
-
Incompatible Minecraft Version
Solution: Ensure you're using a supported Minecraft version (1.8.x - 1.21.x).
-
Incompatible Server Software
Solution: Verify you're using Spigot, Paper, or a compatible fork.
-
Outdated Java Version
Solution: Update to Java 8 or higher.
-
Corrupted JAR File
Solution: Re-download the plugin and verify the file integrity.
-
Missing Dependencies
Solution: Check the console for messages about missing dependencies and install them.
Configuration Errors
Symptoms:
- Plugin loads but doesn't work correctly
- Error messages about configuration in the console
Possible Causes and Solutions:
-
YAML Syntax Errors
Solution: Use a YAML validator to check your configuration files.
-
Missing Configuration Sections
Solution: Compare your configuration with the default one and add any missing sections.
-
Invalid Values
Solution: Make sure all values are of the correct type (string, number, boolean, etc.).
Advanced Troubleshooting
Enabling Debug Mode
To get more detailed information about issues:
- Open
config.yml
- Set
debug: true
- Restart the server or reload the plugin
- Check the console for detailed debug messages
Checking Logs
Server logs can provide valuable information:
- Check
logs/latest.log
for error messages - Look for lines containing advanced armor stands
- Pay attention to errors that occur when using specific commands or features
Getting Help
If you've tried the solutions above and still have issues:
- Check our GitHub Issues to see if your problem has been reported
- Create a new issue with detailed information:
- Plugin version
- Server software and version
- Java version
- Error messages (if any)
- Steps to reproduce the issue
- Any relevant configuration files (with sensitive information removed)
Reporting Bugs
When reporting bugs, please include:
- A clear description of the issue
- Steps to reproduce the problem
- Expected behavior
- Actual behavior
- Server logs or error messages
- Plugin version and server details
This helps us identify and fix issues more quickly.