Bedrock Speedrun Pro Engine (BSPE)

The Definitive JAVA Standard for Minecraft Bedrock Edition.

Engineered specifically to bridge the gap between Bedrock Edition and professional Java speedrunning standards, the Bedrock Speedrun Pro Engine (BSPE) is a foundational, high-performance framework designed for runners, by developers. Built from the ground up by Eyrae, this addon eliminates the need for clunky external timers, manual tracking, and unverifiable run claims.

By utilizing the latest stable Bedrock Scripting API (@minecraft/server), BSPE injects a zero-flicker precision HUD, tick-accurate dual-timers, native auto-splitting, and a strict anti-cheat verification system directly into the game engine. It is the ultimate tool for practicing, tracking, and verifying world-record pace runs.

⏱️ The Logic Engine: Tick-Accurate Dual Timers

At the core of BSPE is a highly optimized execution loop that calculates time exactly how official leaderboards require it.

In-Game Time (IGT): BSPE tracks actual server ticks rather than real-world seconds. This means if the game lags, freezes, or pauses, the IGT perfectly synchronizes with the engine, ensuring runners are never penalized for hardware limitations.
Real-Time Attack (RTA): Running parallel to the IGT, the RTA timer utilizes universal timestamps to track the absolute real-world time elapsed since the run began, giving runners an instant comparison between their raw speed and engine loading times.

🧭 The Precision HUD (F3 Equivalent)

Bedrock Edition natively lacks the debugging tools available to Java players, making advanced routing nearly impossible. BSPE solves this by generating a lightweight, zero-flicker Actionbar display that updates every single tick.

Live Coordinates (XYZ): Instantly track your exact position in the world without opening menus or relying on paper-doll maps.
Sub-Decimal Angles (Pitch & Yaw): Essential for blind travel, Nether portal linking, and stronghold triangulation. The HUD provides precise rotational data (e.g., perfectly locking to 90.0 or -90.0 pitch) to execute frame-perfect mechanics and precise Ender Pearl throws.

⚡ Smart Auto-Splitter

Forget taking your hands off the keyboard to hit a split key. BSPE features a background event listener that natively hooks into Minecraft's dimension and entity systems to automate your splits.

Dimension Tracking: The engine instantly registers and broadcasts a split the exact millisecond your player entity loads into the Nether or the End.
The Finish Line: BSPE binds a listener to the Ender Dragon entity. The moment the dragon's health hits absolute zero, the timer perfectly freezes, eliminating human reaction-time errors from your final score.

🛡️ Ironclad Anti-Cheat & Run Verification

To be viable for official leaderboards, a run must be provably legitimate. BSPE acts as a "Black Box" flight recorder, monitoring the game state behind the scenes.

Active Gamemode Sweeps: Running an un-intrusive 20-tick interval scan, the engine constantly monitors all player entities. If a player switches to Creative or Spectator mode, the run is instantly permanently invalidated.
Command Interception: The engine actively listens to all inputs. If a user attempts to execute forbidden commands (such as /give, /tp, /locate, or /gamemode), the engine immediately throws an invalidation flag.
Cryptographic Verification Keys: When the Ender Dragon falls, the engine compiles your IGT, RTA, and the un-tampered validity flag into a raw string. Since Bedrock does not support standard web cryptography natively, BSPE utilizes a custom-built Base16 Hex Encoder to compress this data into a secure BSPRO Verification Key (e.g., BSPRO-4947543a30303a). This key is broadcasted in the final GG message, allowing leaderboard moderators to mathematically verify that the run was completed on a legitimate, un-tampered engine.

⚔️ Built-In Practice Environment

Speedrunning is about repetition. BSPE features a rapid-reset practice module that allows runners to isolate and grind specific segments of the game without needing to set up external chest grids or command blocks.

Instant Kits: By requesting a specific kit, the engine instantly wipes the player's inventory and replaces it with the exact loadout needed for a specific split.
Available Loadouts: Whether you need standard Bastion routing gear (gold, basic tools, food) or End fight preparation (beds, pearls, obsidian), the practice module handles the inventory management instantly.

⌨️ Official Command Guide

To bypass Bedrock's strict stable-release chat restrictions and prevent the addon from breaking during Minecraft updates, BSPE operates entirely on the official /scriptevent pipeline. These commands can be typed directly into chat or wired into Command Blocks for custom practice maps.

/scriptevent bs:start

Action: Completely wipes all previous run data, resets the anti-cheat validity flag, clears all registered splits, and instantly starts the IGT and RTA timers from 00:00:00.
/scriptevent bs:stop

Action: Manually pauses the timer. Useful for abandoning dead runs or testing features without triggering the Ender Dragon finale.
/scriptevent bs:practice <kit_name>

Action: Grants the specified practice loadout. (Example: /scriptevent bs:practice bastion instantly provides the Bastion routing inventory).
Kits Available: End, Bastion.

⚙️ Technical Specifications & Compatibility

Architecture: Written in modular JavaScript utilizing the @minecraft/server API (Version 1.11.0).
Engine Version: Fully optimized, crash-proof, and tested for the Minecraft Bedrock 1.21.114 Stable Branch.
Multiplayer: Fully compatible with multiplayer servers and SMPs. The HUD and anti-cheat seamlessly scale to monitor multiple players within the world instance.
How to Enable BSPE in Your World

To begin your run with the Bedrock Speedrun Pro Engine, you must properly initialize the addon within your world settings. Follow these steps to ensure the engine and anti-cheat modules load correctly:
- Addon Import and World Creation/Editing: simply double-click the .mcpack file. Minecraft will launch automatically and import the engine. Now go to the settings of the world where you intend to run or practice.
- Behavior Pack Activation: Navigate to the Behavior Packs tab on the left sidebar. Under the Available section, find BSPE and click Activate to move it into the Active list.
- Enable Experimental Toggles: Scroll down to the Experiments section in the world settings. You must toggle Beta APIs to On; this allows the game to execute the custom JavaScript logic required for the timer and HUD.
- Allow Cheats: Ensure that Allow Cheats is toggled On, as this is required for the engine to register the /scriptevent command system.
- Starting the Engine: Once you are in the game, open the chat and type /scriptevent bs:start to calibrate the HUD and begin the official timer.
This mod is an official inspiration from the JAVA Mod known as MCSR Ranked.

For any enquiry or issue, please contact me on discord: @lananatala

Support my work by buying me a ko-fi: ko-fi Eyrae