npm - com.wallstop-studios.dxmessaging - Versions diffs - 2.1.7 → 2.1.9 - Mend

com.wallstop-studios.dxmessaging 2.1.7 → 2.1.9

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 (1408) hide show

package/site/guides/patterns/index.html DELETED Viewed

@@ -1,545 +0,0 @@
-<!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>
-</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>
-</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>
-</span><span id=__span-0-4><a id=__codelineno-0-4 name=__codelineno-0-4 href=#__codelineno-0-4></a>
-</span><span id=__span-0-5><a id=__codelineno-0-5 name=__codelineno-0-5 href=#__codelineno-0-5></a><span class=na>[DxUntargetedMessage]</span>
-</span><span id=__span-0-6><a id=__codelineno-0-6 name=__codelineno-0-6 href=#__codelineno-0-6></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-0-7><a id=__codelineno-0-7 name=__codelineno-0-7 href=#__codelineno-0-7></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>SceneLoaded</span>
-</span><span id=__span-0-8><a id=__codelineno-0-8 name=__codelineno-0-8 href=#__codelineno-0-8></a><span class=p>{</span>
-</span><span id=__span-0-9><a id=__codelineno-0-9 name=__codelineno-0-9 href=#__codelineno-0-9></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>buildIndex</span><span class=p>;</span>
-</span><span id=__span-0-10><a id=__codelineno-0-10 name=__codelineno-0-10 href=#__codelineno-0-10></a><span class=p>}</span>
-</span><span id=__span-0-11><a id=__codelineno-0-11 name=__codelineno-0-11 href=#__codelineno-0-11></a>
-</span><span id=__span-0-12><a id=__codelineno-0-12 name=__codelineno-0-12 href=#__codelineno-0-12></a><span class=c1>// Sender</span>
-</span><span id=__span-0-13><a id=__codelineno-0-13 name=__codelineno-0-13 href=#__codelineno-0-13></a><span class=kt>var</span><span class=w> </span><span class=n>evt</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SceneLoaded</span><span class=p>(</span><span class=n>UnityEngine</span><span class=p>.</span><span class=n>SceneManagement</span><span class=p>.</span><span class=n>SceneManager</span><span class=p>.</span><span class=n>GetActiveScene</span><span class=p>().</span><span class=n>buildIndex</span><span class=p>);</span>
-</span><span id=__span-0-14><a id=__codelineno-0-14 name=__codelineno-0-14 href=#__codelineno-0-14></a><span class=n>evt</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span>
-</span><span id=__span-0-15><a id=__codelineno-0-15 name=__codelineno-0-15 href=#__codelineno-0-15></a>
-</span><span id=__span-0-16><a id=__codelineno-0-16 name=__codelineno-0-16 href=#__codelineno-0-16></a><span class=c1>// Listener</span>
-</span><span id=__span-0-17><a id=__codelineno-0-17 name=__codelineno-0-17 href=#__codelineno-0-17></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>SceneLoaded</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnSceneLoaded</span><span class=p>);</span>
-</span><span id=__span-0-18><a id=__codelineno-0-18 name=__codelineno-0-18 href=#__codelineno-0-18></a><span class=k>void</span><span class=w> </span><span class=nf>OnSceneLoaded</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>SceneLoaded</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>RefreshUI</span><span class=p>();</span>
-</span></code></pre></div> <h2 id=2-directed-commands-targeted>2) Directed Commands (Targeted)<a class=headerlink href=#2-directed-commands-targeted title="Anchor link to this section">&para;</a></h2> <p>Target a specific <code>GameObject</code>/<code>Component</code> when you want direct control.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-1-1><a id=__codelineno-1-1 name=__codelineno-1-1 href=#__codelineno-1-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Messages</span><span class=p>;</span>
-</span><span id=__span-1-2><a id=__codelineno-1-2 name=__codelineno-1-2 href=#__codelineno-1-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Attributes</span><span class=p>;</span>
-</span><span id=__span-1-3><a id=__codelineno-1-3 name=__codelineno-1-3 href=#__codelineno-1-3></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Extensions</span><span class=p>;</span>
-</span><span id=__span-1-4><a id=__codelineno-1-4 name=__codelineno-1-4 href=#__codelineno-1-4></a>
-</span><span id=__span-1-5><a id=__codelineno-1-5 name=__codelineno-1-5 href=#__codelineno-1-5></a><span class=na>[DxTargetedMessage]</span>
-</span><span id=__span-1-6><a id=__codelineno-1-6 name=__codelineno-1-6 href=#__codelineno-1-6></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-1-7><a id=__codelineno-1-7 name=__codelineno-1-7 href=#__codelineno-1-7></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Heal</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-1-8><a id=__codelineno-1-8 name=__codelineno-1-8 href=#__codelineno-1-8></a>
-</span><span id=__span-1-9><a id=__codelineno-1-9 name=__codelineno-1-9 href=#__codelineno-1-9></a><span class=c1>// Sender</span>
-</span><span id=__span-1-10><a id=__codelineno-1-10 name=__codelineno-1-10 href=#__codelineno-1-10></a><span class=kt>var</span><span class=w> </span><span class=n>heal</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>Heal</span><span class=p>(</span><span class=mi>10</span><span class=p>);</span>
-</span><span id=__span-1-11><a id=__codelineno-1-11 name=__codelineno-1-11 href=#__codelineno-1-11></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitComponentTargeted</span><span class=p>(</span><span class=k>this</span><span class=p>);</span>
-</span><span id=__span-1-12><a id=__codelineno-1-12 name=__codelineno-1-12 href=#__codelineno-1-12></a>
-</span><span id=__span-1-13><a id=__codelineno-1-13 name=__codelineno-1-13 href=#__codelineno-1-13></a><span class=c1>// Listener (on the hero)</span>
-</span><span id=__span-1-14><a id=__codelineno-1-14 name=__codelineno-1-14 href=#__codelineno-1-14></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>token</span><span class=p>.</span><span class=n>RegisterComponentTargeted</span><span class=o>&lt;</span><span class=n>Heal</span><span class=o>&gt;</span><span class=p>(</span><span class=k>this</span><span class=p>,</span><span class=w> </span><span class=n>OnHeal</span><span class=p>);</span>
-</span><span id=__span-1-15><a id=__codelineno-1-15 name=__codelineno-1-15 href=#__codelineno-1-15></a><span class=k>void</span><span class=w> </span><span class=nf>OnHeal</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>Heal</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>ApplyHeal</span><span class=p>(</span><span class=n>m</span><span class=p>.</span><span class=n>amount</span><span class=p>);</span>
-</span></code></pre></div> <h2 id=3-observability-broadcast>3) Observability (Broadcast)<a class=headerlink href=#3-observability-broadcast title="Anchor link to this section">&para;</a></h2> <p>Broadcast from a source; any listener can observe.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-2-1><a id=__codelineno-2-1 name=__codelineno-2-1 href=#__codelineno-2-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Messages</span><span class=p>;</span>
-</span><span id=__span-2-2><a id=__codelineno-2-2 name=__codelineno-2-2 href=#__codelineno-2-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Attributes</span><span class=p>;</span>
-</span><span id=__span-2-3><a id=__codelineno-2-3 name=__codelineno-2-3 href=#__codelineno-2-3></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Extensions</span><span class=p>;</span>
-</span><span id=__span-2-4><a id=__codelineno-2-4 name=__codelineno-2-4 href=#__codelineno-2-4></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span><span class=w> </span><span class=c1>// InstanceId</span>
-</span><span id=__span-2-5><a id=__codelineno-2-5 name=__codelineno-2-5 href=#__codelineno-2-5></a>
-</span><span id=__span-2-6><a id=__codelineno-2-6 name=__codelineno-2-6 href=#__codelineno-2-6></a><span class=na>[DxBroadcastMessage]</span>
-</span><span id=__span-2-7><a id=__codelineno-2-7 name=__codelineno-2-7 href=#__codelineno-2-7></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-2-8><a id=__codelineno-2-8 name=__codelineno-2-8 href=#__codelineno-2-8></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>TookDamage</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-2-9><a id=__codelineno-2-9 name=__codelineno-2-9 href=#__codelineno-2-9></a>
-</span><span id=__span-2-10><a id=__codelineno-2-10 name=__codelineno-2-10 href=#__codelineno-2-10></a><span class=c1>// Sender</span>
-</span><span id=__span-2-11><a id=__codelineno-2-11 name=__codelineno-2-11 href=#__codelineno-2-11></a><span class=kt>var</span><span class=w> </span><span class=n>hit</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>TookDamage</span><span class=p>(</span><span class=mi>5</span><span class=p>);</span>
-</span><span id=__span-2-12><a id=__codelineno-2-12 name=__codelineno-2-12 href=#__codelineno-2-12></a><span class=n>hit</span><span class=p>.</span><span class=n>EmitGameObjectBroadcast</span><span class=p>(</span><span class=n>enemyGO</span><span class=p>);</span>
-</span><span id=__span-2-13><a id=__codelineno-2-13 name=__codelineno-2-13 href=#__codelineno-2-13></a>
-</span><span id=__span-2-14><a id=__codelineno-2-14 name=__codelineno-2-14 href=#__codelineno-2-14></a><span class=c1>// Listener: observe every source</span>
-</span><span id=__span-2-15><a id=__codelineno-2-15 name=__codelineno-2-15 href=#__codelineno-2-15></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>token</span><span class=p>.</span><span class=n>RegisterBroadcastWithoutSource</span><span class=o>&lt;</span><span class=n>TookDamage</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnAnyTookDamage</span><span class=p>);</span>
-</span><span id=__span-2-16><a id=__codelineno-2-16 name=__codelineno-2-16 href=#__codelineno-2-16></a><span class=k>void</span><span class=w> </span><span class=nf>OnAnyTookDamage</span><span class=p>(</span><span class=n>InstanceId</span><span class=w> </span><span class=n>src</span><span class=p>,</span><span class=w> </span><span class=n>TookDamage</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Log</span><span class=p>(</span><span class=n>src</span><span class=p>,</span><span class=w> </span><span class=n>m</span><span class=p>);</span>
-</span></code></pre></div> <h2 id=4-validation-and-normalization-interceptors>4) Validation and Normalization (Interceptors)<a class=headerlink href=#4-validation-and-normalization-interceptors title="Anchor link to this section">&para;</a></h2> <p>Use interceptors to enforce rules before handlers run.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-3-1><a id=__codelineno-3-1 name=__codelineno-3-1 href=#__codelineno-3-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span><span class=w> </span><span class=c1>// MessageHandler</span>
-</span><span id=__span-3-2><a id=__codelineno-3-2 name=__codelineno-3-2 href=#__codelineno-3-2></a>
-</span><span id=__span-3-3><a id=__codelineno-3-3 name=__codelineno-3-3 href=#__codelineno-3-3></a><span class=kt>var</span><span class=w> </span><span class=n>bus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>;</span>
-</span><span id=__span-3-4><a id=__codelineno-3-4 name=__codelineno-3-4 href=#__codelineno-3-4></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>token</span><span class=p>.</span><span class=n>RegisterBroadcastInterceptor</span><span class=o>&lt;</span><span class=n>TookDamage</span><span class=o>&gt;</span><span class=p>((</span><span class=k>ref</span><span class=w> </span><span class=n>InstanceId</span><span class=w> </span><span class=n>source</span><span class=p>,</span><span class=w> </span><span class=k>ref</span><span class=w> </span><span class=n>TookDamage</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span>
-</span><span id=__span-3-5><a id=__codelineno-3-5 name=__codelineno-3-5 href=#__codelineno-3-5></a><span class=p>{</span>
-</span><span id=__span-3-6><a id=__codelineno-3-6 name=__codelineno-3-6 href=#__codelineno-3-6></a><span class=w>    </span><span class=k>if</span><span class=w> </span><span class=p>(</span><span class=n>m</span><span class=p>.</span><span class=n>amount</span><span class=w> </span><span class=o>&lt;=</span><span class=w> </span><span class=mi>0</span><span class=p>)</span><span class=w> </span><span class=k>return</span><span class=w> </span><span class=k>false</span><span class=p>;</span><span class=w> </span><span class=c1>// cancel</span>
-</span><span id=__span-3-7><a id=__codelineno-3-7 name=__codelineno-3-7 href=#__codelineno-3-7></a><span class=w>    </span><span class=n>m</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>TookDamage</span><span class=p>(</span><span class=n>Math</span><span class=p>.</span><span class=n>Min</span><span class=p>(</span><span class=n>m</span><span class=p>.</span><span class=n>amount</span><span class=p>,</span><span class=w> </span><span class=mi>999</span><span class=p>));</span><span class=w> </span><span class=c1>// clamp</span>
-</span><span id=__span-3-8><a id=__codelineno-3-8 name=__codelineno-3-8 href=#__codelineno-3-8></a><span class=w>    </span><span class=k>return</span><span class=w> </span><span class=k>true</span><span class=p>;</span>
-</span><span id=__span-3-9><a id=__codelineno-3-9 name=__codelineno-3-9 href=#__codelineno-3-9></a><span class=p>},</span><span class=w> </span><span class=n>priority</span><span class=p>:</span><span class=w> </span><span class=mi>0</span><span class=p>);</span>
-</span></code></pre></div> <h2 id=5-analyticslogging-post-processors>5) Analytics/Logging (Post-Processors)<a class=headerlink href=#5-analyticslogging-post-processors title="Anchor link to this section">&para;</a></h2> <p>Post-processors run after handlers—ideal for metrics.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-4-1><a id=__codelineno-4-1 name=__codelineno-4-1 href=#__codelineno-4-1></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>token</span><span class=p>.</span><span class=n>RegisterUntargetedPostProcessor</span><span class=o>&lt;</span><span class=n>SceneLoaded</span><span class=o>&gt;</span><span class=p>((</span><span class=k>ref</span><span class=w> </span><span class=n>SceneLoaded</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Metrics</span><span class=p>.</span><span class=n>TrackScene</span><span class=p>(</span><span class=n>m</span><span class=p>.</span><span class=n>buildIndex</span><span class=p>));</span>
-</span></code></pre></div> <h2 id=6-local-bus-islands>6) Local Bus Islands<a class=headerlink href=#6-local-bus-islands title="Anchor link to this section">&para;</a></h2> <p><code>MessageHandler.MessageBus</code> is the global bus. For isolation, use your own <code>MessageBus</code> instance and pass it to the token factory.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-5-1><a id=__codelineno-5-1 name=__codelineno-5-1 href=#__codelineno-5-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-5-2><a id=__codelineno-5-2 name=__codelineno-5-2 href=#__codelineno-5-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-5-3><a id=__codelineno-5-3 name=__codelineno-5-3 href=#__codelineno-5-3></a>
-</span><span id=__span-5-4><a id=__codelineno-5-4 name=__codelineno-5-4 href=#__codelineno-5-4></a><span class=kt>var</span><span class=w> </span><span class=n>localBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
-</span><span id=__span-5-5><a id=__codelineno-5-5 name=__codelineno-5-5 href=#__codelineno-5-5></a><span class=kt>var</span><span class=w> </span><span class=n>token</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageRegistrationToken</span><span class=p>.</span><span class=n>Create</span><span class=p>(</span><span class=n>handler</span><span class=p>,</span><span class=w> </span><span class=n>localBus</span><span class=p>);</span>
-</span></code></pre></div> <h2 id=7-lifecycle-pattern-in-unity>7) Lifecycle Pattern in Unity<a class=headerlink href=#7-lifecycle-pattern-in-unity title="Anchor link to this section">&para;</a></h2> <ul> <li><strong>Stage registrations in <code>Awake()</code></strong> (preferred) or <code>Start()</code> (only if order-dependent).</li> <li>Call <code>token.Enable()</code> in <code>OnEnable</code> and <code>token.Disable()</code> in <code>OnDisable</code>.</li> <li>Use <code>MessageAwareComponent</code> to avoid boilerplate—it handles all of this automatically.</li> </ul> <p>Why Awake over Start?</p> <ul> <li><code>Awake()</code> runs before any <code>Start()</code> methods, ensuring your handlers are ready early.</li> <li>Other components may emit messages in their <code>Start()</code> methods—registering in <code>Awake()</code> ensures you don't miss them.</li> <li><code>MessageAwareComponent</code> automatically calls <code>RegisterMessageHandlers()</code> in <code>Awake()</code>, following this best practice.</li> </ul> <p>Side‑by‑side: lifecycle</p> <p>Before</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-6-1><a id=__codelineno-6-1 name=__codelineno-6-1 href=#__codelineno-6-1></a><span class=k>void</span><span class=w> </span><span class=nf>Awake</span><span class=p>()</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=cm>/* register */</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-6-2><a id=__codelineno-6-2 name=__codelineno-6-2 href=#__codelineno-6-2></a><span class=k>void</span><span class=w> </span><span class=nf>OnDestroy</span><span class=p>()</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=cm>/* maybe unregister (often forgotten) */</span><span class=w> </span><span class=p>}</span>
-</span></code></pre></div> <p>After (token)</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-7-1><a id=__codelineno-7-1 name=__codelineno-7-1 href=#__codelineno-7-1></a><span class=k>void</span><span class=w> </span><span class=nf>Awake</span><span class=p>()</span><span class=w>     </span><span class=p>{</span><span class=w> </span><span class=cm>/* stage registrations - PREFERRED */</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-7-2><a id=__codelineno-7-2 name=__codelineno-7-2 href=#__codelineno-7-2></a><span class=k>void</span><span class=w> </span><span class=nf>OnEnable</span><span class=p>()</span><span class=w>  </span><span class=p>{</span><span class=w> </span><span class=n>token</span><span class=p>.</span><span class=n>Enable</span><span class=p>();</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-7-3><a id=__codelineno-7-3 name=__codelineno-7-3 href=#__codelineno-7-3></a><span class=k>void</span><span class=w> </span><span class=nf>OnDisable</span><span class=p>()</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=n>token</span><span class=p>.</span><span class=n>Disable</span><span class=p>();</span><span class=w> </span><span class=p>}</span>
-</span></code></pre></div> <h2 id=8-cross-scene-messaging>8) Cross-Scene Messaging<a class=headerlink href=#8-cross-scene-messaging title="Anchor link to this section">&para;</a></h2> <p>Untargeted messages flow anywhere; targeted/broadcast require a valid <code>InstanceId</code>. For cross-scene, ensure the target/source object exists when you emit.</p> <h2 id=9-bridging-legacy-unity-messaging>9) Bridging Legacy Unity Messaging<a class=headerlink href=#9-bridging-legacy-unity-messaging title="Anchor link to this section">&para;</a></h2> <p><code>ReflexiveMessage</code> mirrors <code>SendMessage*</code> patterns but keeps you in the bus pipeline.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-8-1><a id=__codelineno-8-1 name=__codelineno-8-1 href=#__codelineno-8-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-8-2><a id=__codelineno-8-2 name=__codelineno-8-2 href=#__codelineno-8-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Messages</span><span class=p>;</span>
-</span><span id=__span-8-3><a id=__codelineno-8-3 name=__codelineno-8-3 href=#__codelineno-8-3></a>
-</span><span id=__span-8-4><a id=__codelineno-8-4 name=__codelineno-8-4 href=#__codelineno-8-4></a><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>ReflexiveMessage</span><span class=p>(</span><span class=s>&quot;OnHit&quot;</span><span class=p>,</span><span class=w> </span><span class=n>ReflexiveSendMode</span><span class=p>.</span><span class=n>Upwards</span><span class=p>,</span><span class=w> </span><span class=mi>10</span><span class=p>);</span>
-</span><span id=__span-8-5><a id=__codelineno-8-5 name=__codelineno-8-5 href=#__codelineno-8-5></a><span class=n>msg</span><span class=p>.</span><span class=n>EmitGameObjectTargeted</span><span class=p>(</span><span class=n>someGameObject</span><span class=p>);</span>
-</span></code></pre></div> <h2 id=10-global-accept-all-handlers>10) Global Accept-All Handlers<a class=headerlink href=#10-global-accept-all-handlers title="Anchor link to this section">&para;</a></h2> <p>Use when building tools or inspectors that want to observe everything.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-9-1><a id=__codelineno-9-1 name=__codelineno-9-1 href=#__codelineno-9-1></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>token</span><span class=p>.</span><span class=n>RegisterGlobalAcceptAll</span><span class=p>(</span>
-</span><span id=__span-9-2><a id=__codelineno-9-2 name=__codelineno-9-2 href=#__codelineno-9-2></a><span class=w>    </span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>IUntargetedMessage</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><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;Untargeted {m.MessageType}&quot;</span><span class=p>),</span>
-</span><span id=__span-9-3><a id=__codelineno-9-3 name=__codelineno-9-3 href=#__codelineno-9-3></a><span class=w>    </span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>InstanceId</span><span class=w> </span><span class=n>target</span><span class=p>,</span><span class=w> </span><span class=k>ref</span><span class=w> </span><span class=n>ITargetedMessage</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><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;Targeted {m.MessageType} to {target}&quot;</span><span class=p>),</span>
-</span><span id=__span-9-4><a id=__codelineno-9-4 name=__codelineno-9-4 href=#__codelineno-9-4></a><span class=w>    </span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>InstanceId</span><span class=w> </span><span class=n>source</span><span class=p>,</span><span class=w> </span><span class=k>ref</span><span class=w> </span><span class=n>IBroadcastMessage</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><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;Broadcast {m.MessageType} from {source}&quot;</span><span class=p>)</span>
-</span><span id=__span-9-5><a id=__codelineno-9-5 name=__codelineno-9-5 href=#__codelineno-9-5></a><span class=p>);</span>
-</span><span id=__span-9-6><a id=__codelineno-9-6 name=__codelineno-9-6 href=#__codelineno-9-6></a>
-</span><span id=__span-9-7><a id=__codelineno-9-7 name=__codelineno-9-7 href=#__codelineno-9-7></a><span class=n>Do</span><span class=err>’</span><span class=n>s</span>
-</span><span id=__span-9-8><a id=__codelineno-9-8 name=__codelineno-9-8 href=#__codelineno-9-8></a>
-</span><span id=__span-9-9><a id=__codelineno-9-9 name=__codelineno-9-9 href=#__codelineno-9-9></a><span class=o>-</span><span class=w> </span><span class=n>Use</span><span class=w> </span><span class=n>global</span><span class=w> </span><span class=n>accept</span><span class=err>‑</span><span class=n>all</span><span class=w> </span><span class=k>in</span><span class=w> </span><span class=n>tooling</span><span class=w> </span><span class=k>and</span><span class=w> </span><span class=n>debug</span><span class=w> </span><span class=n>inspectors</span><span class=p>.</span>
-</span><span id=__span-9-10><a id=__codelineno-9-10 name=__codelineno-9-10 href=#__codelineno-9-10></a><span class=o>-</span><span class=w> </span><span class=n>Prefer</span><span class=w> </span><span class=n>specific</span><span class=w> </span><span class=n>registrations</span><span class=w> </span><span class=k>for</span><span class=w> </span><span class=n>gameplay</span><span class=w> </span><span class=n>code</span><span class=w> </span><span class=n>to</span><span class=w> </span><span class=n>avoid</span><span class=w> </span><span class=n>surprises</span><span class=p>.</span>
-</span></code></pre></div> <h2 id=11-diagnostics-and-tuning>11) Diagnostics and Tuning<a class=headerlink href=#11-diagnostics-and-tuning title="Anchor link to this section">&para;</a></h2> <ul> <li>Enable <code>IMessageBus.GlobalDiagnosticsMode</code> in Editor or per-token.</li> <li>Adjust <code>IMessageBus.GlobalMessageBufferSize</code> for deeper history (Editor settings UI provided).</li> <li>Wire <code>MessagingDebug.LogFunction</code> to Unity’s console to see warnings/errors.</li> </ul> <h2 id=12-testing>12) Testing<a class=headerlink href=#12-testing title="Anchor link to this section">&para;</a></h2> <ul> <li>Construct messages directly and emit via extension helpers.</li> <li>Use a local <code>MessageBus</code> per test to avoid global state.</li> <li>Wrap handlers to increment counters or assert payloads.</li> </ul> <h2 id=13-real-world-scale-beyond-toy-examples>13) Real-World Scale: Beyond Toy Examples<a class=headerlink href=#13-real-world-scale-beyond-toy-examples title="Anchor link to this section">&para;</a></h2> <p>Most documentation shows simple, small-scale examples. Here's how DxMessaging behaves at production scale.</p> <h3 id=pattern-managing-100-combat-entities>Pattern: Managing 100+ Combat Entities<a class=headerlink href=#pattern-managing-100-combat-entities title="Anchor link to this section">&para;</a></h3> <p><strong>Challenge:</strong> Track damage, healing, status effects for a large battlefield without performance collapse.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-10-1><a id=__codelineno-10-1 name=__codelineno-10-1 href=#__codelineno-10-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Messages</span><span class=p>;</span>
-</span><span id=__span-10-2><a id=__codelineno-10-2 name=__codelineno-10-2 href=#__codelineno-10-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Attributes</span><span class=p>;</span>
-</span><span id=__span-10-3><a id=__codelineno-10-3 name=__codelineno-10-3 href=#__codelineno-10-3></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Extensions</span><span class=p>;</span>
-</span><span id=__span-10-4><a id=__codelineno-10-4 name=__codelineno-10-4 href=#__codelineno-10-4></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-10-5><a id=__codelineno-10-5 name=__codelineno-10-5 href=#__codelineno-10-5></a>
-</span><span id=__span-10-6><a id=__codelineno-10-6 name=__codelineno-10-6 href=#__codelineno-10-6></a><span class=c1>// Messages</span>
-</span><span id=__span-10-7><a id=__codelineno-10-7 name=__codelineno-10-7 href=#__codelineno-10-7></a><span class=na>[DxBroadcastMessage]</span>
-</span><span id=__span-10-8><a id=__codelineno-10-8 name=__codelineno-10-8 href=#__codelineno-10-8></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-10-9><a id=__codelineno-10-9 name=__codelineno-10-9 href=#__codelineno-10-9></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>EntityDamaged</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-10-10><a id=__codelineno-10-10 name=__codelineno-10-10 href=#__codelineno-10-10></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
-</span><span id=__span-10-11><a id=__codelineno-10-11 name=__codelineno-10-11 href=#__codelineno-10-11></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>damageType</span><span class=p>;</span>
-</span><span id=__span-10-12><a id=__codelineno-10-12 name=__codelineno-10-12 href=#__codelineno-10-12></a><span class=p>}</span>
-</span><span id=__span-10-13><a id=__codelineno-10-13 name=__codelineno-10-13 href=#__codelineno-10-13></a>
-</span><span id=__span-10-14><a id=__codelineno-10-14 name=__codelineno-10-14 href=#__codelineno-10-14></a><span class=na>[DxBroadcastMessage]</span>
-</span><span id=__span-10-15><a id=__codelineno-10-15 name=__codelineno-10-15 href=#__codelineno-10-15></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-10-16><a id=__codelineno-10-16 name=__codelineno-10-16 href=#__codelineno-10-16></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>EntityHealed</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-10-17><a id=__codelineno-10-17 name=__codelineno-10-17 href=#__codelineno-10-17></a>
-</span><span id=__span-10-18><a id=__codelineno-10-18 name=__codelineno-10-18 href=#__codelineno-10-18></a><span class=c1>// Entity: Each of 100+ entities emits events</span>
-</span><span id=__span-10-19><a id=__codelineno-10-19 name=__codelineno-10-19 href=#__codelineno-10-19></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>CombatEntity</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-10-20><a id=__codelineno-10-20 name=__codelineno-10-20 href=#__codelineno-10-20></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>TakeDamage</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>,</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>type</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-10-21><a id=__codelineno-10-21 name=__codelineno-10-21 href=#__codelineno-10-21></a><span class=w>        </span><span class=n>health</span><span class=w> </span><span class=o>-=</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
-</span><span id=__span-10-22><a id=__codelineno-10-22 name=__codelineno-10-22 href=#__codelineno-10-22></a><span class=w>        </span><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>EntityDamaged</span><span class=p>(</span><span class=n>amount</span><span class=p>,</span><span class=w> </span><span class=n>type</span><span class=p>);</span>
-</span><span id=__span-10-23><a id=__codelineno-10-23 name=__codelineno-10-23 href=#__codelineno-10-23></a><span class=w>        </span><span class=n>msg</span><span class=p>.</span><span class=n>EmitGameObjectBroadcast</span><span class=p>(</span><span class=n>gameObject</span><span class=p>);</span>
-</span><span id=__span-10-24><a id=__codelineno-10-24 name=__codelineno-10-24 href=#__codelineno-10-24></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-10-25><a id=__codelineno-10-25 name=__codelineno-10-25 href=#__codelineno-10-25></a><span class=p>}</span>
-</span><span id=__span-10-26><a id=__codelineno-10-26 name=__codelineno-10-26 href=#__codelineno-10-26></a>
-</span><span id=__span-10-27><a id=__codelineno-10-27 name=__codelineno-10-27 href=#__codelineno-10-27></a><span class=c1>// Combat UI: Tracks specific enemy (targeted observation)</span>
-</span><span id=__span-10-28><a id=__codelineno-10-28 name=__codelineno-10-28 href=#__codelineno-10-28></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>EnemyHealthBar</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-10-29><a id=__codelineno-10-29 name=__codelineno-10-29 href=#__codelineno-10-29></a><span class=w>    </span><span class=na>[SerializeField]</span><span class=w> </span><span class=k>private</span><span class=w> </span><span class=n>GameObject</span><span class=w> </span><span class=n>trackedEnemy</span><span class=p>;</span>
-</span><span id=__span-10-30><a id=__codelineno-10-30 name=__codelineno-10-30 href=#__codelineno-10-30></a>
-</span><span id=__span-10-31><a id=__codelineno-10-31 name=__codelineno-10-31 href=#__codelineno-10-31></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-10-32><a id=__codelineno-10-32 name=__codelineno-10-32 href=#__codelineno-10-32></a><span class=w>        </span><span class=c1>// Only listens to ONE enemy, not all 100</span>
-</span><span id=__span-10-33><a id=__codelineno-10-33 name=__codelineno-10-33 href=#__codelineno-10-33></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterGameObjectBroadcast</span><span class=o>&lt;</span><span class=n>EntityDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>trackedEnemy</span><span class=p>,</span><span class=w> </span><span class=n>OnDamaged</span><span class=p>);</span>
-</span><span id=__span-10-34><a id=__codelineno-10-34 name=__codelineno-10-34 href=#__codelineno-10-34></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-10-35><a id=__codelineno-10-35 name=__codelineno-10-35 href=#__codelineno-10-35></a>
-</span><span id=__span-10-36><a id=__codelineno-10-36 name=__codelineno-10-36 href=#__codelineno-10-36></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnDamaged</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>EntityDamaged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>UpdateBar</span><span class=p>();</span>
-</span><span id=__span-10-37><a id=__codelineno-10-37 name=__codelineno-10-37 href=#__codelineno-10-37></a><span class=p>}</span>
-</span><span id=__span-10-38><a id=__codelineno-10-38 name=__codelineno-10-38 href=#__codelineno-10-38></a>
-</span><span id=__span-10-39><a id=__codelineno-10-39 name=__codelineno-10-39 href=#__codelineno-10-39></a><span class=c1>// Analytics: Observes ALL entities (global observation)</span>
-</span><span id=__span-10-40><a id=__codelineno-10-40 name=__codelineno-10-40 href=#__codelineno-10-40></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>CombatAnalytics</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-10-41><a id=__codelineno-10-41 name=__codelineno-10-41 href=#__codelineno-10-41></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>Dictionary</span><span class=o>&lt;</span><span class=n>InstanceId</span><span class=p>,</span><span class=w> </span><span class=kt>int</span><span class=o>&gt;</span><span class=w> </span><span class=n>totalDamageByEntity</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=p>();</span>
-</span><span id=__span-10-42><a id=__codelineno-10-42 name=__codelineno-10-42 href=#__codelineno-10-42></a>
-</span><span id=__span-10-43><a id=__codelineno-10-43 name=__codelineno-10-43 href=#__codelineno-10-43></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-10-44><a id=__codelineno-10-44 name=__codelineno-10-44 href=#__codelineno-10-44></a><span class=w>        </span><span class=c1>// Listens to all 100+ entities with ONE registration</span>
-</span><span id=__span-10-45><a id=__codelineno-10-45 name=__codelineno-10-45 href=#__codelineno-10-45></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterBroadcastWithoutSource</span><span class=o>&lt;</span><span class=n>EntityDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnAnyDamage</span><span class=p>);</span>
-</span><span id=__span-10-46><a id=__codelineno-10-46 name=__codelineno-10-46 href=#__codelineno-10-46></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-10-47><a id=__codelineno-10-47 name=__codelineno-10-47 href=#__codelineno-10-47></a>
-</span><span id=__span-10-48><a id=__codelineno-10-48 name=__codelineno-10-48 href=#__codelineno-10-48></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnAnyDamage</span><span class=p>(</span><span class=n>InstanceId</span><span class=w> </span><span class=n>source</span><span class=p>,</span><span class=w> </span><span class=n>EntityDamaged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-10-49><a id=__codelineno-10-49 name=__codelineno-10-49 href=#__codelineno-10-49></a><span class=w>        </span><span class=k>if</span><span class=w> </span><span class=p>(</span><span class=o>!</span><span class=n>totalDamageByEntity</span><span class=p>.</span><span class=n>ContainsKey</span><span class=p>(</span><span class=n>source</span><span class=p>))</span>
-</span><span id=__span-10-50><a id=__codelineno-10-50 name=__codelineno-10-50 href=#__codelineno-10-50></a><span class=w>            </span><span class=n>totalDamageByEntity</span><span class=p>[</span><span class=n>source</span><span class=p>]</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>0</span><span class=p>;</span>
-</span><span id=__span-10-51><a id=__codelineno-10-51 name=__codelineno-10-51 href=#__codelineno-10-51></a><span class=w>        </span><span class=n>totalDamageByEntity</span><span class=p>[</span><span class=n>source</span><span class=p>]</span><span class=w> </span><span class=o>+=</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>amount</span><span class=p>;</span>
-</span><span id=__span-10-52><a id=__codelineno-10-52 name=__codelineno-10-52 href=#__codelineno-10-52></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-10-53><a id=__codelineno-10-53 name=__codelineno-10-53 href=#__codelineno-10-53></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=scale-characteristics>Scale characteristics<a class=headerlink href=#scale-characteristics title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Each entity broadcasts ~10-50 messages/second → No GC allocations (struct messages)</li> <li>✅ Targeted listeners (health bars) only receive relevant messages → O(1) lookup</li> <li>✅ Global listeners (analytics) receive all messages → Single handler, not N handlers</li> <li>✅ Adding/removing entities doesn't break registrations (no manual wiring)</li> </ul> <h5 id=performance-notes>Performance notes<a class=headerlink href=#performance-notes title="Anchor link to this section">&para;</a></h5> <ul> <li>Disable diagnostics in production (<code>IMessageBus.GlobalDiagnosticsMode = false</code>)</li> <li>Use <code>RegisterBroadcastWithoutSource</code> sparingly (it's called for every emit)</li> <li>Profile with Unity Profiler to find hotspots</li> </ul> <h3 id=pattern-cross-scene-persistent-systems>Pattern: Cross-Scene Persistent Systems<a class=headerlink href=#pattern-cross-scene-persistent-systems title="Anchor link to this section">&para;</a></h3> <p><strong>Challenge:</strong> Maintain event flow across scene loads (achievements, save system, analytics).</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-11-1><a id=__codelineno-11-1 name=__codelineno-11-1 href=#__codelineno-11-1></a><span class=k>using</span><span class=w> </span><span class=nn>UnityEngine</span><span class=p>;</span>
-</span><span id=__span-11-2><a id=__codelineno-11-2 name=__codelineno-11-2 href=#__codelineno-11-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Unity</span><span class=p>;</span>
-</span><span id=__span-11-3><a id=__codelineno-11-3 name=__codelineno-11-3 href=#__codelineno-11-3></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Attributes</span><span class=p>;</span>
-</span><span id=__span-11-4><a id=__codelineno-11-4 name=__codelineno-11-4 href=#__codelineno-11-4></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Extensions</span><span class=p>;</span>
-</span><span id=__span-11-5><a id=__codelineno-11-5 name=__codelineno-11-5 href=#__codelineno-11-5></a>
-</span><span id=__span-11-6><a id=__codelineno-11-6 name=__codelineno-11-6 href=#__codelineno-11-6></a><span class=c1>// Persistent singleton that survives scene loads</span>
-</span><span id=__span-11-7><a id=__codelineno-11-7 name=__codelineno-11-7 href=#__codelineno-11-7></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>PersistentAchievementSystem</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-11-8><a id=__codelineno-11-8 name=__codelineno-11-8 href=#__codelineno-11-8></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=n>PersistentAchievementSystem</span><span class=w> </span><span class=n>instance</span><span class=p>;</span>
-</span><span id=__span-11-9><a id=__codelineno-11-9 name=__codelineno-11-9 href=#__codelineno-11-9></a>
-</span><span id=__span-11-10><a id=__codelineno-11-10 name=__codelineno-11-10 href=#__codelineno-11-10></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>Awake</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-11-11><a id=__codelineno-11-11 name=__codelineno-11-11 href=#__codelineno-11-11></a><span class=w>        </span><span class=k>if</span><span class=w> </span><span class=p>(</span><span class=n>instance</span><span class=w> </span><span class=o>!=</span><span class=w> </span><span class=k>null</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-11-12><a id=__codelineno-11-12 name=__codelineno-11-12 href=#__codelineno-11-12></a><span class=w>            </span><span class=n>Destroy</span><span class=p>(</span><span class=n>gameObject</span><span class=p>);</span>
-</span><span id=__span-11-13><a id=__codelineno-11-13 name=__codelineno-11-13 href=#__codelineno-11-13></a><span class=w>            </span><span class=k>return</span><span class=p>;</span>
-</span><span id=__span-11-14><a id=__codelineno-11-14 name=__codelineno-11-14 href=#__codelineno-11-14></a><span class=w>        </span><span class=p>}</span>
-</span><span id=__span-11-15><a id=__codelineno-11-15 name=__codelineno-11-15 href=#__codelineno-11-15></a><span class=w>        </span><span class=n>instance</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>this</span><span class=p>;</span>
-</span><span id=__span-11-16><a id=__codelineno-11-16 name=__codelineno-11-16 href=#__codelineno-11-16></a><span class=w>        </span><span class=n>DontDestroyOnLoad</span><span class=p>(</span><span class=n>gameObject</span><span class=p>);</span>
-</span><span id=__span-11-17><a id=__codelineno-11-17 name=__codelineno-11-17 href=#__codelineno-11-17></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-11-18><a id=__codelineno-11-18 name=__codelineno-11-18 href=#__codelineno-11-18></a>
-</span><span id=__span-11-19><a id=__codelineno-11-19 name=__codelineno-11-19 href=#__codelineno-11-19></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-11-20><a id=__codelineno-11-20 name=__codelineno-11-20 href=#__codelineno-11-20></a><span class=w>        </span><span class=c1>// Listen to ALL broadcasts from ANY scene</span>
-</span><span id=__span-11-21><a id=__codelineno-11-21 name=__codelineno-11-21 href=#__codelineno-11-21></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterBroadcastWithoutSource</span><span class=o>&lt;</span><span class=n>EntityDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnAnyDamage</span><span class=p>);</span>
-</span><span id=__span-11-22><a id=__codelineno-11-22 name=__codelineno-11-22 href=#__codelineno-11-22></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>LevelCompleted</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnLevelComplete</span><span class=p>);</span>
-</span><span id=__span-11-23><a id=__codelineno-11-23 name=__codelineno-11-23 href=#__codelineno-11-23></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-11-24><a id=__codelineno-11-24 name=__codelineno-11-24 href=#__codelineno-11-24></a>
-</span><span id=__span-11-25><a id=__codelineno-11-25 name=__codelineno-11-25 href=#__codelineno-11-25></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnAnyDamage</span><span class=p>(</span><span class=n>InstanceId</span><span class=w> </span><span class=n>src</span><span class=p>,</span><span class=w> </span><span class=n>EntityDamaged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-11-26><a id=__codelineno-11-26 name=__codelineno-11-26 href=#__codelineno-11-26></a><span class=w>        </span><span class=n>totalDamage</span><span class=w> </span><span class=o>+=</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>amount</span><span class=p>;</span>
-</span><span id=__span-11-27><a id=__codelineno-11-27 name=__codelineno-11-27 href=#__codelineno-11-27></a><span class=w>        </span><span class=n>CheckAchievements</span><span class=p>();</span>
-</span><span id=__span-11-28><a id=__codelineno-11-28 name=__codelineno-11-28 href=#__codelineno-11-28></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-11-29><a id=__codelineno-11-29 name=__codelineno-11-29 href=#__codelineno-11-29></a>
-</span><span id=__span-11-30><a id=__codelineno-11-30 name=__codelineno-11-30 href=#__codelineno-11-30></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnLevelComplete</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>LevelCompleted</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-11-31><a id=__codelineno-11-31 name=__codelineno-11-31 href=#__codelineno-11-31></a><span class=w>        </span><span class=n>UnlockAchievement</span><span class=p>(</span><span class=s>$&quot;Complete_Level_{msg.levelIndex}&quot;</span><span class=p>);</span>
-</span><span id=__span-11-32><a id=__codelineno-11-32 name=__codelineno-11-32 href=#__codelineno-11-32></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-11-33><a id=__codelineno-11-33 name=__codelineno-11-33 href=#__codelineno-11-33></a><span class=p>}</span>
-</span><span id=__span-11-34><a id=__codelineno-11-34 name=__codelineno-11-34 href=#__codelineno-11-34></a>
-</span><span id=__span-11-35><a id=__codelineno-11-35 name=__codelineno-11-35 href=#__codelineno-11-35></a><span class=c1>// Scene-specific objects emit messages normally</span>
-</span><span id=__span-11-36><a id=__codelineno-11-36 name=__codelineno-11-36 href=#__codelineno-11-36></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>Boss</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-11-37><a id=__codelineno-11-37 name=__codelineno-11-37 href=#__codelineno-11-37></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>Die</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-11-38><a id=__codelineno-11-38 name=__codelineno-11-38 href=#__codelineno-11-38></a><span class=w>        </span><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>BossDefeated</span><span class=p>(</span><span class=n>bossName</span><span class=p>);</span>
-</span><span id=__span-11-39><a id=__codelineno-11-39 name=__codelineno-11-39 href=#__codelineno-11-39></a><span class=w>        </span><span class=n>msg</span><span class=p>.</span><span class=n>EmitGameObjectBroadcast</span><span class=p>(</span><span class=n>gameObject</span><span class=p>);</span>
-</span><span id=__span-11-40><a id=__codelineno-11-40 name=__codelineno-11-40 href=#__codelineno-11-40></a><span class=w>        </span><span class=c1>// PersistentAchievementSystem hears this even though it&#39;s in DontDestroyOnLoad</span>
-</span><span id=__span-11-41><a id=__codelineno-11-41 name=__codelineno-11-41 href=#__codelineno-11-41></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-11-42><a id=__codelineno-11-42 name=__codelineno-11-42 href=#__codelineno-11-42></a><span class=p>}</span>
-</span></code></pre></div> <p><strong>Key insight:</strong> Persistent listeners (<code>DontDestroyOnLoad</code>) stay registered across scenes. Scene-specific emitters come/go, but the observer remains.</p> <p><strong>Gotcha:</strong> If you emit <code>Targeted</code> or <code>Broadcast</code> messages, ensure the target/source <code>InstanceId</code> is still valid after scene loads. For cross-scene communication, prefer <code>Untargeted</code> messages.</p> <h3 id=pattern-large-scale-ui-system-20-panels>Pattern: Large-Scale UI System (20+ Panels)<a class=headerlink href=#pattern-large-scale-ui-system-20-panels title="Anchor link to this section">&para;</a></h3> <p><strong>Challenge:</strong> Coordinate 20+ UI panels reacting to game state without tight coupling.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-12-1><a id=__codelineno-12-1 name=__codelineno-12-1 href=#__codelineno-12-1></a><span class=c1>// Game state messages (global)</span>
-</span><span id=__span-12-2><a id=__codelineno-12-2 name=__codelineno-12-2 href=#__codelineno-12-2></a><span class=na>[DxUntargetedMessage]</span>
-</span><span id=__span-12-3><a id=__codelineno-12-3 name=__codelineno-12-3 href=#__codelineno-12-3></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-12-4><a id=__codelineno-12-4 name=__codelineno-12-4 href=#__codelineno-12-4></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>PlayerStatsChanged</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-5><a id=__codelineno-12-5 name=__codelineno-12-5 href=#__codelineno-12-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>health</span><span class=p>;</span>
-</span><span id=__span-12-6><a id=__codelineno-12-6 name=__codelineno-12-6 href=#__codelineno-12-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>mana</span><span class=p>;</span>
-</span><span id=__span-12-7><a id=__codelineno-12-7 name=__codelineno-12-7 href=#__codelineno-12-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>gold</span><span class=p>;</span>
-</span><span id=__span-12-8><a id=__codelineno-12-8 name=__codelineno-12-8 href=#__codelineno-12-8></a><span class=p>}</span>
-</span><span id=__span-12-9><a id=__codelineno-12-9 name=__codelineno-12-9 href=#__codelineno-12-9></a>
-</span><span id=__span-12-10><a id=__codelineno-12-10 name=__codelineno-12-10 href=#__codelineno-12-10></a><span class=na>[DxUntargetedMessage]</span>
-</span><span id=__span-12-11><a id=__codelineno-12-11 name=__codelineno-12-11 href=#__codelineno-12-11></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-12-12><a id=__codelineno-12-12 name=__codelineno-12-12 href=#__codelineno-12-12></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>InventoryChanged</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>itemCount</span><span class=p>;</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-12-13><a id=__codelineno-12-13 name=__codelineno-12-13 href=#__codelineno-12-13></a>
-</span><span id=__span-12-14><a id=__codelineno-12-14 name=__codelineno-12-14 href=#__codelineno-12-14></a><span class=c1>// Each UI panel listens independently</span>
-</span><span id=__span-12-15><a id=__codelineno-12-15 name=__codelineno-12-15 href=#__codelineno-12-15></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>HealthPanel</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-16><a id=__codelineno-12-16 name=__codelineno-12-16 href=#__codelineno-12-16></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-17><a id=__codelineno-12-17 name=__codelineno-12-17 href=#__codelineno-12-17></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>PlayerStatsChanged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnStats</span><span class=p>);</span>
-</span><span id=__span-12-18><a id=__codelineno-12-18 name=__codelineno-12-18 href=#__codelineno-12-18></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-12-19><a id=__codelineno-12-19 name=__codelineno-12-19 href=#__codelineno-12-19></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnStats</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>PlayerStatsChanged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>UpdateHealth</span><span class=p>(</span><span class=n>msg</span><span class=p>.</span><span class=n>health</span><span class=p>);</span>
-</span><span id=__span-12-20><a id=__codelineno-12-20 name=__codelineno-12-20 href=#__codelineno-12-20></a><span class=p>}</span>
-</span><span id=__span-12-21><a id=__codelineno-12-21 name=__codelineno-12-21 href=#__codelineno-12-21></a>
-</span><span id=__span-12-22><a id=__codelineno-12-22 name=__codelineno-12-22 href=#__codelineno-12-22></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>ManaPanel</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-23><a id=__codelineno-12-23 name=__codelineno-12-23 href=#__codelineno-12-23></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-24><a id=__codelineno-12-24 name=__codelineno-12-24 href=#__codelineno-12-24></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>PlayerStatsChanged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnStats</span><span class=p>);</span>
-</span><span id=__span-12-25><a id=__codelineno-12-25 name=__codelineno-12-25 href=#__codelineno-12-25></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-12-26><a id=__codelineno-12-26 name=__codelineno-12-26 href=#__codelineno-12-26></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnStats</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>PlayerStatsChanged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>UpdateMana</span><span class=p>(</span><span class=n>msg</span><span class=p>.</span><span class=n>mana</span><span class=p>);</span>
-</span><span id=__span-12-27><a id=__codelineno-12-27 name=__codelineno-12-27 href=#__codelineno-12-27></a><span class=p>}</span>
-</span><span id=__span-12-28><a id=__codelineno-12-28 name=__codelineno-12-28 href=#__codelineno-12-28></a>
-</span><span id=__span-12-29><a id=__codelineno-12-29 name=__codelineno-12-29 href=#__codelineno-12-29></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>GoldPanel</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-30><a id=__codelineno-12-30 name=__codelineno-12-30 href=#__codelineno-12-30></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-31><a id=__codelineno-12-31 name=__codelineno-12-31 href=#__codelineno-12-31></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>PlayerStatsChanged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnStats</span><span class=p>);</span>
-</span><span id=__span-12-32><a id=__codelineno-12-32 name=__codelineno-12-32 href=#__codelineno-12-32></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-12-33><a id=__codelineno-12-33 name=__codelineno-12-33 href=#__codelineno-12-33></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnStats</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>PlayerStatsChanged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>UpdateGold</span><span class=p>(</span><span class=n>msg</span><span class=p>.</span><span class=n>gold</span><span class=p>);</span>
-</span><span id=__span-12-34><a id=__codelineno-12-34 name=__codelineno-12-34 href=#__codelineno-12-34></a><span class=p>}</span>
-</span><span id=__span-12-35><a id=__codelineno-12-35 name=__codelineno-12-35 href=#__codelineno-12-35></a>
-</span><span id=__span-12-36><a id=__codelineno-12-36 name=__codelineno-12-36 href=#__codelineno-12-36></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>InventoryPanel</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-37><a id=__codelineno-12-37 name=__codelineno-12-37 href=#__codelineno-12-37></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-38><a id=__codelineno-12-38 name=__codelineno-12-38 href=#__codelineno-12-38></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>InventoryChanged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnInventory</span><span class=p>);</span>
-</span><span id=__span-12-39><a id=__codelineno-12-39 name=__codelineno-12-39 href=#__codelineno-12-39></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-12-40><a id=__codelineno-12-40 name=__codelineno-12-40 href=#__codelineno-12-40></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnInventory</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>InventoryChanged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Refresh</span><span class=p>();</span>
-</span><span id=__span-12-41><a id=__codelineno-12-41 name=__codelineno-12-41 href=#__codelineno-12-41></a><span class=p>}</span>
-</span><span id=__span-12-42><a id=__codelineno-12-42 name=__codelineno-12-42 href=#__codelineno-12-42></a>
-</span><span id=__span-12-43><a id=__codelineno-12-43 name=__codelineno-12-43 href=#__codelineno-12-43></a><span class=c1>// Game systems emit once, all panels update</span>
-</span><span id=__span-12-44><a id=__codelineno-12-44 name=__codelineno-12-44 href=#__codelineno-12-44></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>PlayerStats</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-45><a id=__codelineno-12-45 name=__codelineno-12-45 href=#__codelineno-12-45></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>UpdateStats</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-46><a id=__codelineno-12-46 name=__codelineno-12-46 href=#__codelineno-12-46></a><span class=w>        </span><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>PlayerStatsChanged</span><span class=p>(</span><span class=n>health</span><span class=p>,</span><span class=w> </span><span class=n>mana</span><span class=p>,</span><span class=w> </span><span class=n>gold</span><span class=p>);</span>
-</span><span id=__span-12-47><a id=__codelineno-12-47 name=__codelineno-12-47 href=#__codelineno-12-47></a><span class=w>        </span><span class=n>msg</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span><span class=w> </span><span class=c1>// All 3 panels update automatically</span>
-</span><span id=__span-12-48><a id=__codelineno-12-48 name=__codelineno-12-48 href=#__codelineno-12-48></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-12-49><a id=__codelineno-12-49 name=__codelineno-12-49 href=#__codelineno-12-49></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=benefits-at-scale>Benefits at scale<a class=headerlink href=#benefits-at-scale title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Add/remove panels without touching game logic</li> <li>✅ Panels can be enabled/disabled freely (tokens handle lifecycle)</li> <li>✅ Easy to add "observer panels" (e.g., debug overlays) without modifying existing code</li> </ul> <h5 id=anti-pattern-to-avoid>Anti-pattern to avoid<a class=headerlink href=#anti-pattern-to-avoid title="Anchor link to this section">&para;</a></h5> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-13-1><a id=__codelineno-13-1 name=__codelineno-13-1 href=#__codelineno-13-1></a><span class=c1>// ❌ DON&#39;T: Separate message per UI element (too granular)</span>
-</span><span id=__span-13-2><a id=__codelineno-13-2 name=__codelineno-13-2 href=#__codelineno-13-2></a><span class=na>[DxUntargetedMessage]</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>HealthChanged</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>health</span><span class=p>;</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-13-3><a id=__codelineno-13-3 name=__codelineno-13-3 href=#__codelineno-13-3></a><span class=na>[DxUntargetedMessage]</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>ManaChanged</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>mana</span><span class=p>;</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-13-4><a id=__codelineno-13-4 name=__codelineno-13-4 href=#__codelineno-13-4></a><span class=na>[DxUntargetedMessage]</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>GoldChanged</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>gold</span><span class=p>;</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-13-5><a id=__codelineno-13-5 name=__codelineno-13-5 href=#__codelineno-13-5></a><span class=c1>// This creates 3x message traffic and registration overhead</span>
-</span><span id=__span-13-6><a id=__codelineno-13-6 name=__codelineno-13-6 href=#__codelineno-13-6></a>
-</span><span id=__span-13-7><a id=__codelineno-13-7 name=__codelineno-13-7 href=#__codelineno-13-7></a><span class=c1>// ✅ DO: Batch related updates into one message</span>
-</span><span id=__span-13-8><a id=__codelineno-13-8 name=__codelineno-13-8 href=#__codelineno-13-8></a><span class=na>[DxUntargetedMessage]</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>PlayerStatsChanged</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-13-9><a id=__codelineno-13-9 name=__codelineno-13-9 href=#__codelineno-13-9></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>health</span><span class=p>;</span>
-</span><span id=__span-13-10><a id=__codelineno-13-10 name=__codelineno-13-10 href=#__codelineno-13-10></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>mana</span><span class=p>;</span>
-</span><span id=__span-13-11><a id=__codelineno-13-11 name=__codelineno-13-11 href=#__codelineno-13-11></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>gold</span><span class=p>;</span>
-</span><span id=__span-13-12><a id=__codelineno-13-12 name=__codelineno-13-12 href=#__codelineno-13-12></a><span class=p>}</span>
-</span></code></pre></div> <h3 id=pattern-priority-ordered-execution-for-complex-systems>Pattern: Priority-Ordered Execution for Complex Systems<a class=headerlink href=#pattern-priority-ordered-execution-for-complex-systems title="Anchor link to this section">&para;</a></h3> <p><strong>Challenge:</strong> Ensure SaveSystem runs before SceneLoader, AudioSystem fades before UI transitions.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-14-1><a id=__codelineno-14-1 name=__codelineno-14-1 href=#__codelineno-14-1></a><span class=na>[DxUntargetedMessage]</span>
-</span><span id=__span-14-2><a id=__codelineno-14-2 name=__codelineno-14-2 href=#__codelineno-14-2></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-14-3><a id=__codelineno-14-3 name=__codelineno-14-3 href=#__codelineno-14-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>GameExit</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-14-4><a id=__codelineno-14-4 name=__codelineno-14-4 href=#__codelineno-14-4></a>
-</span><span id=__span-14-5><a id=__codelineno-14-5 name=__codelineno-14-5 href=#__codelineno-14-5></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>SaveSystem</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-14-6><a id=__codelineno-14-6 name=__codelineno-14-6 href=#__codelineno-14-6></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-14-7><a id=__codelineno-14-7 name=__codelineno-14-7 href=#__codelineno-14-7></a><span class=w>        </span><span class=c1>// Priority 0 = runs FIRST</span>
-</span><span id=__span-14-8><a id=__codelineno-14-8 name=__codelineno-14-8 href=#__codelineno-14-8></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>GameExit</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnExit</span><span class=p>,</span><span class=w> </span><span class=n>priority</span><span class=p>:</span><span class=w> </span><span class=mi>0</span><span class=p>);</span>
-</span><span id=__span-14-9><a id=__codelineno-14-9 name=__codelineno-14-9 href=#__codelineno-14-9></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-14-10><a id=__codelineno-14-10 name=__codelineno-14-10 href=#__codelineno-14-10></a>
-</span><span id=__span-14-11><a id=__codelineno-14-11 name=__codelineno-14-11 href=#__codelineno-14-11></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnExit</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>GameExit</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-14-12><a id=__codelineno-14-12 name=__codelineno-14-12 href=#__codelineno-14-12></a><span class=w>        </span><span class=n>SaveGame</span><span class=p>();</span><span class=w> </span><span class=c1>// Must complete before audio fades</span>
-</span><span id=__span-14-13><a id=__codelineno-14-13 name=__codelineno-14-13 href=#__codelineno-14-13></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-14-14><a id=__codelineno-14-14 name=__codelineno-14-14 href=#__codelineno-14-14></a><span class=p>}</span>
-</span><span id=__span-14-15><a id=__codelineno-14-15 name=__codelineno-14-15 href=#__codelineno-14-15></a>
-</span><span id=__span-14-16><a id=__codelineno-14-16 name=__codelineno-14-16 href=#__codelineno-14-16></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>AudioSystem</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-14-17><a id=__codelineno-14-17 name=__codelineno-14-17 href=#__codelineno-14-17></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-14-18><a id=__codelineno-14-18 name=__codelineno-14-18 href=#__codelineno-14-18></a><span class=w>        </span><span class=c1>// Priority 5 = runs AFTER SaveSystem</span>
-</span><span id=__span-14-19><a id=__codelineno-14-19 name=__codelineno-14-19 href=#__codelineno-14-19></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>GameExit</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnExit</span><span class=p>,</span><span class=w> </span><span class=n>priority</span><span class=p>:</span><span class=w> </span><span class=mi>5</span><span class=p>);</span>
-</span><span id=__span-14-20><a id=__codelineno-14-20 name=__codelineno-14-20 href=#__codelineno-14-20></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-14-21><a id=__codelineno-14-21 name=__codelineno-14-21 href=#__codelineno-14-21></a>
-</span><span id=__span-14-22><a id=__codelineno-14-22 name=__codelineno-14-22 href=#__codelineno-14-22></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnExit</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>GameExit</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-14-23><a id=__codelineno-14-23 name=__codelineno-14-23 href=#__codelineno-14-23></a><span class=w>        </span><span class=n>FadeOutMusic</span><span class=p>();</span><span class=w> </span><span class=c1>// Runs after save</span>
-</span><span id=__span-14-24><a id=__codelineno-14-24 name=__codelineno-14-24 href=#__codelineno-14-24></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-14-25><a id=__codelineno-14-25 name=__codelineno-14-25 href=#__codelineno-14-25></a><span class=p>}</span>
-</span><span id=__span-14-26><a id=__codelineno-14-26 name=__codelineno-14-26 href=#__codelineno-14-26></a>
-</span><span id=__span-14-27><a id=__codelineno-14-27 name=__codelineno-14-27 href=#__codelineno-14-27></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>UISystem</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-14-28><a id=__codelineno-14-28 name=__codelineno-14-28 href=#__codelineno-14-28></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-14-29><a id=__codelineno-14-29 name=__codelineno-14-29 href=#__codelineno-14-29></a><span class=w>        </span><span class=c1>// Priority 10 = runs LAST</span>
-</span><span id=__span-14-30><a id=__codelineno-14-30 name=__codelineno-14-30 href=#__codelineno-14-30></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>GameExit</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnExit</span><span class=p>,</span><span class=w> </span><span class=n>priority</span><span class=p>:</span><span class=w> </span><span class=mi>10</span><span class=p>);</span>
-</span><span id=__span-14-31><a id=__codelineno-14-31 name=__codelineno-14-31 href=#__codelineno-14-31></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-14-32><a id=__codelineno-14-32 name=__codelineno-14-32 href=#__codelineno-14-32></a>
-</span><span id=__span-14-33><a id=__codelineno-14-33 name=__codelineno-14-33 href=#__codelineno-14-33></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnExit</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>GameExit</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-14-34><a id=__codelineno-14-34 name=__codelineno-14-34 href=#__codelineno-14-34></a><span class=w>        </span><span class=n>ShowExitAnimation</span><span class=p>();</span><span class=w> </span><span class=c1>// Runs after audio fade starts</span>
-</span><span id=__span-14-35><a id=__codelineno-14-35 name=__codelineno-14-35 href=#__codelineno-14-35></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-14-36><a id=__codelineno-14-36 name=__codelineno-14-36 href=#__codelineno-14-36></a><span class=p>}</span>
-</span><span id=__span-14-37><a id=__codelineno-14-37 name=__codelineno-14-37 href=#__codelineno-14-37></a>
-</span><span id=__span-14-38><a id=__codelineno-14-38 name=__codelineno-14-38 href=#__codelineno-14-38></a><span class=c1>// Emit once, all systems execute in priority order</span>
-</span><span id=__span-14-39><a id=__codelineno-14-39 name=__codelineno-14-39 href=#__codelineno-14-39></a><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>GameExit</span><span class=p>();</span>
-</span><span id=__span-14-40><a id=__codelineno-14-40 name=__codelineno-14-40 href=#__codelineno-14-40></a><span class=n>msg</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span>
-</span></code></pre></div> <p><strong>Key insight:</strong> Lower priority numbers run first. Use priority to eliminate race conditions and ensure deterministic ordering.</p> <h4 id=recommended-priority-ranges>Recommended priority ranges<a class=headerlink href=#recommended-priority-ranges title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>-100 to -50:</strong> Critical systems (save, validation)</li> <li><strong>-10 to 0:</strong> Core gameplay logic</li> <li><strong>0 to 10:</strong> UI updates</li> <li><strong>10 to 20:</strong> Visual effects</li> <li><strong>20+:</strong> Analytics, logging, non-critical</li> </ul> <h3 id=pattern-efficient-interception-at-scale>Pattern: Efficient Interception at Scale<a class=headerlink href=#pattern-efficient-interception-at-scale title="Anchor link to this section">&para;</a></h3> <p><strong>Challenge:</strong> Validate 1000s of messages without duplicating logic.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-15-1><a id=__codelineno-15-1 name=__codelineno-15-1 href=#__codelineno-15-1></a><span class=c1>// Single interceptor validates ALL damage</span>
-</span><span id=__span-15-2><a id=__codelineno-15-2 name=__codelineno-15-2 href=#__codelineno-15-2></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>DamageValidator</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-15-3><a id=__codelineno-15-3 name=__codelineno-15-3 href=#__codelineno-15-3></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-15-4><a id=__codelineno-15-4 name=__codelineno-15-4 href=#__codelineno-15-4></a><span class=w>        </span><span class=c1>// Interceptors run BEFORE handlers</span>
-</span><span id=__span-15-5><a id=__codelineno-15-5 name=__codelineno-15-5 href=#__codelineno-15-5></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterBroadcastInterceptor</span><span class=o>&lt;</span><span class=n>EntityDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>ValidateDamage</span><span class=p>,</span><span class=w> </span><span class=n>priority</span><span class=p>:</span><span class=w> </span><span class=o>-</span><span class=mi>100</span><span class=p>);</span>
-</span><span id=__span-15-6><a id=__codelineno-15-6 name=__codelineno-15-6 href=#__codelineno-15-6></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-15-7><a id=__codelineno-15-7 name=__codelineno-15-7 href=#__codelineno-15-7></a>
-</span><span id=__span-15-8><a id=__codelineno-15-8 name=__codelineno-15-8 href=#__codelineno-15-8></a><span class=w>    </span><span class=kt>bool</span><span class=w> </span><span class=nf>ValidateDamage</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>InstanceId</span><span class=w> </span><span class=n>source</span><span class=p>,</span><span class=w> </span><span class=k>ref</span><span class=w> </span><span class=n>EntityDamaged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-15-9><a id=__codelineno-15-9 name=__codelineno-15-9 href=#__codelineno-15-9></a><span class=w>        </span><span class=c1>// Validation logic runs once per message, not per handler</span>
-</span><span id=__span-15-10><a id=__codelineno-15-10 name=__codelineno-15-10 href=#__codelineno-15-10></a><span class=w>        </span><span class=k>if</span><span class=w> </span><span class=p>(</span><span class=n>msg</span><span class=p>.</span><span class=n>amount</span><span class=w> </span><span class=o>&lt;=</span><span class=w> </span><span class=mi>0</span><span class=p>)</span><span class=w> </span><span class=k>return</span><span class=w> </span><span class=k>false</span><span class=p>;</span><span class=w> </span><span class=c1>// Cancel invalid</span>
-</span><span id=__span-15-11><a id=__codelineno-15-11 name=__codelineno-15-11 href=#__codelineno-15-11></a><span class=w>        </span><span class=k>if</span><span class=w> </span><span class=p>(</span><span class=n>msg</span><span class=p>.</span><span class=n>amount</span><span class=w> </span><span class=o>&gt;</span><span class=w> </span><span class=mi>9999</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-15-12><a id=__codelineno-15-12 name=__codelineno-15-12 href=#__codelineno-15-12></a><span class=w>            </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>EntityDamaged</span><span class=p>(</span><span class=mi>9999</span><span class=p>,</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>damageType</span><span class=p>);</span><span class=w> </span><span class=c1>// Clamp</span>
-</span><span id=__span-15-13><a id=__codelineno-15-13 name=__codelineno-15-13 href=#__codelineno-15-13></a><span class=w>        </span><span class=p>}</span>
-</span><span id=__span-15-14><a id=__codelineno-15-14 name=__codelineno-15-14 href=#__codelineno-15-14></a><span class=w>        </span><span class=k>return</span><span class=w> </span><span class=k>true</span><span class=p>;</span><span class=w> </span><span class=c1>// Allow to proceed to handlers</span>
-</span><span id=__span-15-15><a id=__codelineno-15-15 name=__codelineno-15-15 href=#__codelineno-15-15></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-15-16><a id=__codelineno-15-16 name=__codelineno-15-16 href=#__codelineno-15-16></a><span class=p>}</span>
-</span><span id=__span-15-17><a id=__codelineno-15-17 name=__codelineno-15-17 href=#__codelineno-15-17></a>
-</span><span id=__span-15-18><a id=__codelineno-15-18 name=__codelineno-15-18 href=#__codelineno-15-18></a><span class=c1>// Handlers can trust data is valid (no duplicate checks needed)</span>
-</span><span id=__span-15-19><a id=__codelineno-15-19 name=__codelineno-15-19 href=#__codelineno-15-19></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>CombatEntity</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-15-20><a id=__codelineno-15-20 name=__codelineno-15-20 href=#__codelineno-15-20></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-15-21><a id=__codelineno-15-21 name=__codelineno-15-21 href=#__codelineno-15-21></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterComponentBroadcast</span><span class=o>&lt;</span><span class=n>EntityDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=k>this</span><span class=p>,</span><span class=w> </span><span class=n>OnDamaged</span><span class=p>);</span>
-</span><span id=__span-15-22><a id=__codelineno-15-22 name=__codelineno-15-22 href=#__codelineno-15-22></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-15-23><a id=__codelineno-15-23 name=__codelineno-15-23 href=#__codelineno-15-23></a>
-</span><span id=__span-15-24><a id=__codelineno-15-24 name=__codelineno-15-24 href=#__codelineno-15-24></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnDamaged</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>EntityDamaged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-15-25><a id=__codelineno-15-25 name=__codelineno-15-25 href=#__codelineno-15-25></a><span class=w>        </span><span class=c1>// No need to validate - interceptor already did it</span>
-</span><span id=__span-15-26><a id=__codelineno-15-26 name=__codelineno-15-26 href=#__codelineno-15-26></a><span class=w>        </span><span class=n>health</span><span class=w> </span><span class=o>-=</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>amount</span><span class=p>;</span>
-</span><span id=__span-15-27><a id=__codelineno-15-27 name=__codelineno-15-27 href=#__codelineno-15-27></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-15-28><a id=__codelineno-15-28 name=__codelineno-15-28 href=#__codelineno-15-28></a><span class=p>}</span>
-</span></code></pre></div> <p><strong>Scale benefit:</strong> Validation runs O(1) per message, not O(N) per handler. For 100 handlers, this saves 99 validation calls per message.</p> <h3 id=pattern-post-processing-for-analytics-at-scale>Pattern: Post-Processing for Analytics at Scale<a class=headerlink href=#pattern-post-processing-for-analytics-at-scale title="Anchor link to this section">&para;</a></h3> <p><strong>Challenge:</strong> Track metrics without polluting gameplay code.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-16-1><a id=__codelineno-16-1 name=__codelineno-16-1 href=#__codelineno-16-1></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>GameAnalytics</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-16-2><a id=__codelineno-16-2 name=__codelineno-16-2 href=#__codelineno-16-2></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-16-3><a id=__codelineno-16-3 name=__codelineno-16-3 href=#__codelineno-16-3></a><span class=w>        </span><span class=c1>// Post-processors run AFTER all handlers</span>
-</span><span id=__span-16-4><a id=__codelineno-16-4 name=__codelineno-16-4 href=#__codelineno-16-4></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterBroadcastWithoutSourcePostProcessor</span><span class=o>&lt;</span><span class=n>EntityDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>LogDamage</span><span class=p>,</span><span class=w> </span><span class=n>priority</span><span class=p>:</span><span class=w> </span><span class=mi>100</span><span class=p>);</span>
-</span><span id=__span-16-5><a id=__codelineno-16-5 name=__codelineno-16-5 href=#__codelineno-16-5></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargetedPostProcessor</span><span class=o>&lt;</span><span class=n>LevelCompleted</span><span class=o>&gt;</span><span class=p>(</span><span class=n>LogLevelComplete</span><span class=p>,</span><span class=w> </span><span class=n>priority</span><span class=p>:</span><span class=w> </span><span class=mi>100</span><span class=p>);</span>
-</span><span id=__span-16-6><a id=__codelineno-16-6 name=__codelineno-16-6 href=#__codelineno-16-6></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-16-7><a id=__codelineno-16-7 name=__codelineno-16-7 href=#__codelineno-16-7></a>
-</span><span id=__span-16-8><a id=__codelineno-16-8 name=__codelineno-16-8 href=#__codelineno-16-8></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>LogDamage</span><span class=p>(</span><span class=n>InstanceId</span><span class=w> </span><span class=n>source</span><span class=p>,</span><span class=w> </span><span class=n>EntityDamaged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-16-9><a id=__codelineno-16-9 name=__codelineno-16-9 href=#__codelineno-16-9></a><span class=w>        </span><span class=c1>// Analytics code is completely isolated from gameplay</span>
-</span><span id=__span-16-10><a id=__codelineno-16-10 name=__codelineno-16-10 href=#__codelineno-16-10></a><span class=w>        </span><span class=n>SendAnalyticsEvent</span><span class=p>(</span><span class=s>&quot;damage_dealt&quot;</span><span class=p>,</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-16-11><a id=__codelineno-16-11 name=__codelineno-16-11 href=#__codelineno-16-11></a><span class=w>            </span><span class=n>source</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>source</span><span class=p>.</span><span class=n>ToString</span><span class=p>(),</span>
-</span><span id=__span-16-12><a id=__codelineno-16-12 name=__codelineno-16-12 href=#__codelineno-16-12></a><span class=w>            </span><span class=n>amount</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>amount</span><span class=p>,</span>
-</span><span id=__span-16-13><a id=__codelineno-16-13 name=__codelineno-16-13 href=#__codelineno-16-13></a><span class=w>            </span><span class=n>type</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>damageType</span>
-</span><span id=__span-16-14><a id=__codelineno-16-14 name=__codelineno-16-14 href=#__codelineno-16-14></a><span class=w>        </span><span class=p>});</span>
-</span><span id=__span-16-15><a id=__codelineno-16-15 name=__codelineno-16-15 href=#__codelineno-16-15></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-16-16><a id=__codelineno-16-16 name=__codelineno-16-16 href=#__codelineno-16-16></a>
-</span><span id=__span-16-17><a id=__codelineno-16-17 name=__codelineno-16-17 href=#__codelineno-16-17></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>LogLevelComplete</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>LevelCompleted</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-16-18><a id=__codelineno-16-18 name=__codelineno-16-18 href=#__codelineno-16-18></a><span class=w>        </span><span class=n>SendAnalyticsEvent</span><span class=p>(</span><span class=s>&quot;level_complete&quot;</span><span class=p>,</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=n>level</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>levelIndex</span><span class=w> </span><span class=p>});</span>
-</span><span id=__span-16-19><a id=__codelineno-16-19 name=__codelineno-16-19 href=#__codelineno-16-19></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-16-20><a id=__codelineno-16-20 name=__codelineno-16-20 href=#__codelineno-16-20></a><span class=p>}</span>
-</span></code></pre></div> <p><strong>Key insight:</strong> Post-processors let you add analytics, logging, and telemetry WITHOUT touching existing handlers. Add/remove analytics system without modifying game logic.</p> <h3 id=performance-optimization-patterns-at-scale>Performance Optimization Patterns at Scale<a class=headerlink href=#performance-optimization-patterns-at-scale title="Anchor link to this section">&para;</a></h3> <h4 id=optimization-1-disable-diagnostics-in-builds>Optimization 1: Disable Diagnostics in Builds<a class=headerlink href=#optimization-1-disable-diagnostics-in-builds title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-17-1><a id=__codelineno-17-1 name=__codelineno-17-1 href=#__codelineno-17-1></a><span class=cp>#if UNITY_EDITOR</span>
-</span><span id=__span-17-2><a id=__codelineno-17-2 name=__codelineno-17-2 href=#__codelineno-17-2></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsMode</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>true</span><span class=p>;</span>
-</span><span id=__span-17-3><a id=__codelineno-17-3 name=__codelineno-17-3 href=#__codelineno-17-3></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalMessageBufferSize</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>100</span><span class=p>;</span><span class=w> </span><span class=c1>// Keep history for debugging</span>
-</span><span id=__span-17-4><a id=__codelineno-17-4 name=__codelineno-17-4 href=#__codelineno-17-4></a><span class=cp>#else</span>
-</span><span id=__span-17-5><a id=__codelineno-17-5 name=__codelineno-17-5 href=#__codelineno-17-5></a><span class=n>IMessageBus</span><span class=p>.</span><span class=n>GlobalDiagnosticsMode</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>false</span><span class=p>;</span><span class=w> </span><span class=c1>// Production builds</span>
-</span><span id=__span-17-6><a id=__codelineno-17-6 name=__codelineno-17-6 href=#__codelineno-17-6></a><span class=cp>#endif</span>
-</span></code></pre></div> <p><strong>Impact:</strong> Diagnostics adds ~5-10% overhead per message. Disable in production.</p> <h4 id=optimization-2-use-specific-registrations-over-globalacceptall>Optimization 2: Use Specific Registrations Over GlobalAcceptAll<a class=headerlink href=#optimization-2-use-specific-registrations-over-globalacceptall title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-18-1><a id=__codelineno-18-1 name=__codelineno-18-1 href=#__codelineno-18-1></a><span class=c1>// ❌ SLOW: Receives ALL messages, even irrelevant ones</span>
-</span><span id=__span-18-2><a id=__codelineno-18-2 name=__codelineno-18-2 href=#__codelineno-18-2></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterGlobalAcceptAll</span><span class=p>(</span>
-</span><span id=__span-18-3><a id=__codelineno-18-3 name=__codelineno-18-3 href=#__codelineno-18-3></a><span class=w>    </span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>IUntargetedMessage</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=cm>/* called for every untargeted */</span><span class=w> </span><span class=p>},</span>
-</span><span id=__span-18-4><a id=__codelineno-18-4 name=__codelineno-18-4 href=#__codelineno-18-4></a><span class=w>    </span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>InstanceId</span><span class=w> </span><span class=n>t</span><span class=p>,</span><span class=w> </span><span class=k>ref</span><span class=w> </span><span class=n>ITargetedMessage</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=cm>/* called for every targeted */</span><span class=w> </span><span class=p>},</span>
-</span><span id=__span-18-5><a id=__codelineno-18-5 name=__codelineno-18-5 href=#__codelineno-18-5></a><span class=w>    </span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>InstanceId</span><span class=w> </span><span class=n>s</span><span class=p>,</span><span class=w> </span><span class=k>ref</span><span class=w> </span><span class=n>IBroadcastMessage</span><span class=w> </span><span class=n>m</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=cm>/* called for every broadcast */</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-18-6><a id=__codelineno-18-6 name=__codelineno-18-6 href=#__codelineno-18-6></a><span class=p>);</span>
-</span><span id=__span-18-7><a id=__codelineno-18-7 name=__codelineno-18-7 href=#__codelineno-18-7></a>
-</span><span id=__span-18-8><a id=__codelineno-18-8 name=__codelineno-18-8 href=#__codelineno-18-8></a><span class=c1>// ✅ FAST: Only receives relevant messages</span>
-</span><span id=__span-18-9><a id=__codelineno-18-9 name=__codelineno-18-9 href=#__codelineno-18-9></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterBroadcastWithoutSource</span><span class=o>&lt;</span><span class=n>EntityDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnDamage</span><span class=p>);</span>
-</span><span id=__span-18-10><a id=__codelineno-18-10 name=__codelineno-18-10 href=#__codelineno-18-10></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>LevelCompleted</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnLevelComplete</span><span class=p>);</span>
-</span></code></pre></div> <p><strong>Impact:</strong> Specific registrations use type-indexed lookups (O(1)). GlobalAcceptAll checks every message (O(N)).</p> <h4 id=optimization-3-batch-message-emissions>Optimization 3: Batch Message Emissions<a class=headerlink href=#optimization-3-batch-message-emissions title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-19-1><a id=__codelineno-19-1 name=__codelineno-19-1 href=#__codelineno-19-1></a><span class=c1>// ❌ WASTEFUL: Emit after every tiny change</span>
-</span><span id=__span-19-2><a id=__codelineno-19-2 name=__codelineno-19-2 href=#__codelineno-19-2></a><span class=k>void</span><span class=w> </span><span class=nf>TakeDamage</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-19-3><a id=__codelineno-19-3 name=__codelineno-19-3 href=#__codelineno-19-3></a><span class=w>    </span><span class=n>health</span><span class=w> </span><span class=o>-=</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
-</span><span id=__span-19-4><a id=__codelineno-19-4 name=__codelineno-19-4 href=#__codelineno-19-4></a><span class=w>    </span><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>HealthChanged</span><span class=p>(</span><span class=n>health</span><span class=p>);</span>
-</span><span id=__span-19-5><a id=__codelineno-19-5 name=__codelineno-19-5 href=#__codelineno-19-5></a><span class=w>    </span><span class=n>msg</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span><span class=w> </span><span class=c1>// Emits every frame</span>
-</span><span id=__span-19-6><a id=__codelineno-19-6 name=__codelineno-19-6 href=#__codelineno-19-6></a><span class=p>}</span>
-</span><span id=__span-19-7><a id=__codelineno-19-7 name=__codelineno-19-7 href=#__codelineno-19-7></a>
-</span><span id=__span-19-8><a id=__codelineno-19-8 name=__codelineno-19-8 href=#__codelineno-19-8></a><span class=c1>// ✅ EFFICIENT: Batch updates, emit once per frame</span>
-</span><span id=__span-19-9><a id=__codelineno-19-9 name=__codelineno-19-9 href=#__codelineno-19-9></a><span class=k>private</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>healthDirty</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>false</span><span class=p>;</span>
-</span><span id=__span-19-10><a id=__codelineno-19-10 name=__codelineno-19-10 href=#__codelineno-19-10></a>
-</span><span id=__span-19-11><a id=__codelineno-19-11 name=__codelineno-19-11 href=#__codelineno-19-11></a><span class=k>void</span><span class=w> </span><span class=nf>TakeDamage</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-19-12><a id=__codelineno-19-12 name=__codelineno-19-12 href=#__codelineno-19-12></a><span class=w>    </span><span class=n>health</span><span class=w> </span><span class=o>-=</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
-</span><span id=__span-19-13><a id=__codelineno-19-13 name=__codelineno-19-13 href=#__codelineno-19-13></a><span class=w>    </span><span class=n>healthDirty</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>true</span><span class=p>;</span>
-</span><span id=__span-19-14><a id=__codelineno-19-14 name=__codelineno-19-14 href=#__codelineno-19-14></a><span class=p>}</span>
-</span><span id=__span-19-15><a id=__codelineno-19-15 name=__codelineno-19-15 href=#__codelineno-19-15></a>
-</span><span id=__span-19-16><a id=__codelineno-19-16 name=__codelineno-19-16 href=#__codelineno-19-16></a><span class=k>void</span><span class=w> </span><span class=nf>LateUpdate</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-19-17><a id=__codelineno-19-17 name=__codelineno-19-17 href=#__codelineno-19-17></a><span class=w>    </span><span class=k>if</span><span class=w> </span><span class=p>(</span><span class=n>healthDirty</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-19-18><a id=__codelineno-19-18 name=__codelineno-19-18 href=#__codelineno-19-18></a><span class=w>        </span><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>HealthChanged</span><span class=p>(</span><span class=n>health</span><span class=p>);</span>
-</span><span id=__span-19-19><a id=__codelineno-19-19 name=__codelineno-19-19 href=#__codelineno-19-19></a><span class=w>        </span><span class=n>msg</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span><span class=w> </span><span class=c1>// Emits once per frame max</span>
-</span><span id=__span-19-20><a id=__codelineno-19-20 name=__codelineno-19-20 href=#__codelineno-19-20></a><span class=w>        </span><span class=n>healthDirty</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>false</span><span class=p>;</span>
-</span><span id=__span-19-21><a id=__codelineno-19-21 name=__codelineno-19-21 href=#__codelineno-19-21></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-19-22><a id=__codelineno-19-22 name=__codelineno-19-22 href=#__codelineno-19-22></a><span class=p>}</span>
-</span></code></pre></div> <p><strong>Impact:</strong> Reduces message traffic by 10-100x in high-frequency scenarios.</p> <h3 id=scaling-guidelines>Scaling Guidelines<a class=headerlink href=#scaling-guidelines title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Entity Count</th> <th>Message Rate</th> <th>Recommendations</th> </tr> </thead> <tbody> <tr> <td>1-10</td> <td>Any</td> <td>Default settings fine</td> </tr> <tr> <td>10-50</td> <td>&lt;1000/sec</td> <td>Disable diagnostics in builds</td> </tr> <tr> <td>50-100</td> <td>&lt;5000/sec</td> <td>Batch emissions, avoid GlobalAcceptAll</td> </tr> <tr> <td>100-500</td> <td>&lt;10k/sec</td> <td>Use local buses for subsystems, profile carefully</td> </tr> <tr> <td>500+</td> <td>&lt;20k/sec</td> <td>Consider ECS or native code for hot paths</td> </tr> </tbody> </table> <p><strong>Rule of thumb:</strong> If you're emitting &gt;20,000 messages/second, you're likely using DxMessaging for something better suited to ECS or direct method calls.</p> <h3 id=real-world-production-example-battle-royale-game>Real-World Production Example: Battle Royale Game<a class=headerlink href=#real-world-production-example-battle-royale-game title="Anchor link to this section">&para;</a></h3> <p><strong>Scenario:</strong> 100 players, each with health/armor/weapons. UI needs to show:</p> <ul> <li>Your health/armor</li> <li>Teammate health (4 players)</li> <li>Kill feed (all 100 players)</li> <li>Match stats (damage dealt, kills, etc.)</li> </ul> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-20-1><a id=__codelineno-20-1 name=__codelineno-20-1 href=#__codelineno-20-1></a><span class=c1>// Messages</span>
-</span><span id=__span-20-2><a id=__codelineno-20-2 name=__codelineno-20-2 href=#__codelineno-20-2></a><span class=na>[DxBroadcastMessage]</span>
-</span><span id=__span-20-3><a id=__codelineno-20-3 name=__codelineno-20-3 href=#__codelineno-20-3></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-20-4><a id=__codelineno-20-4 name=__codelineno-20-4 href=#__codelineno-20-4></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>PlayerDamaged</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-5><a id=__codelineno-20-5 name=__codelineno-20-5 href=#__codelineno-20-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>playerId</span><span class=p>;</span>
-</span><span id=__span-20-6><a id=__codelineno-20-6 name=__codelineno-20-6 href=#__codelineno-20-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>newHealth</span><span class=p>;</span>
-</span><span id=__span-20-7><a id=__codelineno-20-7 name=__codelineno-20-7 href=#__codelineno-20-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>newArmor</span><span class=p>;</span>
-</span><span id=__span-20-8><a id=__codelineno-20-8 name=__codelineno-20-8 href=#__codelineno-20-8></a><span class=p>}</span>
-</span><span id=__span-20-9><a id=__codelineno-20-9 name=__codelineno-20-9 href=#__codelineno-20-9></a>
-</span><span id=__span-20-10><a id=__codelineno-20-10 name=__codelineno-20-10 href=#__codelineno-20-10></a><span class=na>[DxBroadcastMessage]</span>
-</span><span id=__span-20-11><a id=__codelineno-20-11 name=__codelineno-20-11 href=#__codelineno-20-11></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-20-12><a id=__codelineno-20-12 name=__codelineno-20-12 href=#__codelineno-20-12></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>PlayerKilled</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-13><a id=__codelineno-20-13 name=__codelineno-20-13 href=#__codelineno-20-13></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>victimId</span><span class=p>;</span>
-</span><span id=__span-20-14><a id=__codelineno-20-14 name=__codelineno-20-14 href=#__codelineno-20-14></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>killerId</span><span class=p>;</span>
-</span><span id=__span-20-15><a id=__codelineno-20-15 name=__codelineno-20-15 href=#__codelineno-20-15></a><span class=p>}</span>
-</span><span id=__span-20-16><a id=__codelineno-20-16 name=__codelineno-20-16 href=#__codelineno-20-16></a>
-</span><span id=__span-20-17><a id=__codelineno-20-17 name=__codelineno-20-17 href=#__codelineno-20-17></a><span class=c1>// YOUR health bar (targeted observation)</span>
-</span><span id=__span-20-18><a id=__codelineno-20-18 name=__codelineno-20-18 href=#__codelineno-20-18></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>SelfHealthUI</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-19><a id=__codelineno-20-19 name=__codelineno-20-19 href=#__codelineno-20-19></a><span class=w>    </span><span class=na>[SerializeField]</span><span class=w> </span><span class=k>private</span><span class=w> </span><span class=n>GameObject</span><span class=w> </span><span class=n>localPlayerObject</span><span class=p>;</span>
-</span><span id=__span-20-20><a id=__codelineno-20-20 name=__codelineno-20-20 href=#__codelineno-20-20></a>
-</span><span id=__span-20-21><a id=__codelineno-20-21 name=__codelineno-20-21 href=#__codelineno-20-21></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-22><a id=__codelineno-20-22 name=__codelineno-20-22 href=#__codelineno-20-22></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterGameObjectBroadcast</span><span class=o>&lt;</span><span class=n>PlayerDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>localPlayerObject</span><span class=p>,</span><span class=w> </span><span class=n>OnDamage</span><span class=p>);</span>
-</span><span id=__span-20-23><a id=__codelineno-20-23 name=__codelineno-20-23 href=#__codelineno-20-23></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-20-24><a id=__codelineno-20-24 name=__codelineno-20-24 href=#__codelineno-20-24></a>
-</span><span id=__span-20-25><a id=__codelineno-20-25 name=__codelineno-20-25 href=#__codelineno-20-25></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnDamage</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>PlayerDamaged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>UpdateHealthBar</span><span class=p>(</span><span class=n>msg</span><span class=p>.</span><span class=n>newHealth</span><span class=p>,</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>newArmor</span><span class=p>);</span>
-</span><span id=__span-20-26><a id=__codelineno-20-26 name=__codelineno-20-26 href=#__codelineno-20-26></a><span class=p>}</span>
-</span><span id=__span-20-27><a id=__codelineno-20-27 name=__codelineno-20-27 href=#__codelineno-20-27></a>
-</span><span id=__span-20-28><a id=__codelineno-20-28 name=__codelineno-20-28 href=#__codelineno-20-28></a><span class=c1>// TEAMMATE health bars (selective observation)</span>
-</span><span id=__span-20-29><a id=__codelineno-20-29 name=__codelineno-20-29 href=#__codelineno-20-29></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>TeamHealthUI</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-30><a id=__codelineno-20-30 name=__codelineno-20-30 href=#__codelineno-20-30></a><span class=w>    </span><span class=na>[SerializeField]</span><span class=w> </span><span class=k>private</span><span class=w> </span><span class=n>List</span><span class=o>&lt;</span><span class=n>GameObject</span><span class=o>&gt;</span><span class=w> </span><span class=n>teammateObjects</span><span class=p>;</span>
-</span><span id=__span-20-31><a id=__codelineno-20-31 name=__codelineno-20-31 href=#__codelineno-20-31></a>
-</span><span id=__span-20-32><a id=__codelineno-20-32 name=__codelineno-20-32 href=#__codelineno-20-32></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-33><a id=__codelineno-20-33 name=__codelineno-20-33 href=#__codelineno-20-33></a><span class=w>        </span><span class=k>foreach</span><span class=w> </span><span class=p>(</span><span class=kt>var</span><span class=w> </span><span class=n>teammate</span><span class=w> </span><span class=k>in</span><span class=w> </span><span class=n>teammateObjects</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-34><a id=__codelineno-20-34 name=__codelineno-20-34 href=#__codelineno-20-34></a><span class=w>            </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterGameObjectBroadcast</span><span class=o>&lt;</span><span class=n>PlayerDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>teammate</span><span class=p>,</span><span class=w> </span><span class=n>OnTeammateDamage</span><span class=p>);</span>
-</span><span id=__span-20-35><a id=__codelineno-20-35 name=__codelineno-20-35 href=#__codelineno-20-35></a><span class=w>        </span><span class=p>}</span>
-</span><span id=__span-20-36><a id=__codelineno-20-36 name=__codelineno-20-36 href=#__codelineno-20-36></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-20-37><a id=__codelineno-20-37 name=__codelineno-20-37 href=#__codelineno-20-37></a>
-</span><span id=__span-20-38><a id=__codelineno-20-38 name=__codelineno-20-38 href=#__codelineno-20-38></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnTeammateDamage</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>PlayerDamaged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>UpdateTeammateBar</span><span class=p>(</span><span class=n>msg</span><span class=p>.</span><span class=n>playerId</span><span class=p>,</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>newHealth</span><span class=p>);</span>
-</span><span id=__span-20-39><a id=__codelineno-20-39 name=__codelineno-20-39 href=#__codelineno-20-39></a><span class=p>}</span>
-</span><span id=__span-20-40><a id=__codelineno-20-40 name=__codelineno-20-40 href=#__codelineno-20-40></a>
-</span><span id=__span-20-41><a id=__codelineno-20-41 name=__codelineno-20-41 href=#__codelineno-20-41></a><span class=c1>// KILL FEED (global observation)</span>
-</span><span id=__span-20-42><a id=__codelineno-20-42 name=__codelineno-20-42 href=#__codelineno-20-42></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>KillFeedUI</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-43><a id=__codelineno-20-43 name=__codelineno-20-43 href=#__codelineno-20-43></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-44><a id=__codelineno-20-44 name=__codelineno-20-44 href=#__codelineno-20-44></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterBroadcastWithoutSource</span><span class=o>&lt;</span><span class=n>PlayerKilled</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnAnyKill</span><span class=p>);</span>
-</span><span id=__span-20-45><a id=__codelineno-20-45 name=__codelineno-20-45 href=#__codelineno-20-45></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-20-46><a id=__codelineno-20-46 name=__codelineno-20-46 href=#__codelineno-20-46></a>
-</span><span id=__span-20-47><a id=__codelineno-20-47 name=__codelineno-20-47 href=#__codelineno-20-47></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnAnyKill</span><span class=p>(</span><span class=n>InstanceId</span><span class=w> </span><span class=n>source</span><span class=p>,</span><span class=w> </span><span class=n>PlayerKilled</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-48><a id=__codelineno-20-48 name=__codelineno-20-48 href=#__codelineno-20-48></a><span class=w>        </span><span class=n>ShowKillFeedEntry</span><span class=p>(</span><span class=n>msg</span><span class=p>.</span><span class=n>killerId</span><span class=p>,</span><span class=w> </span><span class=n>msg</span><span class=p>.</span><span class=n>victimId</span><span class=p>);</span>
-</span><span id=__span-20-49><a id=__codelineno-20-49 name=__codelineno-20-49 href=#__codelineno-20-49></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-20-50><a id=__codelineno-20-50 name=__codelineno-20-50 href=#__codelineno-20-50></a><span class=p>}</span>
-</span><span id=__span-20-51><a id=__codelineno-20-51 name=__codelineno-20-51 href=#__codelineno-20-51></a>
-</span><span id=__span-20-52><a id=__codelineno-20-52 name=__codelineno-20-52 href=#__codelineno-20-52></a><span class=c1>// MATCH STATS (analytics)</span>
-</span><span id=__span-20-53><a id=__codelineno-20-53 name=__codelineno-20-53 href=#__codelineno-20-53></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>MatchStats</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-54><a id=__codelineno-20-54 name=__codelineno-20-54 href=#__codelineno-20-54></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=n>Dictionary</span><span class=o>&lt;</span><span class=kt>int</span><span class=p>,</span><span class=w> </span><span class=kt>int</span><span class=o>&gt;</span><span class=w> </span><span class=n>damageByPlayer</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=p>();</span>
-</span><span id=__span-20-55><a id=__codelineno-20-55 name=__codelineno-20-55 href=#__codelineno-20-55></a>
-</span><span id=__span-20-56><a id=__codelineno-20-56 name=__codelineno-20-56 href=#__codelineno-20-56></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-57><a id=__codelineno-20-57 name=__codelineno-20-57 href=#__codelineno-20-57></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterBroadcastWithoutSourcePostProcessor</span><span class=o>&lt;</span><span class=n>PlayerDamaged</span><span class=o>&gt;</span><span class=p>(</span><span class=n>TrackDamage</span><span class=p>);</span>
-</span><span id=__span-20-58><a id=__codelineno-20-58 name=__codelineno-20-58 href=#__codelineno-20-58></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-20-59><a id=__codelineno-20-59 name=__codelineno-20-59 href=#__codelineno-20-59></a>
-</span><span id=__span-20-60><a id=__codelineno-20-60 name=__codelineno-20-60 href=#__codelineno-20-60></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>TrackDamage</span><span class=p>(</span><span class=n>InstanceId</span><span class=w> </span><span class=n>source</span><span class=p>,</span><span class=w> </span><span class=n>PlayerDamaged</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-20-61><a id=__codelineno-20-61 name=__codelineno-20-61 href=#__codelineno-20-61></a><span class=w>        </span><span class=c1>// Track for post-game stats</span>
-</span><span id=__span-20-62><a id=__codelineno-20-62 name=__codelineno-20-62 href=#__codelineno-20-62></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-20-63><a id=__codelineno-20-63 name=__codelineno-20-63 href=#__codelineno-20-63></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=key-insights>Key insights<a class=headerlink href=#key-insights title="Anchor link to this section">&para;</a></h4> <ul> <li>Self health UI: 1 registration, receives ~10 messages/sec</li> <li>Team health UI: 4 registrations, receives ~40 messages/sec</li> <li>Kill feed UI: 1 registration, receives ALL kills (~5 messages/sec)</li> <li>Match stats: Post-processor, doesn't affect gameplay latency</li> </ul> <p><strong>Total:</strong> ~100 players × 10 damage/sec = 1000 messages/sec. DxMessaging handles this with negligible overhead (~0.06ms/frame).</p> <hr> <p><strong>Summary:</strong> DxMessaging scales from small prototypes to large production games. Use targeted observation for specific entities, global observation for analytics, and post-processors for metrics. Disable diagnostics in production and batch emissions for optimal performance.</p> <hr> <h2 id=14-compatibility-with-scriptable-object-architecture-soa>14) Compatibility with Scriptable Object Architecture (SOA)<a class=headerlink href=#14-compatibility-with-scriptable-object-architecture-soa title="Anchor link to this section">&para;</a></h2> <p><strong>Note:</strong> Scriptable Object Architecture (SOA) is a debated pattern in the Unity community. It has both proponents who value its designer-friendly workflow and critics who raise concerns about scalability and maintainability. See <a href=https://github.com/cathei/AntiScriptableObjectArchitecture>Anti-ScriptableObject Architecture</a> for one perspective on the criticisms. Teams should evaluate SOA based on their specific needs. Alternatives include dependency injection (Zenject, VContainer), reactive systems (UniRx), or messaging systems (DxMessaging, MessagePipe).</p> <p>That said, if your project uses or requires SOA, DxMessaging can work alongside it.</p> <h3 id=what-is-scriptable-object-architecture>What is Scriptable Object Architecture?<a class=headerlink href=#what-is-scriptable-object-architecture title="Anchor link to this section">&para;</a></h3> <p><strong>SOA Background:</strong> Popularized by Ryan Hipple's <a href="https://www.youtube.com/watch?v=raQ3iHhE_Kk">Unite Austin 2017 talk</a>, SOA uses ScriptableObject assets as:</p> <ol> <li><strong>Shared Variables</strong> - <code>FloatVariable</code>, <code>IntVariable</code>, etc. (ScriptableObject assets that hold runtime state)</li> <li><strong>Event Channels</strong> - <code>GameEvent</code> + <code>GameEventListener</code> pattern (designer-created events)</li> <li><strong>Runtime Sets</strong> - Collections of active game objects (e.g., all enemies)</li> </ol> <p><strong>Core idea:</strong> Systems communicate through serialized SO assets instead of direct references.</p> <h4 id=key-resources>Key resources<a class=headerlink href=#key-resources title="Anchor link to this section">&para;</a></h4> <ul> <li><a href="https://www.youtube.com/watch?v=raQ3iHhE_Kk">Unite 2017 Talk by Ryan Hipple</a></li> <li><a href=https://unity.com/how-to/architect-game-code-scriptable-objects>Official Unity Guide</a></li> <li><a href=https://github.com/roboryantron/Unite2017>Reference Implementation</a></li> <li><a href=https://github.com/DanielEverland/ScriptableObject-Architecture>Community Package</a></li> </ul> <h3 id=why-soa-is-controversial>Why SOA is Controversial<a class=headerlink href=#why-soa-is-controversial title="Anchor link to this section">&para;</a></h3> <p>From <a href=https://github.com/cathei/AntiScriptableObjectArchitecture>Anti-ScriptableObject Architecture</a>, key criticisms include:</p> <ol> <li><strong>Wrong Purpose</strong> - ScriptableObjects are designed for immutable design data, not runtime mutable state</li> <li><strong>Redundant Complexity</strong> - Standard C# objects achieve the same goals without SO restrictions</li> <li><strong>Inspector Dependency</strong> - Binds architecture to Unity's GUI, complicating debugging and maintenance</li> <li><strong>Limited Scalability</strong> - Runtime-created variables undermine the pattern; managing numerous assets becomes unwieldy</li> <li><strong>Domain Reload Issues</strong> - Disabled domain reloading causes ScriptableObjects to retain values unpredictably</li> <li><strong>Testability Concerns</strong> - SO assets persist between tests, requiring manual cleanup</li> </ol> <h4 id=recommended-alternatives>Recommended alternatives<a class=headerlink href=#recommended-alternatives title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Dependency Injection</strong> - Zenject, VContainer, Reflex (see <a href=../../integrations/ >DxMessaging DI Integrations</a>)</li> <li><strong>Reactive Systems</strong> - UniRx, UniTask</li> <li><strong>Messaging</strong> - DxMessaging (this framework), MessagePipe</li> <li><strong>Configuration Data</strong> - Spreadsheet-based solutions (e.g., BakingSheet)</li> </ul> <p>Use ScriptableObjects for their intended purpose: <strong>immutable design-time data</strong> (configs, balance tables, prefab references).</p> <h3 id=can-dxmessaging-work-with-soa>Can DxMessaging Work with SOA?<a class=headerlink href=#can-dxmessaging-work-with-soa title="Anchor link to this section">&para;</a></h3> <p><strong>Yes, but with caveats.</strong> DxMessaging and SOA solve similar problems (decoupling, communication) with different philosophies:</p> <table> <thead> <tr> <th>Aspect</th> <th>SOA</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Paradigm</strong></td> <td>Asset-based, persistent state</td> <td>Runtime message passing, transient</td> </tr> <tr> <td><strong>Designer-Centric</strong></td> <td>✅ High (create events in Inspector)</td> <td>❌ Low (code-driven)</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>⚠️ Mixed (SO refs typed, but UnityEvent inspector wiring loses compile-time safety)</td> <td>✅ Strong (compile-time validation)</td> </tr> <tr> <td><strong>Lifecycle</strong></td> <td>⚠️ Manual (SO assets persist)</td> <td>✅ Automatic (tokens clean up)</td> </tr> <tr> <td><strong>Debugging</strong></td> <td>⚠️ Inspector-dependent</td> <td>✅ Built-in diagnostics</td> </tr> <tr> <td><strong>Performance</strong></td> <td>⚠️ List iteration, UnityAction overhead</td> <td>✅ Zero-allocation structs</td> </tr> <tr> <td><strong>Use Case</strong></td> <td>Shared state, designer-driven configs</td> <td>Event-driven communication, runtime logic</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⚠️ Requires SO asset cleanup</td> <td>✅ Isolated buses per test</td> </tr> </tbody> </table> <p><strong>Summary:</strong> For new projects, evaluate DxMessaging, DI frameworks, or other messaging approaches based on your needs. If you have existing SOA code, the patterns below show coexistence strategies.</p> <h3 id=pattern-overview>Pattern Overview<a class=headerlink href=#pattern-overview title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Pattern</th> <th>What it shows</th> <th>When to use</th> <th>SOA involvement</th> </tr> </thead> <tbody> <tr> <td><strong>A</strong></td> <td>SOA Events (GameEvent) forwarding to DxMessaging</td> <td>Designer-created event assets, modern code downstream</td> <td>✅ Yes - SOA Event pattern</td> </tr> <tr> <td><strong>B</strong></td> <td>ScriptableObjects for configs + DxMessaging for events</td> <td>New projects / best practice</td> <td>❌ No - proper SO usage only</td> </tr> </tbody> </table> <h3 id=pattern-a-soa--dxmessaging-event-forwarding>Pattern A: SOA → DxMessaging (Event Forwarding)<a class=headerlink href=#pattern-a-soa--dxmessaging-event-forwarding title="Anchor link to this section">&para;</a></h3> <p><strong>Use case:</strong> Designer-created SOA events, but you want DxMessaging benefits downstream.</p> <p><strong>Strategy:</strong> SOA GameEventListener forwards to DxMessaging.</p> <blockquote> <p><strong>This uses the SOA GameEvent pattern:</strong> If you're NOT using designer-created GameEvent assets with <code>Raise()</code>/listener management, you don't need this pattern. For immutable config data, see Pattern B instead.</p> </blockquote> <h4 id=example-scene-transitions>Example: Scene Transitions<a class=headerlink href=#example-scene-transitions title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-21-1><a id=__codelineno-21-1 name=__codelineno-21-1 href=#__codelineno-21-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Messages</span><span class=p>;</span>
-</span><span id=__span-21-2><a id=__codelineno-21-2 name=__codelineno-21-2 href=#__codelineno-21-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Attributes</span><span class=p>;</span>
-</span><span id=__span-21-3><a id=__codelineno-21-3 name=__codelineno-21-3 href=#__codelineno-21-3></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Extensions</span><span class=p>;</span>
-</span><span id=__span-21-4><a id=__codelineno-21-4 name=__codelineno-21-4 href=#__codelineno-21-4></a><span class=k>using</span><span class=w> </span><span class=nn>UnityEngine</span><span class=p>;</span>
-</span><span id=__span-21-5><a id=__codelineno-21-5 name=__codelineno-21-5 href=#__codelineno-21-5></a><span class=k>using</span><span class=w> </span><span class=nn>UnityEngine.Events</span><span class=p>;</span>
-</span><span id=__span-21-6><a id=__codelineno-21-6 name=__codelineno-21-6 href=#__codelineno-21-6></a>
-</span><span id=__span-21-7><a id=__codelineno-21-7 name=__codelineno-21-7 href=#__codelineno-21-7></a><span class=c1>// Traditional SOA event</span>
-</span><span id=__span-21-8><a id=__codelineno-21-8 name=__codelineno-21-8 href=#__codelineno-21-8></a><span class=na>[CreateAssetMenu(menuName = &quot;Events/Game Event&quot;)]</span>
-</span><span id=__span-21-9><a id=__codelineno-21-9 name=__codelineno-21-9 href=#__codelineno-21-9></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>GameEvent</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>ScriptableObject</span>
-</span><span id=__span-21-10><a id=__codelineno-21-10 name=__codelineno-21-10 href=#__codelineno-21-10></a><span class=p>{</span>
-</span><span id=__span-21-11><a id=__codelineno-21-11 name=__codelineno-21-11 href=#__codelineno-21-11></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>List</span><span class=o>&lt;</span><span class=n>UnityAction</span><span class=o>&gt;</span><span class=w> </span><span class=n>listeners</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=p>();</span>
-</span><span id=__span-21-12><a id=__codelineno-21-12 name=__codelineno-21-12 href=#__codelineno-21-12></a>
-</span><span id=__span-21-13><a id=__codelineno-21-13 name=__codelineno-21-13 href=#__codelineno-21-13></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>Raise</span><span class=p>()</span>
-</span><span id=__span-21-14><a id=__codelineno-21-14 name=__codelineno-21-14 href=#__codelineno-21-14></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-21-15><a id=__codelineno-21-15 name=__codelineno-21-15 href=#__codelineno-21-15></a><span class=w>        </span><span class=k>for</span><span class=w> </span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>i</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>listeners</span><span class=p>.</span><span class=n>Count</span><span class=w> </span><span class=o>-</span><span class=w> </span><span class=mi>1</span><span class=p>;</span><span class=w> </span><span class=n>i</span><span class=w> </span><span class=o>&gt;=</span><span class=w> </span><span class=mi>0</span><span class=p>;</span><span class=w> </span><span class=n>i</span><span class=o>--</span><span class=p>)</span>
-</span><span id=__span-21-16><a id=__codelineno-21-16 name=__codelineno-21-16 href=#__codelineno-21-16></a><span class=w>            </span><span class=n>listeners</span><span class=p>[</span><span class=n>i</span><span class=p>]</span><span class=o>?.</span><span class=n>Invoke</span><span class=p>();</span>
-</span><span id=__span-21-17><a id=__codelineno-21-17 name=__codelineno-21-17 href=#__codelineno-21-17></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-21-18><a id=__codelineno-21-18 name=__codelineno-21-18 href=#__codelineno-21-18></a>
-</span><span id=__span-21-19><a id=__codelineno-21-19 name=__codelineno-21-19 href=#__codelineno-21-19></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterListener</span><span class=p>(</span><span class=n>UnityAction</span><span class=w> </span><span class=n>listener</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>listeners</span><span class=p>.</span><span class=n>Add</span><span class=p>(</span><span class=n>listener</span><span class=p>);</span>
-</span><span id=__span-21-20><a id=__codelineno-21-20 name=__codelineno-21-20 href=#__codelineno-21-20></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>UnregisterListener</span><span class=p>(</span><span class=n>UnityAction</span><span class=w> </span><span class=n>listener</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>listeners</span><span class=p>.</span><span class=n>Remove</span><span class=p>(</span><span class=n>listener</span><span class=p>);</span>
-</span><span id=__span-21-21><a id=__codelineno-21-21 name=__codelineno-21-21 href=#__codelineno-21-21></a><span class=p>}</span>
-</span><span id=__span-21-22><a id=__codelineno-21-22 name=__codelineno-21-22 href=#__codelineno-21-22></a>
-</span><span id=__span-21-23><a id=__codelineno-21-23 name=__codelineno-21-23 href=#__codelineno-21-23></a><span class=c1>// DxMessaging message (modern, type-safe)</span>
-</span><span id=__span-21-24><a id=__codelineno-21-24 name=__codelineno-21-24 href=#__codelineno-21-24></a><span class=na>[DxUntargetedMessage]</span>
-</span><span id=__span-21-25><a id=__codelineno-21-25 name=__codelineno-21-25 href=#__codelineno-21-25></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>SceneTransitionRequested</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-21-26><a id=__codelineno-21-26 name=__codelineno-21-26 href=#__codelineno-21-26></a>
-</span><span id=__span-21-27><a id=__codelineno-21-27 name=__codelineno-21-27 href=#__codelineno-21-27></a><span class=c1>// Bridge: SOA Event → DxMessaging</span>
-</span><span id=__span-21-28><a id=__codelineno-21-28 name=__codelineno-21-28 href=#__codelineno-21-28></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>SOAEventBridge</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-21-29><a id=__codelineno-21-29 name=__codelineno-21-29 href=#__codelineno-21-29></a><span class=p>{</span>
-</span><span id=__span-21-30><a id=__codelineno-21-30 name=__codelineno-21-30 href=#__codelineno-21-30></a><span class=w>    </span><span class=na>[SerializeField]</span><span class=w> </span><span class=k>private</span><span class=w> </span><span class=n>GameEvent</span><span class=w> </span><span class=n>onSceneTransitionSO</span><span class=p>;</span><span class=w> </span><span class=c1>// Designer-created asset</span>
-</span><span id=__span-21-31><a id=__codelineno-21-31 name=__codelineno-21-31 href=#__codelineno-21-31></a>
-</span><span id=__span-21-32><a id=__codelineno-21-32 name=__codelineno-21-32 href=#__codelineno-21-32></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnEnable</span><span class=p>()</span>
-</span><span id=__span-21-33><a id=__codelineno-21-33 name=__codelineno-21-33 href=#__codelineno-21-33></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-21-34><a id=__codelineno-21-34 name=__codelineno-21-34 href=#__codelineno-21-34></a><span class=w>        </span><span class=n>onSceneTransitionSO</span><span class=p>.</span><span class=n>RegisterListener</span><span class=p>(</span><span class=n>OnSOAEvent</span><span class=p>);</span>
-</span><span id=__span-21-35><a id=__codelineno-21-35 name=__codelineno-21-35 href=#__codelineno-21-35></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-21-36><a id=__codelineno-21-36 name=__codelineno-21-36 href=#__codelineno-21-36></a>
-</span><span id=__span-21-37><a id=__codelineno-21-37 name=__codelineno-21-37 href=#__codelineno-21-37></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnDisable</span><span class=p>()</span>
-</span><span id=__span-21-38><a id=__codelineno-21-38 name=__codelineno-21-38 href=#__codelineno-21-38></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-21-39><a id=__codelineno-21-39 name=__codelineno-21-39 href=#__codelineno-21-39></a><span class=w>        </span><span class=n>onSceneTransitionSO</span><span class=p>.</span><span class=n>UnregisterListener</span><span class=p>(</span><span class=n>OnSOAEvent</span><span class=p>);</span>
-</span><span id=__span-21-40><a id=__codelineno-21-40 name=__codelineno-21-40 href=#__codelineno-21-40></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-21-41><a id=__codelineno-21-41 name=__codelineno-21-41 href=#__codelineno-21-41></a>
-</span><span id=__span-21-42><a id=__codelineno-21-42 name=__codelineno-21-42 href=#__codelineno-21-42></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnSOAEvent</span><span class=p>()</span>
-</span><span id=__span-21-43><a id=__codelineno-21-43 name=__codelineno-21-43 href=#__codelineno-21-43></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-21-44><a id=__codelineno-21-44 name=__codelineno-21-44 href=#__codelineno-21-44></a><span class=w>        </span><span class=c1>// Forward to DxMessaging</span>
-</span><span id=__span-21-45><a id=__codelineno-21-45 name=__codelineno-21-45 href=#__codelineno-21-45></a><span class=w>        </span><span class=kt>var</span><span class=w> </span><span class=n>message</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SceneTransitionRequested</span><span class=p>();</span>
-</span><span id=__span-21-46><a id=__codelineno-21-46 name=__codelineno-21-46 href=#__codelineno-21-46></a><span class=w>        </span><span class=n>message</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span>
-</span><span id=__span-21-47><a id=__codelineno-21-47 name=__codelineno-21-47 href=#__codelineno-21-47></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-21-48><a id=__codelineno-21-48 name=__codelineno-21-48 href=#__codelineno-21-48></a><span class=p>}</span>
-</span><span id=__span-21-49><a id=__codelineno-21-49 name=__codelineno-21-49 href=#__codelineno-21-49></a>
-</span><span id=__span-21-50><a id=__codelineno-21-50 name=__codelineno-21-50 href=#__codelineno-21-50></a><span class=c1>// Modern DxMessaging listeners (no SO dependency)</span>
-</span><span id=__span-21-51><a id=__codelineno-21-51 name=__codelineno-21-51 href=#__codelineno-21-51></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>AudioSystem</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span>
-</span><span id=__span-21-52><a id=__codelineno-21-52 name=__codelineno-21-52 href=#__codelineno-21-52></a><span class=p>{</span>
-</span><span id=__span-21-53><a id=__codelineno-21-53 name=__codelineno-21-53 href=#__codelineno-21-53></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span>
-</span><span id=__span-21-54><a id=__codelineno-21-54 name=__codelineno-21-54 href=#__codelineno-21-54></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-21-55><a id=__codelineno-21-55 name=__codelineno-21-55 href=#__codelineno-21-55></a><span class=w>        </span><span class=k>base</span><span class=p>.</span><span class=n>RegisterMessageHandlers</span><span class=p>();</span>
-</span><span id=__span-21-56><a id=__codelineno-21-56 name=__codelineno-21-56 href=#__codelineno-21-56></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>SceneTransitionRequested</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnTransition</span><span class=p>);</span>
-</span><span id=__span-21-57><a id=__codelineno-21-57 name=__codelineno-21-57 href=#__codelineno-21-57></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-21-58><a id=__codelineno-21-58 name=__codelineno-21-58 href=#__codelineno-21-58></a>
-</span><span id=__span-21-59><a id=__codelineno-21-59 name=__codelineno-21-59 href=#__codelineno-21-59></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnTransition</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>SceneTransitionRequested</span><span class=w> </span><span class=n>msg</span><span class=p>)</span>
-</span><span id=__span-21-60><a id=__codelineno-21-60 name=__codelineno-21-60 href=#__codelineno-21-60></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-21-61><a id=__codelineno-21-61 name=__codelineno-21-61 href=#__codelineno-21-61></a><span class=w>        </span><span class=n>FadeOutMusic</span><span class=p>();</span><span class=w> </span><span class=c1>// Type-safe, debuggable via DxMessaging Inspector</span>
-</span><span id=__span-21-62><a id=__codelineno-21-62 name=__codelineno-21-62 href=#__codelineno-21-62></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-21-63><a id=__codelineno-21-63 name=__codelineno-21-63 href=#__codelineno-21-63></a><span class=p>}</span>
-</span></code></pre></div> <h5 id=benefits>Benefits<a class=headerlink href=#benefits title="Anchor link to this section">&para;</a></h5> <ul> <li>✅ Designers create events in Inspector (SOA workflow preserved)</li> <li>✅ Code uses DxMessaging (type-safe, lifecycle-safe)</li> </ul> <h6 id=drawbacks>Drawbacks<a class=headerlink href=#drawbacks title="Anchor link to this section">&para;</a></h6> <ul> <li>⚠️ Bridge boilerplate for each SOA event</li> <li>⚠️ Double registration (SOA listener + DxMessaging handler)</li> </ul> <h3 id=pattern-b-proper-scriptableobject-usage-recommended>Pattern B: Proper ScriptableObject Usage (Recommended)<a class=headerlink href=#pattern-b-proper-scriptableobject-usage-recommended title="Anchor link to this section">&para;</a></h3> <p><strong>Use case:</strong> ScriptableObjects for immutable config data, DxMessaging for runtime events.</p> <p><strong>Strategy:</strong> Use each tool for its intended purpose; avoid bridging.</p> <blockquote> <p><strong>Important:</strong> This pattern uses ScriptableObjects CORRECTLY (immutable design data), NOT as SOA (mutable runtime state). This is standard Unity best practice, not SOA. If you're only using SOs for config data like this, you don't need SOA patterns at all.</p> </blockquote> <h4 id=example-combat-with-designer-tunable-data>Example: Combat with Designer-Tunable Data<a class=headerlink href=#example-combat-with-designer-tunable-data title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-22-1><a id=__codelineno-22-1 name=__codelineno-22-1 href=#__codelineno-22-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Messages</span><span class=p>;</span>
-</span><span id=__span-22-2><a id=__codelineno-22-2 name=__codelineno-22-2 href=#__codelineno-22-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Attributes</span><span class=p>;</span>
-</span><span id=__span-22-3><a id=__codelineno-22-3 name=__codelineno-22-3 href=#__codelineno-22-3></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Unity</span><span class=p>;</span>
-</span><span id=__span-22-4><a id=__codelineno-22-4 name=__codelineno-22-4 href=#__codelineno-22-4></a><span class=k>using</span><span class=w> </span><span class=nn>UnityEngine</span><span class=p>;</span>
-</span><span id=__span-22-5><a id=__codelineno-22-5 name=__codelineno-22-5 href=#__codelineno-22-5></a>
-</span><span id=__span-22-6><a id=__codelineno-22-6 name=__codelineno-22-6 href=#__codelineno-22-6></a><span class=c1>// ScriptableObject: Designer-tunable balance data (immutable at runtime)</span>
-</span><span id=__span-22-7><a id=__codelineno-22-7 name=__codelineno-22-7 href=#__codelineno-22-7></a><span class=c1>// This is CORRECT SO usage, NOT SOA</span>
-</span><span id=__span-22-8><a id=__codelineno-22-8 name=__codelineno-22-8 href=#__codelineno-22-8></a><span class=na>[CreateAssetMenu(menuName = &quot;Config/Weapon Stats&quot;)]</span>
-</span><span id=__span-22-9><a id=__codelineno-22-9 name=__codelineno-22-9 href=#__codelineno-22-9></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>WeaponStats</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>ScriptableObject</span>
-</span><span id=__span-22-10><a id=__codelineno-22-10 name=__codelineno-22-10 href=#__codelineno-22-10></a><span class=p>{</span>
-</span><span id=__span-22-11><a id=__codelineno-22-11 name=__codelineno-22-11 href=#__codelineno-22-11></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>baseDamage</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>10</span><span class=p>;</span><span class=w>      </span><span class=c1>// Designer tweaks in Inspector</span>
-</span><span id=__span-22-12><a id=__codelineno-22-12 name=__codelineno-22-12 href=#__codelineno-22-12></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>critMultiplier</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mf>2f</span><span class=p>;</span>
-</span><span id=__span-22-13><a id=__codelineno-22-13 name=__codelineno-22-13 href=#__codelineno-22-13></a><span class=p>}</span>
-</span><span id=__span-22-14><a id=__codelineno-22-14 name=__codelineno-22-14 href=#__codelineno-22-14></a>
-</span><span id=__span-22-15><a id=__codelineno-22-15 name=__codelineno-22-15 href=#__codelineno-22-15></a><span class=c1>// DxMessaging: Runtime event (code-driven)</span>
-</span><span id=__span-22-16><a id=__codelineno-22-16 name=__codelineno-22-16 href=#__codelineno-22-16></a><span class=na>[DxBroadcastMessage]</span>
-</span><span id=__span-22-17><a id=__codelineno-22-17 name=__codelineno-22-17 href=#__codelineno-22-17></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-22-18><a id=__codelineno-22-18 name=__codelineno-22-18 href=#__codelineno-22-18></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>DamageDealt</span>
-</span><span id=__span-22-19><a id=__codelineno-22-19 name=__codelineno-22-19 href=#__codelineno-22-19></a><span class=p>{</span>
-</span><span id=__span-22-20><a id=__codelineno-22-20 name=__codelineno-22-20 href=#__codelineno-22-20></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
-</span><span id=__span-22-21><a id=__codelineno-22-21 name=__codelineno-22-21 href=#__codelineno-22-21></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>wasCrit</span><span class=p>;</span>
-</span><span id=__span-22-22><a id=__codelineno-22-22 name=__codelineno-22-22 href=#__codelineno-22-22></a><span class=p>}</span>
-</span><span id=__span-22-23><a id=__codelineno-22-23 name=__codelineno-22-23 href=#__codelineno-22-23></a>
-</span><span id=__span-22-24><a id=__codelineno-22-24 name=__codelineno-22-24 href=#__codelineno-22-24></a><span class=c1>// Combat system: Reads immutable SO data, emits DxMessaging events</span>
-</span><span id=__span-22-25><a id=__codelineno-22-25 name=__codelineno-22-25 href=#__codelineno-22-25></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>Weapon</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span>
-</span><span id=__span-22-26><a id=__codelineno-22-26 name=__codelineno-22-26 href=#__codelineno-22-26></a><span class=p>{</span>
-</span><span id=__span-22-27><a id=__codelineno-22-27 name=__codelineno-22-27 href=#__codelineno-22-27></a><span class=w>    </span><span class=na>[SerializeField]</span><span class=w> </span><span class=k>private</span><span class=w> </span><span class=n>WeaponStats</span><span class=w> </span><span class=n>stats</span><span class=p>;</span><span class=w> </span><span class=c1>// Immutable config (correct SO usage)</span>
-</span><span id=__span-22-28><a id=__codelineno-22-28 name=__codelineno-22-28 href=#__codelineno-22-28></a>
-</span><span id=__span-22-29><a id=__codelineno-22-29 name=__codelineno-22-29 href=#__codelineno-22-29></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>Fire</span><span class=p>()</span>
-</span><span id=__span-22-30><a id=__codelineno-22-30 name=__codelineno-22-30 href=#__codelineno-22-30></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-22-31><a id=__codelineno-22-31 name=__codelineno-22-31 href=#__codelineno-22-31></a><span class=w>        </span><span class=kt>bool</span><span class=w> </span><span class=n>crit</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Random</span><span class=p>.</span><span class=k>value</span><span class=w> </span><span class=o>&lt;</span><span class=w> </span><span class=mf>0.1f</span><span class=p>;</span>
-</span><span id=__span-22-32><a id=__codelineno-22-32 name=__codelineno-22-32 href=#__codelineno-22-32></a><span class=w>        </span><span class=kt>int</span><span class=w> </span><span class=n>damage</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Mathf</span><span class=p>.</span><span class=n>RoundToInt</span><span class=p>(</span><span class=n>stats</span><span class=p>.</span><span class=n>baseDamage</span><span class=w> </span><span class=o>*</span><span class=w> </span><span class=p>(</span><span class=n>crit</span><span class=w> </span><span class=o>?</span><span class=w> </span><span class=n>stats</span><span class=p>.</span><span class=n>critMultiplier</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=mf>1f</span><span class=p>));</span>
-</span><span id=__span-22-33><a id=__codelineno-22-33 name=__codelineno-22-33 href=#__codelineno-22-33></a>
-</span><span id=__span-22-34><a id=__codelineno-22-34 name=__codelineno-22-34 href=#__codelineno-22-34></a><span class=w>        </span><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>DamageDealt</span><span class=p>(</span><span class=n>damage</span><span class=p>,</span><span class=w> </span><span class=n>crit</span><span class=p>);</span>
-</span><span id=__span-22-35><a id=__codelineno-22-35 name=__codelineno-22-35 href=#__codelineno-22-35></a><span class=w>        </span><span class=n>msg</span><span class=p>.</span><span class=n>EmitComponentBroadcast</span><span class=p>(</span><span class=k>this</span><span class=p>);</span><span class=w> </span><span class=c1>// Runtime event via DxMessaging</span>
-</span><span id=__span-22-36><a id=__codelineno-22-36 name=__codelineno-22-36 href=#__codelineno-22-36></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-22-37><a id=__codelineno-22-37 name=__codelineno-22-37 href=#__codelineno-22-37></a><span class=p>}</span>
-</span><span id=__span-22-38><a id=__codelineno-22-38 name=__codelineno-22-38 href=#__codelineno-22-38></a>
-</span><span id=__span-22-39><a id=__codelineno-22-39 name=__codelineno-22-39 href=#__codelineno-22-39></a><span class=c1>// Analytics: Pure DxMessaging (no SOA dependency)</span>
-</span><span id=__span-22-40><a id=__codelineno-22-40 name=__codelineno-22-40 href=#__codelineno-22-40></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>CombatAnalytics</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span>
-</span><span id=__span-22-41><a id=__codelineno-22-41 name=__codelineno-22-41 href=#__codelineno-22-41></a><span class=p>{</span>
-</span><span id=__span-22-42><a id=__codelineno-22-42 name=__codelineno-22-42 href=#__codelineno-22-42></a><span class=w>    </span><span class=k>protected</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RegisterMessageHandlers</span><span class=p>()</span>
-</span><span id=__span-22-43><a id=__codelineno-22-43 name=__codelineno-22-43 href=#__codelineno-22-43></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-22-44><a id=__codelineno-22-44 name=__codelineno-22-44 href=#__codelineno-22-44></a><span class=w>        </span><span class=k>base</span><span class=p>.</span><span class=n>RegisterMessageHandlers</span><span class=p>();</span>
-</span><span id=__span-22-45><a id=__codelineno-22-45 name=__codelineno-22-45 href=#__codelineno-22-45></a><span class=w>        </span><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Token</span><span class=p>.</span><span class=n>RegisterBroadcastWithoutSource</span><span class=o>&lt;</span><span class=n>DamageDealt</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnDamage</span><span class=p>);</span>
-</span><span id=__span-22-46><a id=__codelineno-22-46 name=__codelineno-22-46 href=#__codelineno-22-46></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-22-47><a id=__codelineno-22-47 name=__codelineno-22-47 href=#__codelineno-22-47></a>
-</span><span id=__span-22-48><a id=__codelineno-22-48 name=__codelineno-22-48 href=#__codelineno-22-48></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnDamage</span><span class=p>(</span><span class=n>InstanceId</span><span class=w> </span><span class=n>source</span><span class=p>,</span><span class=w> </span><span class=n>DamageDealt</span><span class=w> </span><span class=n>msg</span><span class=p>)</span>
-</span><span id=__span-22-49><a id=__codelineno-22-49 name=__codelineno-22-49 href=#__codelineno-22-49></a><span class=w>    </span><span class=p>{</span>
-</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>
-</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>
-</span><span id=__span-22-52><a id=__codelineno-22-52 name=__codelineno-22-52 href=#__codelineno-22-52></a><span class=p>}</span>
-</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>