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/concepts/mental-model/index.html DELETED Viewed

@@ -1,146 +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/concepts/mental-model/ rel=canonical><link href=../ rel=prev><link href=../message-types/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.1"><title>Mental Model - 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=#mental-model-how-to-think-about-dxmessaging 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> Mental Model </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 md-tabs__item--active"> <a href=../ class=md-tabs__link> Concepts </a> </li> <li class=md-tabs__item> <a href=../../guides/patterns/ 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--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3 checked> <div class="md-nav__link md-nav__container"> <a href=../ class="md-nav__link "> <span class=md-ellipsis> Concepts </span> </a> <label class="md-nav__link " for=__nav_3 id=__nav_3_label tabindex> <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=true> <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 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> Mental Model </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Mental Model </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=#the-core-idea class=md-nav__link> <span class=md-ellipsis> The Core Idea </span> </a> </li> <li class=md-nav__item> <a href=#what-problem-does-this-solve class=md-nav__link> <span class=md-ellipsis> What Problem Does This Solve? </span> </a> </li> <li class=md-nav__item> <a href=#the-three-message-categories class=md-nav__link> <span class=md-ellipsis> The Three Message Categories </span> </a> <nav class=md-nav aria-label="The Three Message Categories"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#untargeted-the-pa-system class=md-nav__link> <span class=md-ellipsis> Untargeted: The PA System </span> </a> <nav class=md-nav aria-label="Untargeted: The PA System"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#real-examples class=md-nav__link> <span class=md-ellipsis> Real examples </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#targeted-the-addressed-letter class=md-nav__link> <span class=md-ellipsis> Targeted: The Addressed Letter </span> </a> <nav class=md-nav aria-label="Targeted: The Addressed Letter"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#real-examples_1 class=md-nav__link> <span class=md-ellipsis> Real examples </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#broadcast-the-radio-station class=md-nav__link> <span class=md-ellipsis> Broadcast: The Radio Station </span> </a> <nav class=md-nav aria-label="Broadcast: The Radio Station"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#real-examples_2 class=md-nav__link> <span class=md-ellipsis> Real examples </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#deciding-which-type-to-use class=md-nav__link> <span class=md-ellipsis> Deciding Which Type to Use </span> </a> </li> <li class=md-nav__item> <a href=#tokens-and-lifecycle class=md-nav__link> <span class=md-ellipsis> Tokens and Lifecycle </span> </a> <nav class=md-nav aria-label="Tokens and Lifecycle"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#the-pattern class=md-nav__link> <span class=md-ellipsis> The Pattern </span> </a> </li> <li class=md-nav__item> <a href=#what-the-token-does class=md-nav__link> <span class=md-ellipsis> What the Token Does </span> </a> </li> <li class=md-nav__item> <a href=#why-tokens-matter class=md-nav__link> <span class=md-ellipsis> Why Tokens Matter </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#context-through-game-primitives class=md-nav__link> <span class=md-ellipsis> Context Through Game Primitives </span> </a> <nav class=md-nav aria-label="Context Through Game Primitives"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#instanceid class=md-nav__link> <span class=md-ellipsis> InstanceId </span> </a> </li> <li class=md-nav__item> <a href=#gameobject-vs-component-targeting class=md-nav__link> <span class=md-ellipsis> GameObject vs Component Targeting </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#observing-without-targeting class=md-nav__link> <span class=md-ellipsis> Observing Without Targeting </span> </a> <nav class=md-nav aria-label="Observing Without Targeting"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#observing-all-targeted-messages class=md-nav__link> <span class=md-ellipsis> Observing All Targeted Messages </span> </a> </li> <li class=md-nav__item> <a href=#observing-all-broadcast-messages class=md-nav__link> <span class=md-ellipsis> Observing All Broadcast Messages </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#the-gets-out-of-the-way-philosophy class=md-nav__link> <span class=md-ellipsis> The "Gets Out of the Way" Philosophy </span> </a> </li> <li class=md-nav__item> <a href=#common-patterns-at-a-glance class=md-nav__link> <span class=md-ellipsis> Common Patterns at a Glance </span> </a> </li> <li class=md-nav__item> <a href=#common-mistakes class=md-nav__link> <span class=md-ellipsis> Common Mistakes </span> </a> <nav class=md-nav aria-label="Common Mistakes"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#forgetting-to-enable-the-token class=md-nav__link> <span class=md-ellipsis> Forgetting to Enable the Token </span> </a> </li> <li class=md-nav__item> <a href=#targeting-component-when-you-meant-gameobject-or-vice-versa class=md-nav__link> <span class=md-ellipsis> Targeting Component When You Meant GameObject (or Vice Versa) </span> </a> </li> <li class=md-nav__item> <a href=#forgetting-to-call-baseregistermessagehandlers class=md-nav__link> <span class=md-ellipsis> Forgetting to Call base.RegisterMessageHandlers() </span> </a> </li> <li class=md-nav__item> <a href=#not-understanding-synchronous-handler-execution class=md-nav__link> <span class=md-ellipsis> Not Understanding Synchronous Handler Execution </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#next-steps class=md-nav__link> <span class=md-ellipsis> Next Steps </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../message-types/ class=md-nav__link> <span class=md-ellipsis> Message Types </span> </a> </li> <li class=md-nav__item> <a href=../listening-patterns/ class=md-nav__link> <span class=md-ellipsis> Listening Patterns </span> </a> </li> <li class=md-nav__item> <a href=../targeting-and-context/ class=md-nav__link> <span class=md-ellipsis> Targeting & Context </span> </a> </li> <li class=md-nav__item> <a href=../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--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_4> <label class=md-nav__link for=__nav_4 id=__nav_4_label tabindex=0> <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=false> <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> <a href=../../guides/patterns/ class=md-nav__link> <span class=md-ellipsis> Patterns </span> </a> </li> <li class=md-nav__item> <a href=../../guides/unity-integration/ class=md-nav__link> <span class=md-ellipsis> Unity Integration </span> </a> </li> <li class=md-nav__item> <a href=../../guides/testing/ class=md-nav__link> <span class=md-ellipsis> Testing </span> </a> </li> <li class=md-nav__item> <a href=../../guides/diagnostics/ class=md-nav__link> <span class=md-ellipsis> Diagnostics </span> </a> </li> <li class=md-nav__item> <a href=../../guides/advanced/ class=md-nav__link> <span class=md-ellipsis> Advanced Topics </span> </a> </li> <li class=md-nav__item> <a href=../../guides/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=#the-core-idea class=md-nav__link> <span class=md-ellipsis> The Core Idea </span> </a> </li> <li class=md-nav__item> <a href=#what-problem-does-this-solve class=md-nav__link> <span class=md-ellipsis> What Problem Does This Solve? </span> </a> </li> <li class=md-nav__item> <a href=#the-three-message-categories class=md-nav__link> <span class=md-ellipsis> The Three Message Categories </span> </a> <nav class=md-nav aria-label="The Three Message Categories"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#untargeted-the-pa-system class=md-nav__link> <span class=md-ellipsis> Untargeted: The PA System </span> </a> <nav class=md-nav aria-label="Untargeted: The PA System"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#real-examples class=md-nav__link> <span class=md-ellipsis> Real examples </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#targeted-the-addressed-letter class=md-nav__link> <span class=md-ellipsis> Targeted: The Addressed Letter </span> </a> <nav class=md-nav aria-label="Targeted: The Addressed Letter"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#real-examples_1 class=md-nav__link> <span class=md-ellipsis> Real examples </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#broadcast-the-radio-station class=md-nav__link> <span class=md-ellipsis> Broadcast: The Radio Station </span> </a> <nav class=md-nav aria-label="Broadcast: The Radio Station"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#real-examples_2 class=md-nav__link> <span class=md-ellipsis> Real examples </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#deciding-which-type-to-use class=md-nav__link> <span class=md-ellipsis> Deciding Which Type to Use </span> </a> </li> <li class=md-nav__item> <a href=#tokens-and-lifecycle class=md-nav__link> <span class=md-ellipsis> Tokens and Lifecycle </span> </a> <nav class=md-nav aria-label="Tokens and Lifecycle"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#the-pattern class=md-nav__link> <span class=md-ellipsis> The Pattern </span> </a> </li> <li class=md-nav__item> <a href=#what-the-token-does class=md-nav__link> <span class=md-ellipsis> What the Token Does </span> </a> </li> <li class=md-nav__item> <a href=#why-tokens-matter class=md-nav__link> <span class=md-ellipsis> Why Tokens Matter </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#context-through-game-primitives class=md-nav__link> <span class=md-ellipsis> Context Through Game Primitives </span> </a> <nav class=md-nav aria-label="Context Through Game Primitives"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#instanceid class=md-nav__link> <span class=md-ellipsis> InstanceId </span> </a> </li> <li class=md-nav__item> <a href=#gameobject-vs-component-targeting class=md-nav__link> <span class=md-ellipsis> GameObject vs Component Targeting </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#observing-without-targeting class=md-nav__link> <span class=md-ellipsis> Observing Without Targeting </span> </a> <nav class=md-nav aria-label="Observing Without Targeting"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#observing-all-targeted-messages class=md-nav__link> <span class=md-ellipsis> Observing All Targeted Messages </span> </a> </li> <li class=md-nav__item> <a href=#observing-all-broadcast-messages class=md-nav__link> <span class=md-ellipsis> Observing All Broadcast Messages </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#the-gets-out-of-the-way-philosophy class=md-nav__link> <span class=md-ellipsis> The "Gets Out of the Way" Philosophy </span> </a> </li> <li class=md-nav__item> <a href=#common-patterns-at-a-glance class=md-nav__link> <span class=md-ellipsis> Common Patterns at a Glance </span> </a> </li> <li class=md-nav__item> <a href=#common-mistakes class=md-nav__link> <span class=md-ellipsis> Common Mistakes </span> </a> <nav class=md-nav aria-label="Common Mistakes"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#forgetting-to-enable-the-token class=md-nav__link> <span class=md-ellipsis> Forgetting to Enable the Token </span> </a> </li> <li class=md-nav__item> <a href=#targeting-component-when-you-meant-gameobject-or-vice-versa class=md-nav__link> <span class=md-ellipsis> Targeting Component When You Meant GameObject (or Vice Versa) </span> </a> </li> <li class=md-nav__item> <a href=#forgetting-to-call-baseregistermessagehandlers class=md-nav__link> <span class=md-ellipsis> Forgetting to Call base.RegisterMessageHandlers() </span> </a> </li> <li class=md-nav__item> <a href=#not-understanding-synchronous-handler-execution class=md-nav__link> <span class=md-ellipsis> Not Understanding Synchronous Handler Execution </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#next-steps class=md-nav__link> <span class=md-ellipsis> Next Steps </span> </a> </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> Concepts </span> </a> </li> </ol> </nav> <article class="md-content__inner md-typeset"> <a href=https://github.com/wallstop/DxMessaging/edit/master/docs/concepts/mental-model.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/concepts/mental-model.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=mental-model-how-to-think-about-dxmessaging>Mental Model: How to Think About DxMessaging<a class=headerlink href=#mental-model-how-to-think-about-dxmessaging title="Anchor link to this section">&para;</a></h1> <p><a href=../ >← Concepts Index</a> | <a href=../message-types/ >Message Types</a> | <a href=../../getting-started/getting-started/ >Getting Started</a></p> <hr> <p>This guide explains how to think about DxMessaging from first principles. Understanding the mental model makes everything else easier.</p> <h2 id=the-core-idea>The Core Idea<a class=headerlink href=#the-core-idea title="Anchor link to this section">&para;</a></h2> <p>DxMessaging is built around one principle: <strong>it gets out of your way</strong>.</p> <p>You have data. You need to pass it around. That's the problem.</p> <p>DxMessaging provides fast, simple primitives as building blocks. You model changes as message types with optional context, using game primitives (GameObjects, components) as that context. The library handles the plumbing.</p> <p>You don't build your game INTO the messaging system. The messaging system is opt-in and optional - a tool you reach for when it helps.</p> <h2 id=what-problem-does-this-solve>What Problem Does This Solve?<a class=headerlink href=#what-problem-does-this-solve title="Anchor link to this section">&para;</a></h2> <p>In a typical Unity project, you face a common challenge:</p> <div class="language-text highlight"><span class=filename>Text Only</span><pre><span></span><code><span id=__span-0-1><a id=__codelineno-0-1 name=__codelineno-0-1 href=#__codelineno-0-1></a>Player takes damage
-</span><span id=__span-0-2><a id=__codelineno-0-2 name=__codelineno-0-2 href=#__codelineno-0-2></a>    ├── Health bar needs updating
-</span><span id=__span-0-3><a id=__codelineno-0-3 name=__codelineno-0-3 href=#__codelineno-0-3></a>    ├── Sound system plays damage audio
-</span><span id=__span-0-4><a id=__codelineno-0-4 name=__codelineno-0-4 href=#__codelineno-0-4></a>    ├── Camera shakes
-</span><span id=__span-0-5><a id=__codelineno-0-5 name=__codelineno-0-5 href=#__codelineno-0-5></a>    ├── Achievement system checks milestones
-</span><span id=__span-0-6><a id=__codelineno-0-6 name=__codelineno-0-6 href=#__codelineno-0-6></a>    ├── Analytics logs the event
-</span><span id=__span-0-7><a id=__codelineno-0-7 name=__codelineno-0-7 href=#__codelineno-0-7></a>    └── Tutorial system checks for tips
-</span></code></pre></div> <p>Traditional approaches require tight coupling: either the Player knows about all these systems, or they all hold references to the Player. Both paths lead to tangled dependencies.</p> <p>DxMessaging inverts this relationship. The Player broadcasts a fact - "I took 25 damage" - and interested systems subscribe to receive it. Systems come and go without the Player knowing or caring.</p> <h2 id=the-three-message-categories>The Three Message Categories<a class=headerlink href=#the-three-message-categories title="Anchor link to this section">&para;</a></h2> <p>DxMessaging models three fundamental patterns of communication. Each maps to a real-world analogy.</p> <h3 id=untargeted-the-pa-system>Untargeted: The PA System<a class=headerlink href=#untargeted-the-pa-system title="Anchor link to this section">&para;</a></h3> <pre class=mermaid><code>%%{init: {'theme': 'dark'}}%%
-flowchart LR
-    S[Someone] --&gt;|announces| PA[📢 PA System]
-    PA --&gt; L1[Listener A]
-    PA --&gt; L2[Listener B]
-    PA --&gt; L3[Listener C]</code></pre> <p>Untargeted messages are announcements. No specific recipient. No specific sender that matters. Everyone who cares can hear it.</p> <blockquote> <p>📝 <strong>Note: No sender identity</strong></p> <p>Unlike a real PA system, untargeted messages carry no concept of "who announced it." There is no sender identity attached - only the message content itself.</p> </blockquote> <h4 id=real-examples>Real examples<a class=headerlink href=#real-examples title="Anchor link to this section">&para;</a></h4> <ul> <li>"The game is paused"</li> <li>"Settings changed"</li> <li>"Scene finished loading"</li> <li>"Day/night cycle switched to night"</li> </ul> <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=c1>// Define an untargeted message with attributes</span>
-</span><span id=__span-1-2><a id=__codelineno-1-2 name=__codelineno-1-2 href=#__codelineno-1-2></a><span class=na>[DxUntargetedMessage]</span>
-</span><span id=__span-1-3><a id=__codelineno-1-3 name=__codelineno-1-3 href=#__codelineno-1-3></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-1-4><a id=__codelineno-1-4 name=__codelineno-1-4 href=#__codelineno-1-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>GamePaused</span>
-</span><span id=__span-1-5><a id=__codelineno-1-5 name=__codelineno-1-5 href=#__codelineno-1-5></a><span class=p>{</span>
-</span><span id=__span-1-6><a id=__codelineno-1-6 name=__codelineno-1-6 href=#__codelineno-1-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>bool</span><span class=w> </span><span class=n>isPaused</span><span class=p>;</span>
-</span><span id=__span-1-7><a id=__codelineno-1-7 name=__codelineno-1-7 href=#__codelineno-1-7></a><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>// Multiple fields are supported</span>
-</span><span id=__span-1-10><a id=__codelineno-1-10 name=__codelineno-1-10 href=#__codelineno-1-10></a><span class=na>[DxUntargetedMessage]</span>
-</span><span id=__span-1-11><a id=__codelineno-1-11 name=__codelineno-1-11 href=#__codelineno-1-11></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-1-12><a id=__codelineno-1-12 name=__codelineno-1-12 href=#__codelineno-1-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>SettingsChanged</span>
-</span><span id=__span-1-13><a id=__codelineno-1-13 name=__codelineno-1-13 href=#__codelineno-1-13></a><span class=p>{</span>
-</span><span id=__span-1-14><a id=__codelineno-1-14 name=__codelineno-1-14 href=#__codelineno-1-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>float</span><span class=w> </span><span class=n>volume</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=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>quality</span><span class=p>;</span>
-</span><span id=__span-1-16><a id=__codelineno-1-16 name=__codelineno-1-16 href=#__codelineno-1-16></a><span class=p>}</span>
-</span></code></pre></div> <p><strong>Use when:</strong> You need to announce something to whoever might care. The sender doesn't know or care who's listening.</p> <h3 id=targeted-the-addressed-letter>Targeted: The Addressed Letter<a class=headerlink href=#targeted-the-addressed-letter title="Anchor link to this section">&para;</a></h3> <pre class=mermaid><code>%%{init: {'theme': 'dark'}}%%
-flowchart LR
-    S[Sender] --&gt;|"To: Player"| Letter[📬 Message Bus]
-    Letter --&gt; Player[Player receives]
-    Other1[Enemy A] -.-&gt;|ignores| Letter
-    Other2[Enemy B] -.-&gt;|ignores| Letter</code></pre> <p>Targeted messages are commands or directed events. They have a specific recipient. Only that recipient (and any interested observers) receives them.</p> <h4 id=real-examples_1>Real examples<a class=headerlink href=#real-examples_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>"Player, heal for 10 HP"</li> <li>"Door <a class="magiclink magiclink-github magiclink-issue" href=https://github.com/wallstop/DxMessaging/issues/7 title="GitHub Issue: wallstop/DxMessaging #7">#7</a>, open"</li> <li>"This specific enemy, take 25 damage"</li> <li>"Inventory slot 3, equip this weapon"</li> </ul> <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=c1>// Define a targeted message with attributes</span>
-</span><span id=__span-2-2><a id=__codelineno-2-2 name=__codelineno-2-2 href=#__codelineno-2-2></a><span class=na>[DxTargetedMessage]</span>
-</span><span id=__span-2-3><a id=__codelineno-2-3 name=__codelineno-2-3 href=#__codelineno-2-3></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-2-4><a id=__codelineno-2-4 name=__codelineno-2-4 href=#__codelineno-2-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>Heal</span>
-</span><span id=__span-2-5><a id=__codelineno-2-5 name=__codelineno-2-5 href=#__codelineno-2-5></a><span class=p>{</span>
-</span><span id=__span-2-6><a id=__codelineno-2-6 name=__codelineno-2-6 href=#__codelineno-2-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>amount</span><span class=p>;</span>
-</span><span id=__span-2-7><a id=__codelineno-2-7 name=__codelineno-2-7 href=#__codelineno-2-7></a><span class=p>}</span>
-</span><span id=__span-2-8><a id=__codelineno-2-8 name=__codelineno-2-8 href=#__codelineno-2-8></a>
-</span><span id=__span-2-9><a id=__codelineno-2-9 name=__codelineno-2-9 href=#__codelineno-2-9></a><span class=c1>// Emit to a specific target</span>
-</span><span id=__span-2-10><a id=__codelineno-2-10 name=__codelineno-2-10 href=#__codelineno-2-10></a><span class=n>Heal</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-2-11><a id=__codelineno-2-11 name=__codelineno-2-11 href=#__codelineno-2-11></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitGameObjectTargeted</span><span class=p>(</span><span class=n>playerGameObject</span><span class=p>);</span>
-</span></code></pre></div> <p><strong>Use when:</strong> You're commanding a specific entity to do something, or notifying a specific entity about something that happened to it.</p> <h3 id=broadcast-the-radio-station>Broadcast: The Radio Station<a class=headerlink href=#broadcast-the-radio-station title="Anchor link to this section">&para;</a></h3> <pre class=mermaid><code>%%{init: {'theme': 'dark'}}%%
-flowchart LR
-    Source[Enemy] --&gt;|"I took damage!"| Radio[📻 Message Bus]
-    Radio --&gt; L1[Damage Numbers UI]
-    Radio --&gt; L2[Achievement Tracker]
-    Radio --&gt; L3[Analytics]
-    Radio --&gt; L4[Combat Log]</code></pre> <p>Broadcast messages are facts emitted by a specific source. Unlike targeted messages, there's no intended recipient - just an origin. Anyone who wants to observe can tune in.</p> <h4 id=real-examples_2>Real examples<a class=headerlink href=#real-examples_2 title="Anchor link to this section">&para;</a></h4> <ul> <li>"This enemy took 25 damage" (from the enemy)</li> <li>"The player picked up item X" (from the player)</li> <li>"This chest opened" (from the chest)</li> <li>"Projectile hit something" (from the projectile)</li> </ul> <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=c1>// Define a broadcast message with attributes</span>
-</span><span id=__span-3-2><a id=__codelineno-3-2 name=__codelineno-3-2 href=#__codelineno-3-2></a><span class=na>[DxBroadcastMessage]</span>
-</span><span id=__span-3-3><a id=__codelineno-3-3 name=__codelineno-3-3 href=#__codelineno-3-3></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-3-4><a id=__codelineno-3-4 name=__codelineno-3-4 href=#__codelineno-3-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>TookDamage</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>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-3-7><a id=__codelineno-3-7 name=__codelineno-3-7 href=#__codelineno-3-7></a><span class=p>}</span>
-</span><span id=__span-3-8><a id=__codelineno-3-8 name=__codelineno-3-8 href=#__codelineno-3-8></a>
-</span><span id=__span-3-9><a id=__codelineno-3-9 name=__codelineno-3-9 href=#__codelineno-3-9></a><span class=c1>// Emit from a specific source</span>
-</span><span id=__span-3-10><a id=__codelineno-3-10 name=__codelineno-3-10 href=#__codelineno-3-10></a><span class=n>TookDamage</span><span class=w> </span><span class=n>damage</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>25</span><span class=p>);</span>
-</span><span id=__span-3-11><a id=__codelineno-3-11 name=__codelineno-3-11 href=#__codelineno-3-11></a><span class=n>damage</span><span class=p>.</span><span class=n>EmitGameObjectBroadcast</span><span class=p>(</span><span class=n>thisEnemy</span><span class=p>);</span>
-</span></code></pre></div> <p><strong>Use when:</strong> Something happened to an entity, and other systems might want to know about it. The entity doesn't care who's listening.</p> <h2 id=deciding-which-type-to-use>Deciding Which Type to Use<a class=headerlink href=#deciding-which-type-to-use title="Anchor link to this section">&para;</a></h2> <pre class=mermaid><code>%%{init: {'theme': 'dark'}}%%
-flowchart TD
-    Start([I need to send a message])
-    Start --&gt; Q1{Does it matter&lt;br/&gt;WHO sent it?}
-    Q1 --&gt;|No| Q2{Does it matter&lt;br/&gt;WHO receives it?}
-    Q2 --&gt;|No| Untargeted[Use UNTARGETED&lt;br/&gt;Global announcement]
-    Q2 --&gt;|Yes| Targeted[Use TARGETED&lt;br/&gt;Directed command]
-    Q1 --&gt;|Yes| Q3{Am I commanding&lt;br/&gt;someone to act?}
-    Q3 --&gt;|Yes| Targeted
-    Q3 --&gt;|No| Broadcast[Use BROADCAST&lt;br/&gt;Observable fact]</code></pre> <table> <thead> <tr> <th>Question</th> <th style="text-align: center;">Untargeted</th> <th style="text-align: center;">Targeted</th> <th style="text-align: center;">Broadcast</th> </tr> </thead> <tbody> <tr> <td>Has a specific sender that matters?</td> <td style="text-align: center;">❌</td> <td style="text-align: center;">❌</td> <td style="text-align: center;">✅</td> </tr> <tr> <td>Has a specific recipient?</td> <td style="text-align: center;">❌</td> <td style="text-align: center;">✅</td> <td style="text-align: center;">❌</td> </tr> <tr> <td>Is it a command?</td> <td style="text-align: center;">❌</td> <td style="text-align: center;">✅</td> <td style="text-align: center;">❌</td> </tr> <tr> <td>Is it an observable fact?</td> <td style="text-align: center;">Maybe</td> <td style="text-align: center;">❌</td> <td style="text-align: center;">✅</td> </tr> <tr> <td>Is it a global announcement?</td> <td style="text-align: center;">✅</td> <td style="text-align: center;">❌</td> <td style="text-align: center;">❌</td> </tr> </tbody> </table> <h2 id=tokens-and-lifecycle>Tokens and Lifecycle<a class=headerlink href=#tokens-and-lifecycle title="Anchor link to this section">&para;</a></h2> <p>Registration in DxMessaging happens through tokens. A <code>MessageRegistrationToken</code> collects your registrations and ties them to a lifecycle.</p> <h3 id=the-pattern>The Pattern<a class=headerlink href=#the-pattern title="Anchor link to this section">&para;</a></h3> <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=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>HealthDisplay</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span>
-</span><span id=__span-4-2><a id=__codelineno-4-2 name=__codelineno-4-2 href=#__codelineno-4-2></a><span class=p>{</span>
-</span><span id=__span-4-3><a id=__codelineno-4-3 name=__codelineno-4-3 href=#__codelineno-4-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><span id=__span-4-4><a id=__codelineno-4-4 name=__codelineno-4-4 href=#__codelineno-4-4></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-4-5><a id=__codelineno-4-5 name=__codelineno-4-5 href=#__codelineno-4-5></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-4-6><a id=__codelineno-4-6 name=__codelineno-4-6 href=#__codelineno-4-6></a>
-</span><span id=__span-4-7><a id=__codelineno-4-7 name=__codelineno-4-7 href=#__codelineno-4-7></a><span class=w>        </span><span class=c1>// Register handlers through the Token</span>
-</span><span id=__span-4-8><a id=__codelineno-4-8 name=__codelineno-4-8 href=#__codelineno-4-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>RegisterGameObjectBroadcast</span><span class=o>&lt;</span><span class=n>TookDamage</span><span class=o>&gt;</span><span class=p>(</span><span class=n>player</span><span class=p>,</span><span class=w> </span><span class=n>OnPlayerDamaged</span><span class=p>);</span>
-</span><span id=__span-4-9><a id=__codelineno-4-9 name=__codelineno-4-9 href=#__codelineno-4-9></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>GamePaused</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnGamePaused</span><span class=p>);</span>
-</span><span id=__span-4-10><a id=__codelineno-4-10 name=__codelineno-4-10 href=#__codelineno-4-10></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-4-11><a id=__codelineno-4-11 name=__codelineno-4-11 href=#__codelineno-4-11></a>
-</span><span id=__span-4-12><a id=__codelineno-4-12 name=__codelineno-4-12 href=#__codelineno-4-12></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>OnPlayerDamaged</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>TookDamage</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=cm>/* update display */</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-4-13><a id=__codelineno-4-13 name=__codelineno-4-13 href=#__codelineno-4-13></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>OnGamePaused</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>GamePaused</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=cm>/* pause animations */</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-4-14><a id=__codelineno-4-14 name=__codelineno-4-14 href=#__codelineno-4-14></a><span class=p>}</span>
-</span></code></pre></div> <blockquote> <p>⚠️ <strong>Warning: Always call <code>base.RegisterMessageHandlers()</code></strong></p> <p>When overriding <code>RegisterMessageHandlers()</code>, always call <code>base.RegisterMessageHandlers()</code> first. This ensures that any registrations from parent classes are preserved. Forgetting this call can silently break inherited behavior.</p> </blockquote> <h3 id=what-the-token-does>What the Token Does<a class=headerlink href=#what-the-token-does title="Anchor link to this section">&para;</a></h3> <pre class=mermaid><code>%%{init: {'theme': 'dark'}}%%
-sequenceDiagram
-    participant C as Component
-    participant T as Token
-    participant B as MessageBus
-    Note over C,B: Awake
-    C-&gt;&gt;T: Create Token
-    C-&gt;&gt;T: Register handlers
-    T--&gt;&gt;T: Stage (not active yet)
-    Note over C,B: OnEnable
-    C-&gt;&gt;T: Enable()
-    T-&gt;&gt;B: Activate registrations
-    Note over C,B: Messages flow
-    B-&gt;&gt;C: Handler called
-    Note over C,B: OnDisable
-    C-&gt;&gt;T: Disable()
-    T-&gt;&gt;B: Deactivate registrations
-    Note over C,B: OnDestroy
-    C-&gt;&gt;T: Dispose/Release
-    T-&gt;&gt;B: Remove registrations</code></pre> <p>The token:</p> <ol> <li><strong>Stages</strong> registrations when you call <code>Register*</code> methods</li> <li><strong>Activates</strong> them when you call <code>Enable()</code></li> <li><strong>Deactivates</strong> them when you call <code>Disable()</code></li> <li><strong>Cleans up</strong> when the token is disposed or the component is destroyed</li> </ol> <p>This maps directly to Unity's lifecycle: registrations activate in <code>OnEnable</code>, deactivate in <code>OnDisable</code>, and clean up in <code>OnDestroy</code>.</p> <h3 id=why-tokens-matter>Why Tokens Matter<a class=headerlink href=#why-tokens-matter title="Anchor link to this section">&para;</a></h3> <p>Tokens prevent common event system bugs:</p> <ul> <li><strong>No forgotten unsubscribes</strong>: The token tracks everything</li> <li><strong>No null reference handlers</strong>: Disabled tokens don't receive messages</li> <li><strong>No memory leaks</strong>: Token cleanup is automatic with <code>MessageAwareComponent</code></li> <li><strong>Predictable timing</strong>: Enable/disable follows Unity's enable state</li> </ul> <h2 id=context-through-game-primitives>Context Through Game Primitives<a class=headerlink href=#context-through-game-primitives title="Anchor link to this section">&para;</a></h2> <p>DxMessaging uses Unity's primitives (GameObjects, Components) as natural context for messages.</p> <h3 id=instanceid>InstanceId<a class=headerlink href=#instanceid title="Anchor link to this section">&para;</a></h3> <p>Every registration and emission uses an <code>InstanceId</code> - a lightweight identifier that wraps a Unity Object's instance ID. You rarely need to create these manually because extension methods handle the conversion:</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=c1>// These are equivalent:</span>
-</span><span id=__span-5-2><a id=__codelineno-5-2 name=__codelineno-5-2 href=#__codelineno-5-2></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitGameObjectTargeted</span><span class=p>(</span><span class=n>playerGameObject</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 class=n>heal</span><span class=p>.</span><span class=n>EmitTargeted</span><span class=p>((</span><span class=n>InstanceId</span><span class=p>)</span><span class=n>playerGameObject</span><span class=p>);</span>
-</span><span id=__span-5-4><a id=__codelineno-5-4 name=__codelineno-5-4 href=#__codelineno-5-4></a>
-</span><span id=__span-5-5><a id=__codelineno-5-5 name=__codelineno-5-5 href=#__codelineno-5-5></a><span class=c1>// Registering for a specific component</span>
-</span><span id=__span-5-6><a id=__codelineno-5-6 name=__codelineno-5-6 href=#__codelineno-5-6></a><span class=n>Token</span><span class=p>.</span><span class=n>RegisterComponentTargeted</span><span class=o>&lt;</span><span class=n>Damage</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>OnDamage</span><span class=p>);</span>
-</span><span id=__span-5-7><a id=__codelineno-5-7 name=__codelineno-5-7 href=#__codelineno-5-7></a>
-</span><span id=__span-5-8><a id=__codelineno-5-8 name=__codelineno-5-8 href=#__codelineno-5-8></a><span class=c1>// Registering for a whole GameObject</span>
-</span><span id=__span-5-9><a id=__codelineno-5-9 name=__codelineno-5-9 href=#__codelineno-5-9></a><span class=n>Token</span><span class=p>.</span><span class=n>RegisterGameObjectTargeted</span><span class=o>&lt;</span><span class=n>Damage</span><span class=o>&gt;</span><span class=p>(</span><span class=n>gameObject</span><span class=p>,</span><span class=w> </span><span class=n>OnDamage</span><span class=p>);</span>
-</span></code></pre></div> <h3 id=gameobject-vs-component-targeting>GameObject vs Component Targeting<a class=headerlink href=#gameobject-vs-component-targeting title="Anchor link to this section">&para;</a></h3> <p>You can target at two levels:</p> <p><strong>GameObject level</strong>: All components on that GameObject can respond</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=c1>// Registration</span>
-</span><span id=__span-6-2><a id=__codelineno-6-2 name=__codelineno-6-2 href=#__codelineno-6-2></a><span class=n>Token</span><span class=p>.</span><span class=n>RegisterGameObjectTargeted</span><span class=o>&lt;</span><span class=n>Command</span><span class=o>&gt;</span><span class=p>(</span><span class=n>gameObject</span><span class=p>,</span><span class=w> </span><span class=n>HandleCommand</span><span class=p>);</span>
-</span><span id=__span-6-3><a id=__codelineno-6-3 name=__codelineno-6-3 href=#__codelineno-6-3></a>
-</span><span id=__span-6-4><a id=__codelineno-6-4 name=__codelineno-6-4 href=#__codelineno-6-4></a><span class=c1>// Emission (any component on playerGO can receive this)</span>
-</span><span id=__span-6-5><a id=__codelineno-6-5 name=__codelineno-6-5 href=#__codelineno-6-5></a><span class=n>command</span><span class=p>.</span><span class=n>EmitGameObjectTargeted</span><span class=p>(</span><span class=n>playerGO</span><span class=p>);</span>
-</span></code></pre></div> <p><strong>Component level</strong>: Only that specific component responds</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=c1>// Registration</span>
-</span><span id=__span-7-2><a id=__codelineno-7-2 name=__codelineno-7-2 href=#__codelineno-7-2></a><span class=n>Token</span><span class=p>.</span><span class=n>RegisterComponentTargeted</span><span class=o>&lt;</span><span class=n>Command</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>HandleCommand</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><span id=__span-7-4><a id=__codelineno-7-4 name=__codelineno-7-4 href=#__codelineno-7-4></a><span class=c1>// Emission (only this specific component instance receives this)</span>
-</span><span id=__span-7-5><a id=__codelineno-7-5 name=__codelineno-7-5 href=#__codelineno-7-5></a><span class=n>command</span><span class=p>.</span><span class=n>EmitComponentTargeted</span><span class=p>(</span><span class=n>specificComponent</span><span class=p>);</span>
-</span></code></pre></div> <h2 id=observing-without-targeting>Observing Without Targeting<a class=headerlink href=#observing-without-targeting title="Anchor link to this section">&para;</a></h2> <p>Sometimes you want to see all messages of a type, regardless of their target or source.</p> <h3 id=observing-all-targeted-messages>Observing All Targeted Messages<a class=headerlink href=#observing-all-targeted-messages title="Anchor link to this section">&para;</a></h3> <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=c1>// See every Heal message, no matter who it&#39;s for</span>
-</span><span id=__span-8-2><a id=__codelineno-8-2 name=__codelineno-8-2 href=#__codelineno-8-2></a><span class=n>Token</span><span class=p>.</span><span class=n>RegisterTargetedWithoutTargeting</span><span class=o>&lt;</span><span class=n>Heal</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnAnyHeal</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=k>void</span><span class=w> </span><span class=nf>OnAnyHeal</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>Heal</span><span class=w> </span><span class=n>msg</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=p>{</span>
-</span><span id=__span-8-6><a id=__codelineno-8-6 name=__codelineno-8-6 href=#__codelineno-8-6></a><span class=w>    </span><span class=c1>// &#39;target&#39; tells you who was healed</span>
-</span><span id=__span-8-7><a id=__codelineno-8-7 name=__codelineno-8-7 href=#__codelineno-8-7></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;Someone healed {target} for {msg.amount}&quot;</span><span class=p>);</span>
-</span><span id=__span-8-8><a id=__codelineno-8-8 name=__codelineno-8-8 href=#__codelineno-8-8></a><span class=p>}</span>
-</span></code></pre></div> <h3 id=observing-all-broadcast-messages>Observing All Broadcast Messages<a class=headerlink href=#observing-all-broadcast-messages title="Anchor link to this section">&para;</a></h3> <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=c1>// See every TookDamage message, no matter who broadcast it</span>
-</span><span id=__span-9-2><a id=__codelineno-9-2 name=__codelineno-9-2 href=#__codelineno-9-2></a><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>OnAnyDamage</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><span id=__span-9-4><a id=__codelineno-9-4 name=__codelineno-9-4 href=#__codelineno-9-4></a><span class=k>void</span><span class=w> </span><span class=nf>OnAnyDamage</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>msg</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 class=w>    </span><span class=c1>// &#39;source&#39; tells you who took damage</span>
-</span><span id=__span-9-7><a id=__codelineno-9-7 name=__codelineno-9-7 href=#__codelineno-9-7></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} took {msg.amount} damage&quot;</span><span class=p>);</span>
-</span><span id=__span-9-8><a id=__codelineno-9-8 name=__codelineno-9-8 href=#__codelineno-9-8></a><span class=p>}</span>
-</span></code></pre></div> <p>These patterns are useful for:</p> <ul> <li>Analytics systems</li> <li>Combat logs</li> <li>Debug overlays</li> <li>Achievement tracking</li> <li>Network replication</li> </ul> <h2 id=the-gets-out-of-the-way-philosophy>The "Gets Out of the Way" Philosophy<a class=headerlink href=#the-gets-out-of-the-way-philosophy title="Anchor link to this section">&para;</a></h2> <p>DxMessaging is designed to be invisible when you don't need it:</p> <ol> <li><strong>No global state pollution</strong>: Messages are just data. Define them anywhere.</li> <li><strong>No inheritance requirements</strong>: Implement an interface or add an attribute. That's it.</li> <li><strong>No framework lock-in</strong>: Your message structs are plain C#. They work outside DxMessaging.</li> <li><strong>No ceremony</strong>: Define a struct, emit it, handle it. Three steps.</li> <li><strong>Optional everywhere</strong>: Don't want to use it for something? Don't. Mix and match.</li> </ol> <p>The library provides primitives. You compose them into patterns that fit your game.</p> <h2 id=common-patterns-at-a-glance>Common Patterns at a Glance<a class=headerlink href=#common-patterns-at-a-glance title="Anchor link to this section">&para;</a></h2> <table> <thead> <tr> <th>Pattern</th> <th>Message Type</th> <th>Registration</th> <th>Emission</th> </tr> </thead> <tbody> <tr> <td>Global setting change</td> <td>Untargeted</td> <td><code>RegisterUntargeted&lt;T&gt;</code></td> <td><code>msg.EmitUntargeted()</code></td> </tr> <tr> <td>Command to entity</td> <td>Targeted</td> <td><code>RegisterGameObjectTargeted&lt;T&gt;</code></td> <td><code>msg.EmitGameObjectTargeted(go)</code></td> </tr> <tr> <td>Something happened</td> <td>Broadcast</td> <td><code>RegisterGameObjectBroadcast&lt;T&gt;</code></td> <td><code>msg.EmitGameObjectBroadcast(go)</code></td> </tr> <tr> <td>Observe all of type</td> <td>Targeted</td> <td><code>RegisterTargetedWithoutTargeting&lt;T&gt;</code></td> <td>(normal emission)</td> </tr> <tr> <td>Observe all sources</td> <td>Broadcast</td> <td><code>RegisterBroadcastWithoutSource&lt;T&gt;</code></td> <td>(normal emission)</td> </tr> </tbody> </table> <h2 id=common-mistakes>Common Mistakes<a class=headerlink href=#common-mistakes title="Anchor link to this section">&para;</a></h2> <p>When getting started with DxMessaging, watch out for these common pitfalls:</p> <h3 id=forgetting-to-enable-the-token>Forgetting to Enable the Token<a class=headerlink href=#forgetting-to-enable-the-token title="Anchor link to this section">&para;</a></h3> <p>Registrations are <strong>staged</strong> when you call <code>Register*</code> methods, but they don't become active until the token is enabled. If you're using <code>MessageAwareComponent</code>, this is handled automatically. If managing tokens manually, remember to call <code>Token.Enable()</code> after registering.</p> <h3 id=targeting-component-when-you-meant-gameobject-or-vice-versa>Targeting Component When You Meant GameObject (or Vice Versa)<a class=headerlink href=#targeting-component-when-you-meant-gameobject-or-vice-versa title="Anchor link to this section">&para;</a></h3> <p>Component-level targeting (<code>EmitComponentTargeted</code>) and GameObject-level targeting (<code>EmitGameObjectTargeted</code>) are distinct. A message emitted to a specific component won't be received by handlers registered at the GameObject level for the same object, and vice versa. Be deliberate about which level you're targeting.</p> <h3 id=forgetting-to-call-baseregistermessagehandlers>Forgetting to Call <code>base.RegisterMessageHandlers()</code><a class=headerlink href=#forgetting-to-call-baseregistermessagehandlers title="Anchor link to this section">&para;</a></h3> <p>See the warning in <a href=#the-pattern>The Pattern</a> above. Always call the base method first when overriding <code>RegisterMessageHandlers()</code>.</p> <h3 id=not-understanding-synchronous-handler-execution>Not Understanding Synchronous Handler Execution<a class=headerlink href=#not-understanding-synchronous-handler-execution title="Anchor link to this section">&para;</a></h3> <p>Message handlers are called <strong>synchronously</strong> and <strong>immediately</strong> when a message is emitted. This means:</p> <ul> <li>The emitting code blocks until all handlers complete</li> <li>Long-running handlers will cause frame hitches</li> <li>Handlers execute in registration order (modified by priority)</li> <li>Exceptions in handlers can affect other handlers if not caught</li> </ul> <p>Design your handlers to be fast and non-blocking.</p> <h2 id=next-steps>Next Steps<a class=headerlink href=#next-steps title="Anchor link to this section">&para;</a></h2> <ul> <li><a href=../message-types/ >Message Types</a>: Detailed reference for all three types</li> <li><a href=../listening-patterns/ >Listening Patterns</a>: All the ways to receive messages</li> <li><a href=../../getting-started/getting-started/ >Getting Started</a>: Hands-on walkthrough</li> <li><a href=../../guides/patterns/ >Patterns Guide</a>: Real-world usage patterns</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 29, 2026 05:02:02 UTC"><span class=timeago datetime=2026-01-29T05:02:02+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 29, 2026 05:02:02 UTC">2026-01-29</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 29, 2026 00:16:44 UTC"><span class=timeago datetime=2026-01-29T00:16:44+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 29, 2026 00:16:44 UTC">2026-01-29</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=../ class="md-footer__link md-footer__link--prev" aria-label="Previous: Concepts"> <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> Concepts </div> </div> </a> <a href=../message-types/ class="md-footer__link md-footer__link--next" aria-label="Next: Message Types"> <div class=md-footer__title> <span class=md-footer__direction> Next </span> <div class=md-ellipsis> Message Types </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>

package/site/concepts/mental-model/index.html.meta DELETED Viewed

@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: aa4b61f4b1b7e10429eca2d6d1dc8909
-TextScriptImporter:
-  externalObjects: {}
-  userData:
-  assetBundleName:
-  assetBundleVariant:

package/site/concepts/mental-model.meta DELETED Viewed

@@ -1,8 +0,0 @@
-fileFormatVersion: 2
-guid: e036ae13b7d31904ea7d44f81d768b33
-folderAsset: yes
-DefaultImporter:
-  externalObjects: {}
-  userData:
-  assetBundleName:
-  assetBundleVariant: