Developer tools
The Dev category is for diagnosing issues. Leave these features off during ordinary play unless you need their output. A Cheat edition development build can also expose a No Rotate Button Test intended for a fixed test setup, not for normal use.
Copy Item Data
- Enable Copy Item Data and bind Copy Key.
- Hover an item in a container and press the bind. Its item data goes to the clipboard.
- Paste into a local text editor to inspect it. Check what the copied data contains before sharing it in a public issue.
Dev Mode
- Enable Dev Mode only for an investigation.
- Use Verbose Logging for extra internal messages, Log Event Dispatch for every event-bus post, or Rethrow Listener Exceptions to make listener failures surface immediately.
- Reproduce the issue, save the relevant client log, then turn noisy options back off. Rethrowing is forced in a Fabric development runtime regardless of its switch.
Freeze Capture
- Enable Freeze Capture before trying to reproduce a client stall.
- After a stall of about 200 ms or more, inspect the thread-stack files under the instance’s
config/blackaddons/dev/freezes/directory. - Compare several captures at the same symptom rather than assuming one sample proves the cause.
Dumpers
- Enable Dumpers and bind only the output you need: Dump Scoreboard, Dump Tab List, Dump Action Bar, or Dump Chat.
- Reproduce the relevant game state and press the bind in world. The feature writes a dump and copies it to the clipboard.
- Inspect and redact private chat or account information before attaching a dump to an issue.
For a report checklist, see Troubleshooting.