EuForia Bedrock Debug

If you've ever played Minecraft Java Edition, you know the F3 debug screen. It's an indispensable tool — position coordinates, facing direction, biome, light levels, entity counts, server TPS, and a dozen other data points at a single keystroke. It's how you debug farms, verify chunk boundaries, optimize performance, and satisfy your curiosity about what's happening under the hood.

Now ask yourself: where is this in Bedrock Edition? It doesn't exist. Not natively. Not as a toggle. Not even as an experimental flag.

For years, Bedrock players, mapmakers, and server admins have been flying blind. Sure, there's /gamerule showcoordinates, but that gives you exactly three numbers — X, Y, Z — and nothing else. Want to know your biome? Open the world settings. Want to check light levels for mob spawning? Walk around placing torches and pray. Want to see TPS to diagnose server lag? Good luck.

EuForia Bedrock Debug is our answer to this decade-old gap. It's a real-time diagnostic HUD overlay for Minecraft Bedrock Edition, built entirely with the stable Scripting API — no hacks, no DLL injection, no client mods. Just vanilla Bedrock with behavior packs enabled.

✅ Achievement-Friendly — product_type: addon

🌐 euforiaproject.com  |  💬 Join our Discord

// KNOWN_LIMITATION

⚠️ Actionbar Conflict Warning

EuForia Bedrock Debug renders its HUD through the actionbar. Specifically, it overrides hud_actionbar_text_area in hud_screen.json to inject diagnostic data. This means:

Will It Conflict With Other Addons?

Yes — potentially. Any addon that also writes to the actionbar (via /title @s actionbar commands, Player.onScreenDisplay.setActionBar(), or a hud_screen.json override) will compete for the same display space. Only one source can render to the actionbar at a time. If you run multiple actionbar-based addons simultaneously:

  • ❌ Overwrites: The last writer wins — debug data or the other addon's messages will be lost
  • ❌ Flickering: If both update on a tick loop, the actionbar flashes between two sources
  • ❌ Silent failure: No error is thrown — data simply disappears with no warning

Mitigation Strategies

StrategyHow
Toggle modeUse mode cycling (planned feature) to temporarily disable the HUD when using other actionbar-dependent tools
JSON UI panel modeA future release will add a dedicated UI panel variant that doesn't touch the actionbar at all — useful for addon-heavy environments
Check before installingReview your active behavior packs — if any use /title actionbar or setActionBar(), expect conflicts

Which Addons Typically Conflict?

  • Quest/mission packs (actionbar instructions)
  • RPG systems (actionbar combat text, notifications)
  • Scoreboard overlays that use actionbar fallback
  • Any pack that overrides hud_screen.json
Bottom line: If you only need EuForia Bedrock Debug, you're fine. If you run it alongside other addons that use the actionbar, you will see conflicts. Plan accordingly.
// FEATURE_SET

What It Does

The HUD displays 8 categories of live diagnostic data, refreshed every 0.1 seconds (2 game ticks) for near-instant responsiveness:

[+] Player

  • Position: X, Y, Z with 2-decimal precision
  • Facing direction: Cardinal direction + exact yaw angle
  • Dimension & Biome: Full biome name resolved from the API
  • Health & Hunger: Current / max values
  • XP: Level + progress percentage + absolute total XP across all levels
  • Speed: Accurate blocks/sec derived from velocity vector
  • State flags: Ground, Flying, Sprinting, Sneaking, Swimming, Gliding, InWater, Jumping, Climbing — all nine player states tracked simultaneously
  • GameMode & Permission level

[O] World

  • Player count: Total players + per-dimension breakdown (Overworld / Nether / End) with color coding
  • Day & Time: World day counter + current time-of-day
  • Weather: Live weather state with visual indicators (Raining 💧 / Thundering ⚡ / Clear)
  • Moon Phase: Current moon phase from the full 8-phase cycle
  • Difficulty: Peaceful / Easy / Normal / Hard

[@] System

  • Tick counter: Current server tick with human-readable elapsed world runtime (e.g. "2h 13m 47s")
  • TPS (Ticks Per Second): Real-time TPS measured via Date.now() with exponential moving average smoothing — color-coded green (≥19.5), yellow (≥15), or red (<15) for instant lag detection
  • Platform: Console / Desktop / Mobile detection
  • Graphics mode: Simple / Fancy / Deferred / Ray Traced
  • Device Memory: Hardware RAM tier classification (Super Low through Super High)
  • Max GPU Render Distance: Device's maximum chunk rendering capability

[>] Target

  • Raycast system: Fires both block and entity raycasts simultaneously, picks the closest hit
  • Block mode: Shows full typeId (e.g. minecraft:oak_door), hit face, exact coordinates, and all block states (facing, open, powered, hinge, etc.) — zero truncation, every state visible
  • Entity mode: Shows full typeId, custom name tag, exact coordinates, distance, plus for item entities the contained item stack + count, and for living entities their current/max health
  • Raw identifiers: All typeIds are displayed as-is (minecraft:grass_block, not "Grass Block") — critical for custom addon development where namespace matters

