A Blender script to procedurally generate 3D spaceships from a random seed.
Go to file
Michael Davies f9d9a3cdff Updated LICENSE with extra section for content 2017-08-10 12:11:16 +10:00
screenshots Added step-by-step animation 2016-06-15 19:15:47 +10:00
textures Added source code and textures 2016-06-15 13:48:04 +10:00
.gitignore Git ignore thumbs.db 2016-06-21 15:11:04 +10:00
LICENSE Updated LICENSE with extra section for content 2017-08-10 12:11:16 +10:00
README.md Fixed issue #12 when installing via master ZIP 2016-07-10 23:04:24 +10:00
__init__.py Ticked version # to 1.1.2 2016-11-20 21:53:10 +11:00
build.py indent with spaces 2016-06-19 03:52:53 +02:00
spaceship_generator.py Fixed bevel modifier script error when Blender non-English language is used and Translate New Data is enabled 2016-06-21 14:56:20 +10:00

README.md

Spaceship Generator

A Blender script to procedurally generate 3D spaceships from a random seed.

Spaceship screenshots

Usage

  • Install Blender 2.76 or greater: http://blender.org/download/
  • Download newest add_mesh_SpaceshipGenerator.zip from the Releases section
  • Under File > User Preferences... > Add-ons > Install From File... open the downloaded ZIP file
  • Under File > User Preferences... > Add-ons enable this script (search for "spaceship")
  • Add a spaceship in the 3D View under Add > Mesh > Spaceship

How it works

Step-by-step animation

Watch on YouTube: https://www.youtube.com/watch?v=xJZyXqJ6nog

  • Start with a box.
  • Build the hull: Extrude the front/rear faces several times, adding random translation/scaling/rotation along the way.
  • Add asymmetry to the hull: Pick random faces and extrude them out in a similar manner, reducing in scale each time.
  • Add detail to the hull: Categorize each face by its orientation and generate details on it such as engines, antenna, weapon turrets, lights etc.
  • Sometimes apply horizontal symmetry.
  • Add a Bevel modifier to angularize the shape a bit.
  • Apply materials to the final result.
  • Take over the universe with your new infinite fleet of spaceships.

Extreme examples

The following screenshots were created using extreme values for the number of hull segments and asymmetry segments to show how the algorithm works.

Extreme spaceship screenshots

Tips and Tricks

  • By default the script will delete all objects starting with Spaceship before generating a new spaceship. To disable this feature, remove or comment out the call to reset_scene() around line 735 in the main function.
  • You can provide a seed to the generate_spaceship() function to always generate the same spaceship. For example, generate_spaceship('michael').
  • The generate_spaceship() function takes many more parameters that affect the generation process. Try playing with them!

Credits

Written for fun as part of the /r/proceduralgeneration June 2016 monthly challenge.

Released under the MIT License.

Authored and maintained by Michael Davies.

GitHub @a1studmuffin Twitter @butterparty

Special thanks to @panzi for bugfixes, a proper GUI and build script. Also to @mjrthemes for bugfixing.