https://github.com/cartergames/notiontounity
A tool to download Notion databases into a Unity scriptable object for use in Unity projects. Handy for game data such as items, localization, skills and more!
https://github.com/cartergames/notiontounity
data-structures datadownloader notion notion-api notion-database scriptableobject unity
Last synced: about 1 month ago
JSON representation
A tool to download Notion databases into a Unity scriptable object for use in Unity projects. Handy for game data such as items, localization, skills and more!
- Host: GitHub
- URL: https://github.com/cartergames/notiontounity
- Owner: CarterGames
- License: mit
- Created: 2024-03-08T16:31:46.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-04-18T19:00:39.000Z (about 1 month ago)
- Last Synced: 2026-04-18T20:25:25.178Z (about 1 month ago)
- Topics: data-structures, datadownloader, notion, notion-api, notion-database, scriptableobject, unity
- Language: C#
- Homepage: https://carter.games/notion-database-to-unity-so-standalone/
- Size: 1.82 MB
- Stars: 28
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Notion Database to Unity Scriptable Object
A tool to download Notion databases into a Unity scriptable object for use in Unity projects. Handy for game data such as items, localization, skills and more!
### Authors
- Jonathan Carter
### Dependencies
- Newtonsoft Json Unity Package which can be added via the Unity package manager with the following:
```
com.unity.nuget.newtonsoft-json
```
### Documentation
Full documentation can be found [here](Docs/Docs.md)
# Table of contents
* [Features](#features)
* [Planned Features](#planned-features)
* [Supported Properties](#supported-properties)
* [Installation](#installation)
* [Unity Package Manager (Git URL)](#unity-package-manager-git-url-recommended)
* [Package Import (.unityPackage)](#unity-package-unitypackage)
* [Manual (Clone)](#manual-clone)
# Features
- Download databases of any size.
- Apply sorting and filters to data to order it just as it is in a Notion database view.
- Automatic parsing of data into their field types.
- Support for most useful Notion data properties.
- Automatic API key removal on build creation for security.
- System to reference assets in code without a direct inspector reference.
# Planned Features
- None at the moment other than general support where needed.
# Supported Properties
Any ```string``` convertible type should also support JSON for custom classes, but the mileage may vary. Best to just store raw data in these assets and convert the data with an override to the ```PostDataDownloaded()``` method in the ```Notion Data Asset```.
Note that rollups are supported only when they show a property that is otherwise supported below:
| Property type | Conversion types supported (Unity) |
| --- | --- |
| Title | ```string``` |
| Text | ```string``` ```NotionDataWrapper(GameObject(Prefab)/Sprite/AudioClip)```, List/Array of ```string```, ```int```, ```float```, ```double```, ```bool``` |
| Number | ```int``` ```float``` ```double``` etc |
| Toggle | ```bool``` |
| Single-Select | ```string``` ```enum``` |
| Multi-Select | ```string[]``` ```List``` ```enum flags``` |
| Rollup | ```Any supported in this table.``` |
| Date | ```SerializableDateTime``` |
| Url | ```string``` |
# Installation
## Unity Package Manager (Git URL) [Recommended]
Release:
The most up-to-date version of the repo that is considered stable enough for public use.
```
https://github.com/CarterGames/NotionToUnity.git
```
Pre-release:
Used to prepare future releases before releasing them, checking for bugs mainly. Will have the latest features but may not be stable just yet. Use at your own risk.
```
https://github.com/CarterGames/NotionToUnity.git#pre-release
```
## Unity Package (.unitypackage)
Import the package found in the releases section through the "Import custom package" right-click menu option in Unity's project tab.
## Manual (Clone)
Download the repo/clone it and import the files into your project manually.
Please refer to the [documentation](Docs/Docs.md) for details on setup in your project & usage.