---
title: Troubleshooting Pixelmon With Debug Settings
description: "Learn what every setting in Pixelmon's debug.yml controls. This guide explains Pixelmon's debugging and logging options, including detailed error reporting, verbose logging, and the optional fix for Pokémon clumping near world borders."
source: "https://nodecraft.com/support/games/minecraft/mods/pixelmon/troubleshooting-pixelmon-with-debug-settings"
image: "https://dynamic-assets.nodecraft.com/signedurl/w7vokBAexMnVlnMZ1Q/image.jpg?modifications=W3sibmFtZSI6ImdhbWVfYmciLCJpbWFnZV91cmwiOiJodHRwczovL2Ntcy1hLm5vZGVjcmFmdC5jb20vZi8xMzM5MzIvMjAwMHg1NTAvZGNiMGFkNjkzOC9jYXZlcy1hbmQtY2xpZmZzLXB0LTItMS0yLTAucG5nL20vIn0seyJuYW1lIjoiZ2FtZV9sb2dvIiwiaW1hZ2VfdXJsIjoiaHR0cHM6Ly9jbXMtYS5ub2RlY3JhZnQuY29tL2YvMTMzOTMyLzM3NXgxNTAvM2MxZGIyYmFiNS9taW5lY3JhZnQucG5nL20vIn0seyJuYW1lIjoiY3RhX3RleHQiLCJ0ZXh0IjoiQ3JlYXRlIHlvdXIgb3duIHNlcnZlciEifSx7Im5hbWUiOiJ0ZXh0IiwidGV4dCI6IlRyb3VibGVzaG9vdGluZyBQaXhlbG1vbiBXaXRoIERlYnVnIFNldHRpbmdzIn1d&s=0f109ff7a41c0cd0675b763ff76ed4a950fea85bcbbb9c1d9987de202df2776f"
published: "2026-08-12T18:52:04.291Z"
updated: "2026-08-12T18:52:04.291Z"
---

# Troubleshooting Pixelmon With Debug Settings

Learn what every setting in Pixelmon's debug.yml controls. This guide explains Pixelmon's debugging and logging options, including detailed error reporting, verbose logging, and the optional fix for Pokémon clumping near world borders.

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.