BlurEngine Bebe

Game engine library for Minecraft Bedrock scripting.

Warning: bebe is still in an early stage of development. Backward compatibility is not guaranteed yet, and breaking changes may happen while the public engine surface is still being shaped.

Packages

• @blurengine/bebe: engine lifecycle, ownership, runtime scheduling primitives, Zones, RenderAnchors, Link, and Metrics
• @blurengine/bebe/bedrock: Bedrock edge helpers for block, adjacency, block-traversal, slot, item stack, item entity, and durability work
• @blurengine/bebe/catalog: immutable block catalogs plus the built-in vanilla preset and tag-traversal helpers
• @blurengine/bebe/features/fishing: opt-in derived events around vanilla fishing behaviour
• @blurengine/bebe/maths: vectors, facings, AABBs, extents, voxel/grid helpers, tweens, and numeric helpers
• npm install @blurengine/bebe @minecraft/server

Quick Start

import { Context } from "@blurengine/bebe";
import { tweenNumber } from "@blurengine/bebe/maths";

const ctx = new Context();

tweenNumber(ctx, {
  from: 0,
  to: 1,
  durationTicks: 20,
  onUpdate(value) {
    console.warn(`progress: ${Math.round(value * 100)}%`);
  },
});

What Bebe Is For

• Provide a game engine layer for Bedrock scripting that can own runtime work, compose runtime systems, and grow into higher-level engine systems over time.
• Keep timers, subscriptions, spawned child scopes, and other runtime work owned by one Context.
• Expose simple derived event sources through EventSignal instead of repeating local emitter code in each feature.
• Provide small runtime helpers for staging owned work over ticks, including grouped schedules derived from flat item lists.
• Provide the root-level Zones singleton for registering, querying, and watching dimension-partitioned extents without making extents aware of dimensions, worlds, entities, or events.
• Provide the root-level RenderAnchors singleton for distant entity-like visuals that are declared as assets, generated by tooling, and maintained by one shared runtime loop with Bebe-owned cleanup.
• Keep Bedrock-specific friction at the edge through reusable helpers instead of repeating the same safety, adjacency, traversal, and fallback code inside gameplay features.
• Provide an opt-in block catalog surface so Bedrock features can query curated vanilla block categories, collect tags from subsets, and build small derived indexes without carrying giant local tables or repetitive local query helpers.
• Provide opt-in feature modules for common derived Bedrock behaviours, starting with vanilla fishing events.
• Provide a local Link bridge surface for tooling messages between BDS runtime code and blr, while staying no-op when unavailable.
• Provide Prometheus-style runtime metrics for counters, gauges, histograms, labels, and plaintext dashboard snapshots.
• Provide a separate maths surface for vector, facing, AABB, extent, voxel/grid, voxel collection, tween, and scalar helpers without making the root package feel overloaded.

Documentation

• Docs Index
• Context Guide
• Stagger Guide
• Zones Guide
• Bedrock Guide
• Techniques Guide
• Catalog Guide
• Fishing Guide
• Link Guide
• Metrics Guide
• Maths Guide
• Voxels Guide
• Changelog

Development

npm install
npm run check

License

Licensed under the Apache License, Version 2.0. See LICENSE.

Open Source

• Contributing Guide
• Security Policy