[=] Equipment

  • All 6 equipment slots: Mainhand, Offhand, Helmet, Chestplate, Leggings, Boots
  • Full raw identifiers: Every slot shows the exact typeIdmynamespace:custom_sword, not "Custom Sword"
  • Hotbar slot indicator: Shows which hotbar slot (1-9) is currently selected
  • Handles empty slots gracefully with clear "Empty" indicators

[~] Environment

  • Entity count: Total entities in the current dimension
  • Light level: Block light at player's feet
  • Sky light: Sky light level at player's location
  • Chunk status: Whether the current chunk is loaded

[#] Rules

  • 11 game rules displayed across 3 lines with clean Y / N indicators:
    • showCoordinates, keepInventory, PvP, doDayLightCycle, doWeatherCycle
    • doMobSpawning, tntExplodes, doFireTick, commandBlocksEnabled
    • showDeathMessages, randomTickSpeed
  • Every label has its own color reset to prevent formatting bleed
// TECH_STACK

Technology Stack

Behavior Pack (EuForia Bedrock Debug [BP])

ComponentTechnologyVersion
RuntimeMinecraft Bedrock Scripting API@minecraft/server 2.8.0 (stable)
LanguageJavaScript (ES Modules)
Entry Pointscripts/main.jsSingle 295-line file
ArchitectureMonolithic tick-loop pattern — No external dependencies

Key APIs used:

  • Player.location, Player.getRotation(), Player.getViewDirection()
  • Player.getBlockFromViewDirection() — block raycast
  • Player.getEntitiesFromViewDirection() — entity raycast
  • EntityEquippableComponent + EquipmentSlot enum — all 6 gear slots
  • EntityItemComponent — dropped item inspection
  • EntityHealthComponent — target entity health
  • Block.permutation.getAllStates() — full block state inspection
  • Player.clientSystemInfo — platform, memory tier, graphics mode, GPU render cap
  • World.gameRules — all available game rules
  • Dimension.getWeather(), Dimension.getBiome(), Dimension.getLightLevel()
  • system.currentTick — tick counter
  • Date.now() — wall-clock time for TPS calculation
// TARGET_AUDIENCE

Who This Is For

  • 🗺️ Mapmakers — Verify light levels for mob spawning, check chunk boundaries, debug command blocks
  • 🖥️ Server admins — Monitor TPS in real-time, check player distribution across dimensions, audit game rules
  • 🔧 Addon developers — Inspect block states, verify item identifiers, debug entity components
  • ⚙️ Technical players — The F3 screen you've been missing since switching from Java
  • 🎥 Content creators — Show debug info on-stream without clunky command block setups
// SETUP_GUIDE

Installation

  1. Download the Behavior Pack .mcpack and the Resource Pack .mcpack from euforiaproject.com.
  2. Open each file — Minecraft Bedrock imports them automatically into your library.
  3. Open or create a world, navigate to World Settings → Add-Ons, and activate EuForia Bedrock Debug [BP] under Behavior Packs.
  4. The Resource Pack self-activates through the manifest dependency — no extra toggle needed.
  5. Load the world — the HUD appears immediately in the actionbar area at the bottom of the screen.

To remove, deactivate the Behavior Pack from the same Add-Ons menu.

// ROADMAP

What's Next?

This is V.1.0.0 — the foundation. Future updates we're considering:

  • Toggle commands/scriptevent-based per-player show/hide control
  • Standalone UI panel — Decouple from the actionbar so other addons can coexist
  • Selective categories — Let each player pick which data sections to display
  • Snapshot export — Dump the current state into a report for bug reproduction
  • TPS timeline — Rolling 60-second performance graph
// LICENSE_INFO

License

Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)

✅ What You Can Do

  • Use this addon in your own worlds, servers, and content
  • Modify, remix, and build upon it for personal or community projects
  • Share it with friends, communities, and players

❌ What You Cannot Do

  • Sell it, bundle it in paid products, or use it for commercial monetization
  • Re-upload it as-is (direct rehost) on CurseForge, MCPEDL, or any other platform — substantial modification and added value are required before redistribution

📋 Attribution Policy

By downloading and using EuForia Bedrock Debug, you are automatically considered to have given appropriate credit. You do not need to write out attribution text or include a credit line — using the addon is credit enough.

📄 Full license terms: creativecommons.org/licenses/by-nc/4.0/

// COMMUNITY

Feedback & Community

Found a bug? Have a feature request or an idea to make this addon better? We would love to hear from you.

💬 Join our Discord

Drop your suggestions, bug reports, or just say hello — the EuForia community is always open.

"Every Bedrock player deserves the tools
to understand their world."

— EUFORIA_PROJECT
// GET_STARTED

📥 Download

Minecraft Bedrock 1.26.0+  ·  CC BY-NC 4.0  ·  Achievement Friendly