mirror of https://github.com/unity-atoms/unity-atoms.git synced 2025-01-29 19:32:51 -05:00

Miika Lönnqvist 532008c768

#189 Restructure tutorials and add two new tutorials (#190 )

* Restructure tutorials and add two new tutorials

- Non-generated documentation review and edit
  - Consistent terminology
  - Stylistic changes
  - Minor structure changes
  - Minor clarifications
  - Typo fixes

- Split basic tutorial into two
- Tutorials are easier to follow when they are short and to the point
- Added event and variable instancer tutorials
- Had to bump node version for the docker container to work

* #189 - Fixing minor nitpicks

Co-authored-by: Adam Ramberg <adam@mambojambostudios.com>

2020-08-23 12:13:10 +02:00

3.3 KiB

Raw Blame History

id	title	hide_title	sidebar_label
quick-start	Quick start	true	Quick start

Quick start

Installation

Prerequisite: Since Unity Atoms is using the Unity Package Manager (UPM) you need to use Unity version 2018.3 >=

NPM

Add the following to your manifest.json:

{
    "scopedRegistries": [
        {
            "name": "NPM Registry",
            "url": "https://registry.npmjs.org",
            "scopes": [
                "com.mambojambostudios.unity-atoms-core",
                "com.mambojambostudios.unity-atoms-base-atoms",
                "com.mambojambostudios.unity-atoms-fsm",
                "com.mambojambostudios.unity-atoms-mobile",
                "com.mambojambostudios.unity-atoms-mono-hooks",
                "com.mambojambostudios.unity-atoms-tags",
                "com.mambojambostudios.unity-atoms-scene-mgmt",
                "com.mambojambostudios.unity-atoms-ui"
            ]
        }
    ],
    "dependencies": {
        ...
        "com.mambojambostudios.unity-atoms-core": "4.3.0",
        "com.mambojambostudios.unity-atoms-base-atoms": "4.3.0",
        "com.mambojambostudios.unity-atoms-fsm": "4.3.0",
        "com.mambojambostudios.unity-atoms-mobile": "4.3.0",
        "com.mambojambostudios.unity-atoms-mono-hooks": "4.3.0",
        "com.mambojambostudios.unity-atoms-tags": "4.3.0",
        "com.mambojambostudios.unity-atoms-scene-mgmt": "4.3.0",
        "com.mambojambostudios.unity-atoms-ui": "4.3.0",
        ...
    }
}

Note that the core and base atoms packages are mandatory while the others are optional. If you don't want a subpackage, simply remove it from your dependencies.

OpenUPM

The package is available on the openupm registry. It's recommended to install it via openupm-cli.

# required
openupm add com.mambojambostudios.unity-atoms-core
openupm add com.mambojambostudios.unity-atoms-base-atoms

# optional
openupm add com.mambojambostudios.unity-atoms-fsm
openupm add com.mambojambostudios.unity-atoms-mobile
openupm add com.mambojambostudios.unity-atoms-mono-hooks
openupm add com.mambojambostudios.unity-atoms-tags
openupm add com.mambojambostudios.unity-atoms-scene-mgmt
openupm add com.mambojambostudios.unity-atoms-ui

Github URL

There is an alternative approach installing Unity Atoms using the Github URL to this repo.

Add the following to your manifest.json:

{
    "dependencies": {
        ...
        "com.mambojambostudios.unity-atoms": "https://github.com/AdamRamberg/unity-atoms.git#master",
        ...
    }
}

Updating

Updating Unity Atoms to a new release when using the Unity Package Manager is as easy as opening the Package Manager window and clicking on Update on the selected package.

Follow Unity Atoms on Github to stay up-to-date on the current version.

Create your first Atom

You are now ready to create your first Atom. Simply right click somewhere in the Project window and go to Create / Unity Atoms and pick the Atom of your choice:

Now you are ready to go to Overview and philosopy to learn more about Unity Atoms!

3.3 KiB Raw Blame History