mirror of
https://github.com/unity-atoms/unity-atoms.git
synced 2025-01-22 08:08:51 -05:00
120 lines
5.9 KiB
Markdown
120 lines
5.9 KiB
Markdown
# ⚛️ Unity Atoms
|
|
|
|
[](https://openupm.com/packages/com.unity-atoms.unity-atoms-core/)
|
|
[](https://openupm.com/packages/com.unity-atoms.unity-atoms-base-atoms/)
|
|
[](https://openupm.com/packages/com.unity-atoms.unity-atoms-fsm/)
|
|
[](https://openupm.com/packages/com.unity-atoms.unity-atoms-mobile/)
|
|
[](https://openupm.com/packages/com.unity-atoms.unity-atoms-mono-hooks/)
|
|
[](https://openupm.com/packages/com.unity-atoms.unity-atoms-tags/)
|
|
[](https://openupm.com/packages/com.unity-atoms.unity-atoms-scene-mgmt/)
|
|
[](https://openupm.com/packages/com.unity-atoms.unity-atoms-ui/)
|
|
|
|
_Tiny modular pieces utilizing the power of Scriptable Objects_
|
|
|
|
## Influences
|
|
|
|
Unity Atoms is derived from and a continuation of Ryan Hipple's [talk](https://www.youtube.com/watch?v=raQ3iHhE_Kk&t=2787s) from Unite 2017. The original source code can be found [here](https://github.com/roboryantron/Unite2017).
|
|
|
|
[This](https://www.youtube.com/watch?v=6vmRwLYWNRo&t=738s) talk by Richard Fine is a forerunner to Ryan Hipple's talk during Unite 2016.
|
|
|
|
## Motivation
|
|
|
|
The general approach to building scripts in Unity often generates a code base that is monolithic. This results in that your code is cumbersome to test, non-modular and hard to debug and understand.
|
|
|
|
Unity Atoms is an open source library that aims to make your game code:
|
|
|
|
- 📦 Modular _- avoid scripts and systems directly dependent on each other_
|
|
- ✏️ Editable _- Scriptable Objects makes it possible to make changes to your game at runtime_
|
|
- 🐛 Debuggable _- modular code is easier to debug than tightly coupled code_
|
|
|
|
## Installation
|
|
|
|
### NPM
|
|
|
|
_Prerequisite: Since Unity Atoms is using the Unity Package Manager (UPM) you need to use Unity version 2018.3 >=_
|
|
|
|
Add the following to your `manifest.json` (which is located under your project location in the folder `Packages`):
|
|
|
|
```
|
|
{
|
|
"scopedRegistries": [
|
|
{
|
|
"name": "NPM Registry",
|
|
"url": "https://registry.npmjs.org",
|
|
"scopes": [
|
|
"com.unity-atoms.unity-atoms-core",
|
|
"com.unity-atoms.unity-atoms-base-atoms",
|
|
"com.unity-atoms.unity-atoms-fsm",
|
|
"com.unity-atoms.unity-atoms-mobile",
|
|
"com.unity-atoms.unity-atoms-mono-hooks",
|
|
"com.unity-atoms.unity-atoms-tags",
|
|
"com.unity-atoms.unity-atoms-scene-mgmt",
|
|
"com.unity-atoms.unity-atoms-ui",
|
|
"com.unity-atoms.unity-atoms-input-system"
|
|
]
|
|
}
|
|
],
|
|
"dependencies": {
|
|
...
|
|
"com.unity-atoms.unity-atoms-core": "4.4.3",
|
|
"com.unity-atoms.unity-atoms-base-atoms": "4.4.3",
|
|
"com.unity-atoms.unity-atoms-fsm": "4.4.3",
|
|
"com.unity-atoms.unity-atoms-mobile": "4.4.3",
|
|
"com.unity-atoms.unity-atoms-mono-hooks": "4.4.3",
|
|
"com.unity-atoms.unity-atoms-tags": "4.4.3",
|
|
"com.unity-atoms.unity-atoms-scene-mgmt": "4.4.3",
|
|
"com.unity-atoms.unity-atoms-ui": "4.4.3",
|
|
"com.unity-atoms.unity-atoms-input-system": "4.4.3",
|
|
...
|
|
}
|
|
}
|
|
```
|
|
|
|
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`.
|
|
Note that subpackages may have additional dependencies.
|
|
|
|
### OpenUPM
|
|
|
|
The package is available on the [openupm registry](https://openupm.com). It's recommended to install it via [openupm-cli](https://github.com/openupm/openupm-cli).
|
|
|
|
```
|
|
# required
|
|
openupm add com.unity-atoms.unity-atoms-core
|
|
openupm add com.unity-atoms.unity-atoms-base-atoms
|
|
|
|
# optional
|
|
openupm add com.unity-atoms.unity-atoms-fsm
|
|
openupm add com.unity-atoms.unity-atoms-mobile
|
|
openupm add com.unity-atoms.unity-atoms-mono-hooks
|
|
openupm add com.unity-atoms.unity-atoms-tags
|
|
openupm add com.unity-atoms.unity-atoms-scene-mgmt
|
|
openupm add com.unity-atoms.unity-atoms-ui
|
|
openupm add com.unity-atoms.unity-atoms-input-system
|
|
```
|
|
|
|
## Documentation
|
|
|
|
The Unity Atoms docs are now published at **https://unity-atoms.github.io/unity-atoms**.
|
|
|
|
### Blog posts
|
|
|
|
- [Unity Atoms — Tiny modular pieces utilizing the power of Scriptable Objects](https://medium.com/@adamramberg/unity-atoms-tiny-modular-pieces-utilizing-the-power-of-scriptable-objects-e8add1b95201)
|
|
- [Announcing Unity Atoms v2](https://medium.com/@adamramberg/announcing-unity-atoms-v2-1719ef3e587e)
|
|
- [Unity Atoms v4 is out!](https://medium.com/@adamramberg/unity-atoms-v4-is-out-b15a37da49da)
|
|
|
|
## How does it work?
|
|
|
|
Read [this](https://medium.com/@adamramberg/unity-atoms-tiny-modular-pieces-utilizing-the-power-of-scriptable-objects-e8add1b95201) article on Medium for a great introduction to Unity Atoms.
|
|
|
|
## Looking for support?
|
|
|
|
For questions and support please join our [Discord channel](https://discord.gg/W4yd7E7).
|
|
|
|
## Maintainers
|
|
|
|
- [AdamRamberg](https://github.com/AdamRamberg)
|
|
- [soraphis](https://github.com/soraphis)
|
|
- [miikalo](https://github.com/miikalo)
|
|
|
|
We are looking for more people to join the team! Contact us if you want to jump aboard.
|