Quick Links: Installation | When to use | Quick Start | Services | Docs | Changelog | Migration Guide
Building robust game architecture in Unity often leads to tightly coupled systems, scattered initialization logic, and memory management headaches. This Services package solves these pain points:
| Problem | Solution |
|---|---|
| Scattered dependencies | Lightweight service locator (MainInstaller) for centralized dependency management |
| Tightly coupled systems | Message broker enables decoupled pub/sub communication |
| Manual update management | Tick service centralizes Update/FixedUpdate/LateUpdate callbacks |
| Coroutines in pure C# | Coroutine service runs Unity coroutines without MonoBehaviour |
| Memory churn from instantiation | Object pooling with lifecycle hooks for efficient reuse |
| Inconsistent save/load | Cross-platform data persistence with automatic serialization |
| Non-deterministic gameplay | Deterministic RNG service with state save/restore |
| Version tracking complexity | Build version service with git commit/branch metadata |
Built for production: Minimal per-frame allocations. Used in real games.
Use this package when you want a lightweight set of standalone services you can pick and choose from, without committing to a full DI framework.
Consider alternatives (e.g. VContainer, Zenject) when you need scoped lifetimes, factory bindings, or constructor injection across many types. In that case, use Installer directly (not MainInstaller) for multi-interface binding within your DI composition root.
- Unity 6000.0+ (Unity 6)
- GameLovers GameData (v1.0.0) — automatically resolved
- Unity Addressables (≥ 1.21.20) — automatically resolved
- UniTask (≥ 2.5.10) — automatically resolved
| Unity Version | Status |
|---|---|
| 6000.0+ (Unity 6) | ✅ Fully Tested |
| 2022.3 LTS |
- Open Unity Package Manager (
Window→Package Manager) - Click
+→Add package from git URL - Enter:
https://github.com/CoderGamester/Services.git
{
"dependencies": {
"com.gamelovers.services": "https://github.com/CoderGamester/Services.git"
}
}| Component | Responsibility |
|---|---|
| MainInstaller | Static service locator for global-scope single-interface bindings |
| Installer | Instance-based DI container (supports multi-interface binding) |
| IMessageBrokerService | Type-safe pub/sub messaging |
| ITickService | Centralized Update/FixedUpdate/LateUpdate callbacks |
| ICoroutineService | Run coroutines from pure C# classes |
| IPoolService | Object pool registry and management |
| IDataService / IDataProvider | Cross-platform data persistence (read-write / read-only) |
| ITimeService / ITimeManipulator | Unified time access with offset/sync manipulation |
| IRngService | Deterministic random number generation |
| ICommandService<TGameLogic> | Typed command execution layer |
| VersionServices | Runtime access to build/git metadata |
| AssetResolverService | Addressables-based typed asset loading by id + asset type |
| IAssetLoader / ISceneLoader | Low-level addressable load/unload/instantiate interfaces |
usingUnityEngine;usingGameLovers.Services;publicclassGameBootstrap:MonoBehaviour{voidAwake(){varmessageBroker=newMessageBrokerService();vartickService=newTickService();vardataService=newDataService();MainInstaller.Bind<IMessageBrokerService>(messageBroker);MainInstaller.Bind<ITickService>(tickService);MainInstaller.Bind<IDataService>(dataService);}voidOnDestroy(){MainInstaller.CleanDispose<ITickService>();MainInstaller.Clean();}}// Resolve anywherevarbroker=MainInstaller.Resolve<IMessageBrokerService>();broker.Subscribe<PlayerDamagedMessage>(OnPlayerDamaged);publicstructPlayerDamagedMessage:IMessage{publicintPlayerId;publicfloatDamage;}Full API reference and recipes live in docs/. Short examples below.
MainInstaller.Bind<IMessageBrokerService>(newMessageBrokerService());varbroker=MainInstaller.Resolve<IMessageBrokerService>();MainInstaller.TryResolve<IDataService>(outvards);MainInstaller.CleanDispose<ITickService>();MainInstaller.Clean();// Multi-interface binding — use Installer directlyvarinstaller=newInstaller();installer.Bind<TimeService,ITimeService,ITimeManipulator>(newTimeService());// static method subscriptions are NOT supportedbroker.Subscribe<EnemyDefeatedMessage>(OnEnemyDefeated);broker.Publish(newEnemyDefeatedMessage{EnemyId=42});broker.PublishSafe(newEnemyDefeatedMessage{EnemyId=42});// safe during publishbroker.Unsubscribe<EnemyDefeatedMessage>(this);broker.UnsubscribeAll(this);vartick=newTickService();tick.SubscribeOnUpdate(OnUpdate);tick.SubscribeOnUpdate(OnThrottled,deltaTime:0.1f);// rate-limitedtick.SubscribeOnFixedUpdate(OnFixed);tick.SubscribeOnLateUpdate(OnLate);tick.UnsubscribeAll(this);tick.Dispose();// destroys host GameObjectvarcs=newCoroutineService();IAsyncCoroutinehandle=cs.StartAsyncCoroutine(MyRoutine());handle.OnComplete(()=>Debug.Log("Done!"));cs.StartDelayCall(()=>Debug.Log("2 s later"),delay:2f);cs.Dispose();varpool=newPoolService();pool.AddPool(newGameObjectPool<Bullet>(50,prefab));varbullet=pool.Spawn<Bullet>();pool.Despawn(bullet);vards=newDataService();PlayerDataplayer=ds.LoadData<PlayerData>();// loads from PlayerPrefs or creates freshplayer.Level=10;ds.SaveData<PlayerData>();RngDatarngData=RngService.CreateRngData(seed:42);varrng=newRngService(rngData);introll=rng.Range(1,7);// 1–6intsaved=rng.Counter;rng.Restore(saved);// replay from saved pointvartime=newTimeService();DateTimeutc=time.DateTimeUtcNow;floatunity=time.UnityTimeNow;longunixMs=time.UnixTimeNow;time.AddTime(3600f);// fast-forward 1 hour (ITimeManipulator)publicstructLevelUpCommand:IGameCommand<GameLogic>{publicvoidExecute(GameLogicgl,IMessageBrokerServicemb){gl.PlayerLevel++;mb.Publish(newPlayerLevelledUpMessage{Level=gl.PlayerLevel});}}ICommandService<GameLogic>cmd=newCommandService<GameLogic>(gameLogic,messageBroker);cmd.ExecuteCommand(newLevelUpCommand());// No setup call needed — version metadata auto-loads at SubsystemRegistration,// with a lazy-load fallback on first property access.stringbranch=VersionServices.Branch;stringcommit=VersionServices.Commit;stringext=VersionServices.VersionExternal;// always safe, no load needed// Optional explicit pre-warm (idempotent — no-ops if already loaded):// VersionServices.LoadVersionData(); // sync, recommended default// await VersionServices.LoadVersionDataAsync(); // async — only useful for large VersionData blobs// Low-levelvarloader=newAddressablesAssetLoader();vartexture=awaitloader.LoadAssetAsync<Texture2D>("Textures/hero");// High-level: typed by idvarresolver=newAssetResolverService();resolver.AddConfigs(spriteConfigs);// AssetConfigsScriptableObject<SpriteId, Sprite>varsprite=awaitresolver.RequestAsset<SpriteId,Sprite>(SpriteId.Hero,true,false);awaitresolver.LoadSceneAsync<SceneId>(SceneId.MainMenu,LoadSceneMode.Single,true);The package ships a set of editor utilities that work in both Edit and Play mode.
Open via Tools > GameLovers > Services Explorer.
A dockable UIToolkit window with one tab per service. During Play mode each tab live-refreshes at 250 ms intervals. In Edit mode a snapshot banner is shown and data is read on demand.
| Tab | What it shows | Primary CTA / Actions |
|---|---|---|
| Overview | Per-service card grid with bound/ready status and direct jump-links | Open (jumps to tab), per-service primary CTA |
| Versioning | VersionExternal, VersionInternal, Branch, Commit, BuildNumber; version-data.txt preview | Reveal version-data.txt |
| Installer | All MainInstaller bindings (interface → concrete type) | Clean All; Clean, CleanDispose per binding |
| Message Broker | All IMessage subscriptions with expandable subscriber lists | Unsubscribe All; Unsubscribe per type, Publish default(T) test |
| Tick | Update / FixedUpdate / LateUpdate subscriber lists with throttle settings | Unsubscribe All; Clear per list |
| Coroutine | Active IAsyncCoroutine handles (start time, running, completed) | Stop All Coroutines; Stop individual |
| Pool | All registered pools: spawned count, sample entity | Clear All Pools; DespawnAll, Dispose, RemovePool, Ping sample |
| Data | All loaded data types with indented JSON preview | Save All Data; Save, Load, Delete PlayerPrefs key |
| Time | Live DateTimeUtcNow, UnityTimeNow, UnityScaleTimeNow, UnixTimeNow | Reset Time; AddTime slider, SetInitialTime picker |
| RNG | Seed, Counter, peek-next N values | Restore(count) |
| Asset Resolver | AssetMap tree: asset type → id type → (id → ref, loaded status) | Unload All (behind destructive toggle); Unload per asset |
| Assets Importer | Discovered IAssetConfigsImporter list with per-importer path and status | Import All; Set Path, Import, Select per importer |
| Addressable Ids | Generator settings (ScriptFilename, Namespace, AddressableLabel) with output status | Generate Addressable Ids; Open Addressables Groups |
AssetConfigsScriptableObject— diagnostics panel (duplicate keys, empty GUIDs) + default fields + "Regenerate Addressable Ids" button.AddressablesIdGeneratorSettings— settings are now configured in the Services Explorer Addressable Ids tab (Tools > GameLovers > Addressable Ids > Open in Explorer).AssetReferenceScene(property drawer) — resolved scene path label + "Open in Addressables Groups" button.
Assets > Create > GameLovers Services > …
| Entry | Generates |
|---|---|
| Message | struct : IMessage |
| Command | struct : IGameCommand<TGameLogic> |
| Service | IMyService + MyService : IMyService, IDisposable |
| Pool Entity | class implementing IPoolEntitySpawn + IPoolEntityDespawn |
File names and namespaces are set interactively in the Project window, identical to Unity's built-in "Create > C# Script" flow.
Importable samples live under Samples~/ and are exposed via the Unity Package Manager:
| Sample | Addressables required? | Focus |
|---|---|---|
| Services Playground | No | All foundation services (MainInstaller, MessageBroker, Tick, Coroutine, Pool, Data, Time, Rng, Commands, Versioning) wired into a single scene. Doubles as the manual end-to-end protocol for the Services Explorer window |
| Asset Resolver | Yes (~2 minutes setup) | Typed asset loading via AssetResolverService + AssetConfigsScriptableObject<TId, TAsset>, plus the Addressable Ids generator and Assets Importer pipeline |
Each sample ships as a complete, runnable Unity scene with a programmatically-built UI — no per-import wiring step (the Asset Resolver sample requires marking your sprites Addressable; see its README). For the index, AI-assistant common-mistakes section, and full list of sample-only types (which are NOT part of the package public API), see Samples~/README.md.
To import a sample: Window > Package Manager > GameLovers Services > Samples > Import.
Contributions are welcome! See GitHub Issues to report bugs or request features. For development setup, architecture details, namespace conventions, and coding standards, see AGENTS.md.
| Document | Purpose |
|---|---|
| docs/README.md | Full per-service API reference |
| AGENTS.md | Contributor/agent guide (architecture, gotchas, workflows) |
| CHANGELOG.md | Version history |
| MIGRATION.md | v1.x → v2.0.0 migration guide |
- Issues: Report bugs or request features
- Discussions: Ask questions and share ideas
MIT — see LICENSE.md.