Troubleshooting
Creating Add-Ons for Bedrock Minecraft is a relatively straightforward process once you get the hang of it. The first time is usually a frustrating, bug-prone process. This document contains some tips and tricks for fixing those dastardly bugs, as well as best practice information.
Please read the whole page, before jumping into troubleshooting tips for a specific domain.
Reload
First, you should always reload Minecraft. That means fully closing the game and then reopening it. This can catch many errors, especially those related to assets that are accessed via a filepath, such as textures or loot tables.
The Environment
The best way to prevent nasty bugs is by working in the right environment. You should review the software preparation document for editor recommendations. The most important part is getting a JSON-linter, (or using an online json-linter), and storing your packs in development_behavior_packs and development_resource_packs.
If you have your add-ons in the normal folders, you can run into "pack caching" issues, where you edit the files in one location, but the game is still using the old files.
Content Log
Use the Content Log!
Content log is the best tool you have for debugging your add-ons. Please don't skip this step!
TIP
Errors are not cleared between runs, so the errors you see in the content log may be old errors from prior runs.
The 'Content Log' is a list of issues found in your pack. Minecraft will generate this list every time your load your world.
It can catch issues such as:
- Wrong texture path
- Misspelled component
- Incorrect json structure
Content log can be turned on in in Settings > Creator. The content log will show in-game on load up, and if more errors occur during gameplay.
Content Log File
The content log is saved in .txt format inside your files:
- Windows:
C:\Users\USERNAME\AppData\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\logs - Android:
/storage/emulated/0/Android/data/com.mojang.minecraftpe/files/games/com.mojang/logs
Using Vanilla Resources
You should download the vanilla resource and behavior pack. You can find the vanilla resource and behavior pack here. You can compare against the vanilla files if you have any issues!
JSON-Schemas
JSON-Schemas are a valuable tool for file validation. You can learn more about JSON-Schemas here.
Troubleshooting Your Add-On
Entities
Troubleshoot your entities.Items
Troubleshoot your items.Blocks
Troubleshoot your blocks.Contributors
