SaltboxGames.Unity is a source-distributed Unity utility package for Saltbox Games projects.
It contains Unity-specific extensions, editor drawers, Addressables helpers, Cinemachine effects, player-loop helpers, and service lifecycle adapters for SaltboxGames.Core.
Start with the package documentation index: Docs/README.md.
SaltboxGames.Unity depends on SaltboxGames.Core. Install both packages in the same Unity project.
Add the package to your Unity project's Packages/manifest.json:
{
"dependencies": {
"com.saltboxgames.core": "[email protected]:SaltboxGames/SaltboxGames.Core.git",
"com.saltboxgames.unity": "[email protected]:SaltboxGames/SaltboxGames.Unity.git"
}
}Use a git submodule if you want the package checked into Packages/:
git submodule add [email protected]:SaltboxGames/SaltboxGames.Core.git ./Packages/com.saltboxgames.core
git submodule add [email protected]:SaltboxGames/SaltboxGames.Unity.git ./Packages/com.saltboxgames.unityUnity will detect it as an embedded package.
Unity enables optional integrations automatically when the matching packages are installed:
- Addressables: defines
ADDRESSABLES_2for scene reference helpers. - Cinemachine: defines
CINEMACHINEfor camera FX helpers. - ZLinq: defines
ZLINQfor optional value-enumerable integrations.
No manual compilation symbols are required in Unity. The package assembly definitions set the symbols through Unity versionDefines.
This package is licensed under MPL 2.0. See LICENSE.