Skip to content

Home

Jump to bottom
Recep Samet Yıldız edited this page Sep 1, 2026 · 1 revision

UEBPCracker Wiki

Welcome to the UEBPCracker wiki — the complete documentation for the AI-driven Blueprint automation plugin for Unreal Engine 5.8.

Quick Navigation

Section Description
Getting Started Installation, prerequisites, first run
Architecture How the plugin works, commit pipeline, data flow
Tool Reference All MCP tools with parameters and examples
Blueprint Spec Format .uebp.json v2 schema reference
Security Model L0–L3 layers, policy configuration, error codes
Snapshot and Fingerprint Blake3 fingerprints, snapshot store, diff
Patch and Idempotency Three-way ownership diff, sealed plan hash
Transaction and Recovery FScopedTransaction, undo loop, durable backup
Extra Modules Domain extension roadmap (Enhanced Input, Gameplay Tags, ...)
UE 5.8 Gotchas Confirmed API quirks and proven workarounds
Troubleshooting Common errors, log categories, debug checklist
Contributing Build environment, code standards, PR process

What is UEBPCracker?

UEBPCracker is an editor-only C++ plugin that lets MCP-compatible AI agents (VS Code Copilot, Claude, Codex, any MCP client) safely create, read, edit, compile, and save Unreal Engine Blueprints through a contract-validated, transactional API.

User (natural language)
    │
    ▼
AI Agent  (VS Code / Copilot / Claude / Codex)
    │  JSON-RPC tool call
    ▼
Unreal MCP  (localhost:8000/mcp)
    │  Toolset Registry
    ▼
UEBPCracker Toolset  (15+ tools)
    │
    ├─ Preflight  → schema & permission validation
    ├─ Transaction → FScopedTransaction mutation
    ├─ Postcondition → structural assertion
    └─ Commit Pipeline → compile → data validation → save

The plugin does not host its own LLM, produce .uasset binaries directly, or give the AI unrestricted engine access. It is a controlled, contract-validated bridge.

Project Status

Metric Value
Core modules 28/28 complete
Extra modules 4/22 complete (Enhanced Input foundation)
DoD 31/31 ready
UE version 5.8.2 (CL 56702186)
License MIT

Changelog

See CHANGELOG.md for the full release history.

Author

Recep Samet Yıldız — yildizportfolio.com · github.com/ThePecerowski

Clone this wiki locally