com.wallstop-studios.dxmessaging 2.1.5 → 2.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (163) hide show
  1. package/.artifacts/SourceGenerators.Tests/obj/Debug/net9.0/WallstopStudios.DxMessaging.SourceGenerators.Tests.AssemblyInfo.cs +1 -1
  2. package/.cspell.json +4 -1
  3. package/.github/workflows/actionlint.yml +11 -1
  4. package/.github/workflows/csharpier-autofix.yml +34 -3
  5. package/.github/workflows/dotnet-tests.yml +13 -0
  6. package/.github/workflows/format-on-demand.yml +38 -44
  7. package/.github/workflows/json-format-check.yml +24 -0
  8. package/.github/workflows/lint-doc-links.yml +13 -0
  9. package/.github/workflows/markdown-json.yml +21 -4
  10. package/.github/workflows/markdown-link-text-check.yml +10 -0
  11. package/.github/workflows/markdown-link-validity.yml +10 -0
  12. package/.github/workflows/markdownlint.yml +7 -5
  13. package/.github/workflows/prettier-autofix.yml +67 -11
  14. package/.github/workflows/release-drafter.yml +2 -2
  15. package/.github/workflows/sync-wiki.yml +3 -3
  16. package/.github/workflows/yaml-format-lint.yml +26 -0
  17. package/.llm/context.md +113 -3
  18. package/.llm/skills/documentation/changelog-management.md +38 -0
  19. package/.llm/skills/documentation/documentation-style-guide.md +18 -0
  20. package/.llm/skills/documentation/documentation-update-workflow.md +2 -0
  21. package/.llm/skills/documentation/documentation-updates.md +2 -0
  22. package/.llm/skills/documentation/markdown-compatibility.md +476 -0
  23. package/.llm/skills/documentation/mermaid-theming.md +326 -0
  24. package/.llm/skills/documentation/mkdocs-navigation.md +290 -0
  25. package/.llm/skills/github-actions/git-renormalize-patterns.md +231 -0
  26. package/.llm/skills/github-actions/workflow-consistency.md +346 -0
  27. package/.llm/skills/index.md +53 -27
  28. package/.llm/skills/scripting/javascript-code-quality.md +417 -0
  29. package/.llm/skills/scripting/regex-documentation.md +461 -0
  30. package/.llm/skills/scripting/shell-best-practices.md +55 -4
  31. package/.llm/skills/scripting/validation-patterns.md +418 -0
  32. package/.llm/skills/specification.md +4 -1
  33. package/.llm/skills/testing/test-code-quality.md +243 -0
  34. package/.llm/skills/testing/test-production-code.md +348 -0
  35. package/CHANGELOG.md +24 -0
  36. package/README.md +113 -24
  37. package/Tests/Runtime/Benchmarks/WallstopStudios.DxMessaging.Tests.Runtime.Benchmarks.asmdef +1 -6
  38. package/Tests/Runtime/Integrations/Reflex/WallstopStudios.DxMessaging.Tests.Runtime.Reflex.asmdef +1 -1
  39. package/Tests/Runtime/Integrations/VContainer/WallstopStudios.DxMessaging.Tests.Runtime.VContainer.asmdef +1 -1
  40. package/Tests/Runtime/Integrations/Zenject/WallstopStudios.DxMessaging.Tests.Runtime.Zenject.asmdef +1 -1
  41. package/coverage/clover.xml +216 -3
  42. package/coverage/clover.xml.meta +7 -7
  43. package/coverage/coverage-final.json +2 -1
  44. package/coverage/coverage-final.json.meta +7 -7
  45. package/coverage/lcov-report/base.css.meta +1 -1
  46. package/coverage/lcov-report/block-navigation.js.meta +1 -1
  47. package/coverage/lcov-report/favicon.png.meta +1 -1
  48. package/coverage/lcov-report/index.html +25 -10
  49. package/coverage/lcov-report/index.html.meta +7 -7
  50. package/coverage/lcov-report/prettify.css.meta +1 -1
  51. package/coverage/lcov-report/prettify.js.meta +1 -1
  52. package/coverage/lcov-report/sort-arrow-sprite.png.meta +1 -1
  53. package/coverage/lcov-report/sorter.js.meta +1 -1
  54. package/coverage/lcov-report/transform-docs-to-wiki.js.html +1 -1
  55. package/coverage/lcov-report/transform-docs-to-wiki.js.html.meta +7 -7
  56. package/coverage/lcov-report/vendor.meta +1 -1
  57. package/coverage/lcov-report.meta +8 -8
  58. package/coverage/lcov.info +365 -0
  59. package/coverage/lcov.info.meta +7 -7
  60. package/docs/architecture/design-and-architecture.md +0 -1
  61. package/docs/concepts/index.md +37 -0
  62. package/docs/concepts/index.md.meta +7 -0
  63. package/docs/concepts/interceptors-and-ordering.md +0 -2
  64. package/docs/concepts/mental-model.md +390 -0
  65. package/docs/concepts/mental-model.md.meta +7 -0
  66. package/docs/concepts/message-types.md +0 -1
  67. package/docs/getting-started/getting-started.md +1 -0
  68. package/docs/getting-started/index.md +6 -5
  69. package/docs/getting-started/overview.md +1 -0
  70. package/docs/getting-started/quick-start.md +2 -1
  71. package/docs/getting-started/visual-guide.md +4 -10
  72. package/docs/hooks.py +10 -1
  73. package/docs/images/DxMessaging-banner.svg +1 -1
  74. package/docs/index.md +7 -7
  75. package/docs/javascripts/mermaid-config.js +44 -4
  76. package/docs/reference/helpers.md +130 -154
  77. package/docs/reference/quick-reference.md +5 -1
  78. package/docs/reference/reference.md +124 -130
  79. package/mkdocs.yml +2 -0
  80. package/package.json +7 -2
  81. package/scripts/__tests__/generate-skills-index.test.js +397 -0
  82. package/scripts/__tests__/generate-skills-index.test.js.meta +7 -0
  83. package/scripts/__tests__/mermaid-config.test.js +467 -0
  84. package/scripts/__tests__/mermaid-config.test.js.meta +7 -0
  85. package/scripts/__tests__/validate-skills-optional-fields.test.js +1474 -0
  86. package/scripts/__tests__/validate-skills-optional-fields.test.js.meta +7 -0
  87. package/scripts/__tests__/validate-skills-required-fields.test.js +188 -0
  88. package/scripts/__tests__/validate-skills-required-fields.test.js.meta +7 -0
  89. package/scripts/__tests__/validate-skills-tags.test.js +353 -0
  90. package/scripts/__tests__/validate-skills-tags.test.js.meta +7 -0
  91. package/scripts/__tests__/validate-workflows.test.js +188 -0
  92. package/scripts/__tests__/validate-workflows.test.js.meta +7 -0
  93. package/scripts/generate-skills-index.js +88 -3
  94. package/scripts/validate-skills.js +230 -30
  95. package/scripts/validate-workflows.js +272 -0
  96. package/scripts/validate-workflows.js.meta +7 -0
  97. package/scripts/wiki/generate-wiki-sidebar.js.meta +1 -8
  98. package/scripts/wiki/transform-docs-to-wiki.js.meta +1 -1
  99. package/site/404.html +1 -1
  100. package/site/advanced/emit-shorthands/index.html +2 -2
  101. package/site/advanced/message-bus-providers/index.html +2 -2
  102. package/site/advanced/registration-builders/index.html +2 -2
  103. package/site/advanced/runtime-configuration/index.html +2 -2
  104. package/site/advanced/string-messages/index.html +2 -2
  105. package/site/advanced.meta +1 -1
  106. package/site/architecture/comparisons/index.html +2 -2
  107. package/site/architecture/design-and-architecture/index.html +2 -2
  108. package/site/architecture/performance/index.html +1 -1
  109. package/site/architecture.meta +1 -1
  110. package/site/concepts/index.html +1 -0
  111. package/site/concepts/index.html.meta +7 -0
  112. package/site/concepts/interceptors-and-ordering/index.html +4 -4
  113. package/site/concepts/listening-patterns/index.html +2 -2
  114. package/site/concepts/mental-model/index.html +146 -0
  115. package/site/concepts/mental-model/index.html.meta +7 -0
  116. package/site/concepts/mental-model.meta +8 -0
  117. package/site/concepts/message-types/index.html +2 -2
  118. package/site/concepts/targeting-and-context/index.html +2 -2
  119. package/site/concepts.meta +1 -1
  120. package/site/examples/end-to-end/index.html +2 -2
  121. package/site/examples/end-to-end-scene-transitions/index.html +2 -2
  122. package/site/examples.meta +1 -1
  123. package/site/getting-started/getting-started/index.html +3 -3
  124. package/site/getting-started/index.html +4 -4
  125. package/site/getting-started/install/index.html +3 -3
  126. package/site/getting-started/overview/index.html +2 -2
  127. package/site/getting-started/quick-start/index.html +2 -2
  128. package/site/getting-started/visual-guide/index.html +11 -11
  129. package/site/getting-started.meta +1 -1
  130. package/site/guides/advanced/index.html +2 -2
  131. package/site/guides/diagnostics/index.html +2 -2
  132. package/site/guides/migration-guide/index.html +2 -2
  133. package/site/guides/patterns/index.html +2 -2
  134. package/site/guides/testing/index.html +2 -2
  135. package/site/guides/unity-integration/index.html +2 -2
  136. package/site/guides.meta +1 -1
  137. package/site/hooks.py.meta +1 -1
  138. package/site/images/DxMessaging-banner.svg +119 -0
  139. package/site/images/DxMessaging-banner.svg.meta +7 -0
  140. package/site/images.meta +8 -0
  141. package/site/index.html +2 -2
  142. package/site/integrations/index.html +2 -2
  143. package/site/integrations/reflex/index.html +2 -2
  144. package/site/integrations/vcontainer/index.html +2 -2
  145. package/site/integrations/zenject/index.html +2 -2
  146. package/site/integrations.meta +1 -1
  147. package/site/javascripts/csharp-highlight.js.meta +7 -7
  148. package/site/javascripts/mermaid-config.js +4 -1
  149. package/site/javascripts/mermaid-config.js.meta +1 -1
  150. package/site/javascripts.meta +1 -1
  151. package/site/reference/compatibility/index.html +1 -1
  152. package/site/reference/faq/index.html +1 -1
  153. package/site/reference/glossary/index.html +2 -2
  154. package/site/reference/helpers/index.html +15 -15
  155. package/site/reference/quick-reference/index.html +3 -3
  156. package/site/reference/reference/index.html +37 -37
  157. package/site/reference/troubleshooting/index.html +1 -1
  158. package/site/reference.meta +1 -1
  159. package/site/search/search_index.json +1 -1
  160. package/site/sitemap.xml +46 -38
  161. package/site/sitemap.xml.gz +0 -0
  162. package/site/stylesheets/extra.css.meta +1 -1
  163. package/site/stylesheets.meta +1 -1
