Skip to content
DarkBladeDev Docs

CraftLab-frontend (Web Studio UI)

CraftLab-frontend is the browser-based authoring environment for Minecraft server administrators, builders, and developers. Built with React 18, Vite, and Tailwind CSS, it empowers users to design custom items, preview 3D display blocks, and manage resource packs without editing raw YAML or JSON files manually.

Studio Workspaces

+---------------------------------------------------------------------------------+
|                               CRAFTLAB-FRONTEND                                 |
+---------------------------------------------------------------------------------+
|                                                                                 |
|   +-----------------------+  +-----------------------+  +--------------------+  |
|   |      ITEM STUDIO      |  |     BLOCK STUDIO      |  |    PACK MANAGER    |  |
|   | Custom item models    |  | Display entity props  |  | Textures & models  |  |
|   | Data Components       |  | Barrier collision     |  | Sound manifests    |  |
|   | CustomModelData       |  | Seat interactions     |  | ZIP compilation    |  |
|   +-----------------------+  +-----------------------+  +--------------------+  |
|                                                                                 |
|   +-------------------------------------------------------------------------+   |
|   |                           TARGET MANAGEMENT                             |   |
|   | Fleet connection monitor, live health indicators, and sync commands     |   |
|   +-------------------------------------------------------------------------+   |
+---------------------------------------------------------------------------------+

Workspaces in Detail

1. Item Studio

Design custom items with full fidelity for modern Minecraft versions:

  • Minecraft 1.21 Data Components: Configure native item_model keys pointing to custom definitions.
  • CustomModelData Support: Provide fallback numeric IDs for legacy resource packs and plugins.
  • Visual Attributes Editor: Customize item names, colorized lore formatting (MiniMessage / legacy colors), rarity, enchantments, and item flags.
  • Real-Time Deployment: Push modified item definitions directly into active Paper servers with a single click.

2. Block Studio (Virtual Props & State Machines)

Author custom furniture, 3D decorative blocks, and props without registering tile entities or lagging server performance:

  • PacketEvents Display Previews: Visual configuration of display entity scales, translation offsets, and rotation angles.
  • State Machines & Variants: Dedicated tab to configure multiple named states (default_state, states), distinct block models, light levels (0–15), entry sounds, and quick presets (Lamps, Doors/Gates).
  • Dynamic Hitboxes: Configure solid (solid) or passable (passable) collision per state with safe horizontal player ejection on close.
  • Physical Collision Anchors: Automatically bind invisible barrier or structure void blocks across relative footprint coordinates.
  • Interactive Sit & Lay Mechanics: Attach passenger seats to furniture props allowing players to sit or lie down by right-clicking.
  • Break Lifecycle: Link custom prop drops and sound effects upon block destruction.

3. Pack Manager

Comprehensive workspace for packaging visual assets:

  • Universal Multi-Version Matrix: Real-time visualization of the 4-layer packaging architecture: Base Layer (1.21.0 - 1.21.1, formats 34..41), Items V2 (1.21.2+, formats 42..max), Modern Shaders (1.21.4+, formats 46..max), and auto-synthesized texture atlases.
  • Layer Precedence Manager: Drag-and-drop or configure layer evaluation priority for Studio assets, workspace files, and ingested third-party pack sources.
  • Pre-Flight Conflict Auditor: Interactive diagnostic modal displaying blocking CustomModelData collisions, missing physical texture references, core shader overlaps, and mipmap/animation safety warnings.
  • Pack Manifest Configurator: Define base format, operator-configurable maximum format boundaries (max_inclusive), and description metadata.
  • One-Click Build: Trigger server-side compilation, review deterministic SHA-1 digests, and verify player download links.

4. Target Management

Centralized fleet dashboard for all linked Paper servers:

  • Real-Time Status: Observe WebSocket connectivity, latency, and agent build versions.
  • Instant Actions: Broadcast catalog refreshes, reload resource packs, or test player delivery.