Resource icon

    SMBEdit 0.1.9

    StarMade Blueprint Editor

    This editor allows changes to StarMade blueprints that are either difficult or too tedious to do with he official client.
    SMBEdit called from command prompt is compatible with both python2.7 and python3, and should work on all platforms.
    The graphical user interface of SMBEdit requires python3.6 and several extra pip packages.
    Using the GUI allows the import of 3D models from .stl and .obj files, if triangular facets are used.

    Installation instructions can be found at:
    Installation · p-hofmann/SMBEdit Wiki · GitHub

    A manual for command prompt usage and examples can be found there:
    Command prompt usage · p-hofmann/SMBEdit Wiki · GitHub
    Examples · p-hofmann/SMBEdit Wiki · GitHub

    # Features:

    * Import 3D model from .obj, .stl (GUI only, experimental)
    * Auto-shape: Set wedges on edges or tetra/corner shapes on corners automatically.
    * Change entity type
    * Change entity class
    * Exchange all hull blocks with std./adv. Armor blocks or the other way around.
    * Mirror entity at core/center at each axis.
    * Move core/center
    * Remove blocks
    * Removes outdated blocks
    * Replaces old style docked entities with rail docked entities.
    * Replace all blocks of a block type with another block type

    # Restrictions
    This editor works with StarMade blueprints from v0.199.253 to v0.199.651.
    Older blueprint versions, smd2 and some old smd3, are not guaranteed to work.
    It is recommended to use the StarMade client to update a blueprint before using with SMBEdit.
    But if you notice that the StarMade client fails to load some turret heads from some smd2 blueprints,
    try converting it with SMBEdit.

    ## Meta file / Docked entities
    Reading/manipulation of the 'meta.smbpm' file is very rudimentary at the moment and can lead to errors.
    If a blueprint is deleted after loading a single player game, or it fails to upload, it probably is because of a faulty meta file.
    Write me an 'issue' on github, ideally with a link to the blueprint so I can try fixing it.

    ## Header file
    The statistical info of an entity, read from the 'header.smbph' file, is not updated after blocks are modified.
    But this causes no known problems.

    ## Turrets / Docked entities
    Old style docked entities, docked to "Turret Docking Unit" or "Docking Module", are always converted to rail docked entities

    # Bug Report and Suggestions:
    To report a bug or make a suggestion write here in the forum, or
    an 'issue' can be opened on Github, or send me a message at

    # More information:
    Home · p-hofmann/SMBEdit Wiki · GitHub
    First release
    Last update
    4.38 star(s) 8 ratings

    Latest updates

    1. Pip library, GUI with 3D Model import (experimental)

      It is now possible to install SMBEdit as pip library. Thanks Septaris! The instruction can be...
    2. Fixed parsing block config

      Bugfix: Parsing block config of Starmade version 0.199.472 caused a crash. Thanks to Haalon, for...
    3. Hotfix: coverting block data

      Hotfix: Parsing orientation bits in a less restricted way caused errors when reading messy block...

    Latest reviews

    Awesome utility! I use it to convert OBJ files I strip with Blender to make cool new ships.

    Note that the install instructions for linux did not work for me. No such thing as a Pip3.6 command, so I created my own install instructions here, if anyone is interested:

    Also NOTE that you cannot use the latest version of StarMade with this! You must use a pre-systems 2.0 version. I use version 0.199.654#20170826_140955
    This stuff crashes even when im trying to load smal blueprint ;(
    Sorry to hear it.
    I would appreciate it if you could give me a detailed description of the crash. Either write me a pm, or make a post:
    Maybe I am doing something wrong, but all i get is - 'NoneType' object has no attribute 'text' error. Both on Linux and Win,
    Fixed, thank you.
    Essential tool when you have to move a core. Makes building SO much easier when you don't have to worry about planning core position right from the start!
    Nice update :)

    A hugely useful tool when importing models. Saves literally hours of tedious work!
    Its till awesome ! I tested it a few times and it worked great :D But sometimes it looks like the process crashed, because theres no progress bar or something like this. The wedging is still buged, tried -at und -aw together and my ship looked kinda destroyed after it finished, because often the wrong blocks were placed, but otherwise its a great tool ! :D
    Thanks for the feedback!

    With '-verbose' more info is shown on what is happening.

    The auto-shape function is a 'quick and dirty' solution.
    It looks at the positions directly adjacent to it, no diagonals, and tries to guess what shape is right.
    I think it would work best with a hull that is 2 block thick or has other blocks on the 'inside' below the hull.
    I just hope it does far more blocks right than wrong.
    An option to restriction this to cube shaped blocks to prevent overwriting correct blocks would be a helpful next step.
    Its just excellent ! I havent tried it yet, but the idea is very good and i hope this will help people to create amazing ships faster than before :) But if it possible that you could add an Automatic wedge function in the future ? Keep the great work up !
    I lost more than a few nights on the auto wedge/corner problem.
    It can be quite difficult to tell, which side of the hull is 'in' and which is 'out', not to mention that block orientation in StarMade it a nightmare in of its own.

    There are cases where it is obvious and it would save a lot of time already. I will give it another night of thought.
    I was just talking to a faction mate who wanted to make his 200k ship a different color when i told him about how its such a pain to replace the hull block color on large ships without either taking a long time replacing in small sections or crashing constantly trying to push the limit.. So when i logged off and seen this on the docks imagine my surprise.. Were your ears burning? At any rate, thanks for this awesome tool!
    I have been considering to add something like '-color blue:red' and it would exchange all hull of one color with the other.
    But until I need it myself I am to lazy to do it. :)

    When exchanging blocks of the same shape, the block orientation should stay conserved, if not it would help if you could tell the the block ids which were used so I can fix it.