Official v1.0 Release • Reforged Eden 2 Ready

Empyrion Blueprint Generator

The all-in-one standalone 3D blueprint suite for Empyrion: Galactic Survival. Reverse-engineered binary parsing, AI photo-to-voxel sculpting, procedural 3D text signage, and seeded color auto-painting.
Created and Coded by Replica

⚡ Size: 28.4 MB • 💻 OS: Windows 10 / 11 (64-bit) • 🛡️ Zero Setup: No Python or runtimes needed • 🚀 Scenario: Vanilla & Reforged Eden 2
In-game 3D Text Sign
Spawned In-Game
"WELCOME TRAVELERS! READY FOR LAUNCH"
Generated from text in seconds and placed directly onto an alien planet surface.
In-game Space Station Orbit
Space Orbit
Mandalorian Space Citadel (BA)
Generated from a 2D helmet image, customized in-game, and orbiting a planetary ring system.

Built for Builders, Designers & Modders

Everything needed to inspect, customize, and generate Empyrion assets in a high-speed hardware-accelerated desktop suite.

Read & View in Free 3D

Direct binary decoding loads 35,000+ block dreadnoughts in ~1.2 seconds. Three.js InstancedMesh GPU acceleration delivers fluid 60 FPS. Free 3-axis trackball orbit (left-click), pan (right-click), smooth wheel zoom, and center auto-fitting.

Photo to Blueprint

Upload top-down or 3/4 concept art. Automatic alpha isolation extracts silhouettes, performs bilateral flight symmetry, applies thickness tapering with cockpit elevations, and carves hollow cabin chambers ready for interior detailing.

Text to Blueprint (3D Signs)

Procedurally generate massive 3D signs for bases and space stations using a built-in 5x7 bitmap matrix font. Customize scale (1x–4x), thickness (1–10 blocks), and materials (glowing neon, solid steel, glass) with automatic word wrapping.

Random Color Auto-Painter

Spam the randomize button or enter exact seed numbers to roll cohesive color themes. Maps primary hull, secondary greebles, and cockpit glass across 8 architectural themes (Beskar Prime, Stealth, Industrial, Faction Vanguard) with live preview and permanent .epb writing.

Building Sheets & Layer Slicing

Generate high-contrast 2D floor plans of any horizontal layer ($Y$-slice). Clearly inspect structural walls, airtight seals, and internal device layouts for manual survival mode building or repair projection.

YAML Round-Trip & Modding

Export any loaded blueprint to a clean, human-readable .yaml structure. Easily edit block coordinates, metadata, and device groups in a text editor, or incorporate generated blueprints into automated scenario scripting pipelines.

Reverse-Engineering the .EPB Format

How this tool reads, synthesizes, and round-trips Empyrion's binary blueprint container without corruption.

📦 1. Binary Container & Raw Deflate Stream

Empyrion's .epb begins with a 16-byte header containing the magic identifier 0x78945245, blueprint version integer (v25), vessel class byte (SV/CV/HV/BA), and bounding dimensions $(W, H, D)$. The file body is a raw Deflate stream (PK zip stream '0', RFC 1951) requiring decompression with zlib.decompress(data, -15) to bypass missing zlib stream wrappers.

Magic: 0x78945245 ('ER\x94x') | Version: 25 Stream: Raw Deflate (wbits = -15) Header: [Magic:4B][Ver:4B][Type:1B][Bounds:6B]

⚡ 2. 1-Bit Occupancy Bitmask

To prevent storing millions of empty air voxels in massive $100\times100\times100$ bounding spaces, the format encodes a 1-bit occupancy bitmask of length $\lceil(W \times H \times D)/8\rceil$ bytes. A bit value of $1$ signifies a solid block exists at $(X, Y, Z)$; only occupied voxels consume space in subsequent data arrays.

Bitmask Length = ceil((W * H * D) / 8) bytes Occupied Test: (bitmask[idx >> 3] >> (idx & 7)) & 1 Sequential Voxel Stream follows immediately

🧩 3. BlocksConfig.ecf Mapping & Packing

Every occupied block is represented by a 32-bit packed integer (11-bit Block ID, 5-bit Rotation, 7-bit Shape Variant, and 9-bit State Flags). The engine maps these IDs against our database of 1,893 block entries extracted from BlocksConfig.ecf (such as HullCombatFullLarge, Core, and Cockpit).

Bits 0..10 (11b): Block Type ID (0..2047) Bits 11..15 (5b) : 3D Block Rotation (0..31) Bits 25..31 (7b) : Geometric Shape Variant Index

🎨 4. 30-Bit Color Matrices & YAML Round-Trip

Each cube voxel stores 6 faces (Top, Bottom, North, South, East, West). Each face stores a 5-bit palette index ($2^5 = 32$), packing into a 30-bit integer mapping into the game's standard 32-color RGB palette. All synthesis routines round-trip through verified serialization, guaranteeing 100% crash-free spawning in-game.

Face Palette: 6 faces * 5 bits = 30 bits Colors: 32-entry RGB Palette (0 to 31) Device Groups: Packed coordinates + LEB128 names

How to Use the Tool

Get up and running in seconds with zero complicated configuration.

01

Download & Extract

Download Empyrion_Blueprint_Generator_v1.0.zip and extract it anywhere on your Windows PC (e.g. Desktop or Tools folder).

02

Double-Click Launch

Run Empyrion_Blueprint_Gen_v1.0_Replica.exe. The application automatically starts the local backend and opens the desktop 3D window.

03

Load or Generate

Browse 3,990+ scenario prefabs, open your own .epb, or click "Photo to Blueprint" / "Text to Blueprint" to synthesize a new vessel or 3D sign.

04

Paint & Export

Roll color seeds with the Auto-Painter, preview in real-time, then click "Download .EPB" to copy the generated blueprint directly into your Empyrion Saves folder.

Windows SmartScreen First-Launch Notice

When running Empyrion_Blueprint_Gen_v1.0_Replica.exe for the first time, Windows SmartScreen may display a prompt stating "Windows protected your PC — SmartScreen prevented an unrecognized app from starting".

This is normal for newly released standalone community tools. Because independent modding utilities do not carry expensive ($400+/year) commercial enterprise code-signing certificates, SmartScreen simply asks for your confirmation on the first launch.

  • Click "More info" on the Windows SmartScreen dialog.
  • Click "Run anyway" to launch the tool.
  • The application will boot immediately and launch the 3D desktop window.

Tip for Photo-to-Blueprint: The generative engine provides an accurate volumetric hull, flight symmetry, and functional starter core from 2D imagery. It is intended as a rapid prototyping starting point for Creative Mode where you can add specialized interior blocks, weapons, and thruster detailing before flying in Survival.

Ready to Build Your Fleet?

Get the standalone executable now and start creating custom vessels, space station signs, and exploring blueprints in full 3D.