Skip to content

imivi/se-blueprinter

Repository files navigation

SE Blueprinter

SE Blueprinter is an online tool to convert 3D models into Space Engineers blueprints.

Try it now at https://imivi.github.io/se-blueprinter

Features

  • Supports both cubes and sloped blocks (full list below)
  • Choose between large/small grids, and heavy/light armor
  • Make meshes hollow

How to use

  1. Upload your 3d model. The format must by GLTF binary (.glb extension). If you have an STL or another format you can use Blender to convert it to .glb
  2. Pick between large/small grid, heavy/light armor, and static/ship grid.
  3. Optionally, enter your player information
  4. Create the blueprint preview. You can view the generated preview layer by layer.
  5. Download the blueprint as a zip file. Unzip it and place the folder inside the SE blueprints folder. By default it's C:/Users/<YOUR_USERNAME>/AppData/Roaming/SpaceEngineers/Blueprints/local/

Caveats & tips

Here's a few tips to achieve the best results using SE Blueprinter.

Tip #1: apply transformations and modifiers

Before exporting your 3D model, make sure to:

  • apply rotation and scale to all meshes! (in Blender: select meshes > CTRL+A > Rotation & Scale)
  • apply modifiers to all meshes (in the Blender export dialog: Data > Mesh > Apply Modifiers)

"Apply modifiers"

Tip #2: orient faces outward

SE Blueprinter relies on face normals (i.e. the direction that the faces are facing) to detect where blocks should go, so if the normals are wrong you may end up with missing blocks.

To fix this, make sure that all mesh faces are oriented outward. This is easy in Blender:

  • Select the mesh

  • Enter edit mode (tab)

  • Show normals: in Mesh edit mode, click on the icon for Display normals and increase the size slider:

    "Show face normals in Blender"

  • Still in edit mode, select all faces (shortcut: A)

  • hit mesh > normals > recalculate outside

    "Recalculate normals"

Tip #3: simplify your meshes

Removing unnecessary faces, edges and vertices can improve both accuracy and performance.

  1. Select a mesh
  2. Enter edit mode (tab)
  3. Select all faces (shortcut: A)
  4. hit mesh > delete > limited dissolve

Compare before and after:

"Limited dissolve"

More info: https://docs.blender.org/manual/en/latest/modeling/meshes/editing/mesh/delete.html#limited-dissolve

Tip #4: design your meshes as solids

For the best results, every mesh should be "watertight" or "solid", meaning that all mesh faces create a single continuous surface with no gaps or holes, thus the back of these faces is never visible from the outside. This kind of mesh is also called "manifold".

Tip #5: 1 meter = 1 block

In Space Engineers, the size of a large block is 2.5m, and a small block is 0.5m. However, SE Blueprinter treats 1m as 1 block, regardless of the grid size you pick.

FAQ

The blueprint is missing some blocks / it has blocks that should not be there

  • Make sure the face normals of the 3D model are facing outwards
  • Try changing the raycast direction before generating the blueprint
  • Try splitting the model into multiple meshes, as this can improve accuracy as well as performance

Is this tool safe to use? Are my blueprints being uploaded somewhere?

SE Blueprinter runs entirely in your browser, so all your data stays private.

Supported blocks

Only armor blocks are supported.

Block Name Supported?
block block ✔️
slope slope ✔️
corner corner ✔️
inv_corner inv corner ✔️
half half ✔️
half_slope half slope ✔️
slope_211_base slope 211 base ✔️
slope_211_tip slope 211 tip ✔️
inv_corner_211_base inv corner 211 base ✔️
inv_corner_211_tip inv corner 211 tip ✔️
corner_211_base corner 211 base ✔️
corner_211_tip corner 211 tip ✔️
corner_square corner square ✔️
corner_square_inv corner square inv ✔️
half_corner half corner ✔️
half_slope_corner half slope corner ✔️
half_slope_corner_inv half slope corner inv ✔️
half_sloped_corner half sloped corner ✔️
half_sloped_corner_base half sloped corner base ✔️
half_slope_inv half slope inv ✔️
round_slope round slope ✔️
round_corner round corner ✔️
round_inv_corner round inv corner
sloped_corner sloped corner ✔️
sloped_corner_base sloped corner base ✔️
sloped_corner_tip sloped corner tip ✔️
panel panel ✔️ (recommended mesh thickness: 0.2)

Acknowledgements

Info for developers

Add more blocks

  1. Edit src/blocks/block-names.csv and add the names for the new blocks
  2. run npm run save-block-names to convert the csv to json (src/blocks/block-names.json)
  3. Edit src/models/blocks.blend adding the blocks in all orientations
  4. Export to public/cubes.glb
  5. Re-create the block signatures (steps below)

Update block signatures

  1. Run the webapp in debug mode: http://localhost:5173/se-blueprinter?debug=true
  2. Load any example model
  3. In the debug panel, click on copy signatures
  4. Paste the signatures in src/blocks/block-signatures-38.json

About

Create Space Engineers blueprints from 3D models.

Topics

Resources

License

Stars

Watchers

Forks

Languages