AdamRamberg/unity-atoms

⚛️ Tiny modular pieces utilizing the power of Scriptable Objects

1,390

stars

432

commits

primary language

Jul 17, 2026

updated

README

⚛️ Unity Atoms

Scriptable Object Architecture

Tiny modular pieces utilizing the power of Scriptable Objects
Inspired of Ryan Hipple's talk from Unite 2017 this project features a set of tiny composible "Atoms" that improve modularity in your project.

Motivation • Installation • Documentation • Discord • Aknowlegements •

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

... more in our Documentation

Installation

Requirements

Unity 2022.2+

Github Link

In the Package manager window, add a package via git url:

    Core: https://github.com/unity-atoms/unity-atoms.git?path=/Packages/Core#v4.6.2
    Base Atoms: https://github.com/unity-atoms/unity-atoms.git?path=/Packages/BaseAtoms#v4.6.2

for additional packages, just adjust the path

NPM

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.6.1",
        "com.unity-atoms.unity-atoms-base-atoms": "4.6.1",
        "com.unity-atoms.unity-atoms-fsm": "4.6.1",
        "com.unity-atoms.unity-atoms-mobile": "4.6.1",
        "com.unity-atoms.unity-atoms-mono-hooks": "4.6.1",
        "com.unity-atoms.unity-atoms-tags": "4.6.1",
        "com.unity-atoms.unity-atoms-scene-mgmt": "4.6.1",
        "com.unity-atoms.unity-atoms-ui": "4.6.1",
	    "com.unity-atoms.unity-atoms-input-system": "4.6.1",
        ...
    }
}

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. It's recommended to install it via 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

Blog posts

Unity Atoms — Tiny modular pieces utilizing the power of Scriptable Objects
Announcing Unity Atoms v2
Unity Atoms v4 is out!
How does it work? Read this article on Medium for a great introduction to Unity Atoms.

Aknowlegements

Maintainers

soraphis (active)
AdamRamberg (creator)
miikalo
ThimoDEV

We are looking for more people to join the team! Contact us if you want to jump aboard.

Influences

Ryan Hipple's original repository
This talk by Richard Fine

Contributors

(top 30 of 31)

269 commits

68 commits

17 commits

15 commits

Similar repos

5argon/E7Unity

Common Unity resources Exceed7 Experiments uses in projects.

171

IvanMurzak/Unity-AI-ParticleSystem

MCP Tools for Unity Particle System — create and edit particle effects with AI.

Unity-Technologies/com.unity.netcode.gameobjects

Netcode for GameObjects is a high-level netcode SDK that provides networking capabilities to…

2,322

insthync/awesome-unity3d

A categorized collection of awesome opensource unity3d repos

2,733

GlitchEnzo/NuGetForUnity

A NuGet Package Manager for Unity

4,567

IvanMurzak/Unity-MCP

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick…

4,232

CoplayDev/unity-mcp

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to…

13,948

Unity-Technologies/skills

A collection of reusable skills for AI coding agents — prompts, slash commands, and tools built for…

822

Languages

98.6%

JavaScript

1.0%