{"id":15027328,"url":"https://github.com/a1studmuffin/spaceshipgenerator","last_synced_at":"2025-04-09T03:09:23.841Z","repository":{"id":41044929,"uuid":"61088333","full_name":"a1studmuffin/SpaceshipGenerator","owner":"a1studmuffin","description":"A Blender script to procedurally generate 3D spaceships","archived":false,"fork":false,"pushed_at":"2024-05-25T16:11:50.000Z","size":6900,"stargazers_count":7664,"open_issues_count":25,"forks_count":437,"subscribers_count":220,"default_branch":"master","last_synced_at":"2024-10-29T14:59:30.776Z","etag":null,"topics":["3d","blender-scripts","game-development","procedural-generation","python","spaceship"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a1studmuffin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-14T03:16:07.000Z","updated_at":"2024-10-25T09:17:27.000Z","dependencies_parsed_at":"2022-07-13T18:21:09.731Z","dependency_job_id":"e79ecfa2-ae97-44ad-b223-167d79cbf049","html_url":"https://github.com/a1studmuffin/SpaceshipGenerator","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a1studmuffin%2FSpaceshipGenerator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a1studmuffin%2FSpaceshipGenerator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a1studmuffin%2FSpaceshipGenerator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a1studmuffin%2FSpaceshipGenerator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a1studmuffin","download_url":"https://codeload.github.com/a1studmuffin/SpaceshipGenerator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247968366,"owners_count":21025823,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","blender-scripts","game-development","procedural-generation","python","spaceship"],"created_at":"2024-09-24T20:06:13.911Z","updated_at":"2025-04-09T03:09:23.823Z","avatar_url":"https://github.com/a1studmuffin.png","language":"Python","readme":"# Spaceship Generator\n\nA Blender script to procedurally generate 3D spaceships from a random seed.\n\n![Spaceship screenshots](https://raw.githubusercontent.com/a1studmuffin/SpaceshipGenerator/master/screenshots/spaceships_grid.jpg)\n\nUsage\n-----\n* Install Blender 2.80 or greater: http://blender.org/download/\n* Download newest `add_mesh_SpaceshipGenerator.zip` from the [Releases](https://github.com/a1studmuffin/SpaceshipGenerator/releases) section\n* Under Edit \u003e Preferences... \u003e Add-ons \u003e Install... open the downloaded ZIP file\n* Under Edit \u003e Preferences... \u003e Add-ons enable the \"Add Mesh: Spaceship Generator\" script (search for \"spaceship\")\n* Add a spaceship in the 3D View under Add \u003e Mesh \u003e Spaceship\n* Expand the Spaceship tab that appears in the bottom left of the viewport to adjust procedural generation settings\n\nHow it works\n------------\n\n![Step-by-step animation](https://raw.githubusercontent.com/a1studmuffin/SpaceshipGenerator/master/screenshots/step-by-step-animation.gif)\n\nWatch on YouTube: https://www.youtube.com/watch?v=xJZyXqJ6nog\n\n* Start with a box.\n* Build the hull: Extrude the front/rear faces several times, adding random translation/scaling/rotation along the way.\n* Add asymmetry to the hull: Pick random faces and extrude them out in a similar manner, reducing in scale each time.\n* Add detail to the hull: Categorize each face by its orientation and generate details on it such as engines, antenna, weapon turrets, lights etc.\n* Sometimes apply horizontal symmetry.\n* Add a Bevel modifier to angularize the shape a bit.\n* Apply materials to the final result.\n* Take over the universe with your new infinite fleet of spaceships.\n\nExtreme examples\n----------------\nThe following screenshots were created using extreme values for the number of hull segments and asymmetry segments to show how the algorithm works.\n\n![Extreme spaceship screenshots](https://raw.githubusercontent.com/a1studmuffin/SpaceshipGenerator/master/screenshots/extreme_examples.jpg)\n\nTips and Tricks\n---------------\n* 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.\n* You can provide a seed to the `generate_spaceship()` function to always generate the same spaceship. For example, `generate_spaceship('michael')`.\n* The `generate_spaceship()` function takes many more parameters that affect the generation process. Try playing with them!\n* You can replace the textures with your own ones. All textures are applied using global-space cube UVs. `hull_normal.png` is a normal map that adds extra surface \"greebles\". `hull_lights_diffuse.png` is an additive diffuse texture to set the color of the window lights. `hull_lights_emit.png` is an emissive texture to make the windows glow in darkness.\n\nCredits\n-------\nWritten for fun as part of the [/r/proceduralgeneration](https://www.reddit.com/r/proceduralgeneration/) June 2016 [monthly challenge](https://www.reddit.com/r/proceduralgeneration/comments/4mn9gj/monthly_challenge_7_june_2016_procedural/).\n\nReleased under the [MIT License].\n\nAuthored and maintained by Michael Davies.\n\n\u003e GitHub [@a1studmuffin](https://github.com/a1studmuffin)\n\u003e Twitter [@butterparty](https://twitter.com/butterparty)\n\nSpecial thanks to [@panzi](https://github.com/panzi) for bugfixes, a proper GUI and build script. Also to [@mjrthemes](https://github.com/mjrthemes) for bugfixing, and [@LendoK](https://github.com/LendoK) for the 2.80 port.\n\n[MIT License]: http://mit-license.org/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa1studmuffin%2Fspaceshipgenerator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa1studmuffin%2Fspaceshipgenerator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa1studmuffin%2Fspaceshipgenerator/lists"}