{"id":13,"date":"2021-07-19T15:58:06","date_gmt":"2021-07-19T15:58:06","guid":{"rendered":"https:\/\/docs.sisus.co\/inity\/?p=13"},"modified":"2025-07-27T13:53:33","modified_gmt":"2025-07-27T13:53:33","slug":"what-is-init-args","status":"publish","type":"post","link":"https:\/\/docs.sisus.co\/init-args\/introduction\/what-is-init-args\/","title":{"rendered":"1. What Is Init(args)"},"content":{"rendered":"

\"\"<\/p>\n

Init(args)<\/strong> is a straightforward and type-safe solution for providing your components with all the objects that they depend on.<\/p>\n

Here are some reasons why Init(args) could be the ideal choice to power the architecture of your next game…<\/p>\n

It’s Simple<\/h1>\n

Init(args)’s Inspector<\/strong> and attribute<\/strong>-based workflow is incredibly intuitive – the basics can literally be learned in a matter of minutes<\/strong>.<\/p>\n

[Service(FindFromScene = true)] \/\/ <- Register a service\r\nclass Player : MonoBehaviour { ... }\r\n\r\nclass Enemy : MonoBehaviour<Player>\r\n{\r\n   protected override void Init(Player player) { ... } \/\/ <- Receive the service\r\n}<\/pre>\n
Thanks to this all developers in your team can use Init(args) to connect objects together \u2013 no software engineering degree required.<\/p>\n
It’s Inspector-Integrated<\/h1>\n
Services that clients will receive are visualized in the Inspector and support click-to-ping – just like you’re used to with serialized fields!<\/p>\n
\"\"<\/p>\n
It’s Dependable<\/h1>\n
Clients always<\/em> receive the services they depend on before their Awake event – regardless of whether they’re loaded as part of a scene<\/strong>, instantiated from a prefab<\/strong>, or created using AddComponent<\/strong>.<\/p>\n
class Enemy : MonoBehaviour<Player>\r\n{\r\n   Player player;\r\n\r\n   protected override void Init(Player player) => this.player = player;\r\n\r\n   protected override void OnAwake() => Debug.Log($\"Player: {player.name}\"); \/\/ <- this is safe\r\n}<\/pre>\n
It’s Debuggable<\/h1>\n
Forgot to register a service that is required by a client?<\/p>\n
Init(args) will display a warning in the Inspector and log a warning in Edit Mode, and throw an exception and visualize unserialized fields in the Inspector in Play Mode.<\/p>\n
\"\"\u00a0 \"\"<\/p>\n
It’s Highly Flexible<\/h1>\n
Global and local services, full interface support, cross-scene references, value providers… don’t let Init(args)’s ease-of-use mislead you into thinking it’s lacking in the power department!<\/p>\n
\"\"<\/p>\n
It’s Fast<\/h1>\n
The simple and type-safe injection pipelines at the heart of Init(args) don’t depend on reflection, IL post-processing or source generators, while delivering class-leading performance.<\/p>\n\n\n\n\n\n\n\n\n
Tested<\/strong><\/td>\nAverage (ns)<\/strong><\/td>\nDetails<\/strong><\/td>\n<\/tr>\n
Init(args)<\/strong><\/td>\n3.053<\/strong><\/td>\nvia MonoBehaviour<T><\/strong><\/td>\n<\/tr>\n
VContainer<\/td>\n3.343<\/td>\nvia InjectGameObject, Source Generator: On<\/td>\n<\/tr>\n
Reflex<\/td>\n3.757<\/td>\nvia GameObjectSelfInjector<\/td>\n<\/tr>\n
[SerializeReference]<\/td>\n8.312<\/td>\n<\/td>\n<\/tr>\n
Extenject<\/td>\n8.718<\/td>\nvia ZenAutoInjecter, Reflection Baking: Off<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Main Features<\/h2>\n
    \n
  1. Global Services<\/strong><\/a> – simply add the [Service] attribute to create a global service.<\/li>\n
  2. Local Services<\/strong><\/a> – simply use the context menu in the Inspector Window to create a local service.<\/li>\n
  3. Full Interface Support<\/strong><\/a> – assign components, scriptable objects and plain C# objects into the same interface fields.<\/li>\n
  4. Cross-Scene References<\/strong><\/a> – just drag-and-drop an Object reference from one scene to another.<\/li>\n
  5. Prefab Instance References<\/strong><\/a> – just drag-and-drop a prefab asset and pick ‘Prefab Instance’.<\/li>\n
  6. Value Providers<\/strong><\/a> – localized strings, randomized values, addressable assets…<\/li>\n
  7. Wrappers<\/strong><\/a> – attach plain old C# objects to GameObjects and make unit testing a breeze.<\/li>\n
  8. Instantiate with arguments<\/strong><\/a> – pass arguments when instantiating an Object.<\/li>\n
  9. Add Component with arguments<\/strong><\/a> – pass arguments when attaching a component to a GameObject.<\/li>\n
  10. Create ScriptableObject with arguments<\/strong><\/a> – pass arguments when creating a ScriptableObject.<\/li>\n
  11. new GameObject with arguments<\/strong><\/a> – create a new GameObject and initialize its components.<\/li>\n
  12. Type-safe and reflection-free injection<\/strong><\/a><\/li>\n
  13. Asynchronous Initialization Support<\/strong><\/a> – Want to load services from Addressables to avoid stuttering? Init(args) has got you covered.<\/li>\n
  14. Deferred Initialization Support<\/strong><\/a> – A service is not ready yet when a client is being loaded? Init(args) can automatically delay its initialization!<\/li>\n<\/ol>\n
    Let Init(args) take care of all the dirty plumbing work, and allow yourself to fully focus on just creating a great game!<\/p>\n","protected":false},"excerpt":{"rendered":"
    Init(args) is a straightforward and type-safe solution for providing your components with all the objects that they depend on. Here are some reasons why Init(args) could be the ideal choice to power the architecture of your next game… It’s Simple Init(args)’s Inspector and attribute-based workflow is incredibly intuitive – the basics can literally be learned ..<\/p>\n
    <\/div>\n
    Read more<\/a><\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[3],"tags":[],"_links":{"self":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts\/13"}],"collection":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/comments?post=13"}],"version-history":[{"count":52,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts\/13\/revisions"}],"predecessor-version":[{"id":985,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts\/13\/revisions\/985"}],"wp:attachment":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/media?parent=13"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/categories?post=13"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/tags?post=13"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}