Troubleshooting
Last modified: 26 April 2026
Startup
| Problem | Fix |
|---|---|
Only license.yml exists | License validation has not passed yet. |
config.yml missing | Fix the license and restart. |
| Plugin does not load | Check Java version, platform version, duplicate jars, and console startup errors. |
Commands
If commands do not respond, check install location, permission assignment, proxy command forwarding, and whether another plugin owns the same alias.
Compatibility
Keep core network plugins updated. If a plugin update changes traffic shape, use observe first and review incidents before tuning.
False positives
- Switch to
observe. - Reproduce the normal action.
- Collect the incident ID and versions.
- Send details privately.
Support ready
A useful report includes versions, profile, deployment shape, the broad feature involved, incident ID, and exact reproduction steps.