#################
Quick Start
#################



You can either:

1. Open the *starship_generator* .blend file that comes alongside the add-on installation file and start by changing the *Master Seed* parameter on the *Starship Controls* modifier on the right hand panel of Blender.  Remember to change to *Rendered View* in the top right of the main viewport.

    .. image:: images/starship_gen_main_file.jpg
        :alt: Starship Generator Blend File

2. To add a Starship to a scene using Blender's *Add* menu, follow the steps below.

=================
Using the Add-on
=================

|quickstart_video|

.. |quickstart_video| raw:: html

    <iframe width="560" height="315" src="https://www.youtube.com/embed/jjp9Ef6Qx20" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>


#. Open Blender and :ref:`install<Installation>` the add-on if you haven't already.
#. Start a new scene and delete the default cube, or open an existing scene.
#. Add a *Starship* object through the standard *Add -> Mesh* menu in Blender. Access this menu either through the *Object* menu at the top of the 3D view or by pressing *Shift+A*. Select the *Starship* option:

    .. image:: images/add_starship_menu.jpg
        :alt: Add Menu

#.  A new random starship model will be added to the scene.

    .. image:: images/add_starship_scene.jpg
        :alt: Adding a starship to the scene

#. Expand the small menu that appears in the bottom left of the viewport marked *Starship*.

    .. image:: images/add_starship_menu_expand.jpg
        :alt: Menu Expand

#. Change the seed number until you find a shape you might like.  Don't worry if this initial menu disappears when you click away: you can always change the seed value later by going to the :ref:`Starship Controls Modifier`.

    .. image:: images/seed_change_viewport.gif
        :alt: Change Seed Object

#. Note in the Outline view that a new *Starship Generator* **Collection** has been added to the scene, which contains the *Starship* object and its hidden supporting components. Adding more starships will add more collections:

    .. image:: images/starship_generator_collection.jpg
        :alt: Starship Generator Collection

#. With the *Starship* object selected, go to the *modifiers* tab where you can change the :ref:`controls`:

    .. image:: images/starship_modifiers_screenshot.jpg
        :alt: Starship Generator Modifier Panel