Troubleshooting Pixelmon With Debug Settings
The Debug section controls how much troubleshooting information Pixelmon writes to the server log and includes an optional fix for Pokémon clumping around world edges. These settings are most useful while diagnosing server problems.
Pixelmon Debug Settings
The settings below are listed in the same order as they appear in debug.yml. All three options are Boolean values that can be set to true or false. The Setting column shows a reader-friendly name first, followed by the matching debug.yml key for reference.
| Setting and Config Key | Default and Accepted Values | Description |
|---|---|---|
| Detailed Pixelmon Error Logging print-errors | Default: true Values: true or false | Controls whether Pixelmon-related server errors are printed to the log in detail. When disabled, error messages are shorter and contain less troubleshooting information. |
| Use Entity Edge-Clumping Fix use-update-entity-with-optional-force-fix | Default: false Values: true or false | Controls an optional fix for Pokémon clumping around the edges of the world. Keep it disabled on Sponge servers or if you are unsure whether the fix applies. |
| Verbose Logging verbose | Default: false Values: true or false | Controls additional verbose logging. Keep it disabled during normal operation and enable it only while gathering detailed information for troubleshooting. |
Important Debug Setting Notes
Error Detail
When print-errors is enabled, Pixelmon-related server errors are written to the server log with more detail. Disable it only if you intentionally want shorter error messages with less troubleshooting information.
Edge-Clumping Fix
The use-update-entity-with-optional-force-fix setting addresses Pokémon clumping around world edges. Pixelmon recommends keeping it disabled on Sponge servers or whenever you are unsure whether the fix is needed.
Verbose Logging
Enable print-errors when detailed Pixelmon error information is useful for troubleshooting.
Keep the optional force fix disabled on Sponge or when its purpose is unclear.
Keep verbose logging disabled unless you are actively diagnosing a problem.
Final Thoughts
Pixelmon's debug settings are designed for troubleshooting, not everyday experimentation. Leave the specialized fixes and verbose output disabled unless you are investigating a specific issue and return temporary logging changes to normal afterward.
Need Help?
If you have questions or run into any issues, our support team is here to help! Reach out using the support widget on our website or visit our support center for further assistance.