BedrockDebugLog

Conditional debug logging for the Bedrock display pipeline.

"Bedrock player sees no models" is the single hardest FMM symptom to triage in production: the failure can be in any of FMM's per-viewer display decision (Java vs Bedrock branch), EMG's per-viewer spawn/equipment packet emission, Geyser's translation of those packets to Bedrock protocol, the RSPM-produced merged Bedrock pack on the proxy, or the client itself. Server logs alone don't say which.

Runtime toggle — NOT a config option. Deliberately not persisted in config.yml: this is verbose enough to flood logs on a busy server, and a config flag is too easy to forget on. Operators flip it with /fmm debug bedrock on|off, reproduce the issue, then turn it off. The state resets to false on every plugin enable.

All log lines are prefixed with [FMM-BedrockDebug] so a single grep against the server log surfaces the entire decision trail for one Bedrock viewer's session.