How to Enable Debug Mode

How to Enable Debug and Test Mode

Step-by-step guide for enabling debug logging and test mode in your project.

Debug Mode

Debug mode enables verbose logging for TLP packages. Disabled by default — no performance impact when disabled because logging code is not compiled into builds.

Enable Debug Mode

1. Go to Edit > Project Settings > Player > Script Compilation
2. Add TLP_DEBUG to the list of scripting defines
3. Find the TLP_Logger prefab in your scene
4. Set logging severity to Debug (default is Info)

Disable Debug Mode

1. Go to Edit > Project Settings > Player > Script Compilation
2. Remove TLP_DEBUG from the list
3. Set TLP_Logger severity back to Info or higher

Debug logging is verbose — only enable when actively debugging.

Test Mode

Test mode enables SDK workarounds for unit testing. Disabled by default — do not enable in production builds.

Enable Test Mode

1. Go to Edit > Project Settings > Player > Script Compilation
2. Add TLP_UNIT_TESTING to the list of scripting defines

Disable Test Mode

1. Remove TLP_UNIT_TESTING from the list

Test mode enables workarounds for VRChat SDK parts that cannot be easily mocked.

See Also

• Compilation Symbols Reference — full list of scripting defines
• Debug and Test Mode — overview