package/site/guides/patterns/index.html CHANGED
@@ -1,4 +1,4 @@
1
- <!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="High-performance type-safe messaging library for Unity"><meta name=author content="Wallstop Studios"><link href=https://wallstop.github.io/DxMessaging/guides/patterns/ rel=canonical><link href=../../concepts/interceptors-and-ordering/ rel=prev><link href=../unity-integration/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.1"><title>Patterns - DxMessaging Documentation</title><link rel=stylesheet href=../../assets/stylesheets/main.484c7ddc.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.ab4e12ef.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../css/timeago.css><link rel=stylesheet href=../../stylesheets/extra.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#dxmessaging-patterns-real-world-solutions class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class="md-header md-header--shadow md-header--lifted" data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="DxMessaging Documentation" class="md-header__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> DxMessaging Documentation </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Patterns </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to dark mode" type=radio name=__palette id=__palette_0> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> <input class=md-option data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme=slate data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to light mode" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_0 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <a href=javascript:void(0) class="md-search__icon md-icon" title=Share aria-label=Share data-clipboard data-clipboard-text data-md-component=search-share tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg> </a> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> <div class=md-search__suggest data-md-component=search-suggest></div> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> </nav> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Home </a> </li> <li class=md-tabs__item> <a href=../../getting-started/ class=md-tabs__link> Getting Started </a> </li> <li class=md-tabs__item> <a href=../../concepts/message-types/ class=md-tabs__link> Concepts </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> Guides </a> </li> <li class=md-tabs__item> <a href=../../architecture/design-and-architecture/ class=md-tabs__link> Architecture </a> </li> <li class=md-tabs__item> <a href=../../advanced/emit-shorthands/ class=md-tabs__link> Advanced </a> </li> <li class=md-tabs__item> <a href=../../integrations/ class=md-tabs__link> Integrations </a> </li> <li class=md-tabs__item> <a href=../../examples/end-to-end/ class=md-tabs__link> Examples </a> </li> <li class=md-tabs__item> <a href=../../reference/reference/ class=md-tabs__link> Reference </a> </li> </ul> </div> </nav> </header> <div class=md-container data-md-component=container> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="DxMessaging Documentation" class="md-nav__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> DxMessaging Documentation </label> <div class=md-nav__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Home </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_2> <div class="md-nav__link md-nav__container"> <a href=../../getting-started/ class="md-nav__link "> <span class=md-ellipsis> Getting Started </span> </a> <label class="md-nav__link " for=__nav_2 id=__nav_2_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_2_label aria-expanded=false> <label class=md-nav__title for=__nav_2> <span class="md-nav__icon md-icon"></span> Getting Started </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../getting-started/overview/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/install/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/quick-start/ class=md-nav__link> <span class=md-ellipsis> Quick Start </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/getting-started/ class=md-nav__link> <span class=md-ellipsis> Getting Started Guide </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/visual-guide/ class=md-nav__link> <span class=md-ellipsis> Visual Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_3> <label class=md-nav__link for=__nav_3 id=__nav_3_label tabindex=0> <span class=md-ellipsis> Concepts </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3> <span class="md-nav__icon md-icon"></span> Concepts </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../concepts/message-types/ class=md-nav__link> <span class=md-ellipsis> Message Types </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/listening-patterns/ class=md-nav__link> <span class=md-ellipsis> Listening Patterns </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/targeting-and-context/ class=md-nav__link> <span class=md-ellipsis> Targeting & Context </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/interceptors-and-ordering/ class=md-nav__link> <span class=md-ellipsis> Interceptors & Ordering </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4 checked> <label class=md-nav__link for=__nav_4 id=__nav_4_label tabindex> <span class=md-ellipsis> Guides </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_4_label aria-expanded=true> <label class=md-nav__title for=__nav_4> <span class="md-nav__icon md-icon"></span> Guides </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Patterns </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Patterns </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#what-youll-find class=md-nav__link> <span class=md-ellipsis> What you'll find </span> </a> <nav class=md-nav aria-label="What you'll find"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#reading-guide class=md-nav__link> <span class=md-ellipsis> Reading guide </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#quick-links-i-want-to class=md-nav__link> <span class=md-ellipsis> Quick Links: "I Want To..." </span> </a> <nav class=md-nav aria-label='Quick Links: "I Want To..."'> <ul class=md-nav__list> <li class=md-nav__item> <a href=#find-your-use-case-jump-to-the-pattern class=md-nav__link> <span class=md-ellipsis> Find your use case, jump to the pattern </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#table-of-contents class=md-nav__link> <span class=md-ellipsis> Table of Contents </span> </a> <nav class=md-nav aria-label="Table of Contents"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#basic-patterns class=md-nav__link> <span class=md-ellipsis> Basic Patterns </span> </a> </li> <li class=md-nav__item> <a href=#advanced-patterns class=md-nav__link> <span class=md-ellipsis> Advanced Patterns </span> </a> </li> <li class=md-nav__item> <a href=#real-world-scale-patterns class=md-nav__link> <span class=md-ellipsis> Real-World Scale Patterns </span> </a> </li> <li class=md-nav__item> <a href=#important-inheritance-with-messageawarecomponent class=md-nav__link> <span class=md-ellipsis> Important: Inheritance with MessageAwareComponent </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#1-scene-wide-events-untargeted class=md-nav__link> <span class=md-ellipsis> 1) Scene-wide Events (Untargeted) </span> </a> </li> <li class=md-nav__item> <a href=#2-directed-commands-targeted class=md-nav__link> <span class=md-ellipsis> 2) Directed Commands (Targeted) </span> </a> </li> <li class=md-nav__item> <a href=#3-observability-broadcast class=md-nav__link> <span class=md-ellipsis> 3) Observability (Broadcast) </span> </a> </li> <li class=md-nav__item> <a href=#4-validation-and-normalization-interceptors class=md-nav__link> <span class=md-ellipsis> 4) Validation and Normalization (Interceptors) </span> </a> </li> <li class=md-nav__item> <a href=#5-analyticslogging-post-processors class=md-nav__link> <span class=md-ellipsis> 5) Analytics/Logging (Post-Processors) </span> </a> </li> <li class=md-nav__item> <a href=#6-local-bus-islands class=md-nav__link> <span class=md-ellipsis> 6) Local Bus Islands </span> </a> </li> <li class=md-nav__item> <a href=#7-lifecycle-pattern-in-unity class=md-nav__link> <span class=md-ellipsis> 7) Lifecycle Pattern in Unity </span> </a> </li> <li class=md-nav__item> <a href=#8-cross-scene-messaging class=md-nav__link> <span class=md-ellipsis> 8) Cross-Scene Messaging </span> </a> </li> <li class=md-nav__item> <a href=#9-bridging-legacy-unity-messaging class=md-nav__link> <span class=md-ellipsis> 9) Bridging Legacy Unity Messaging </span> </a> </li> <li class=md-nav__item> <a href=#10-global-accept-all-handlers class=md-nav__link> <span class=md-ellipsis> 10) Global Accept-All Handlers </span> </a> </li> <li class=md-nav__item> <a href=#11-diagnostics-and-tuning class=md-nav__link> <span class=md-ellipsis> 11) Diagnostics and Tuning </span> </a> </li> <li class=md-nav__item> <a href=#12-testing class=md-nav__link> <span class=md-ellipsis> 12) Testing </span> </a> </li> <li class=md-nav__item> <a href=#13-real-world-scale-beyond-toy-examples class=md-nav__link> <span class=md-ellipsis> 13) Real-World Scale: Beyond Toy Examples </span> </a> <nav class=md-nav aria-label="13) Real-World Scale: Beyond Toy Examples"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#pattern-managing-100-combat-entities class=md-nav__link> <span class=md-ellipsis> Pattern: Managing 100+ Combat Entities </span> </a> <nav class=md-nav aria-label="Pattern: Managing 100+ Combat Entities"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#scale-characteristics class=md-nav__link> <span class=md-ellipsis> Scale characteristics </span> </a> <nav class=md-nav aria-label="Scale characteristics"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#performance-notes class=md-nav__link> <span class=md-ellipsis> Performance notes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-cross-scene-persistent-systems class=md-nav__link> <span class=md-ellipsis> Pattern: Cross-Scene Persistent Systems </span> </a> </li> <li class=md-nav__item> <a href=#pattern-large-scale-ui-system-20-panels class=md-nav__link> <span class=md-ellipsis> Pattern: Large-Scale UI System (20+ Panels) </span> </a> <nav class=md-nav aria-label="Pattern: Large-Scale UI System (20+ Panels)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits-at-scale class=md-nav__link> <span class=md-ellipsis> Benefits at scale </span> </a> <nav class=md-nav aria-label="Benefits at scale"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#anti-pattern-to-avoid class=md-nav__link> <span class=md-ellipsis> Anti-pattern to avoid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-priority-ordered-execution-for-complex-systems class=md-nav__link> <span class=md-ellipsis> Pattern: Priority-Ordered Execution for Complex Systems </span> </a> <nav class=md-nav aria-label="Pattern: Priority-Ordered Execution for Complex Systems"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#recommended-priority-ranges class=md-nav__link> <span class=md-ellipsis> Recommended priority ranges </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-efficient-interception-at-scale class=md-nav__link> <span class=md-ellipsis> Pattern: Efficient Interception at Scale </span> </a> </li> <li class=md-nav__item> <a href=#pattern-post-processing-for-analytics-at-scale class=md-nav__link> <span class=md-ellipsis> Pattern: Post-Processing for Analytics at Scale </span> </a> </li> <li class=md-nav__item> <a href=#performance-optimization-patterns-at-scale class=md-nav__link> <span class=md-ellipsis> Performance Optimization Patterns at Scale </span> </a> <nav class=md-nav aria-label="Performance Optimization Patterns at Scale"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#optimization-1-disable-diagnostics-in-builds class=md-nav__link> <span class=md-ellipsis> Optimization 1: Disable Diagnostics in Builds </span> </a> </li> <li class=md-nav__item> <a href=#optimization-2-use-specific-registrations-over-globalacceptall class=md-nav__link> <span class=md-ellipsis> Optimization 2: Use Specific Registrations Over GlobalAcceptAll </span> </a> </li> <li class=md-nav__item> <a href=#optimization-3-batch-message-emissions class=md-nav__link> <span class=md-ellipsis> Optimization 3: Batch Message Emissions </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#scaling-guidelines class=md-nav__link> <span class=md-ellipsis> Scaling Guidelines </span> </a> </li> <li class=md-nav__item> <a href=#real-world-production-example-battle-royale-game class=md-nav__link> <span class=md-ellipsis> Real-World Production Example: Battle Royale Game </span> </a> <nav class=md-nav aria-label="Real-World Production Example: Battle Royale Game"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-insights class=md-nav__link> <span class=md-ellipsis> Key insights </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#14-compatibility-with-scriptable-object-architecture-soa class=md-nav__link> <span class=md-ellipsis> 14) Compatibility with Scriptable Object Architecture (SOA) </span> </a> <nav class=md-nav aria-label="14) Compatibility with Scriptable Object Architecture (SOA)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-is-scriptable-object-architecture class=md-nav__link> <span class=md-ellipsis> What is Scriptable Object Architecture? </span> </a> <nav class=md-nav aria-label="What is Scriptable Object Architecture?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-resources class=md-nav__link> <span class=md-ellipsis> Key resources </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#why-soa-is-controversial class=md-nav__link> <span class=md-ellipsis> Why SOA is Controversial </span> </a> <nav class=md-nav aria-label="Why SOA is Controversial"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#recommended-alternatives class=md-nav__link> <span class=md-ellipsis> Recommended alternatives </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#can-dxmessaging-work-with-soa class=md-nav__link> <span class=md-ellipsis> Can DxMessaging Work with SOA? </span> </a> </li> <li class=md-nav__item> <a href=#pattern-overview class=md-nav__link> <span class=md-ellipsis> Pattern Overview </span> </a> </li> <li class=md-nav__item> <a href=#pattern-a-soa--dxmessaging-event-forwarding class=md-nav__link> <span class=md-ellipsis> Pattern A: SOA → DxMessaging (Event Forwarding) </span> </a> <nav class=md-nav aria-label="Pattern A: SOA → DxMessaging (Event Forwarding)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-scene-transitions class=md-nav__link> <span class=md-ellipsis> Example: Scene Transitions </span> </a> <nav class=md-nav aria-label="Example: Scene Transitions"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> <nav class=md-nav aria-label=Benefits> <ul class=md-nav__list> <li class=md-nav__item> <a href=#drawbacks class=md-nav__link> <span class=md-ellipsis> Drawbacks </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-b-proper-scriptableobject-usage-recommended class=md-nav__link> <span class=md-ellipsis> Pattern B: Proper ScriptableObject Usage (Recommended) </span> </a> <nav class=md-nav aria-label="Pattern B: Proper ScriptableObject Usage (Recommended)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-combat-with-designer-tunable-data class=md-nav__link> <span class=md-ellipsis> Example: Combat with Designer-Tunable Data </span> </a> <nav class=md-nav aria-label="Example: Combat with Designer-Tunable Data"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits_1 class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> <nav class=md-nav aria-label=Benefits> <ul class=md-nav__list> <li class=md-nav__item> <a href=#this-pattern-separates-concerns-clearly class=md-nav__link> <span class=md-ellipsis> This pattern separates concerns clearly </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#when-to-use-each-pattern class=md-nav__link> <span class=md-ellipsis> When to Use Each Pattern </span> </a> </li> <li class=md-nav__item> <a href=#migration-path-soa--dxmessaging class=md-nav__link> <span class=md-ellipsis> Migration Path: SOA → DxMessaging </span> </a> </li> <li class=md-nav__item> <a href=#final-recommendations class=md-nav__link> <span class=md-ellipsis> Final Recommendations </span> </a> <nav class=md-nav aria-label="Final Recommendations"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#if-youre-using-soa class=md-nav__link> <span class=md-ellipsis> If you're using SOA </span> </a> <nav class=md-nav aria-label="If you're using SOA"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#if-youre-starting-fresh class=md-nav__link> <span class=md-ellipsis> If you're starting fresh </span> </a> <nav class=md-nav aria-label="If you're starting fresh"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#resources class=md-nav__link> <span class=md-ellipsis> Resources </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#related-documentation class=md-nav__link> <span class=md-ellipsis> Related Documentation </span> </a> <nav class=md-nav aria-label="Related Documentation"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#learn-the-basics-first class=md-nav__link> <span class=md-ellipsis> Learn the Basics First? </span> </a> </li> <li class=md-nav__item> <a href=#try-real-examples class=md-nav__link> <span class=md-ellipsis> Try Real Examples </span> </a> </li> <li class=md-nav__item> <a href=#deep-dives class=md-nav__link> <span class=md-ellipsis> Deep Dives </span> </a> </li> <li class=md-nav__item> <a href=#reference class=md-nav__link> <span class=md-ellipsis> Reference </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../unity-integration/ class=md-nav__link> <span class=md-ellipsis> Unity Integration </span> </a> </li> <li class=md-nav__item> <a href=../testing/ class=md-nav__link> <span class=md-ellipsis> Testing </span> </a> </li> <li class=md-nav__item> <a href=../diagnostics/ class=md-nav__link> <span class=md-ellipsis> Diagnostics </span> </a> </li> <li class=md-nav__item> <a href=../advanced/ class=md-nav__link> <span class=md-ellipsis> Advanced Topics </span> </a> </li> <li class=md-nav__item> <a href=../migration-guide/ class=md-nav__link> <span class=md-ellipsis> Migration Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_5> <label class=md-nav__link for=__nav_5 id=__nav_5_label tabindex=0> <span class=md-ellipsis> Architecture </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_5_label aria-expanded=false> <label class=md-nav__title for=__nav_5> <span class="md-nav__icon md-icon"></span> Architecture </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../architecture/design-and-architecture/ class=md-nav__link> <span class=md-ellipsis> Design & Architecture </span> </a> </li> <li class=md-nav__item> <a href=../../architecture/comparisons/ class=md-nav__link> <span class=md-ellipsis> Comparisons </span> </a> </li> <li class=md-nav__item> <a href=../../architecture/performance/ class=md-nav__link> <span class=md-ellipsis> Performance </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Advanced </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Advanced </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../advanced/emit-shorthands/ class=md-nav__link> <span class=md-ellipsis> Emit Shorthands </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/message-bus-providers/ class=md-nav__link> <span class=md-ellipsis> Message Bus Providers </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/registration-builders/ class=md-nav__link> <span class=md-ellipsis> Registration Builders </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/runtime-configuration/ class=md-nav__link> <span class=md-ellipsis> Runtime Configuration </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/string-messages/ class=md-nav__link> <span class=md-ellipsis> String Messages </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_7> <div class="md-nav__link md-nav__container"> <a href=../../integrations/ class="md-nav__link "> <span class=md-ellipsis> Integrations </span> </a> <label class="md-nav__link " for=__nav_7 id=__nav_7_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Integrations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../integrations/vcontainer/ class=md-nav__link> <span class=md-ellipsis> VContainer </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/zenject/ class=md-nav__link> <span class=md-ellipsis> Zenject </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/reflex/ class=md-nav__link> <span class=md-ellipsis> Reflex </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Examples </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Examples </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../examples/end-to-end/ class=md-nav__link> <span class=md-ellipsis> End-to-End </span> </a> </li> <li class=md-nav__item> <a href=../../examples/end-to-end-scene-transitions/ class=md-nav__link> <span class=md-ellipsis> Scene Transitions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/reference/ class=md-nav__link> <span class=md-ellipsis> API Reference (Practical) </span> </a> </li> <li class=md-nav__item> <a href=../../reference/quick-reference/ class=md-nav__link> <span class=md-ellipsis> Quick Reference </span> </a> </li> <li class=md-nav__item> <a href=../../reference/helpers/ class=md-nav__link> <span class=md-ellipsis> Helpers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/faq/ class=md-nav__link> <span class=md-ellipsis> FAQ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/glossary/ class=md-nav__link> <span class=md-ellipsis> Glossary </span> </a> </li> <li class=md-nav__item> <a href=../../reference/troubleshooting/ class=md-nav__link> <span class=md-ellipsis> Troubleshooting </span> </a> </li> <li class=md-nav__item> <a href=../../reference/compatibility/ class=md-nav__link> <span class=md-ellipsis> Compatibility </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#what-youll-find class=md-nav__link> <span class=md-ellipsis> What you'll find </span> </a> <nav class=md-nav aria-label="What you'll find"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#reading-guide class=md-nav__link> <span class=md-ellipsis> Reading guide </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#quick-links-i-want-to class=md-nav__link> <span class=md-ellipsis> Quick Links: "I Want To..." </span> </a> <nav class=md-nav aria-label='Quick Links: "I Want To..."'> <ul class=md-nav__list> <li class=md-nav__item> <a href=#find-your-use-case-jump-to-the-pattern class=md-nav__link> <span class=md-ellipsis> Find your use case, jump to the pattern </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#table-of-contents class=md-nav__link> <span class=md-ellipsis> Table of Contents </span> </a> <nav class=md-nav aria-label="Table of Contents"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#basic-patterns class=md-nav__link> <span class=md-ellipsis> Basic Patterns </span> </a> </li> <li class=md-nav__item> <a href=#advanced-patterns class=md-nav__link> <span class=md-ellipsis> Advanced Patterns </span> </a> </li> <li class=md-nav__item> <a href=#real-world-scale-patterns class=md-nav__link> <span class=md-ellipsis> Real-World Scale Patterns </span> </a> </li> <li class=md-nav__item> <a href=#important-inheritance-with-messageawarecomponent class=md-nav__link> <span class=md-ellipsis> Important: Inheritance with MessageAwareComponent </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#1-scene-wide-events-untargeted class=md-nav__link> <span class=md-ellipsis> 1) Scene-wide Events (Untargeted) </span> </a> </li> <li class=md-nav__item> <a href=#2-directed-commands-targeted class=md-nav__link> <span class=md-ellipsis> 2) Directed Commands (Targeted) </span> </a> </li> <li class=md-nav__item> <a href=#3-observability-broadcast class=md-nav__link> <span class=md-ellipsis> 3) Observability (Broadcast) </span> </a> </li> <li class=md-nav__item> <a href=#4-validation-and-normalization-interceptors class=md-nav__link> <span class=md-ellipsis> 4) Validation and Normalization (Interceptors) </span> </a> </li> <li class=md-nav__item> <a href=#5-analyticslogging-post-processors class=md-nav__link> <span class=md-ellipsis> 5) Analytics/Logging (Post-Processors) </span> </a> </li> <li class=md-nav__item> <a href=#6-local-bus-islands class=md-nav__link> <span class=md-ellipsis> 6) Local Bus Islands </span> </a> </li> <li class=md-nav__item> <a href=#7-lifecycle-pattern-in-unity class=md-nav__link> <span class=md-ellipsis> 7) Lifecycle Pattern in Unity </span> </a> </li> <li class=md-nav__item> <a href=#8-cross-scene-messaging class=md-nav__link> <span class=md-ellipsis> 8) Cross-Scene Messaging </span> </a> </li> <li class=md-nav__item> <a href=#9-bridging-legacy-unity-messaging class=md-nav__link> <span class=md-ellipsis> 9) Bridging Legacy Unity Messaging </span> </a> </li> <li class=md-nav__item> <a href=#10-global-accept-all-handlers class=md-nav__link> <span class=md-ellipsis> 10) Global Accept-All Handlers </span> </a> </li> <li class=md-nav__item> <a href=#11-diagnostics-and-tuning class=md-nav__link> <span class=md-ellipsis> 11) Diagnostics and Tuning </span> </a> </li> <li class=md-nav__item> <a href=#12-testing class=md-nav__link> <span class=md-ellipsis> 12) Testing </span> </a> </li> <li class=md-nav__item> <a href=#13-real-world-scale-beyond-toy-examples class=md-nav__link> <span class=md-ellipsis> 13) Real-World Scale: Beyond Toy Examples </span> </a> <nav class=md-nav aria-label="13) Real-World Scale: Beyond Toy Examples"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#pattern-managing-100-combat-entities class=md-nav__link> <span class=md-ellipsis> Pattern: Managing 100+ Combat Entities </span> </a> <nav class=md-nav aria-label="Pattern: Managing 100+ Combat Entities"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#scale-characteristics class=md-nav__link> <span class=md-ellipsis> Scale characteristics </span> </a> <nav class=md-nav aria-label="Scale characteristics"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#performance-notes class=md-nav__link> <span class=md-ellipsis> Performance notes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-cross-scene-persistent-systems class=md-nav__link> <span class=md-ellipsis> Pattern: Cross-Scene Persistent Systems </span> </a> </li> <li class=md-nav__item> <a href=#pattern-large-scale-ui-system-20-panels class=md-nav__link> <span class=md-ellipsis> Pattern: Large-Scale UI System (20+ Panels) </span> </a> <nav class=md-nav aria-label="Pattern: Large-Scale UI System (20+ Panels)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits-at-scale class=md-nav__link> <span class=md-ellipsis> Benefits at scale </span> </a> <nav class=md-nav aria-label="Benefits at scale"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#anti-pattern-to-avoid class=md-nav__link> <span class=md-ellipsis> Anti-pattern to avoid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-priority-ordered-execution-for-complex-systems class=md-nav__link> <span class=md-ellipsis> Pattern: Priority-Ordered Execution for Complex Systems </span> </a> <nav class=md-nav aria-label="Pattern: Priority-Ordered Execution for Complex Systems"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#recommended-priority-ranges class=md-nav__link> <span class=md-ellipsis> Recommended priority ranges </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-efficient-interception-at-scale class=md-nav__link> <span class=md-ellipsis> Pattern: Efficient Interception at Scale </span> </a> </li> <li class=md-nav__item> <a href=#pattern-post-processing-for-analytics-at-scale class=md-nav__link> <span class=md-ellipsis> Pattern: Post-Processing for Analytics at Scale </span> </a> </li> <li class=md-nav__item> <a href=#performance-optimization-patterns-at-scale class=md-nav__link> <span class=md-ellipsis> Performance Optimization Patterns at Scale </span> </a> <nav class=md-nav aria-label="Performance Optimization Patterns at Scale"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#optimization-1-disable-diagnostics-in-builds class=md-nav__link> <span class=md-ellipsis> Optimization 1: Disable Diagnostics in Builds </span> </a> </li> <li class=md-nav__item> <a href=#optimization-2-use-specific-registrations-over-globalacceptall class=md-nav__link> <span class=md-ellipsis> Optimization 2: Use Specific Registrations Over GlobalAcceptAll </span> </a> </li> <li class=md-nav__item> <a href=#optimization-3-batch-message-emissions class=md-nav__link> <span class=md-ellipsis> Optimization 3: Batch Message Emissions </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#scaling-guidelines class=md-nav__link> <span class=md-ellipsis> Scaling Guidelines </span> </a> </li> <li class=md-nav__item> <a href=#real-world-production-example-battle-royale-game class=md-nav__link> <span class=md-ellipsis> Real-World Production Example: Battle Royale Game </span> </a> <nav class=md-nav aria-label="Real-World Production Example: Battle Royale Game"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-insights class=md-nav__link> <span class=md-ellipsis> Key insights </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#14-compatibility-with-scriptable-object-architecture-soa class=md-nav__link> <span class=md-ellipsis> 14) Compatibility with Scriptable Object Architecture (SOA) </span> </a> <nav class=md-nav aria-label="14) Compatibility with Scriptable Object Architecture (SOA)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-is-scriptable-object-architecture class=md-nav__link> <span class=md-ellipsis> What is Scriptable Object Architecture? </span> </a> <nav class=md-nav aria-label="What is Scriptable Object Architecture?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-resources class=md-nav__link> <span class=md-ellipsis> Key resources </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#why-soa-is-controversial class=md-nav__link> <span class=md-ellipsis> Why SOA is Controversial </span> </a> <nav class=md-nav aria-label="Why SOA is Controversial"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#recommended-alternatives class=md-nav__link> <span class=md-ellipsis> Recommended alternatives </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#can-dxmessaging-work-with-soa class=md-nav__link> <span class=md-ellipsis> Can DxMessaging Work with SOA? </span> </a> </li> <li class=md-nav__item> <a href=#pattern-overview class=md-nav__link> <span class=md-ellipsis> Pattern Overview </span> </a> </li> <li class=md-nav__item> <a href=#pattern-a-soa--dxmessaging-event-forwarding class=md-nav__link> <span class=md-ellipsis> Pattern A: SOA → DxMessaging (Event Forwarding) </span> </a> <nav class=md-nav aria-label="Pattern A: SOA → DxMessaging (Event Forwarding)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-scene-transitions class=md-nav__link> <span class=md-ellipsis> Example: Scene Transitions </span> </a> <nav class=md-nav aria-label="Example: Scene Transitions"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> <nav class=md-nav aria-label=Benefits> <ul class=md-nav__list> <li class=md-nav__item> <a href=#drawbacks class=md-nav__link> <span class=md-ellipsis> Drawbacks </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-b-proper-scriptableobject-usage-recommended class=md-nav__link> <span class=md-ellipsis> Pattern B: Proper ScriptableObject Usage (Recommended) </span> </a> <nav class=md-nav aria-label="Pattern B: Proper ScriptableObject Usage (Recommended)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-combat-with-designer-tunable-data class=md-nav__link> <span class=md-ellipsis> Example: Combat with Designer-Tunable Data </span> </a> <nav class=md-nav aria-label="Example: Combat with Designer-Tunable Data"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits_1 class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> <nav class=md-nav aria-label=Benefits> <ul class=md-nav__list> <li class=md-nav__item> <a href=#this-pattern-separates-concerns-clearly class=md-nav__link> <span class=md-ellipsis> This pattern separates concerns clearly </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#when-to-use-each-pattern class=md-nav__link> <span class=md-ellipsis> When to Use Each Pattern </span> </a> </li> <li class=md-nav__item> <a href=#migration-path-soa--dxmessaging class=md-nav__link> <span class=md-ellipsis> Migration Path: SOA → DxMessaging </span> </a> </li> <li class=md-nav__item> <a href=#final-recommendations class=md-nav__link> <span class=md-ellipsis> Final Recommendations </span> </a> <nav class=md-nav aria-label="Final Recommendations"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#if-youre-using-soa class=md-nav__link> <span class=md-ellipsis> If you're using SOA </span> </a> <nav class=md-nav aria-label="If you're using SOA"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#if-youre-starting-fresh class=md-nav__link> <span class=md-ellipsis> If you're starting fresh </span> </a> <nav class=md-nav aria-label="If you're starting fresh"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#resources class=md-nav__link> <span class=md-ellipsis> Resources </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#related-documentation class=md-nav__link> <span class=md-ellipsis> Related Documentation </span> </a> <nav class=md-nav aria-label="Related Documentation"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#learn-the-basics-first class=md-nav__link> <span class=md-ellipsis> Learn the Basics First? </span> </a> </li> <li class=md-nav__item> <a href=#try-real-examples class=md-nav__link> <span class=md-ellipsis> Try Real Examples </span> </a> </li> <li class=md-nav__item> <a href=#deep-dives class=md-nav__link> <span class=md-ellipsis> Deep Dives </span> </a> </li> <li class=md-nav__item> <a href=#reference class=md-nav__link> <span class=md-ellipsis> Reference </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <nav class=md-path aria-label=Navigation> <ol class=md-path__list> <li class=md-path__item> <a href=../.. class=md-path__link> <span class=md-ellipsis> Home </span> </a> </li> <li class=md-path__item> <a href=./ class=md-path__link> <span class=md-ellipsis> Guides </span> </a> </li> </ol> </nav> <article class="md-content__inner md-typeset"> <a href=https://github.com/wallstop/DxMessaging/edit/master/docs/guides/patterns.md title="Edit this page" class="md-content__button md-icon" rel=edit> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg> </a> <a href=https://github.com/wallstop/DxMessaging/raw/master/docs/guides/patterns.md title="View source of this page" class="md-content__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg> </a> <h1 id=dxmessaging-patterns-real-world-solutions>DxMessaging Patterns: Real-World Solutions<a class=headerlink href=#dxmessaging-patterns-real-world-solutions title="Anchor link to this section">&para;</a></h1> <p><a href=../../getting-started/ >← Back to Index</a> | <a href=../../getting-started/getting-started/ >Getting Started</a> | <a href=../../concepts/message-types/ >Message Types</a> | <a href=https://github.com/wallstop/DxMessaging/tree/master/Samples~>Samples</a></p> <hr> <p><strong>You're here because:</strong> You understand DxMessaging basics, now you want to see "How do I actually build X?"</p> <h2 id=what-youll-find>What you'll find<a class=headerlink href=#what-youll-find title="Anchor link to this section">&para;</a></h2> <ul> <li><strong>Basic Patterns</strong> - Fundamental building blocks (scene transitions, commands, observability)</li> <li><strong>Advanced Patterns</strong> - Power user techniques (diagnostics, testing, legacy integration)</li> <li><strong>Scale Patterns</strong> - Examples for larger systems (100+ entities, cross-scene systems, large UI)</li> </ul> <h3 id=reading-guide>Reading guide<a class=headerlink href=#reading-guide title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>New to DxMessaging?</strong> Start with Basic Patterns 1-8</li> <li><strong>Intermediate user?</strong> Jump to Advanced Patterns 9-12</li> <li><strong>Building at scale?</strong> Go straight to Real-World Scale Patterns</li> <li><strong>Specific problem?</strong> Use Ctrl+F / Cmd+F to search</li> </ul> <p><strong>Philosophy:</strong> These patterns address common challenges teams face when building messaging systems.</p> <hr> <h2 id=quick-links-i-want-to>Quick Links: "I Want To..."<a class=headerlink href=#quick-links-i-want-to title="Anchor link to this section">&para;</a></h2> <h3 id=find-your-use-case-jump-to-the-pattern>Find your use case, jump to the pattern<a class=headerlink href=#find-your-use-case-jump-to-the-pattern title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>I want to...</th> <th>Go to</th> </tr> </thead> <tbody> <tr> <td>Make UI react to gameplay</td> <td><a href=#2-directed-commands-targeted>Pattern 2: Directed Commands</a></td> </tr> <tr> <td>Coordinate scene transitions</td> <td><a href=#1-scene-wide-events-untargeted>Pattern 1: Scene-wide Events</a></td> </tr> <tr> <td>Build an achievement system</td> <td><a href=#3-observability-broadcast>Pattern 3: Observability</a> + <a href=#10-global-accept-all-handlers>Global Accept-All</a></td> </tr> <tr> <td>Validate input/damage before it happens</td> <td><a href=#4-validation-and-normalization-interceptors>Pattern 4: Interceptors</a></td> </tr> <tr> <td>Add analytics without touching gameplay</td> <td><a href=#5-analyticslogging-post-processors>Pattern 5: Post-Processors</a></td> </tr> <tr> <td>Track ALL damage from ANY entity</td> <td><a href=#pattern-managing-100-combat-entities>Pattern: Managing 100+ Entities</a></td> </tr> <tr> <td>Build a large UI system (20+ panels)</td> <td><a href=#pattern-large-scale-ui-system-20-panels>Pattern: Large-Scale UI</a></td> </tr> <tr> <td>Make systems run in a specific order</td> <td><a href=#pattern-priority-ordered-execution-for-complex-systems>Pattern: Priority Ordering</a></td> </tr> <tr> <td>Test in isolation</td> <td><a href=#6-local-bus-islands>Pattern 6: Local Bus Islands</a></td> </tr> <tr> <td>Migrate from C# events</td> <td><a href=#9-bridging-legacy-unity-messaging>Pattern 9: Bridging Legacy</a></td> </tr> <tr> <td>Handle persistent systems across scene loads</td> <td><a href=#pattern-cross-scene-persistent-systems>Pattern: Cross-Scene Persistent</a></td> </tr> <tr> <td>See what's happening (debug message flow)</td> <td><a href=#11-diagnostics-and-tuning>Pattern 11: Diagnostics</a></td> </tr> <tr> <td>Build a battle royale / large multiplayer</td> <td><a href=#real-world-production-example-battle-royale-game>Pattern: Battle Royale Example</a></td> </tr> <tr> <td>Use with Scriptable Object Architecture</td> <td><a href=#14-compatibility-with-scriptable-object-architecture-soa>Pattern 14: SOA Compatibility</a></td> </tr> </tbody> </table> <hr> <h2 id=table-of-contents>Table of Contents<a class=headerlink href=#table-of-contents title="Anchor link to this section">&para;</a></h2> <h3 id=basic-patterns>Basic Patterns<a class=headerlink href=#basic-patterns title="Anchor link to this section">&para;</a></h3> <ul> <li><a href=#1-scene-wide-events-untargeted>Scene-wide Events (Untargeted)</a></li> <li><a href=#2-directed-commands-targeted>Directed Commands (Targeted)</a></li> <li><a href=#3-observability-broadcast>Observability (Broadcast)</a></li> <li><a href=#4-validation-and-normalization-interceptors>Validation and Normalization (Interceptors)</a></li> <li><a href=#5-analyticslogging-post-processors>Analytics and Logging (Post-Processors)</a></li> <li><a href=#6-local-bus-islands>Local Bus Islands</a></li> <li><a href=#7-lifecycle-pattern-in-unity>Lifecycle Pattern in Unity</a></li> <li><a href=#8-cross-scene-messaging>Cross-Scene Messaging</a></li> </ul> <h3 id=advanced-patterns>Advanced Patterns<a class=headerlink href=#advanced-patterns title="Anchor link to this section">&para;</a></h3> <ul> <li><a href=#9-bridging-legacy-unity-messaging>Bridging Legacy Unity Messaging</a></li> <li><a href=#10-global-accept-all-handlers>Global Accept-All Handlers</a></li> <li><a href=#11-diagnostics-and-tuning>Diagnostics and Tuning</a></li> <li><a href=#12-testing>Testing</a></li> <li><a href=#14-compatibility-with-scriptable-object-architecture-soa>Compatibility with Scriptable Object Architecture (SOA)</a></li> </ul> <h3 id=real-world-scale-patterns>Real-World Scale Patterns<a class=headerlink href=#real-world-scale-patterns title="Anchor link to this section">&para;</a></h3> <ul> <li><a href=#pattern-managing-100-combat-entities>Managing 100+ Combat Entities</a></li> <li><a href=#pattern-cross-scene-persistent-systems>Cross-Scene Persistent Systems</a></li> <li><a href=#pattern-large-scale-ui-system-20-panels>Large-Scale UI System (20+ Panels)</a></li> <li><a href=#pattern-priority-ordered-execution-for-complex-systems>Priority-Ordered Execution</a></li> <li><a href=#pattern-efficient-interception-at-scale>Efficient Interception at Scale</a></li> <li><a href=#pattern-post-processing-for-analytics-at-scale>Post-Processing for Analytics at Scale</a></li> <li><a href=#performance-optimization-patterns-at-scale>Performance Optimization Patterns</a></li> <li><a href=#real-world-production-example-battle-royale-game>Production Example: Battle Royale Game</a></li> </ul> <hr> <h3 id=important-inheritance-with-messageawarecomponent>Important: Inheritance with MessageAwareComponent<a class=headerlink href=#important-inheritance-with-messageawarecomponent title="Anchor link to this section">&para;</a></h3> <ul> <li>Many examples derive from <code>MessageAwareComponent</code>. <strong>When overriding hooks, you MUST call the base method.</strong></li> <li><strong>Always call <code>base.RegisterMessageHandlers()</code> FIRST</strong> in your override to preserve default string‑message registrations and parent class registrations.</li> <li><strong>CRITICAL</strong>: Call <code>base.OnEnable()</code> / <code>base.OnDisable()</code> if you override lifecycle methods; otherwise your token may never enable/disable.</li> <li><strong>CRITICAL</strong>: Call <code>base.Awake()</code> if you override <code>Awake()</code>; otherwise your token won't be created.</li> <li>To opt out of string demos, override <code>RegisterForStringMessages =&gt; false</code> instead of skipping the base call.</li> <li><strong>Don't use <code>new</code> to hide methods</strong> (e.g., <code>new void OnEnable()</code>); always use <code>override</code> and call <code>base.*</code>.</li> </ul> <p>Registration timing (pit of success)</p> <ul> <li><strong>Prefer <code>Awake()</code> for all message handler registration</strong>—this is when <code>MessageAwareComponent</code> calls <code>RegisterMessageHandlers()</code>.</li> <li>Avoid registering in <code>Start()</code> unless you have a specific order-of-execution reason.</li> <li>Early registration in <code>Awake()</code> ensures your handlers are ready before other components' <code>Start()</code> methods run.</li> </ul> <h2 id=1-scene-wide-events-untargeted>1) Scene-wide Events (Untargeted)<a class=headerlink href=#1-scene-wide-events-untargeted title="Anchor link to this section">&para;</a></h2> <p>Use untargeted messages for global state changes that any system might care about. Keep messages small and immutable.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-0-1><a id=__codelineno-0-1 name=__codelineno-0-1 href=#__codelineno-0-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Messages</span><span class=p>;</span>
1
+ <!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="High-performance type-safe messaging library for Unity"><meta name=author content="Wallstop Studios"><link href=https://wallstop.github.io/DxMessaging/guides/patterns/ rel=canonical><link href=../../concepts/interceptors-and-ordering/ rel=prev><link href=../unity-integration/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.1"><title>Patterns - DxMessaging Documentation</title><link rel=stylesheet href=../../assets/stylesheets/main.484c7ddc.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.ab4e12ef.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../css/timeago.css><link rel=stylesheet href=../../stylesheets/extra.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#dxmessaging-patterns-real-world-solutions class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class="md-header md-header--shadow md-header--lifted" data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="DxMessaging Documentation" class="md-header__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> DxMessaging Documentation </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Patterns </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to dark mode" type=radio name=__palette id=__palette_0> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> <input class=md-option data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme=slate data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to light mode" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_0 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <a href=javascript:void(0) class="md-search__icon md-icon" title=Share aria-label=Share data-clipboard data-clipboard-text data-md-component=search-share tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg> </a> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> <div class=md-search__suggest data-md-component=search-suggest></div> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> </nav> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Home </a> </li> <li class=md-tabs__item> <a href=../../getting-started/ class=md-tabs__link> Getting Started </a> </li> <li class=md-tabs__item> <a href=../../concepts/ class=md-tabs__link> Concepts </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> Guides </a> </li> <li class=md-tabs__item> <a href=../../architecture/design-and-architecture/ class=md-tabs__link> Architecture </a> </li> <li class=md-tabs__item> <a href=../../advanced/emit-shorthands/ class=md-tabs__link> Advanced </a> </li> <li class=md-tabs__item> <a href=../../integrations/ class=md-tabs__link> Integrations </a> </li> <li class=md-tabs__item> <a href=../../examples/end-to-end/ class=md-tabs__link> Examples </a> </li> <li class=md-tabs__item> <a href=../../reference/reference/ class=md-tabs__link> Reference </a> </li> </ul> </div> </nav> </header> <div class=md-container data-md-component=container> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="DxMessaging Documentation" class="md-nav__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> DxMessaging Documentation </label> <div class=md-nav__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Home </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_2> <div class="md-nav__link md-nav__container"> <a href=../../getting-started/ class="md-nav__link "> <span class=md-ellipsis> Getting Started </span> </a> <label class="md-nav__link " for=__nav_2 id=__nav_2_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_2_label aria-expanded=false> <label class=md-nav__title for=__nav_2> <span class="md-nav__icon md-icon"></span> Getting Started </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../getting-started/overview/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/install/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/quick-start/ class=md-nav__link> <span class=md-ellipsis> Quick Start </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/getting-started/ class=md-nav__link> <span class=md-ellipsis> Getting Started Guide </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/visual-guide/ class=md-nav__link> <span class=md-ellipsis> Visual Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_3> <div class="md-nav__link md-nav__container"> <a href=../../concepts/ class="md-nav__link "> <span class=md-ellipsis> Concepts </span> </a> <label class="md-nav__link " for=__nav_3 id=__nav_3_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3> <span class="md-nav__icon md-icon"></span> Concepts </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../concepts/mental-model/ class=md-nav__link> <span class=md-ellipsis> Mental Model </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/message-types/ class=md-nav__link> <span class=md-ellipsis> Message Types </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/listening-patterns/ class=md-nav__link> <span class=md-ellipsis> Listening Patterns </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/targeting-and-context/ class=md-nav__link> <span class=md-ellipsis> Targeting & Context </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/interceptors-and-ordering/ class=md-nav__link> <span class=md-ellipsis> Interceptors & Ordering </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4 checked> <label class=md-nav__link for=__nav_4 id=__nav_4_label tabindex> <span class=md-ellipsis> Guides </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_4_label aria-expanded=true> <label class=md-nav__title for=__nav_4> <span class="md-nav__icon md-icon"></span> Guides </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Patterns </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Patterns </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#what-youll-find class=md-nav__link> <span class=md-ellipsis> What you'll find </span> </a> <nav class=md-nav aria-label="What you'll find"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#reading-guide class=md-nav__link> <span class=md-ellipsis> Reading guide </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#quick-links-i-want-to class=md-nav__link> <span class=md-ellipsis> Quick Links: "I Want To..." </span> </a> <nav class=md-nav aria-label='Quick Links: "I Want To..."'> <ul class=md-nav__list> <li class=md-nav__item> <a href=#find-your-use-case-jump-to-the-pattern class=md-nav__link> <span class=md-ellipsis> Find your use case, jump to the pattern </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#table-of-contents class=md-nav__link> <span class=md-ellipsis> Table of Contents </span> </a> <nav class=md-nav aria-label="Table of Contents"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#basic-patterns class=md-nav__link> <span class=md-ellipsis> Basic Patterns </span> </a> </li> <li class=md-nav__item> <a href=#advanced-patterns class=md-nav__link> <span class=md-ellipsis> Advanced Patterns </span> </a> </li> <li class=md-nav__item> <a href=#real-world-scale-patterns class=md-nav__link> <span class=md-ellipsis> Real-World Scale Patterns </span> </a> </li> <li class=md-nav__item> <a href=#important-inheritance-with-messageawarecomponent class=md-nav__link> <span class=md-ellipsis> Important: Inheritance with MessageAwareComponent </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#1-scene-wide-events-untargeted class=md-nav__link> <span class=md-ellipsis> 1) Scene-wide Events (Untargeted) </span> </a> </li> <li class=md-nav__item> <a href=#2-directed-commands-targeted class=md-nav__link> <span class=md-ellipsis> 2) Directed Commands (Targeted) </span> </a> </li> <li class=md-nav__item> <a href=#3-observability-broadcast class=md-nav__link> <span class=md-ellipsis> 3) Observability (Broadcast) </span> </a> </li> <li class=md-nav__item> <a href=#4-validation-and-normalization-interceptors class=md-nav__link> <span class=md-ellipsis> 4) Validation and Normalization (Interceptors) </span> </a> </li> <li class=md-nav__item> <a href=#5-analyticslogging-post-processors class=md-nav__link> <span class=md-ellipsis> 5) Analytics/Logging (Post-Processors) </span> </a> </li> <li class=md-nav__item> <a href=#6-local-bus-islands class=md-nav__link> <span class=md-ellipsis> 6) Local Bus Islands </span> </a> </li> <li class=md-nav__item> <a href=#7-lifecycle-pattern-in-unity class=md-nav__link> <span class=md-ellipsis> 7) Lifecycle Pattern in Unity </span> </a> </li> <li class=md-nav__item> <a href=#8-cross-scene-messaging class=md-nav__link> <span class=md-ellipsis> 8) Cross-Scene Messaging </span> </a> </li> <li class=md-nav__item> <a href=#9-bridging-legacy-unity-messaging class=md-nav__link> <span class=md-ellipsis> 9) Bridging Legacy Unity Messaging </span> </a> </li> <li class=md-nav__item> <a href=#10-global-accept-all-handlers class=md-nav__link> <span class=md-ellipsis> 10) Global Accept-All Handlers </span> </a> </li> <li class=md-nav__item> <a href=#11-diagnostics-and-tuning class=md-nav__link> <span class=md-ellipsis> 11) Diagnostics and Tuning </span> </a> </li> <li class=md-nav__item> <a href=#12-testing class=md-nav__link> <span class=md-ellipsis> 12) Testing </span> </a> </li> <li class=md-nav__item> <a href=#13-real-world-scale-beyond-toy-examples class=md-nav__link> <span class=md-ellipsis> 13) Real-World Scale: Beyond Toy Examples </span> </a> <nav class=md-nav aria-label="13) Real-World Scale: Beyond Toy Examples"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#pattern-managing-100-combat-entities class=md-nav__link> <span class=md-ellipsis> Pattern: Managing 100+ Combat Entities </span> </a> <nav class=md-nav aria-label="Pattern: Managing 100+ Combat Entities"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#scale-characteristics class=md-nav__link> <span class=md-ellipsis> Scale characteristics </span> </a> <nav class=md-nav aria-label="Scale characteristics"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#performance-notes class=md-nav__link> <span class=md-ellipsis> Performance notes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-cross-scene-persistent-systems class=md-nav__link> <span class=md-ellipsis> Pattern: Cross-Scene Persistent Systems </span> </a> </li> <li class=md-nav__item> <a href=#pattern-large-scale-ui-system-20-panels class=md-nav__link> <span class=md-ellipsis> Pattern: Large-Scale UI System (20+ Panels) </span> </a> <nav class=md-nav aria-label="Pattern: Large-Scale UI System (20+ Panels)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits-at-scale class=md-nav__link> <span class=md-ellipsis> Benefits at scale </span> </a> <nav class=md-nav aria-label="Benefits at scale"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#anti-pattern-to-avoid class=md-nav__link> <span class=md-ellipsis> Anti-pattern to avoid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-priority-ordered-execution-for-complex-systems class=md-nav__link> <span class=md-ellipsis> Pattern: Priority-Ordered Execution for Complex Systems </span> </a> <nav class=md-nav aria-label="Pattern: Priority-Ordered Execution for Complex Systems"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#recommended-priority-ranges class=md-nav__link> <span class=md-ellipsis> Recommended priority ranges </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-efficient-interception-at-scale class=md-nav__link> <span class=md-ellipsis> Pattern: Efficient Interception at Scale </span> </a> </li> <li class=md-nav__item> <a href=#pattern-post-processing-for-analytics-at-scale class=md-nav__link> <span class=md-ellipsis> Pattern: Post-Processing for Analytics at Scale </span> </a> </li> <li class=md-nav__item> <a href=#performance-optimization-patterns-at-scale class=md-nav__link> <span class=md-ellipsis> Performance Optimization Patterns at Scale </span> </a> <nav class=md-nav aria-label="Performance Optimization Patterns at Scale"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#optimization-1-disable-diagnostics-in-builds class=md-nav__link> <span class=md-ellipsis> Optimization 1: Disable Diagnostics in Builds </span> </a> </li> <li class=md-nav__item> <a href=#optimization-2-use-specific-registrations-over-globalacceptall class=md-nav__link> <span class=md-ellipsis> Optimization 2: Use Specific Registrations Over GlobalAcceptAll </span> </a> </li> <li class=md-nav__item> <a href=#optimization-3-batch-message-emissions class=md-nav__link> <span class=md-ellipsis> Optimization 3: Batch Message Emissions </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#scaling-guidelines class=md-nav__link> <span class=md-ellipsis> Scaling Guidelines </span> </a> </li> <li class=md-nav__item> <a href=#real-world-production-example-battle-royale-game class=md-nav__link> <span class=md-ellipsis> Real-World Production Example: Battle Royale Game </span> </a> <nav class=md-nav aria-label="Real-World Production Example: Battle Royale Game"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-insights class=md-nav__link> <span class=md-ellipsis> Key insights </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#14-compatibility-with-scriptable-object-architecture-soa class=md-nav__link> <span class=md-ellipsis> 14) Compatibility with Scriptable Object Architecture (SOA) </span> </a> <nav class=md-nav aria-label="14) Compatibility with Scriptable Object Architecture (SOA)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-is-scriptable-object-architecture class=md-nav__link> <span class=md-ellipsis> What is Scriptable Object Architecture? </span> </a> <nav class=md-nav aria-label="What is Scriptable Object Architecture?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-resources class=md-nav__link> <span class=md-ellipsis> Key resources </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#why-soa-is-controversial class=md-nav__link> <span class=md-ellipsis> Why SOA is Controversial </span> </a> <nav class=md-nav aria-label="Why SOA is Controversial"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#recommended-alternatives class=md-nav__link> <span class=md-ellipsis> Recommended alternatives </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#can-dxmessaging-work-with-soa class=md-nav__link> <span class=md-ellipsis> Can DxMessaging Work with SOA? </span> </a> </li> <li class=md-nav__item> <a href=#pattern-overview class=md-nav__link> <span class=md-ellipsis> Pattern Overview </span> </a> </li> <li class=md-nav__item> <a href=#pattern-a-soa--dxmessaging-event-forwarding class=md-nav__link> <span class=md-ellipsis> Pattern A: SOA → DxMessaging (Event Forwarding) </span> </a> <nav class=md-nav aria-label="Pattern A: SOA → DxMessaging (Event Forwarding)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-scene-transitions class=md-nav__link> <span class=md-ellipsis> Example: Scene Transitions </span> </a> <nav class=md-nav aria-label="Example: Scene Transitions"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> <nav class=md-nav aria-label=Benefits> <ul class=md-nav__list> <li class=md-nav__item> <a href=#drawbacks class=md-nav__link> <span class=md-ellipsis> Drawbacks </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-b-proper-scriptableobject-usage-recommended class=md-nav__link> <span class=md-ellipsis> Pattern B: Proper ScriptableObject Usage (Recommended) </span> </a> <nav class=md-nav aria-label="Pattern B: Proper ScriptableObject Usage (Recommended)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-combat-with-designer-tunable-data class=md-nav__link> <span class=md-ellipsis> Example: Combat with Designer-Tunable Data </span> </a> <nav class=md-nav aria-label="Example: Combat with Designer-Tunable Data"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits_1 class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> <nav class=md-nav aria-label=Benefits> <ul class=md-nav__list> <li class=md-nav__item> <a href=#this-pattern-separates-concerns-clearly class=md-nav__link> <span class=md-ellipsis> This pattern separates concerns clearly </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#when-to-use-each-pattern class=md-nav__link> <span class=md-ellipsis> When to Use Each Pattern </span> </a> </li> <li class=md-nav__item> <a href=#migration-path-soa--dxmessaging class=md-nav__link> <span class=md-ellipsis> Migration Path: SOA → DxMessaging </span> </a> </li> <li class=md-nav__item> <a href=#final-recommendations class=md-nav__link> <span class=md-ellipsis> Final Recommendations </span> </a> <nav class=md-nav aria-label="Final Recommendations"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#if-youre-using-soa class=md-nav__link> <span class=md-ellipsis> If you're using SOA </span> </a> <nav class=md-nav aria-label="If you're using SOA"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#if-youre-starting-fresh class=md-nav__link> <span class=md-ellipsis> If you're starting fresh </span> </a> <nav class=md-nav aria-label="If you're starting fresh"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#resources class=md-nav__link> <span class=md-ellipsis> Resources </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#related-documentation class=md-nav__link> <span class=md-ellipsis> Related Documentation </span> </a> <nav class=md-nav aria-label="Related Documentation"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#learn-the-basics-first class=md-nav__link> <span class=md-ellipsis> Learn the Basics First? </span> </a> </li> <li class=md-nav__item> <a href=#try-real-examples class=md-nav__link> <span class=md-ellipsis> Try Real Examples </span> </a> </li> <li class=md-nav__item> <a href=#deep-dives class=md-nav__link> <span class=md-ellipsis> Deep Dives </span> </a> </li> <li class=md-nav__item> <a href=#reference class=md-nav__link> <span class=md-ellipsis> Reference </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../unity-integration/ class=md-nav__link> <span class=md-ellipsis> Unity Integration </span> </a> </li> <li class=md-nav__item> <a href=../testing/ class=md-nav__link> <span class=md-ellipsis> Testing </span> </a> </li> <li class=md-nav__item> <a href=../diagnostics/ class=md-nav__link> <span class=md-ellipsis> Diagnostics </span> </a> </li> <li class=md-nav__item> <a href=../advanced/ class=md-nav__link> <span class=md-ellipsis> Advanced Topics </span> </a> </li> <li class=md-nav__item> <a href=../migration-guide/ class=md-nav__link> <span class=md-ellipsis> Migration Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_5> <label class=md-nav__link for=__nav_5 id=__nav_5_label tabindex=0> <span class=md-ellipsis> Architecture </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_5_label aria-expanded=false> <label class=md-nav__title for=__nav_5> <span class="md-nav__icon md-icon"></span> Architecture </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../architecture/design-and-architecture/ class=md-nav__link> <span class=md-ellipsis> Design & Architecture </span> </a> </li> <li class=md-nav__item> <a href=../../architecture/comparisons/ class=md-nav__link> <span class=md-ellipsis> Comparisons </span> </a> </li> <li class=md-nav__item> <a href=../../architecture/performance/ class=md-nav__link> <span class=md-ellipsis> Performance </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Advanced </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Advanced </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../advanced/emit-shorthands/ class=md-nav__link> <span class=md-ellipsis> Emit Shorthands </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/message-bus-providers/ class=md-nav__link> <span class=md-ellipsis> Message Bus Providers </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/registration-builders/ class=md-nav__link> <span class=md-ellipsis> Registration Builders </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/runtime-configuration/ class=md-nav__link> <span class=md-ellipsis> Runtime Configuration </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/string-messages/ class=md-nav__link> <span class=md-ellipsis> String Messages </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_7> <div class="md-nav__link md-nav__container"> <a href=../../integrations/ class="md-nav__link "> <span class=md-ellipsis> Integrations </span> </a> <label class="md-nav__link " for=__nav_7 id=__nav_7_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Integrations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../integrations/vcontainer/ class=md-nav__link> <span class=md-ellipsis> VContainer </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/zenject/ class=md-nav__link> <span class=md-ellipsis> Zenject </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/reflex/ class=md-nav__link> <span class=md-ellipsis> Reflex </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Examples </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Examples </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../examples/end-to-end/ class=md-nav__link> <span class=md-ellipsis> End-to-End </span> </a> </li> <li class=md-nav__item> <a href=../../examples/end-to-end-scene-transitions/ class=md-nav__link> <span class=md-ellipsis> Scene Transitions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/reference/ class=md-nav__link> <span class=md-ellipsis> API Reference (Practical) </span> </a> </li> <li class=md-nav__item> <a href=../../reference/quick-reference/ class=md-nav__link> <span class=md-ellipsis> Quick Reference </span> </a> </li> <li class=md-nav__item> <a href=../../reference/helpers/ class=md-nav__link> <span class=md-ellipsis> Helpers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/faq/ class=md-nav__link> <span class=md-ellipsis> FAQ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/glossary/ class=md-nav__link> <span class=md-ellipsis> Glossary </span> </a> </li> <li class=md-nav__item> <a href=../../reference/troubleshooting/ class=md-nav__link> <span class=md-ellipsis> Troubleshooting </span> </a> </li> <li class=md-nav__item> <a href=../../reference/compatibility/ class=md-nav__link> <span class=md-ellipsis> Compatibility </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#what-youll-find class=md-nav__link> <span class=md-ellipsis> What you'll find </span> </a> <nav class=md-nav aria-label="What you'll find"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#reading-guide class=md-nav__link> <span class=md-ellipsis> Reading guide </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#quick-links-i-want-to class=md-nav__link> <span class=md-ellipsis> Quick Links: "I Want To..." </span> </a> <nav class=md-nav aria-label='Quick Links: "I Want To..."'> <ul class=md-nav__list> <li class=md-nav__item> <a href=#find-your-use-case-jump-to-the-pattern class=md-nav__link> <span class=md-ellipsis> Find your use case, jump to the pattern </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#table-of-contents class=md-nav__link> <span class=md-ellipsis> Table of Contents </span> </a> <nav class=md-nav aria-label="Table of Contents"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#basic-patterns class=md-nav__link> <span class=md-ellipsis> Basic Patterns </span> </a> </li> <li class=md-nav__item> <a href=#advanced-patterns class=md-nav__link> <span class=md-ellipsis> Advanced Patterns </span> </a> </li> <li class=md-nav__item> <a href=#real-world-scale-patterns class=md-nav__link> <span class=md-ellipsis> Real-World Scale Patterns </span> </a> </li> <li class=md-nav__item> <a href=#important-inheritance-with-messageawarecomponent class=md-nav__link> <span class=md-ellipsis> Important: Inheritance with MessageAwareComponent </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#1-scene-wide-events-untargeted class=md-nav__link> <span class=md-ellipsis> 1) Scene-wide Events (Untargeted) </span> </a> </li> <li class=md-nav__item> <a href=#2-directed-commands-targeted class=md-nav__link> <span class=md-ellipsis> 2) Directed Commands (Targeted) </span> </a> </li> <li class=md-nav__item> <a href=#3-observability-broadcast class=md-nav__link> <span class=md-ellipsis> 3) Observability (Broadcast) </span> </a> </li> <li class=md-nav__item> <a href=#4-validation-and-normalization-interceptors class=md-nav__link> <span class=md-ellipsis> 4) Validation and Normalization (Interceptors) </span> </a> </li> <li class=md-nav__item> <a href=#5-analyticslogging-post-processors class=md-nav__link> <span class=md-ellipsis> 5) Analytics/Logging (Post-Processors) </span> </a> </li> <li class=md-nav__item> <a href=#6-local-bus-islands class=md-nav__link> <span class=md-ellipsis> 6) Local Bus Islands </span> </a> </li> <li class=md-nav__item> <a href=#7-lifecycle-pattern-in-unity class=md-nav__link> <span class=md-ellipsis> 7) Lifecycle Pattern in Unity </span> </a> </li> <li class=md-nav__item> <a href=#8-cross-scene-messaging class=md-nav__link> <span class=md-ellipsis> 8) Cross-Scene Messaging </span> </a> </li> <li class=md-nav__item> <a href=#9-bridging-legacy-unity-messaging class=md-nav__link> <span class=md-ellipsis> 9) Bridging Legacy Unity Messaging </span> </a> </li> <li class=md-nav__item> <a href=#10-global-accept-all-handlers class=md-nav__link> <span class=md-ellipsis> 10) Global Accept-All Handlers </span> </a> </li> <li class=md-nav__item> <a href=#11-diagnostics-and-tuning class=md-nav__link> <span class=md-ellipsis> 11) Diagnostics and Tuning </span> </a> </li> <li class=md-nav__item> <a href=#12-testing class=md-nav__link> <span class=md-ellipsis> 12) Testing </span> </a> </li> <li class=md-nav__item> <a href=#13-real-world-scale-beyond-toy-examples class=md-nav__link> <span class=md-ellipsis> 13) Real-World Scale: Beyond Toy Examples </span> </a> <nav class=md-nav aria-label="13) Real-World Scale: Beyond Toy Examples"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#pattern-managing-100-combat-entities class=md-nav__link> <span class=md-ellipsis> Pattern: Managing 100+ Combat Entities </span> </a> <nav class=md-nav aria-label="Pattern: Managing 100+ Combat Entities"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#scale-characteristics class=md-nav__link> <span class=md-ellipsis> Scale characteristics </span> </a> <nav class=md-nav aria-label="Scale characteristics"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#performance-notes class=md-nav__link> <span class=md-ellipsis> Performance notes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-cross-scene-persistent-systems class=md-nav__link> <span class=md-ellipsis> Pattern: Cross-Scene Persistent Systems </span> </a> </li> <li class=md-nav__item> <a href=#pattern-large-scale-ui-system-20-panels class=md-nav__link> <span class=md-ellipsis> Pattern: Large-Scale UI System (20+ Panels) </span> </a> <nav class=md-nav aria-label="Pattern: Large-Scale UI System (20+ Panels)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits-at-scale class=md-nav__link> <span class=md-ellipsis> Benefits at scale </span> </a> <nav class=md-nav aria-label="Benefits at scale"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#anti-pattern-to-avoid class=md-nav__link> <span class=md-ellipsis> Anti-pattern to avoid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-priority-ordered-execution-for-complex-systems class=md-nav__link> <span class=md-ellipsis> Pattern: Priority-Ordered Execution for Complex Systems </span> </a> <nav class=md-nav aria-label="Pattern: Priority-Ordered Execution for Complex Systems"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#recommended-priority-ranges class=md-nav__link> <span class=md-ellipsis> Recommended priority ranges </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-efficient-interception-at-scale class=md-nav__link> <span class=md-ellipsis> Pattern: Efficient Interception at Scale </span> </a> </li> <li class=md-nav__item> <a href=#pattern-post-processing-for-analytics-at-scale class=md-nav__link> <span class=md-ellipsis> Pattern: Post-Processing for Analytics at Scale </span> </a> </li> <li class=md-nav__item> <a href=#performance-optimization-patterns-at-scale class=md-nav__link> <span class=md-ellipsis> Performance Optimization Patterns at Scale </span> </a> <nav class=md-nav aria-label="Performance Optimization Patterns at Scale"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#optimization-1-disable-diagnostics-in-builds class=md-nav__link> <span class=md-ellipsis> Optimization 1: Disable Diagnostics in Builds </span> </a> </li> <li class=md-nav__item> <a href=#optimization-2-use-specific-registrations-over-globalacceptall class=md-nav__link> <span class=md-ellipsis> Optimization 2: Use Specific Registrations Over GlobalAcceptAll </span> </a> </li> <li class=md-nav__item> <a href=#optimization-3-batch-message-emissions class=md-nav__link> <span class=md-ellipsis> Optimization 3: Batch Message Emissions </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#scaling-guidelines class=md-nav__link> <span class=md-ellipsis> Scaling Guidelines </span> </a> </li> <li class=md-nav__item> <a href=#real-world-production-example-battle-royale-game class=md-nav__link> <span class=md-ellipsis> Real-World Production Example: Battle Royale Game </span> </a> <nav class=md-nav aria-label="Real-World Production Example: Battle Royale Game"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-insights class=md-nav__link> <span class=md-ellipsis> Key insights </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#14-compatibility-with-scriptable-object-architecture-soa class=md-nav__link> <span class=md-ellipsis> 14) Compatibility with Scriptable Object Architecture (SOA) </span> </a> <nav class=md-nav aria-label="14) Compatibility with Scriptable Object Architecture (SOA)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-is-scriptable-object-architecture class=md-nav__link> <span class=md-ellipsis> What is Scriptable Object Architecture? </span> </a> <nav class=md-nav aria-label="What is Scriptable Object Architecture?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-resources class=md-nav__link> <span class=md-ellipsis> Key resources </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#why-soa-is-controversial class=md-nav__link> <span class=md-ellipsis> Why SOA is Controversial </span> </a> <nav class=md-nav aria-label="Why SOA is Controversial"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#recommended-alternatives class=md-nav__link> <span class=md-ellipsis> Recommended alternatives </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#can-dxmessaging-work-with-soa class=md-nav__link> <span class=md-ellipsis> Can DxMessaging Work with SOA? </span> </a> </li> <li class=md-nav__item> <a href=#pattern-overview class=md-nav__link> <span class=md-ellipsis> Pattern Overview </span> </a> </li> <li class=md-nav__item> <a href=#pattern-a-soa--dxmessaging-event-forwarding class=md-nav__link> <span class=md-ellipsis> Pattern A: SOA → DxMessaging (Event Forwarding) </span> </a> <nav class=md-nav aria-label="Pattern A: SOA → DxMessaging (Event Forwarding)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-scene-transitions class=md-nav__link> <span class=md-ellipsis> Example: Scene Transitions </span> </a> <nav class=md-nav aria-label="Example: Scene Transitions"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> <nav class=md-nav aria-label=Benefits> <ul class=md-nav__list> <li class=md-nav__item> <a href=#drawbacks class=md-nav__link> <span class=md-ellipsis> Drawbacks </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-b-proper-scriptableobject-usage-recommended class=md-nav__link> <span class=md-ellipsis> Pattern B: Proper ScriptableObject Usage (Recommended) </span> </a> <nav class=md-nav aria-label="Pattern B: Proper ScriptableObject Usage (Recommended)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-combat-with-designer-tunable-data class=md-nav__link> <span class=md-ellipsis> Example: Combat with Designer-Tunable Data </span> </a> <nav class=md-nav aria-label="Example: Combat with Designer-Tunable Data"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits_1 class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> <nav class=md-nav aria-label=Benefits> <ul class=md-nav__list> <li class=md-nav__item> <a href=#this-pattern-separates-concerns-clearly class=md-nav__link> <span class=md-ellipsis> This pattern separates concerns clearly </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#when-to-use-each-pattern class=md-nav__link> <span class=md-ellipsis> When to Use Each Pattern </span> </a> </li> <li class=md-nav__item> <a href=#migration-path-soa--dxmessaging class=md-nav__link> <span class=md-ellipsis> Migration Path: SOA → DxMessaging </span> </a> </li> <li class=md-nav__item> <a href=#final-recommendations class=md-nav__link> <span class=md-ellipsis> Final Recommendations </span> </a> <nav class=md-nav aria-label="Final Recommendations"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#if-youre-using-soa class=md-nav__link> <span class=md-ellipsis> If you're using SOA </span> </a> <nav class=md-nav aria-label="If you're using SOA"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#if-youre-starting-fresh class=md-nav__link> <span class=md-ellipsis> If you're starting fresh </span> </a> <nav class=md-nav aria-label="If you're starting fresh"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#resources class=md-nav__link> <span class=md-ellipsis> Resources </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#related-documentation class=md-nav__link> <span class=md-ellipsis> Related Documentation </span> </a> <nav class=md-nav aria-label="Related Documentation"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#learn-the-basics-first class=md-nav__link> <span class=md-ellipsis> Learn the Basics First? </span> </a> </li> <li class=md-nav__item> <a href=#try-real-examples class=md-nav__link> <span class=md-ellipsis> Try Real Examples </span> </a> </li> <li class=md-nav__item> <a href=#deep-dives class=md-nav__link> <span class=md-ellipsis> Deep Dives </span> </a> </li> <li class=md-nav__item> <a href=#reference class=md-nav__link> <span class=md-ellipsis> Reference </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <nav class=md-path aria-label=Navigation> <ol class=md-path__list> <li class=md-path__item> <a href=../.. class=md-path__link> <span class=md-ellipsis> Home </span> </a> </li> <li class=md-path__item> <a href=./ class=md-path__link> <span class=md-ellipsis> Guides </span> </a> </li> </ol> </nav> <article class="md-content__inner md-typeset"> <a href=https://github.com/wallstop/DxMessaging/edit/master/docs/guides/patterns.md title="Edit this page" class="md-content__button md-icon" rel=edit> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg> </a> <a href=https://github.com/wallstop/DxMessaging/raw/master/docs/guides/patterns.md title="View source of this page" class="md-content__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg> </a> <h1 id=dxmessaging-patterns-real-world-solutions>DxMessaging Patterns: Real-World Solutions<a class=headerlink href=#dxmessaging-patterns-real-world-solutions title="Anchor link to this section">&para;</a></h1> <p><a href=../../getting-started/ >← Back to Index</a> | <a href=../../getting-started/getting-started/ >Getting Started</a> | <a href=../../concepts/message-types/ >Message Types</a> | <a href=https://github.com/wallstop/DxMessaging/tree/master/Samples~>Samples</a></p> <hr> <p><strong>You're here because:</strong> You understand DxMessaging basics, now you want to see "How do I actually build X?"</p> <h2 id=what-youll-find>What you'll find<a class=headerlink href=#what-youll-find title="Anchor link to this section">&para;</a></h2> <ul> <li><strong>Basic Patterns</strong> - Fundamental building blocks (scene transitions, commands, observability)</li> <li><strong>Advanced Patterns</strong> - Power user techniques (diagnostics, testing, legacy integration)</li> <li><strong>Scale Patterns</strong> - Examples for larger systems (100+ entities, cross-scene systems, large UI)</li> </ul> <h3 id=reading-guide>Reading guide<a class=headerlink href=#reading-guide title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>New to DxMessaging?</strong> Start with Basic Patterns 1-8</li> <li><strong>Intermediate user?</strong> Jump to Advanced Patterns 9-12</li> <li><strong>Building at scale?</strong> Go straight to Real-World Scale Patterns</li> <li><strong>Specific problem?</strong> Use Ctrl+F / Cmd+F to search</li> </ul> <p><strong>Philosophy:</strong> These patterns address common challenges teams face when building messaging systems.</p> <hr> <h2 id=quick-links-i-want-to>Quick Links: "I Want To..."<a class=headerlink href=#quick-links-i-want-to title="Anchor link to this section">&para;</a></h2> <h3 id=find-your-use-case-jump-to-the-pattern>Find your use case, jump to the pattern<a class=headerlink href=#find-your-use-case-jump-to-the-pattern title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>I want to...</th> <th>Go to</th> </tr> </thead> <tbody> <tr> <td>Make UI react to gameplay</td> <td><a href=#2-directed-commands-targeted>Pattern 2: Directed Commands</a></td> </tr> <tr> <td>Coordinate scene transitions</td> <td><a href=#1-scene-wide-events-untargeted>Pattern 1: Scene-wide Events</a></td> </tr> <tr> <td>Build an achievement system</td> <td><a href=#3-observability-broadcast>Pattern 3: Observability</a> + <a href=#10-global-accept-all-handlers>Global Accept-All</a></td> </tr> <tr> <td>Validate input/damage before it happens</td> <td><a href=#4-validation-and-normalization-interceptors>Pattern 4: Interceptors</a></td> </tr> <tr> <td>Add analytics without touching gameplay</td> <td><a href=#5-analyticslogging-post-processors>Pattern 5: Post-Processors</a></td> </tr> <tr> <td>Track ALL damage from ANY entity</td> <td><a href=#pattern-managing-100-combat-entities>Pattern: Managing 100+ Entities</a></td> </tr> <tr> <td>Build a large UI system (20+ panels)</td> <td><a href=#pattern-large-scale-ui-system-20-panels>Pattern: Large-Scale UI</a></td> </tr> <tr> <td>Make systems run in a specific order</td> <td><a href=#pattern-priority-ordered-execution-for-complex-systems>Pattern: Priority Ordering</a></td> </tr> <tr> <td>Test in isolation</td> <td><a href=#6-local-bus-islands>Pattern 6: Local Bus Islands</a></td> </tr> <tr> <td>Migrate from C# events</td> <td><a href=#9-bridging-legacy-unity-messaging>Pattern 9: Bridging Legacy</a></td> </tr> <tr> <td>Handle persistent systems across scene loads</td> <td><a href=#pattern-cross-scene-persistent-systems>Pattern: Cross-Scene Persistent</a></td> </tr> <tr> <td>See what's happening (debug message flow)</td> <td><a href=#11-diagnostics-and-tuning>Pattern 11: Diagnostics</a></td> </tr> <tr> <td>Build a battle royale / large multiplayer</td> <td><a href=#real-world-production-example-battle-royale-game>Pattern: Battle Royale Example</a></td> </tr> <tr> <td>Use with Scriptable Object Architecture</td> <td><a href=#14-compatibility-with-scriptable-object-architecture-soa>Pattern 14: SOA Compatibility</a></td> </tr> </tbody> </table> <hr> <h2 id=table-of-contents>Table of Contents<a class=headerlink href=#table-of-contents title="Anchor link to this section">&para;</a></h2> <h3 id=basic-patterns>Basic Patterns<a class=headerlink href=#basic-patterns title="Anchor link to this section">&para;</a></h3> <ul> <li><a href=#1-scene-wide-events-untargeted>Scene-wide Events (Untargeted)</a></li> <li><a href=#2-directed-commands-targeted>Directed Commands (Targeted)</a></li> <li><a href=#3-observability-broadcast>Observability (Broadcast)</a></li> <li><a href=#4-validation-and-normalization-interceptors>Validation and Normalization (Interceptors)</a></li> <li><a href=#5-analyticslogging-post-processors>Analytics and Logging (Post-Processors)</a></li> <li><a href=#6-local-bus-islands>Local Bus Islands</a></li> <li><a href=#7-lifecycle-pattern-in-unity>Lifecycle Pattern in Unity</a></li> <li><a href=#8-cross-scene-messaging>Cross-Scene Messaging</a></li> </ul> <h3 id=advanced-patterns>Advanced Patterns<a class=headerlink href=#advanced-patterns title="Anchor link to this section">&para;</a></h3> <ul> <li><a href=#9-bridging-legacy-unity-messaging>Bridging Legacy Unity Messaging</a></li> <li><a href=#10-global-accept-all-handlers>Global Accept-All Handlers</a></li> <li><a href=#11-diagnostics-and-tuning>Diagnostics and Tuning</a></li> <li><a href=#12-testing>Testing</a></li> <li><a href=#14-compatibility-with-scriptable-object-architecture-soa>Compatibility with Scriptable Object Architecture (SOA)</a></li> </ul> <h3 id=real-world-scale-patterns>Real-World Scale Patterns<a class=headerlink href=#real-world-scale-patterns title="Anchor link to this section">&para;</a></h3> <ul> <li><a href=#pattern-managing-100-combat-entities>Managing 100+ Combat Entities</a></li> <li><a href=#pattern-cross-scene-persistent-systems>Cross-Scene Persistent Systems</a></li> <li><a href=#pattern-large-scale-ui-system-20-panels>Large-Scale UI System (20+ Panels)</a></li> <li><a href=#pattern-priority-ordered-execution-for-complex-systems>Priority-Ordered Execution</a></li> <li><a href=#pattern-efficient-interception-at-scale>Efficient Interception at Scale</a></li> <li><a href=#pattern-post-processing-for-analytics-at-scale>Post-Processing for Analytics at Scale</a></li> <li><a href=#performance-optimization-patterns-at-scale>Performance Optimization Patterns</a></li> <li><a href=#real-world-production-example-battle-royale-game>Production Example: Battle Royale Game</a></li> </ul> <hr> <h3 id=important-inheritance-with-messageawarecomponent>Important: Inheritance with MessageAwareComponent<a class=headerlink href=#important-inheritance-with-messageawarecomponent title="Anchor link to this section">&para;</a></h3> <ul> <li>Many examples derive from <code>MessageAwareComponent</code>. <strong>When overriding hooks, you MUST call the base method.</strong></li> <li><strong>Always call <code>base.RegisterMessageHandlers()</code> FIRST</strong> in your override to preserve default string‑message registrations and parent class registrations.</li> <li><strong>CRITICAL</strong>: Call <code>base.OnEnable()</code> / <code>base.OnDisable()</code> if you override lifecycle methods; otherwise your token may never enable/disable.</li> <li><strong>CRITICAL</strong>: Call <code>base.Awake()</code> if you override <code>Awake()</code>; otherwise your token won't be created.</li> <li>To opt out of string demos, override <code>RegisterForStringMessages =&gt; false</code> instead of skipping the base call.</li> <li><strong>Don't use <code>new</code> to hide methods</strong> (e.g., <code>new void OnEnable()</code>); always use <code>override</code> and call <code>base.*</code>.</li> </ul> <p>Registration timing (pit of success)</p> <ul> <li><strong>Prefer <code>Awake()</code> for all message handler registration</strong>—this is when <code>MessageAwareComponent</code> calls <code>RegisterMessageHandlers()</code>.</li> <li>Avoid registering in <code>Start()</code> unless you have a specific order-of-execution reason.</li> <li>Early registration in <code>Awake()</code> ensures your handlers are ready before other components' <code>Start()</code> methods run.</li> </ul> <h2 id=1-scene-wide-events-untargeted>1) Scene-wide Events (Untargeted)<a class=headerlink href=#1-scene-wide-events-untargeted title="Anchor link to this section">&para;</a></h2> <p>Use untargeted messages for global state changes that any system might care about. Keep messages small and immutable.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-0-1><a id=__codelineno-0-1 name=__codelineno-0-1 href=#__codelineno-0-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Messages</span><span class=p>;</span>
2
2
  </span><span id=__span-0-2><a id=__codelineno-0-2 name=__codelineno-0-2 href=#__codelineno-0-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Attributes</span><span class=p>;</span>
