npm - com.wallstop-studios.dxmessaging - Versions diffs - 2.1.4 → 2.1.5 - Mend

com.wallstop-studios.dxmessaging 2.1.4 → 2.1.5

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

package/site/concepts/targeting-and-context/index.html ADDED Viewed

@@ -0,0 +1,201 @@
+<!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/targeting-and-context/ rel=canonical><link href=../listening-patterns/ rel=prev><link href=../interceptors-and-ordering/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.1"><title>Targeting & Context - 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=#targeting-and-context-component-vs-gameobject 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> Targeting & Context </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=../message-types/ 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> <label class=md-nav__link for=__nav_3 id=__nav_3_label tabindex> <span class=md-ellipsis> Concepts </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=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> <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 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> Targeting & Context </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Targeting & Context </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=#overview class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=#key-concepts class=md-nav__link> <span class=md-ellipsis> Key Concepts </span> </a> <nav class=md-nav aria-label="Key Concepts"> <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=#matching-rules class=md-nav__link> <span class=md-ellipsis> Matching Rules </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#understanding-gameobject-vs-component-targeting class=md-nav__link> <span class=md-ellipsis> Understanding GameObject vs Component Targeting </span> </a> <nav class=md-nav aria-label="Understanding GameObject vs Component Targeting"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-gameobject-targeting-means class=md-nav__link> <span class=md-ellipsis> What GameObject Targeting Means </span> </a> <nav class=md-nav aria-label="What GameObject Targeting Means"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#who-receives-it class=md-nav__link> <span class=md-ellipsis> Who receives it? </span> </a> <nav class=md-nav aria-label="Who receives it?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-when class=md-nav__link> <span class=md-ellipsis> Use when </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#what-component-targeting-means class=md-nav__link> <span class=md-ellipsis> What Component Targeting Means </span> </a> <nav class=md-nav aria-label="What Component Targeting Means"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#who-receives-it_1 class=md-nav__link> <span class=md-ellipsis> Who receives it? </span> </a> <nav class=md-nav aria-label="Who receives it?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-when_1 class=md-nav__link> <span class=md-ellipsis> Use when </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#visual-comparison-targeted-messages class=md-nav__link> <span class=md-ellipsis> Visual Comparison: Targeted Messages </span> </a> </li> <li class=md-nav__item> <a href=#broadcast-messages-same-rules-apply class=md-nav__link> <span class=md-ellipsis> Broadcast Messages: Same Rules Apply </span> </a> </li> <li class=md-nav__item> <a href=#the-this-trap class=md-nav__link> <span class=md-ellipsis> The this Trap </span> </a> </li> <li class=md-nav__item> <a href=#listening-to-all-events-global-observers class=md-nav__link> <span class=md-ellipsis> Listening to ALL Events (Global Observers) </span> </a> <nav class=md-nav aria-label="Listening to ALL Events (Global Observers)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#why-this-is-different-from-classic-event-buses class=md-nav__link> <span class=md-ellipsis> Why this is different from classic event buses </span> </a> </li> <li class=md-nav__item> <a href=#classic-event-bus-anti-pattern class=md-nav__link> <span class=md-ellipsis> Classic Event Bus Anti-Pattern </span> </a> </li> <li class=md-nav__item> <a href=#dxmessaging-global-observer-pattern class=md-nav__link> <span class=md-ellipsis> DxMessaging Global Observer Pattern </span> </a> </li> <li class=md-nav__item> <a href=#listening-to-all-targeted-messages class=md-nav__link> <span class=md-ellipsis> Listening to All Targeted Messages </span> </a> <nav class=md-nav aria-label="Listening to All Targeted Messages"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-cases class=md-nav__link> <span class=md-ellipsis> Use cases </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#listening-to-all-broadcast-messages class=md-nav__link> <span class=md-ellipsis> Listening to All Broadcast Messages </span> </a> <nav class=md-nav aria-label="Listening to All Broadcast Messages"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-cases_1 class=md-nav__link> <span class=md-ellipsis> Use cases </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#specific-vs-global-listeners-both-can-coexist class=md-nav__link> <span class=md-ellipsis> Specific vs Global Listeners: Both Can Coexist </span> </a> </li> <li class=md-nav__item> <a href=#real-world-example-combat-system class=md-nav__link> <span class=md-ellipsis> Real-World Example: Combat System </span> </a> </li> <li class=md-nav__item> <a href=#performance-note class=md-nav__link> <span class=md-ellipsis> Performance Note </span> </a> <nav class=md-nav aria-label="Performance Note"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#rule-of-thumb class=md-nav__link> <span class=md-ellipsis> Rule of thumb </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#when-to-use-which class=md-nav__link> <span class=md-ellipsis> When to Use Which </span> </a> <nav class=md-nav aria-label="When to Use Which"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#gameobject-context class=md-nav__link> <span class=md-ellipsis> GameObject Context </span> </a> <nav class=md-nav aria-label="GameObject Context"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-when_2 class=md-nav__link> <span class=md-ellipsis> Use when </span> </a> <nav class=md-nav aria-label="Use when"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#examples class=md-nav__link> <span class=md-ellipsis> Examples </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#component-context class=md-nav__link> <span class=md-ellipsis> Component Context </span> </a> <nav class=md-nav aria-label="Component Context"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-when_3 class=md-nav__link> <span class=md-ellipsis> Use when </span> </a> <nav class=md-nav aria-label="Use when"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#examples_1 class=md-nav__link> <span class=md-ellipsis> Examples </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#best-practices class=md-nav__link> <span class=md-ellipsis> Best Practices </span> </a> <nav class=md-nav aria-label="Best Practices"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#dos class=md-nav__link> <span class=md-ellipsis> Do's </span> </a> </li> <li class=md-nav__item> <a href=#donts class=md-nav__link> <span class=md-ellipsis> Don'ts </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#troubleshooting class=md-nav__link> <span class=md-ellipsis> Troubleshooting </span> </a> <nav class=md-nav aria-label=Troubleshooting> <ul class=md-nav__list> <li class=md-nav__item> <a href=#my-handler-isnt-firing class=md-nav__link> <span class=md-ellipsis> "My handler isn't firing!" </span> </a> <nav class=md-nav aria-label='"My handler isn&#39;t firing!"'> <ul class=md-nav__list> <li class=md-nav__item> <a href=#other-causes class=md-nav__link> <span class=md-ellipsis> Other causes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#quick-reference class=md-nav__link> <span class=md-ellipsis> Quick Reference </span> </a> </li> <li class=md-nav__item> <a href=#see-also class=md-nav__link> <span class=md-ellipsis> See Also </span> </a> </li> </ul> </nav> </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=#overview class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=#key-concepts class=md-nav__link> <span class=md-ellipsis> Key Concepts </span> </a> <nav class=md-nav aria-label="Key Concepts"> <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=#matching-rules class=md-nav__link> <span class=md-ellipsis> Matching Rules </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#understanding-gameobject-vs-component-targeting class=md-nav__link> <span class=md-ellipsis> Understanding GameObject vs Component Targeting </span> </a> <nav class=md-nav aria-label="Understanding GameObject vs Component Targeting"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-gameobject-targeting-means class=md-nav__link> <span class=md-ellipsis> What GameObject Targeting Means </span> </a> <nav class=md-nav aria-label="What GameObject Targeting Means"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#who-receives-it class=md-nav__link> <span class=md-ellipsis> Who receives it? </span> </a> <nav class=md-nav aria-label="Who receives it?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-when class=md-nav__link> <span class=md-ellipsis> Use when </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#what-component-targeting-means class=md-nav__link> <span class=md-ellipsis> What Component Targeting Means </span> </a> <nav class=md-nav aria-label="What Component Targeting Means"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#who-receives-it_1 class=md-nav__link> <span class=md-ellipsis> Who receives it? </span> </a> <nav class=md-nav aria-label="Who receives it?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-when_1 class=md-nav__link> <span class=md-ellipsis> Use when </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#visual-comparison-targeted-messages class=md-nav__link> <span class=md-ellipsis> Visual Comparison: Targeted Messages </span> </a> </li> <li class=md-nav__item> <a href=#broadcast-messages-same-rules-apply class=md-nav__link> <span class=md-ellipsis> Broadcast Messages: Same Rules Apply </span> </a> </li> <li class=md-nav__item> <a href=#the-this-trap class=md-nav__link> <span class=md-ellipsis> The this Trap </span> </a> </li> <li class=md-nav__item> <a href=#listening-to-all-events-global-observers class=md-nav__link> <span class=md-ellipsis> Listening to ALL Events (Global Observers) </span> </a> <nav class=md-nav aria-label="Listening to ALL Events (Global Observers)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#why-this-is-different-from-classic-event-buses class=md-nav__link> <span class=md-ellipsis> Why this is different from classic event buses </span> </a> </li> <li class=md-nav__item> <a href=#classic-event-bus-anti-pattern class=md-nav__link> <span class=md-ellipsis> Classic Event Bus Anti-Pattern </span> </a> </li> <li class=md-nav__item> <a href=#dxmessaging-global-observer-pattern class=md-nav__link> <span class=md-ellipsis> DxMessaging Global Observer Pattern </span> </a> </li> <li class=md-nav__item> <a href=#listening-to-all-targeted-messages class=md-nav__link> <span class=md-ellipsis> Listening to All Targeted Messages </span> </a> <nav class=md-nav aria-label="Listening to All Targeted Messages"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-cases class=md-nav__link> <span class=md-ellipsis> Use cases </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#listening-to-all-broadcast-messages class=md-nav__link> <span class=md-ellipsis> Listening to All Broadcast Messages </span> </a> <nav class=md-nav aria-label="Listening to All Broadcast Messages"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-cases_1 class=md-nav__link> <span class=md-ellipsis> Use cases </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#specific-vs-global-listeners-both-can-coexist class=md-nav__link> <span class=md-ellipsis> Specific vs Global Listeners: Both Can Coexist </span> </a> </li> <li class=md-nav__item> <a href=#real-world-example-combat-system class=md-nav__link> <span class=md-ellipsis> Real-World Example: Combat System </span> </a> </li> <li class=md-nav__item> <a href=#performance-note class=md-nav__link> <span class=md-ellipsis> Performance Note </span> </a> <nav class=md-nav aria-label="Performance Note"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#rule-of-thumb class=md-nav__link> <span class=md-ellipsis> Rule of thumb </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#when-to-use-which class=md-nav__link> <span class=md-ellipsis> When to Use Which </span> </a> <nav class=md-nav aria-label="When to Use Which"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#gameobject-context class=md-nav__link> <span class=md-ellipsis> GameObject Context </span> </a> <nav class=md-nav aria-label="GameObject Context"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-when_2 class=md-nav__link> <span class=md-ellipsis> Use when </span> </a> <nav class=md-nav aria-label="Use when"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#examples class=md-nav__link> <span class=md-ellipsis> Examples </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#component-context class=md-nav__link> <span class=md-ellipsis> Component Context </span> </a> <nav class=md-nav aria-label="Component Context"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-when_3 class=md-nav__link> <span class=md-ellipsis> Use when </span> </a> <nav class=md-nav aria-label="Use when"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#examples_1 class=md-nav__link> <span class=md-ellipsis> Examples </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#best-practices class=md-nav__link> <span class=md-ellipsis> Best Practices </span> </a> <nav class=md-nav aria-label="Best Practices"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#dos class=md-nav__link> <span class=md-ellipsis> Do's </span> </a> </li> <li class=md-nav__item> <a href=#donts class=md-nav__link> <span class=md-ellipsis> Don'ts </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#troubleshooting class=md-nav__link> <span class=md-ellipsis> Troubleshooting </span> </a> <nav class=md-nav aria-label=Troubleshooting> <ul class=md-nav__list> <li class=md-nav__item> <a href=#my-handler-isnt-firing class=md-nav__link> <span class=md-ellipsis> "My handler isn't firing!" </span> </a> <nav class=md-nav aria-label='"My handler isn&#39;t firing!"'> <ul class=md-nav__list> <li class=md-nav__item> <a href=#other-causes class=md-nav__link> <span class=md-ellipsis> Other causes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#quick-reference class=md-nav__link> <span class=md-ellipsis> Quick Reference </span> </a> </li> <li class=md-nav__item> <a href=#see-also class=md-nav__link> <span class=md-ellipsis> See Also </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=../message-types/ 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/targeting-and-context.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/targeting-and-context.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=targeting-and-context-component-vs-gameobject>Targeting and Context (Component vs GameObject)<a class=headerlink href=#targeting-and-context-component-vs-gameobject title="Anchor link to this section">&para;</a></h1> <p><strong>Critical Unity concept:</strong> Understanding GameObject vs Component targeting is essential for using DxMessaging effectively.</p> <h2 id=overview>Overview<a class=headerlink href=#overview title="Anchor link to this section">&para;</a></h2> <p>Targeted and broadcast messages carry context: an <code>InstanceId</code> for the target (targeted) or source (broadcast). In Unity, <code>InstanceId</code> can represent either a <code>GameObject</code> or a specific <code>Component</code>. <strong>These are completely separate channels</strong> — mixing them is the <a class="magiclink magiclink-github magiclink-issue" href=https://github.com/wallstop/DxMessaging/issues/1 title="GitHub Issue: wallstop/DxMessaging #1">#1</a> cause of "why isn't my handler firing?" bugs.</p> <h2 id=key-concepts>Key Concepts<a class=headerlink href=#key-concepts title="Anchor link to this section">&para;</a></h2> <h3 id=instanceid>InstanceId<a class=headerlink href=#instanceid title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>Implicit conversion:</strong> Automatically converts from both <code>GameObject</code> and <code>Component</code></li> <li><strong>Equality:</strong> Based on Unity's instance ID (internally stored as an <code>int</code>)</li> <li><strong>Matching:</strong> The bus compares <code>InstanceId</code> values for exact matches</li> <li><strong>Separate channels:</strong> GameObject and Component are distinct addresses</li> </ul> <h3 id=matching-rules>Matching Rules<a class=headerlink href=#matching-rules title="Anchor link to this section">&para;</a></h3> <ul> <li>A handler registered for a <code>GameObject</code> <strong>only</strong> receives messages emitted to that <code>GameObject</code></li> <li>A handler registered for a <code>Component</code> <strong>only</strong> receives messages emitted to that <code>Component</code></li> <li>Emitting to a <code>GameObject</code> does <strong>not</strong> reach Component-registered handlers (and vice versa)</li> <li>This applies to <strong>both</strong> targeted and broadcast messages</li> </ul> <h2 id=understanding-gameobject-vs-component-targeting>Understanding GameObject vs Component Targeting<a class=headerlink href=#understanding-gameobject-vs-component-targeting title="Anchor link to this section">&para;</a></h2> <h3 id=what-gameobject-targeting-means>What GameObject Targeting Means<a class=headerlink href=#what-gameobject-targeting-means title="Anchor link to this section">&para;</a></h3> <p>When you emit to a <strong>GameObject</strong>, you're saying: "This message is for whatever is attached to this GameObject."</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=na>[DxTargetedMessage]</span>
+</span><span id=__span-0-2><a id=__codelineno-0-2 name=__codelineno-0-2 href=#__codelineno-0-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-0-3><a id=__codelineno-0-3 name=__codelineno-0-3 href=#__codelineno-0-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>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-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=c1>// Emit to GameObject</span>
+</span><span id=__span-0-6><a id=__codelineno-0-6 name=__codelineno-0-6 href=#__codelineno-0-6></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-0-7><a id=__codelineno-0-7 name=__codelineno-0-7 href=#__codelineno-0-7></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> <h4 id=who-receives-it>Who receives it?<a class=headerlink href=#who-receives-it title="Anchor link to this section">&para;</a></h4> <ul> <li>Any Component on that GameObject that registered with <code>RegisterGameObjectTargeted</code></li> <li>Multiple components on the same GameObject can all receive it</li> <li>Components on child/parent GameObjects will NOT receive it</li> </ul> <h5 id=use-when>Use when<a class=headerlink href=#use-when title="Anchor link to this section">&para;</a></h5> <ul> <li>You don't care which specific component handles it</li> <li>You want flexibility (multiple components can respond)</li> <li>You're commanding "the player" or "the enemy" as a conceptual unit</li> </ul> <h3 id=what-component-targeting-means>What Component Targeting Means<a class=headerlink href=#what-component-targeting-means title="Anchor link to this section">&para;</a></h3> <p>When you emit to a <strong>Component</strong>, you're saying: "This message is specifically for this one Component instance."</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=c1>// Emit to specific Component</span>
+</span><span id=__span-1-2><a id=__codelineno-1-2 name=__codelineno-1-2 href=#__codelineno-1-2></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-3><a id=__codelineno-1-3 name=__codelineno-1-3 href=#__codelineno-1-3></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitComponentTargeted</span><span class=p>(</span><span class=n>playerHealthComponent</span><span class=p>);</span>
+</span></code></pre></div> <h4 id=who-receives-it_1>Who receives it?<a class=headerlink href=#who-receives-it_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>ONLY that specific Component instance</li> <li>Other components on the same GameObject will NOT receive it</li> <li>This is a direct, pinpoint message</li> </ul> <h5 id=use-when_1>Use when<a class=headerlink href=#use-when_1 title="Anchor link to this section">&para;</a></h5> <ul> <li>You have a reference to the exact component you want to message</li> <li>You need precise control (only this component, not its siblings)</li> <li>You're working with component-specific logic</li> </ul> <h2 id=visual-comparison-targeted-messages>Visual Comparison: Targeted Messages<a class=headerlink href=#visual-comparison-targeted-messages title="Anchor link to this section">&para;</a></h2> <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>// Setup: Player GameObject with multiple components</span>
+</span><span id=__span-2-2><a id=__codelineno-2-2 name=__codelineno-2-2 href=#__codelineno-2-2></a><span class=n>GameObject</span><span class=w> </span><span class=n>player</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=cm>/* ... */</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=n>HealthComponent</span><span class=w> </span><span class=n>health</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>player</span><span class=p>.</span><span class=n>GetComponent</span><span class=o>&lt;</span><span class=n>HealthComponent</span><span class=o>&gt;</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=n>UIComponent</span><span class=w> </span><span class=n>ui</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>player</span><span class=p>.</span><span class=n>GetComponent</span><span class=o>&lt;</span><span class=n>UIComponent</span><span class=o>&gt;</span><span class=p>();</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=c1>// Both components register for Heal on the GameObject</span>
+</span><span id=__span-2-7><a id=__codelineno-2-7 name=__codelineno-2-7 href=#__codelineno-2-7></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>healthToken</span><span class=p>.</span><span class=n>RegisterGameObjectTargeted</span><span class=o>&lt;</span><span class=n>Heal</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>health</span><span class=p>.</span><span class=n>OnHeal</span><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 class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>uiToken</span><span class=p>.</span><span class=n>RegisterGameObjectTargeted</span><span class=o>&lt;</span><span class=n>Heal</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>ui</span><span class=p>.</span><span class=n>OnHeal</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>// Scenario 1: Target the GameObject</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>player</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=c1>// ✅ health.OnHeal() fires</span>
+</span><span id=__span-2-13><a id=__codelineno-2-13 name=__codelineno-2-13 href=#__codelineno-2-13></a><span class=c1>// ✅ ui.OnHeal() fires</span>
+</span><span id=__span-2-14><a id=__codelineno-2-14 name=__codelineno-2-14 href=#__codelineno-2-14></a><span class=c1>// Both components receive it!</span>
+</span><span id=__span-2-15><a id=__codelineno-2-15 name=__codelineno-2-15 href=#__codelineno-2-15></a>
+</span><span id=__span-2-16><a id=__codelineno-2-16 name=__codelineno-2-16 href=#__codelineno-2-16></a><span class=c1>// Scenario 2: Target a Component (but registered for GameObject)</span>
+</span><span id=__span-2-17><a id=__codelineno-2-17 name=__codelineno-2-17 href=#__codelineno-2-17></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitComponentTargeted</span><span class=p>(</span><span class=n>health</span><span class=p>);</span>
+</span><span id=__span-2-18><a id=__codelineno-2-18 name=__codelineno-2-18 href=#__codelineno-2-18></a><span class=c1>// ❌ health.OnHeal() does NOT fire (registered for GameObject, not Component)</span>
+</span><span id=__span-2-19><a id=__codelineno-2-19 name=__codelineno-2-19 href=#__codelineno-2-19></a><span class=c1>// ❌ ui.OnHeal() does NOT fire</span>
+</span><span id=__span-2-20><a id=__codelineno-2-20 name=__codelineno-2-20 href=#__codelineno-2-20></a><span class=c1>// Nothing happens! Wrong channel!</span>
+</span><span id=__span-2-21><a id=__codelineno-2-21 name=__codelineno-2-21 href=#__codelineno-2-21></a>
+</span><span id=__span-2-22><a id=__codelineno-2-22 name=__codelineno-2-22 href=#__codelineno-2-22></a><span class=c1>// Scenario 3: Register for Component, emit to Component</span>
+</span><span id=__span-2-23><a id=__codelineno-2-23 name=__codelineno-2-23 href=#__codelineno-2-23></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>healthToken</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=n>health</span><span class=p>,</span><span class=w> </span><span class=n>health</span><span class=p>.</span><span class=n>OnHeal</span><span class=p>);</span>
+</span><span id=__span-2-24><a id=__codelineno-2-24 name=__codelineno-2-24 href=#__codelineno-2-24></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitComponentTargeted</span><span class=p>(</span><span class=n>health</span><span class=p>);</span>
+</span><span id=__span-2-25><a id=__codelineno-2-25 name=__codelineno-2-25 href=#__codelineno-2-25></a><span class=c1>// ✅ health.OnHeal() fires</span>
+</span><span id=__span-2-26><a id=__codelineno-2-26 name=__codelineno-2-26 href=#__codelineno-2-26></a><span class=c1>// ❌ ui.OnHeal() does NOT fire (different component)</span>
+</span></code></pre></div> <h2 id=broadcast-messages-same-rules-apply>Broadcast Messages: Same Rules Apply<a class=headerlink href=#broadcast-messages-same-rules-apply title="Anchor link to this section">&para;</a></h2> <p>Broadcast messages follow the exact same GameObject vs Component rules:</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=na>[DxBroadcastMessage]</span>
+</span><span id=__span-3-2><a id=__codelineno-3-2 name=__codelineno-3-2 href=#__codelineno-3-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-3-3><a id=__codelineno-3-3 name=__codelineno-3-3 href=#__codelineno-3-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>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-3-4><a id=__codelineno-3-4 name=__codelineno-3-4 href=#__codelineno-3-4></a>
+</span><span id=__span-3-5><a id=__codelineno-3-5 name=__codelineno-3-5 href=#__codelineno-3-5></a><span class=c1>// Broadcast from GameObject</span>
+</span><span id=__span-3-6><a id=__codelineno-3-6 name=__codelineno-3-6 href=#__codelineno-3-6></a><span class=kt>var</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>5</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=n>damage</span><span class=p>.</span><span class=n>EmitGameObjectBroadcast</span><span class=p>(</span><span class=n>enemyGameObject</span><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>// Register for broadcasts from this GameObject</span>
+</span><span id=__span-3-10><a id=__codelineno-3-10 name=__codelineno-3-10 href=#__codelineno-3-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>RegisterGameObjectBroadcast</span><span class=o>&lt;</span><span class=n>TookDamage</span><span class=o>&gt;</span><span class=p>(</span><span class=n>enemyGameObject</span><span class=p>,</span><span class=w> </span><span class=n>OnEnemyDamage</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=c1>// ✅ OnEnemyDamage fires when damage.EmitGameObjectBroadcast(enemyGameObject) is called</span>
+</span><span id=__span-3-12><a id=__codelineno-3-12 name=__codelineno-3-12 href=#__codelineno-3-12></a>
+</span><span id=__span-3-13><a id=__codelineno-3-13 name=__codelineno-3-13 href=#__codelineno-3-13></a><span class=c1>// Register for broadcasts from this Component</span>
+</span><span id=__span-3-14><a id=__codelineno-3-14 name=__codelineno-3-14 href=#__codelineno-3-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>RegisterComponentBroadcast</span><span class=o>&lt;</span><span class=n>TookDamage</span><span class=o>&gt;</span><span class=p>(</span><span class=n>enemyComponent</span><span class=p>,</span><span class=w> </span><span class=n>OnComponentDamage</span><span class=p>);</span>
+</span><span id=__span-3-15><a id=__codelineno-3-15 name=__codelineno-3-15 href=#__codelineno-3-15></a><span class=c1>// ❌ OnComponentDamage does NOT fire (registered for Component, but emitted from GameObject)</span>
+</span></code></pre></div> <h2 id=the-this-trap>The <code>this</code> Trap<a class=headerlink href=#the-this-trap title="Anchor link to this section">&para;</a></h2> <p><strong>Most common mistake:</strong> Using <code>this</code> in a MonoBehaviour and forgetting it's a Component, not a GameObject.</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=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>Enemy</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</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>void</span><span class=w> </span><span class=nf>Start</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=c1>// ❌ WRONG: Registered for GameObject</span>
+</span><span id=__span-4-6><a id=__codelineno-4-6 name=__codelineno-4-6 href=#__codelineno-4-6></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>RegisterGameObjectTargeted</span><span class=o>&lt;</span><span class=n>TakeDamage</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><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=p>}</span>
+</span><span id=__span-4-8><a id=__codelineno-4-8 name=__codelineno-4-8 href=#__codelineno-4-8></a>
+</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=k>void</span><span class=w> </span><span class=nf>TakeDamageFrom</span><span class=p>(</span><span class=n>GameObject</span><span class=w> </span><span class=n>attacker</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 class=w>        </span><span class=kt>var</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>TakeDamage</span><span class=p>(</span><span class=mi>10</span><span class=p>);</span>
+</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=c1>// ❌ WRONG: Emitting to Component (this)</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=n>damage</span><span class=p>.</span><span class=n>EmitAt</span><span class=p>(</span><span class=k>this</span><span class=p>);</span><span class=w>  </span><span class=c1>// WON&#39;T BE RECEIVED!</span>
+</span><span id=__span-4-14><a id=__codelineno-4-14 name=__codelineno-4-14 href=#__codelineno-4-14></a><span class=w>    </span><span class=p>}</span>
+</span><span id=__span-4-15><a id=__codelineno-4-15 name=__codelineno-4-15 href=#__codelineno-4-15></a>
+</span><span id=__span-4-16><a id=__codelineno-4-16 name=__codelineno-4-16 href=#__codelineno-4-16></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>TakeDamage</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=p>}</span>
+</span><span id=__span-4-17><a id=__codelineno-4-17 name=__codelineno-4-17 href=#__codelineno-4-17></a><span class=p>}</span>
+</span><span id=__span-4-18><a id=__codelineno-4-18 name=__codelineno-4-18 href=#__codelineno-4-18></a>
+</span><span id=__span-4-19><a id=__codelineno-4-19 name=__codelineno-4-19 href=#__codelineno-4-19></a><span class=c1>// FIX 1: Both use GameObject</span>
+</span><span id=__span-4-20><a id=__codelineno-4-20 name=__codelineno-4-20 href=#__codelineno-4-20></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>RegisterGameObjectTargeted</span><span class=o>&lt;</span><span class=n>TakeDamage</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><span id=__span-4-21><a id=__codelineno-4-21 name=__codelineno-4-21 href=#__codelineno-4-21></a><span class=n>damage</span><span class=p>.</span><span class=n>EmitAt</span><span class=p>(</span><span class=n>gameObject</span><span class=p>);</span><span class=w>  </span><span class=c1>// ✅ Works!</span>
+</span><span id=__span-4-22><a id=__codelineno-4-22 name=__codelineno-4-22 href=#__codelineno-4-22></a>
+</span><span id=__span-4-23><a id=__codelineno-4-23 name=__codelineno-4-23 href=#__codelineno-4-23></a><span class=c1>// FIX 2: Both use Component</span>
+</span><span id=__span-4-24><a id=__codelineno-4-24 name=__codelineno-4-24 href=#__codelineno-4-24></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>TakeDamage</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-4-25><a id=__codelineno-4-25 name=__codelineno-4-25 href=#__codelineno-4-25></a><span class=n>damage</span><span class=p>.</span><span class=n>EmitAt</span><span class=p>(</span><span class=k>this</span><span class=p>);</span><span class=w>  </span><span class=c1>// ✅ Works!</span>
+</span></code></pre></div> <p><strong>Remember:</strong> In Unity, <code>this</code> inside a <code>MonoBehaviour</code> is <strong>always</strong> a Component, never a GameObject!</p> <h2 id=listening-to-all-events-global-observers>Listening to ALL Events (Global Observers)<a class=headerlink href=#listening-to-all-events-global-observers title="Anchor link to this section">&para;</a></h2> <p><strong>Feature:</strong> DxMessaging allows listening to all targeted or broadcast messages <strong>without knowing the specific target or source</strong>.</p> <p>This is useful for:</p> <ul> <li><strong>Analytics</strong> — Track every action in your game without coupling to individual objects</li> <li><strong>Debugging</strong> — See all events of a type in one place</li> <li><strong>Cross-cutting concerns</strong> — Achievements, logging, VFX that respond to any entity's events</li> </ul> <h3 id=why-this-is-different-from-classic-event-buses>Why this is different from classic event buses<a class=headerlink href=#why-this-is-different-from-classic-event-buses title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Approach</th> <th>Classic Event Bus</th> <th>DxMessaging Global Observers</th> </tr> </thead> <tbody> <tr> <td><strong>Subscriptions needed</strong></td> <td>One per entity type</td> <td>One for ALL entities</td> </tr> <tr> <td><strong>Coupling</strong></td> <td>Tight (know all entity types)</td> <td>Zero (no knowledge needed)</td> </tr> <tr> <td><strong>New entity types</strong></td> <td>Update all subscribers</td> <td>Zero changes needed</td> </tr> <tr> <td><strong>Context</strong></td> <td>Lost (who was damaged?)</td> <td>Provided (source/target parameter)</td> </tr> </tbody> </table> <h3 id=classic-event-bus-anti-pattern>Classic Event Bus Anti-Pattern<a class=headerlink href=#classic-event-bus-anti-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-5-1><a id=__codelineno-5-1 name=__codelineno-5-1 href=#__codelineno-5-1></a><span class=c1>// ❌ Traditional approach: Tight coupling, multiple subscriptions</span>
+</span><span id=__span-5-2><a id=__codelineno-5-2 name=__codelineno-5-2 href=#__codelineno-5-2></a><span class=n>EventBus</span><span class=p>.</span><span class=n>PlayerDamaged</span><span class=w> </span><span class=o>+=</span><span class=w> </span><span class=n>OnPlayerDamaged</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>EventBus</span><span class=p>.</span><span class=n>EnemyDamaged</span><span class=w> </span><span class=o>+=</span><span class=w> </span><span class=n>OnEnemyDamaged</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 class=n>EventBus</span><span class=p>.</span><span class=n>NPCDamaged</span><span class=w> </span><span class=o>+=</span><span class=w> </span><span class=n>OnNPCDamaged</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=n>EventBus</span><span class=p>.</span><span class=n>BossDamaged</span><span class=w> </span><span class=o>+=</span><span class=w> </span><span class=n>OnBossDamaged</span><span class=p>;</span>
+</span><span id=__span-5-6><a id=__codelineno-5-6 name=__codelineno-5-6 href=#__codelineno-5-6></a><span class=c1>// Add new entity? Update EVERY analytics/logging system!</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=k>void</span><span class=w> </span><span class=nf>OnPlayerDamaged</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 class=w> </span><span class=n>RecordDamage</span><span class=p>(</span><span class=s>&quot;Player&quot;</span><span class=p>,</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-5-9><a id=__codelineno-5-9 name=__codelineno-5-9 href=#__codelineno-5-9></a><span class=k>void</span><span class=w> </span><span class=nf>OnEnemyDamaged</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 class=w> </span><span class=n>RecordDamage</span><span class=p>(</span><span class=s>&quot;Enemy&quot;</span><span class=p>,</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-5-10><a id=__codelineno-5-10 name=__codelineno-5-10 href=#__codelineno-5-10></a><span class=k>void</span><span class=w> </span><span class=nf>OnNPCDamaged</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 class=w> </span><span class=n>RecordDamage</span><span class=p>(</span><span class=s>&quot;NPC&quot;</span><span class=p>,</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-5-11><a id=__codelineno-5-11 name=__codelineno-5-11 href=#__codelineno-5-11></a><span class=k>void</span><span class=w> </span><span class=nf>OnBossDamaged</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 class=w> </span><span class=n>RecordDamage</span><span class=p>(</span><span class=s>&quot;Boss&quot;</span><span class=p>,</span><span class=w> </span><span class=n>amount</span><span class=p>);</span><span class=w> </span><span class=p>}</span>
+</span></code></pre></div> <h3 id=dxmessaging-global-observer-pattern>DxMessaging Global Observer Pattern<a class=headerlink href=#dxmessaging-global-observer-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-6-1><a id=__codelineno-6-1 name=__codelineno-6-1 href=#__codelineno-6-1></a><span class=c1>// ✅ DxMessaging: One subscription, zero coupling</span>
+</span><span id=__span-6-2><a id=__codelineno-6-2 name=__codelineno-6-2 href=#__codelineno-6-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>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-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=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-6-5><a id=__codelineno-6-5 name=__codelineno-6-5 href=#__codelineno-6-5></a><span class=p>{</span>
+</span><span id=__span-6-6><a id=__codelineno-6-6 name=__codelineno-6-6 href=#__codelineno-6-6></a><span class=w>    </span><span class=c1>// Works for Player, Enemy, NPC, Boss, and any future entity type!</span>
+</span><span id=__span-6-7><a id=__codelineno-6-7 name=__codelineno-6-7 href=#__codelineno-6-7></a><span class=w>    </span><span class=n>RecordDamage</span><span class=p>(</span><span class=n>source</span><span class=p>,</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-6-8><a id=__codelineno-6-8 name=__codelineno-6-8 href=#__codelineno-6-8></a><span class=p>}</span>
+</span><span id=__span-6-9><a id=__codelineno-6-9 name=__codelineno-6-9 href=#__codelineno-6-9></a><span class=c1>// Add new entity? Zero changes needed.</span>
+</span></code></pre></div> <h3 id=listening-to-all-targeted-messages>Listening to All Targeted Messages<a class=headerlink href=#listening-to-all-targeted-messages title="Anchor link to this section">&para;</a></h3> <p>Use <code>RegisterTargetedWithoutTargeting</code> to receive ALL targeted messages of a type, regardless of target:</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=na>[DxTargetedMessage]</span>
+</span><span id=__span-7-2><a id=__codelineno-7-2 name=__codelineno-7-2 href=#__codelineno-7-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-7-3><a id=__codelineno-7-3 name=__codelineno-7-3 href=#__codelineno-7-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>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-7-4><a id=__codelineno-7-4 name=__codelineno-7-4 href=#__codelineno-7-4></a>
+</span><span id=__span-7-5><a id=__codelineno-7-5 name=__codelineno-7-5 href=#__codelineno-7-5></a><span class=c1>// Listen to ALL heal messages, no matter who they&#39;re targeted at</span>
+</span><span id=__span-7-6><a id=__codelineno-7-6 name=__codelineno-7-6 href=#__codelineno-7-6></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>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-7-7><a id=__codelineno-7-7 name=__codelineno-7-7 href=#__codelineno-7-7></a>
+</span><span id=__span-7-8><a id=__codelineno-7-8 name=__codelineno-7-8 href=#__codelineno-7-8></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-7-9><a id=__codelineno-7-9 name=__codelineno-7-9 href=#__codelineno-7-9></a><span class=p>{</span>
+</span><span id=__span-7-10><a id=__codelineno-7-10 name=__codelineno-7-10 href=#__codelineno-7-10></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-7-11><a id=__codelineno-7-11 name=__codelineno-7-11 href=#__codelineno-7-11></a><span class=w>    </span><span class=c1>// You get the target as a parameter so you know WHO was healed</span>
+</span><span id=__span-7-12><a id=__codelineno-7-12 name=__codelineno-7-12 href=#__codelineno-7-12></a><span class=p>}</span>
+</span><span id=__span-7-13><a id=__codelineno-7-13 name=__codelineno-7-13 href=#__codelineno-7-13></a>
+</span><span id=__span-7-14><a id=__codelineno-7-14 name=__codelineno-7-14 href=#__codelineno-7-14></a><span class=c1>// Now when ANYONE emits a heal...</span>
+</span><span id=__span-7-15><a id=__codelineno-7-15 name=__codelineno-7-15 href=#__codelineno-7-15></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitAt</span><span class=p>(</span><span class=n>player</span><span class=p>);</span><span class=w>    </span><span class=c1>// OnAnyHeal fires with target = player</span>
+</span><span id=__span-7-16><a id=__codelineno-7-16 name=__codelineno-7-16 href=#__codelineno-7-16></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitAt</span><span class=p>(</span><span class=n>enemy</span><span class=p>);</span><span class=w>     </span><span class=c1>// OnAnyHeal fires with target = enemy</span>
+</span><span id=__span-7-17><a id=__codelineno-7-17 name=__codelineno-7-17 href=#__codelineno-7-17></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitAt</span><span class=p>(</span><span class=n>npc</span><span class=p>);</span><span class=w>       </span><span class=c1>// OnAnyHeal fires with target = npc</span>
+</span></code></pre></div> <h4 id=use-cases>Use cases<a class=headerlink href=#use-cases title="Anchor link to this section">&para;</a></h4> <ul> <li>Analytics ("track all damage dealt")</li> <li>Debugging ("log every heal in the game")</li> <li>Achievements ("count total kills")</li> <li>Global UI updates ("show floating damage numbers for any entity")</li> </ul> <h3 id=listening-to-all-broadcast-messages>Listening to All Broadcast Messages<a class=headerlink href=#listening-to-all-broadcast-messages title="Anchor link to this section">&para;</a></h3> <p>Use <code>RegisterBroadcastWithoutSource</code> to receive ALL broadcast messages of a type, regardless of source:</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=na>[DxBroadcastMessage]</span>
+</span><span id=__span-8-2><a id=__codelineno-8-2 name=__codelineno-8-2 href=#__codelineno-8-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-8-3><a id=__codelineno-8-3 name=__codelineno-8-3 href=#__codelineno-8-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>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-8-4><a id=__codelineno-8-4 name=__codelineno-8-4 href=#__codelineno-8-4></a>
+</span><span id=__span-8-5><a id=__codelineno-8-5 name=__codelineno-8-5 href=#__codelineno-8-5></a><span class=c1>// Listen to ALL damage events from any source</span>
+</span><span id=__span-8-6><a id=__codelineno-8-6 name=__codelineno-8-6 href=#__codelineno-8-6></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>OnAnyDamage</span><span class=p>);</span>
+</span><span id=__span-8-7><a id=__codelineno-8-7 name=__codelineno-8-7 href=#__codelineno-8-7></a>
+</span><span id=__span-8-8><a id=__codelineno-8-8 name=__codelineno-8-8 href=#__codelineno-8-8></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-8-9><a id=__codelineno-8-9 name=__codelineno-8-9 href=#__codelineno-8-9></a><span class=p>{</span>
+</span><span id=__span-8-10><a id=__codelineno-8-10 name=__codelineno-8-10 href=#__codelineno-8-10></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-8-11><a id=__codelineno-8-11 name=__codelineno-8-11 href=#__codelineno-8-11></a><span class=w>    </span><span class=c1>// You get the source as a parameter so you know WHO took damage</span>
+</span><span id=__span-8-12><a id=__codelineno-8-12 name=__codelineno-8-12 href=#__codelineno-8-12></a><span class=p>}</span>
+</span><span id=__span-8-13><a id=__codelineno-8-13 name=__codelineno-8-13 href=#__codelineno-8-13></a>
+</span><span id=__span-8-14><a id=__codelineno-8-14 name=__codelineno-8-14 href=#__codelineno-8-14></a><span class=c1>// Now when ANYONE broadcasts damage...</span>
+</span><span id=__span-8-15><a id=__codelineno-8-15 name=__codelineno-8-15 href=#__codelineno-8-15></a><span class=n>damage</span><span class=p>.</span><span class=n>EmitFrom</span><span class=p>(</span><span class=n>enemy</span><span class=p>);</span><span class=w>     </span><span class=c1>// OnAnyDamage fires with source = enemy</span>
+</span><span id=__span-8-16><a id=__codelineno-8-16 name=__codelineno-8-16 href=#__codelineno-8-16></a><span class=n>damage</span><span class=p>.</span><span class=n>EmitFrom</span><span class=p>(</span><span class=n>player</span><span class=p>);</span><span class=w>    </span><span class=c1>// OnAnyDamage fires with source = player</span>
+</span><span id=__span-8-17><a id=__codelineno-8-17 name=__codelineno-8-17 href=#__codelineno-8-17></a><span class=n>damage</span><span class=p>.</span><span class=n>EmitFrom</span><span class=p>(</span><span class=n>boss</span><span class=p>);</span><span class=w>      </span><span class=c1>// OnAnyDamage fires with source = boss</span>
+</span></code></pre></div> <h4 id=use-cases_1>Use cases<a class=headerlink href=#use-cases_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>Combat logs ("record all damage in the scene")</li> <li>Particle effects ("spawn blood VFX for any damage")</li> <li>Achievement tracking ("count enemy deaths")</li> <li>Analytics dashboards ("total damage per second")</li> </ul> <h3 id=specific-vs-global-listeners-both-can-coexist>Specific vs Global Listeners: Both Can Coexist<a class=headerlink href=#specific-vs-global-listeners-both-can-coexist title="Anchor link to this section">&para;</a></h3> <p>You can have BOTH specific listeners AND global listeners for the same message:</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=c1>// Specific listener: only cares about player damage</span>
+</span><span id=__span-9-2><a id=__codelineno-9-2 name=__codelineno-9-2 href=#__codelineno-9-2></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>playerToken</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>playerGameObject</span><span class=p>,</span><span class=w> </span><span class=n>OnPlayerDamage</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=c1>// Global listener: cares about ALL damage</span>
+</span><span id=__span-9-5><a id=__codelineno-9-5 name=__codelineno-9-5 href=#__codelineno-9-5></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>analyticsToken</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-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=c1>// When player takes damage</span>
+</span><span id=__span-9-8><a id=__codelineno-9-8 name=__codelineno-9-8 href=#__codelineno-9-8></a><span class=n>damage</span><span class=p>.</span><span class=n>EmitFrom</span><span class=p>(</span><span class=n>playerGameObject</span><span class=p>);</span>
+</span><span id=__span-9-9><a id=__codelineno-9-9 name=__codelineno-9-9 href=#__codelineno-9-9></a><span class=c1>// ✅ OnPlayerDamage fires (specific listener)</span>
+</span><span id=__span-9-10><a id=__codelineno-9-10 name=__codelineno-9-10 href=#__codelineno-9-10></a><span class=c1>// ✅ OnAnyDamage fires (global listener)</span>
+</span><span id=__span-9-11><a id=__codelineno-9-11 name=__codelineno-9-11 href=#__codelineno-9-11></a><span class=c1>// Both fire!</span>
+</span><span id=__span-9-12><a id=__codelineno-9-12 name=__codelineno-9-12 href=#__codelineno-9-12></a>
+</span><span id=__span-9-13><a id=__codelineno-9-13 name=__codelineno-9-13 href=#__codelineno-9-13></a><span class=c1>// When enemy takes damage</span>
+</span><span id=__span-9-14><a id=__codelineno-9-14 name=__codelineno-9-14 href=#__codelineno-9-14></a><span class=n>damage</span><span class=p>.</span><span class=n>EmitFrom</span><span class=p>(</span><span class=n>enemyGameObject</span><span class=p>);</span>
+</span><span id=__span-9-15><a id=__codelineno-9-15 name=__codelineno-9-15 href=#__codelineno-9-15></a><span class=c1>// ❌ OnPlayerDamage does NOT fire (wrong source)</span>
+</span><span id=__span-9-16><a id=__codelineno-9-16 name=__codelineno-9-16 href=#__codelineno-9-16></a><span class=c1>// ✅ OnAnyDamage fires (global listener catches everything)</span>
+</span></code></pre></div> <h3 id=real-world-example-combat-system>Real-World Example: Combat System<a class=headerlink href=#real-world-example-combat-system title="Anchor link to this section">&para;</a></h3> <p>Here's how to combine specific and global listeners in a combat system:</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>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>Player</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span>
+</span><span id=__span-10-2><a id=__codelineno-10-2 name=__codelineno-10-2 href=#__codelineno-10-2></a><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=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-10-4><a id=__codelineno-10-4 name=__codelineno-10-4 href=#__codelineno-10-4></a><span class=w>    </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 class=w>        </span><span class=c1>// Listen only to damage targeting THIS player</span>
+</span><span id=__span-10-6><a id=__codelineno-10-6 name=__codelineno-10-6 href=#__codelineno-10-6></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>gameObject</span><span class=p>,</span><span class=w> </span><span class=n>OnPlayerTookDamage</span><span class=p>);</span>
+</span><span id=__span-10-7><a id=__codelineno-10-7 name=__codelineno-10-7 href=#__codelineno-10-7></a><span class=w>    </span><span class=p>}</span>
+</span><span id=__span-10-8><a id=__codelineno-10-8 name=__codelineno-10-8 href=#__codelineno-10-8></a>
+</span><span id=__span-10-9><a id=__codelineno-10-9 name=__codelineno-10-9 href=#__codelineno-10-9></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnPlayerTookDamage</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><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=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=c1>// Player-specific logic: update health bar, play hurt sound</span>
+</span><span id=__span-10-12><a id=__codelineno-10-12 name=__codelineno-10-12 href=#__codelineno-10-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>msg</span><span class=p>.</span><span class=n>amount</span><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 class=w>        </span><span class=n>PlayHurtSound</span><span class=p>();</span>
+</span><span id=__span-10-14><a id=__codelineno-10-14 name=__codelineno-10-14 href=#__codelineno-10-14></a><span class=w>    </span><span class=p>}</span>
+</span><span id=__span-10-15><a id=__codelineno-10-15 name=__codelineno-10-15 href=#__codelineno-10-15></a><span class=p>}</span>
+</span><span id=__span-10-16><a id=__codelineno-10-16 name=__codelineno-10-16 href=#__codelineno-10-16></a>
+</span><span id=__span-10-17><a id=__codelineno-10-17 name=__codelineno-10-17 href=#__codelineno-10-17></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>CombatLog</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span>
+</span><span id=__span-10-18><a id=__codelineno-10-18 name=__codelineno-10-18 href=#__codelineno-10-18></a><span class=p>{</span>
+</span><span id=__span-10-19><a id=__codelineno-10-19 name=__codelineno-10-19 href=#__codelineno-10-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><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=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=c1>// Listen to ALL damage from ANY source (global observer)</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=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>OnAnyDamage</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=p>}</span>
+</span><span id=__span-10-24><a id=__codelineno-10-24 name=__codelineno-10-24 href=#__codelineno-10-24></a>
+</span><span id=__span-10-25><a id=__codelineno-10-25 name=__codelineno-10-25 href=#__codelineno-10-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=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-10-26><a id=__codelineno-10-26 name=__codelineno-10-26 href=#__codelineno-10-26></a><span class=w>    </span><span class=p>{</span>
+</span><span id=__span-10-27><a id=__codelineno-10-27 name=__codelineno-10-27 href=#__codelineno-10-27></a><span class=w>        </span><span class=c1>// Global combat logging</span>
+</span><span id=__span-10-28><a id=__codelineno-10-28 name=__codelineno-10-28 href=#__codelineno-10-28></a><span class=w>        </span><span class=n>LogToFile</span><span class=p>(</span><span class=s>$&quot;{Time.time}: {source} took {msg.amount} damage&quot;</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=p>}</span>
+</span><span id=__span-10-30><a id=__codelineno-10-30 name=__codelineno-10-30 href=#__codelineno-10-30></a><span class=p>}</span>
+</span><span id=__span-10-31><a id=__codelineno-10-31 name=__codelineno-10-31 href=#__codelineno-10-31></a>
+</span><span id=__span-10-32><a id=__codelineno-10-32 name=__codelineno-10-32 href=#__codelineno-10-32></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>AchievementSystem</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MessageAwareComponent</span>
+</span><span id=__span-10-33><a id=__codelineno-10-33 name=__codelineno-10-33 href=#__codelineno-10-33></a><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=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-10-35><a id=__codelineno-10-35 name=__codelineno-10-35 href=#__codelineno-10-35></a><span class=w>    </span><span class=p>{</span>
+</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=c1>// Listen to ALL damage targeting ANY entity (global observer)</span>
+</span><span id=__span-10-37><a id=__codelineno-10-37 name=__codelineno-10-37 href=#__codelineno-10-37></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>RegisterTargetedWithoutTargeting</span><span class=o>&lt;</span><span class=n>DealDamage</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnAnyDamageDealt</span><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 class=w>    </span><span class=p>}</span>
+</span><span id=__span-10-39><a id=__codelineno-10-39 name=__codelineno-10-39 href=#__codelineno-10-39></a>
+</span><span id=__span-10-40><a id=__codelineno-10-40 name=__codelineno-10-40 href=#__codelineno-10-40></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnAnyDamageDealt</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>DealDamage</span><span class=w> </span><span class=n>msg</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=p>{</span>
+</span><span id=__span-10-42><a id=__codelineno-10-42 name=__codelineno-10-42 href=#__codelineno-10-42></a><span class=w>        </span><span class=c1>// Track total damage dealt for achievements</span>
+</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=n>totalDamageDealt</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-44><a id=__codelineno-10-44 name=__codelineno-10-44 href=#__codelineno-10-44></a><span class=w>        </span><span class=n>CheckDamageAchievements</span><span class=p>();</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=p>}</span>
+</span><span id=__span-10-46><a id=__codelineno-10-46 name=__codelineno-10-46 href=#__codelineno-10-46></a><span class=p>}</span>
+</span></code></pre></div> <h3 id=performance-note>Performance Note<a class=headerlink href=#performance-note title="Anchor link to this section">&para;</a></h3> <p>Global listeners (<code>RegisterTargetedWithoutTargeting</code> / <code>RegisterBroadcastWithoutSource</code>) are <strong>slightly slower</strong> than specific listeners because they receive every message of that type. This is usually negligible, but avoid them in hot paths if you're emitting thousands of messages per frame.</p> <h4 id=rule-of-thumb>Rule of thumb<a class=headerlink href=#rule-of-thumb title="Anchor link to this section">&para;</a></h4> <ul> <li>For gameplay (&lt; 100 messages/frame): Use freely</li> <li>For analytics/debugging: Perfect use case</li> <li>For tight loops (&gt; 1000 messages/frame): Prefer specific listeners</li> </ul> <h2 id=when-to-use-which>When to Use Which<a class=headerlink href=#when-to-use-which title="Anchor link to this section">&para;</a></h2> <h3 id=gameobject-context>GameObject Context<a class=headerlink href=#gameobject-context title="Anchor link to this section">&para;</a></h3> <h4 id=use-when_2>Use when<a class=headerlink href=#use-when_2 title="Anchor link to this section">&para;</a></h4> <ul> <li>The whole object is the logical target/source (e.g., "Player was healed", "Enemy took damage")</li> <li>Multiple components should coordinate under the same address</li> <li>You don't care which specific component handles it</li> <li>You want flexibility for future refactoring (adding/removing components)</li> </ul> <h5 id=examples>Examples<a class=headerlink href=#examples title="Anchor link to this section">&para;</a></h5> <ul> <li>Combat: "Deal damage to this enemy"</li> <li>UI: "Update all panels related to this character"</li> <li>State: "Notify all systems that this entity died"</li> </ul> <h3 id=component-context>Component Context<a class=headerlink href=#component-context title="Anchor link to this section">&para;</a></h3> <h4 id=use-when_3>Use when<a class=headerlink href=#use-when_3 title="Anchor link to this section">&para;</a></h4> <ul> <li>The message is explicitly for one component's responsibility (e.g., "open JUST this DoorController")</li> <li>Multiple components on the same GameObject must be independently addressable</li> <li>You need pinpoint precision</li> <li>You have a direct reference to the target component</li> </ul> <h5 id=examples_1>Examples<a class=headerlink href=#examples_1 title="Anchor link to this section">&para;</a></h5> <ul> <li>UI: "Update this specific health bar, not the mana bar"</li> <li>Animation: "Tell this animator to play a clip"</li> <li>Physics: "Toggle this specific collider"</li> </ul> <h2 id=best-practices>Best Practices<a class=headerlink href=#best-practices title="Anchor link to this section">&para;</a></h2> <h3 id=dos>Do's<a class=headerlink href=#dos title="Anchor link to this section">&para;</a></h3> <p>✅ <strong>Pick a context and be consistent</strong> across emitters and listeners for that message type ✅ <strong>Prefer GameObject when in doubt</strong> — easier coordination among components on the same object ✅ <strong>Use explicit helpers</strong> (<code>EmitGameObjectTargeted</code>, <code>RegisterGameObjectTargeted</code>) to make intent clear ✅ <strong>Document</strong> which context your message types use (add it to your message comments) ✅ <strong>Use global listeners</strong> for analytics, debugging, and cross-cutting concerns</p> <h3 id=donts>Don'ts<a class=headerlink href=#donts title="Anchor link to this section">&para;</a></h3> <p>❌ <strong>Don't emit to GameObject</strong> and expect Component-registered handlers to receive it (and vice versa) ❌ <strong>Don't assume <code>this</code> means GameObject</strong> — it's always a Component in Unity ❌ <strong>Don't mix GameObject/Component</strong> for the same message type across your codebase ❌ <strong>Don't register the same handler under both</strong> unless you intend to handle both contexts ❌ <strong>Don't use global listeners</strong> in performance-critical tight loops (thousands of messages/frame)</p> <h2 id=troubleshooting>Troubleshooting<a class=headerlink href=#troubleshooting title="Anchor link to this section">&para;</a></h2> <h3 id=my-handler-isnt-firing>"My handler isn't firing!"<a class=headerlink href=#my-handler-isnt-firing title="Anchor link to this section">&para;</a></h3> <p><strong>Most likely cause:</strong> GameObject/Component mismatch</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=c1>// Check 1: Are you emitting and registering on the same type?</span>
+</span><span id=__span-11-2><a id=__codelineno-11-2 name=__codelineno-11-2 href=#__codelineno-11-2></a><span class=c1>// ❌ WRONG</span>
+</span><span id=__span-11-3><a id=__codelineno-11-3 name=__codelineno-11-3 href=#__codelineno-11-3></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>RegisterGameObjectTargeted</span><span class=o>&lt;</span><span class=n>Heal</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>OnHeal</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=n>heal</span><span class=p>.</span><span class=n>EmitAt</span><span class=p>(</span><span class=k>this</span><span class=p>);</span><span class=w>  </span><span class=c1>// Component, not GameObject!</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>// ✅ CORRECT</span>
+</span><span id=__span-11-7><a id=__codelineno-11-7 name=__codelineno-11-7 href=#__codelineno-11-7></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>RegisterGameObjectTargeted</span><span class=o>&lt;</span><span class=n>Heal</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>OnHeal</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=n>heal</span><span class=p>.</span><span class=n>EmitAt</span><span class=p>(</span><span class=n>gameObject</span><span class=p>);</span><span class=w>  </span><span class=c1>// Both GameObject</span>
+</span></code></pre></div> <h4 id=other-causes>Other causes<a class=headerlink href=#other-causes title="Anchor link to this section">&para;</a></h4> <ol> <li>Handler not enabled (call <code>token.Enable()</code> in <code>OnEnable</code>)</li> <li>Registration happened after emission</li> <li>Using wrong bus (local vs global)</li> </ol> <p>See <a href=../../reference/troubleshooting/ >Troubleshooting</a> for more debugging tips.</p> <h2 id=quick-reference>Quick Reference<a class=headerlink href=#quick-reference title="Anchor link to this section">&para;</a></h2> <table> <thead> <tr> <th>Operation</th> <th>GameObject Variant</th> <th>Component Variant</th> </tr> </thead> <tbody> <tr> <td><strong>Emit Targeted</strong></td> <td><code>msg.EmitGameObjectTargeted(go)</code></td> <td><code>msg.EmitComponentTargeted(comp)</code></td> </tr> <tr> <td><strong>Emit Broadcast</strong></td> <td><code>msg.EmitGameObjectBroadcast(go)</code></td> <td><code>msg.EmitComponentBroadcast(comp)</code></td> </tr> <tr> <td><strong>Register Targeted</strong></td> <td><code>RegisterGameObjectTargeted&lt;T&gt;(go, handler)</code></td> <td><code>RegisterComponentTargeted&lt;T&gt;(comp, handler)</code></td> </tr> <tr> <td><strong>Register Broadcast</strong></td> <td><code>RegisterGameObjectBroadcast&lt;T&gt;(go, handler)</code></td> <td><code>RegisterComponentBroadcast&lt;T&gt;(comp, handler)</code></td> </tr> <tr> <td><strong>Global Targeted</strong></td> <td><code>RegisterTargetedWithoutTargeting&lt;T&gt;(handler)</code></td> <td>(Same — no distinction)</td> </tr> <tr> <td><strong>Global Broadcast</strong></td> <td><code>RegisterBroadcastWithoutSource&lt;T&gt;(handler)</code></td> <td>(Same — no distinction)</td> </tr> </tbody> </table> <h2 id=see-also>See Also<a class=headerlink href=#see-also title="Anchor link to this section">&para;</a></h2> <ul> <li><strong><a href=../../advanced/emit-shorthands/ >Emit Shorthands</a></strong> — Concise ways to emit messages</li> <li><strong><a href=../message-types/ >Message Types</a></strong> — Understanding Untargeted, Targeted, and Broadcast</li> <li><strong><a href=../../guides/unity-integration/ >Unity Integration</a></strong> — MessageAwareComponent and lifecycle</li> <li><strong><a href=../../reference/quick-reference/ >Quick Reference</a></strong> — API cheat sheet</li> <li><strong><a href=../../reference/troubleshooting/ >Troubleshooting</a></strong> — Solving common issues</li> </ul> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 26, 2026 18:15:02 UTC"><span class=timeago datetime=2026-01-26T18:15:02+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 26, 2026 18:15:02 UTC">2026-01-26</span> </span> <span class=md-source-file__fact> <span class=md-icon title=Created> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M14.47 15.08 11 13V7h1.5v5.25l3.08 1.83c-.41.28-.79.62-1.11 1m-1.39 4.84c-.36.05-.71.08-1.08.08-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8c0 .37-.03.72-.08 1.08.69.1 1.33.32 1.92.64.1-.56.16-1.13.16-1.72 0-5.5-4.5-10-10-10S2 6.5 2 12s4.47 10 10 10c.59 0 1.16-.06 1.72-.16-.32-.59-.54-1.23-.64-1.92M18 15v3h-3v2h3v3h2v-3h3v-2h-3v-3z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 26, 2026 18:15:02 UTC"><span class=timeago datetime=2026-01-26T18:15:02+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 26, 2026 18:15:02 UTC">2026-01-26</span> </span> </aside> </article> </div> <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg> Back to top </button> </main> <footer class=md-footer> <nav class="md-footer__inner md-grid" aria-label=Footer> <a href=../listening-patterns/ class="md-footer__link md-footer__link--prev" aria-label="Previous: Listening Patterns"> <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> Listening Patterns </div> </div> </a> <a href=../interceptors-and-ordering/ class="md-footer__link md-footer__link--next" aria-label="Next: Interceptors & Ordering"> <div class=md-footer__title> <span class=md-footer__direction> Next </span> <div class=md-ellipsis> Interceptors & Ordering </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/targeting-and-context/index.html.meta ADDED Viewed

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

package/site/concepts/targeting-and-context.meta ADDED Viewed

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

package/site/concepts.meta ADDED Viewed

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

package/site/css/timeago.css ADDED Viewed

@@ -0,0 +1,15 @@
+/*
+ timeago output is dynamic, which breaks when you print a page.
+ This CSS is only included when type: timeago
+ and ensures fallback to type "iso_date" when printing.
+ */
+.git-revision-date-localized-plugin-iso_date { display: none }
+@media print {
+    .git-revision-date-localized-plugin-iso_date { display: inline }
+    .git-revision-date-localized-plugin-timeago { display: none }
+}

package/site/css/timeago.css.meta ADDED Viewed

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 8d4f91833ac316840aa82739e6480b36
+DefaultImporter:
+  externalObjects: {}
+  userData:
+  assetBundleName:
+  assetBundleVariant:

package/site/css.meta ADDED Viewed

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