3
3
  </span><span id=__span-0-3><a id=__codelineno-0-3 name=__codelineno-0-3 href=#__codelineno-0-3></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Extensions</span><span class=p>;</span>
4
4
  </span><span id=__span-0-4><a id=__codelineno-0-4 name=__codelineno-0-4 href=#__codelineno-0-4></a>
@@ -542,4 +542,4 @@
542
542
  </span><span id=__span-22-50><a id=__codelineno-22-50 name=__codelineno-22-50 href=#__codelineno-22-50></a><span class=w> </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;{source} dealt {msg.amount} damage (crit: {msg.wasCrit})&quot;</span><span class=p>);</span>
543
543
  </span><span id=__span-22-51><a id=__codelineno-22-51 name=__codelineno-22-51 href=#__codelineno-22-51></a><span class=w> </span><span class=p>}</span>
544
544
  </span><span id=__span-22-52><a id=__codelineno-22-52 name=__codelineno-22-52 href=#__codelineno-22-52></a><span class=p>}</span>
545
- </span></code></pre></div> <h5 id=benefits_1>Benefits<a class=headerlink href=#benefits_1 title="Anchor link to this section">&para;</a></h5> <ul> <li>✅ <strong>Best of both worlds</strong> - ScriptableObjects for static configs, DxMessaging for runtime events</li> <li>✅ No bridging overhead</li> <li>✅ Uses each system correctly: SOs for their intended purpose (immutable design data), messaging for runtime communication</li> <li>✅ This is NOT SOA - it's proper Unity architecture</li> </ul> <h6 id=this-pattern-separates-concerns-clearly>This pattern separates concerns clearly<a class=headerlink href=#this-pattern-separates-concerns-clearly title="Anchor link to this section">&para;</a></h6> <h3 id=when-to-use-each-pattern>When to Use Each Pattern<a class=headerlink href=#when-to-use-each-pattern title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Pattern</th> <th>Use When</th> <th>Complexity</th> <th>Performance</th> </tr> </thead> <tbody> <tr> <td><strong>A: SOA → DxMessaging</strong></td> <td>Designers create SOA events, modern code uses messaging</td> <td>Medium</td> <td>⚠️ Medium</td> </tr> <tr> <td><strong>B: Proper SO Usage</strong></td> <td>Immutable configs only, messaging for events</td> <td>Low</td> <td>✅ Good</td> </tr> <tr> <td><strong>None (Pure DxMessaging)</strong></td> <td>Greenfield project or full SOA migration</td> <td>Lowest</td> <td>✅ Best</td> </tr> </tbody> </table> <h3 id=migration-path-soa--dxmessaging>Migration Path: SOA → DxMessaging<a class=headerlink href=#migration-path-soa--dxmessaging title="Anchor link to this section">&para;</a></h3> <p>If you're moving away from SOA:</p> <ol> <li><strong>Phase 1:</strong> Identify SOA event usage (GameEvent/GameEventListener patterns)</li> <li><strong>Phase 2:</strong> Create equivalent DxMessaging messages (Untargeted/Broadcast)</li> <li><strong>Phase 3:</strong> Add bridges (Pattern A or B) to maintain compatibility</li> <li><strong>Phase 4:</strong> Migrate listeners to DxMessaging incrementally</li> <li><strong>Phase 5:</strong> Remove bridges and SOA assets once all references gone</li> </ol> <p>For SOA variables:</p> <ol> <li>Convert read-only SO configs → Keep as-is (correct SO usage) or move to JSON/ScriptableObjects for data</li> <li>Convert mutable SO variables → DxMessaging messages or DI-injected services</li> <li>Convert RuntimeSets → DxMessaging global observers (<code>RegisterBroadcastWithoutSource</code>)</li> </ol> <h3 id=final-recommendations>Final Recommendations<a class=headerlink href=#final-recommendations title="Anchor link to this section">&para;</a></h3> <h4 id=if-youre-using-soa>If you're using SOA<a class=headerlink href=#if-youre-using-soa title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Do:</strong> Use Pattern B (Proper SO Usage) - SOs for immutable configs ONLY, DxMessaging for runtime events</li> <li>✅ <strong>Do:</strong> Use Pattern A to bridge existing SOA GameEvent assets to DxMessaging during migration</li> <li>✅ <strong>Do:</strong> Read <a href=https://github.com/cathei/AntiScriptableObjectArchitecture>Anti-ScriptableObject Architecture</a> to understand risks</li> <li>✅ <strong>Do:</strong> Consider gradual migration to DxMessaging or DI frameworks</li> <li>❌ <strong>Don't:</strong> Use SOs for mutable runtime state (health, scores, etc.)</li> <li>❌ <strong>Don't:</strong> Create new SOA event assets—use DxMessaging messages instead</li> </ul> <h5 id=if-youre-starting-fresh>If you're starting fresh<a class=headerlink href=#if-youre-starting-fresh title="Anchor link to this section">&para;</a></h5> <ul> <li>✅ <strong>Do:</strong> Use DxMessaging for all messaging/events</li> <li>✅ <strong>Do:</strong> Use ScriptableObjects ONLY for immutable design data (weapon stats, level configs)</li> <li>✅ <strong>Do:</strong> Consider DI frameworks (Zenject/VContainer) for service dependencies</li> <li>❌ <strong>Don't:</strong> Adopt SOA's GameEvent/Variable patterns—they're superseded by better tools</li> </ul> <h6 id=resources>Resources<a class=headerlink href=#resources title="Anchor link to this section">&para;</a></h6> <ul> <li><a href=https://github.com/cathei/AntiScriptableObjectArchitecture>Anti-ScriptableObject Architecture</a> - Detailed critique</li> <li><a href="https://www.youtube.com/watch?v=raQ3iHhE_Kk">Ryan Hipple Unite 2017 Talk</a> - Original SOA presentation</li> <li><a href=https://unity.com/how-to/architect-game-code-scriptable-objects>Unity Official Guide</a> - Unity's perspective</li> <li><a href=../../integrations/ >DxMessaging DI Integrations</a> - Better alternatives for dependency management</li> <li><a href=https://github.com/modesttree/Zenject>Zenject</a> - Recommended DI framework</li> <li><a href=https://github.com/hadashiA/VContainer>VContainer</a> - Lightweight DI alternative</li> </ul> <hr> <h2 id=related-documentation>Related Documentation<a class=headerlink href=#related-documentation title="Anchor link to this section">&para;</a></h2> <h3 id=learn-the-basics-first>Learn the Basics First?<a class=headerlink href=#learn-the-basics-first title="Anchor link to this section">&para;</a></h3> <ul> <li>→ <a href=../../getting-started/getting-started/ >Getting Started</a> (10 min) — Complete introduction</li> <li>→ <a href=../../concepts/message-types/ >Message Types</a> (10 min) — When to use what</li> <li>→ <a href=../../getting-started/visual-guide/ >Visual Guide</a> (5 min) — Beginner-friendly pictures</li> </ul> <h3 id=try-real-examples>Try Real Examples<a class=headerlink href=#try-real-examples title="Anchor link to this section">&para;</a></h3> <ul> <li>→ <a href=https://github.com/wallstop/DxMessaging/blob/master/Samples~/Mini%20Combat/README.md>Mini Combat sample</a> — Working combat example</li> <li>→ <a href=https://github.com/wallstop/DxMessaging/blob/master/Samples~/UI%20Buttons%20%2B%20Inspector/README.md>UI Buttons + Inspector sample</a> — Interactive diagnostics</li> <li>→ <a href=../../examples/end-to-end/ >End-to-End Example</a> — Complete feature walkthrough</li> </ul> <h3 id=deep-dives>Deep Dives<a class=headerlink href=#deep-dives title="Anchor link to this section">&para;</a></h3> <ul> <li>→ <a href=../../concepts/interceptors-and-ordering/ >Interceptors &amp; Ordering</a> — Control execution flow</li> <li>→ <a href=../../architecture/design-and-architecture/ >Design &amp; Architecture</a> — Internals and optimizations</li> <li>→ <a href=../../architecture/performance/ >Performance</a> — Benchmarks and tuning</li> </ul> <h3 id=reference>Reference<a class=headerlink href=#reference title="Anchor link to this section">&para;</a></h3> <ul> <li>→ <a href=../../reference/quick-reference/ >Quick Reference</a> — Cheat sheet</li> <li>→ <a href=../../reference/reference/ >API Reference</a> — Complete API</li> </ul> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 26, 2026 18:15:02 UTC"><span class=timeago datetime=2026-01-26T18:15:02+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 26, 2026 18:15:02 UTC">2026-01-26</span> </span> <span class=md-source-file__fact> <span class=md-icon title=Created> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M14.47 15.08 11 13V7h1.5v5.25l3.08 1.83c-.41.28-.79.62-1.11 1m-1.39 4.84c-.36.05-.71.08-1.08.08-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8c0 .37-.03.72-.08 1.08.69.1 1.33.32 1.92.64.1-.56.16-1.13.16-1.72 0-5.5-4.5-10-10-10S2 6.5 2 12s4.47 10 10 10c.59 0 1.16-.06 1.72-.16-.32-.59-.54-1.23-.64-1.92M18 15v3h-3v2h3v3h2v-3h3v-2h-3v-3z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 26, 2026 18:15:02 UTC"><span class=timeago datetime=2026-01-26T18:15:02+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 26, 2026 18:15:02 UTC">2026-01-26</span> </span> </aside> </article> </div> <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg> Back to top </button> </main> <footer class=md-footer> <nav class="md-footer__inner md-grid" aria-label=Footer> <a href=../../concepts/interceptors-and-ordering/ class="md-footer__link md-footer__link--prev" aria-label="Previous: Interceptors & Ordering"> <div class="md-footer__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </div> <div class=md-footer__title> <span class=md-footer__direction> Previous </span> <div class=md-ellipsis> Interceptors & Ordering </div> </div> </a> <a href=../unity-integration/ class="md-footer__link md-footer__link--next" aria-label="Next: Unity Integration"> <div class=md-footer__title> <span class=md-footer__direction> Next </span> <div class=md-ellipsis> Unity Integration </div> </div> <div class="md-footer__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg> </div> </a> </nav> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> <div class=md-copyright__highlight> Copyright &copy; 2017-2026 Wallstop Studios </div> </div> <div class=md-social> <a href=https://github.com/wallstop target=_blank rel=noopener title="Wallstop Studios on GitHub" class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-progress data-md-component=progress role=progressbar></div> <script id=__config type=application/json>{"annotate": null, "base": "../..", "features": ["announce.dismiss", "content.action.edit", "content.action.view", "content.code.annotate", "content.code.copy", "content.tabs.link", "navigation.expand", "navigation.footer", "navigation.indexes", "navigation.instant", "navigation.instant.prefetch", "navigation.instant.progress", "navigation.path", "navigation.sections", "navigation.tabs", "navigation.tabs.sticky", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script> <script src=../../assets/javascripts/bundle.79ae519e.min.js></script> <script src=../../js/timeago.min.js></script> <script src=../../js/timeago_mkdocs_material.js></script> <script src=https://unpkg.com/mermaid@11/dist/mermaid.min.js></script> <script src=../../javascripts/mermaid-config.js></script> <script src=../../javascripts/csharp-highlight.js></script> </body> </html>
545
+ </span></code></pre></div> <h5 id=benefits_1>Benefits<a class=headerlink href=#benefits_1 title="Anchor link to this section">&para;</a></h5> <ul> <li>✅ <strong>Best of both worlds</strong> - ScriptableObjects for static configs, DxMessaging for runtime events</li> <li>✅ No bridging overhead</li> <li>✅ Uses each system correctly: SOs for their intended purpose (immutable design data), messaging for runtime communication</li> <li>✅ This is NOT SOA - it's proper Unity architecture</li> </ul> <h6 id=this-pattern-separates-concerns-clearly>This pattern separates concerns clearly<a class=headerlink href=#this-pattern-separates-concerns-clearly title="Anchor link to this section">&para;</a></h6> <h3 id=when-to-use-each-pattern>When to Use Each Pattern<a class=headerlink href=#when-to-use-each-pattern title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Pattern</th> <th>Use When</th> <th>Complexity</th> <th>Performance</th> </tr> </thead> <tbody> <tr> <td><strong>A: SOA → DxMessaging</strong></td> <td>Designers create SOA events, modern code uses messaging</td> <td>Medium</td> <td>⚠️ Medium</td> </tr> <tr> <td><strong>B: Proper SO Usage</strong></td> <td>Immutable configs only, messaging for events</td> <td>Low</td> <td>✅ Good</td> </tr> <tr> <td><strong>None (Pure DxMessaging)</strong></td> <td>Greenfield project or full SOA migration</td> <td>Lowest</td> <td>✅ Best</td> </tr> </tbody> </table> <h3 id=migration-path-soa--dxmessaging>Migration Path: SOA → DxMessaging<a class=headerlink href=#migration-path-soa--dxmessaging title="Anchor link to this section">&para;</a></h3> <p>If you're moving away from SOA:</p> <ol> <li><strong>Phase 1:</strong> Identify SOA event usage (GameEvent/GameEventListener patterns)</li> <li><strong>Phase 2:</strong> Create equivalent DxMessaging messages (Untargeted/Broadcast)</li> <li><strong>Phase 3:</strong> Add bridges (Pattern A or B) to maintain compatibility</li> <li><strong>Phase 4:</strong> Migrate listeners to DxMessaging incrementally</li> <li><strong>Phase 5:</strong> Remove bridges and SOA assets once all references gone</li> </ol> <p>For SOA variables:</p> <ol> <li>Convert read-only SO configs → Keep as-is (correct SO usage) or move to JSON/ScriptableObjects for data</li> <li>Convert mutable SO variables → DxMessaging messages or DI-injected services</li> <li>Convert RuntimeSets → DxMessaging global observers (<code>RegisterBroadcastWithoutSource</code>)</li> </ol> <h3 id=final-recommendations>Final Recommendations<a class=headerlink href=#final-recommendations title="Anchor link to this section">&para;</a></h3> <h4 id=if-youre-using-soa>If you're using SOA<a class=headerlink href=#if-youre-using-soa title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Do:</strong> Use Pattern B (Proper SO Usage) - SOs for immutable configs ONLY, DxMessaging for runtime events</li> <li>✅ <strong>Do:</strong> Use Pattern A to bridge existing SOA GameEvent assets to DxMessaging during migration</li> <li>✅ <strong>Do:</strong> Read <a href=https://github.com/cathei/AntiScriptableObjectArchitecture>Anti-ScriptableObject Architecture</a> to understand risks</li> <li>✅ <strong>Do:</strong> Consider gradual migration to DxMessaging or DI frameworks</li> <li>❌ <strong>Don't:</strong> Use SOs for mutable runtime state (health, scores, etc.)</li> <li>❌ <strong>Don't:</strong> Create new SOA event assets—use DxMessaging messages instead</li> </ul> <h5 id=if-youre-starting-fresh>If you're starting fresh<a class=headerlink href=#if-youre-starting-fresh title="Anchor link to this section">&para;</a></h5> <ul> <li>✅ <strong>Do:</strong> Use DxMessaging for all messaging/events</li> <li>✅ <strong>Do:</strong> Use ScriptableObjects ONLY for immutable design data (weapon stats, level configs)</li> <li>✅ <strong>Do:</strong> Consider DI frameworks (Zenject/VContainer) for service dependencies</li> <li>❌ <strong>Don't:</strong> Adopt SOA's GameEvent/Variable patterns—they're superseded by better tools</li> </ul> <h6 id=resources>Resources<a class=headerlink href=#resources title="Anchor link to this section">&para;</a></h6> <ul> <li><a href=https://github.com/cathei/AntiScriptableObjectArchitecture>Anti-ScriptableObject Architecture</a> - Detailed critique</li> <li><a href="https://www.youtube.com/watch?v=raQ3iHhE_Kk">Ryan Hipple Unite 2017 Talk</a> - Original SOA presentation</li> <li><a href=https://unity.com/how-to/architect-game-code-scriptable-objects>Unity Official Guide</a> - Unity's perspective</li> <li><a href=../../integrations/ >DxMessaging DI Integrations</a> - Better alternatives for dependency management</li> <li><a href=https://github.com/modesttree/Zenject>Zenject</a> - Recommended DI framework</li> <li><a href=https://github.com/hadashiA/VContainer>VContainer</a> - Lightweight DI alternative</li> </ul> <hr> <h2 id=related-documentation>Related Documentation<a class=headerlink href=#related-documentation title="Anchor link to this section">&para;</a></h2> <h3 id=learn-the-basics-first>Learn the Basics First?<a class=headerlink href=#learn-the-basics-first title="Anchor link to this section">&para;</a></h3> <ul> <li>→ <a href=../../getting-started/getting-started/ >Getting Started</a> (10 min) — Complete introduction</li> <li>→ <a href=../../concepts/message-types/ >Message Types</a> (10 min) — When to use what</li> <li>→ <a href=../../getting-started/visual-guide/ >Visual Guide</a> (5 min) — Beginner-friendly pictures</li> </ul> <h3 id=try-real-examples>Try Real Examples<a class=headerlink href=#try-real-examples title="Anchor link to this section">&para;</a></h3> <ul> <li>→ <a href=https://github.com/wallstop/DxMessaging/blob/master/Samples~/Mini%20Combat/README.md>Mini Combat sample</a> — Working combat example</li> <li>→ <a href=https://github.com/wallstop/DxMessaging/blob/master/Samples~/UI%20Buttons%20%2B%20Inspector/README.md>UI Buttons + Inspector sample</a> — Interactive diagnostics</li> <li>→ <a href=../../examples/end-to-end/ >End-to-End Example</a> — Complete feature walkthrough</li> </ul> <h3 id=deep-dives>Deep Dives<a class=headerlink href=#deep-dives title="Anchor link to this section">&para;</a></h3> <ul> <li>→ <a href=../../concepts/interceptors-and-ordering/ >Interceptors &amp; Ordering</a> — Control execution flow</li> <li>→ <a href=../../architecture/design-and-architecture/ >Design &amp; Architecture</a> — Internals and optimizations</li> <li>→ <a href=../../architecture/performance/ >Performance</a> — Benchmarks and tuning</li> </ul> <h3 id=reference>Reference<a class=headerlink href=#reference title="Anchor link to this section">&para;</a></h3> <ul> <li>→ <a href=../../reference/quick-reference/ >Quick Reference</a> — Cheat sheet</li> <li>→ <a href=../../reference/reference/ >API Reference</a> — Complete API</li> </ul> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 27, 2026 04:59:07 UTC"><span class=timeago datetime=2026-01-27T04:59:07+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 27, 2026 04:59:07 UTC">2026-01-27</span> </span> <span class=md-source-file__fact> <span class=md-icon title=Created> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M14.47 15.08 11 13V7h1.5v5.25l3.08 1.83c-.41.28-.79.62-1.11 1m-1.39 4.84c-.36.05-.71.08-1.08.08-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8c0 .37-.03.72-.08 1.08.69.1 1.33.32 1.92.64.1-.56.16-1.13.16-1.72 0-5.5-4.5-10-10-10S2 6.5 2 12s4.47 10 10 10c.59 0 1.16-.06 1.72-.16-.32-.59-.54-1.23-.64-1.92M18 15v3h-3v2h3v3h2v-3h3v-2h-3v-3z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 27, 2026 04:59:07 UTC"><span class=timeago datetime=2026-01-27T04:59:07+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 27, 2026 04:59:07 UTC">2026-01-27</span> </span> </aside> </article> </div> <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg> Back to top </button> </main> <footer class=md-footer> <nav class="md-footer__inner md-grid" aria-label=Footer> <a href=../../concepts/interceptors-and-ordering/ class="md-footer__link md-footer__link--prev" aria-label="Previous: Interceptors & Ordering"> <div class="md-footer__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </div> <div class=md-footer__title> <span class=md-footer__direction> Previous </span> <div class=md-ellipsis> Interceptors & Ordering </div> </div> </a> <a href=../unity-integration/ class="md-footer__link md-footer__link--next" aria-label="Next: Unity Integration"> <div class=md-footer__title> <span class=md-footer__direction> Next </span> <div class=md-ellipsis> Unity Integration </div> </div> <div class="md-footer__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg> </div> </a> </nav> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> <div class=md-copyright__highlight> Copyright &copy; 2017-2026 Wallstop Studios </div> </div> <div class=md-social> <a href=https://github.com/wallstop target=_blank rel=noopener title="Wallstop Studios on GitHub" class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-progress data-md-component=progress role=progressbar></div> <script id=__config type=application/json>{"annotate": null, "base": "../..", "features": ["announce.dismiss", "content.action.edit", "content.action.view", "content.code.annotate", "content.code.copy", "content.tabs.link", "navigation.expand", "navigation.footer", "navigation.indexes", "navigation.instant", "navigation.instant.prefetch", "navigation.instant.progress", "navigation.path", "navigation.sections", "navigation.tabs", "navigation.tabs.sticky", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script> <script src=../../assets/javascripts/bundle.79ae519e.min.js></script> <script src=../../js/timeago.min.js></script> <script src=../../js/timeago_mkdocs_material.js></script> <script src=https://unpkg.com/mermaid@11/dist/mermaid.min.js></script> <script src=../../javascripts/mermaid-config.js></script> <script src=../../javascripts/csharp-highlight.js></script> </body> </html>