npm - com.wallstop-studios.dxmessaging - Versions diffs - 2.1.6 → 2.1.8 - Mend

com.wallstop-studios.dxmessaging 2.1.6 → 2.1.8

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

package/site/advanced/runtime-configuration/index.html DELETED Viewed

@@ -1,196 +0,0 @@
-<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="High-performance type-safe messaging library for Unity"><meta name=author content="Wallstop Studios"><link href=https://wallstop.github.io/DxMessaging/advanced/runtime-configuration/ rel=canonical><link href=../registration-builders/ rel=prev><link href=../string-messages/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.1"><title>Runtime Configuration - 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=#runtime-message-bus-configuration 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> Runtime Configuration </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to dark mode" type=radio name=__palette id=__palette_0> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> <input class=md-option data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme=slate data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to light mode" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_0 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <a href=javascript:void(0) class="md-search__icon md-icon" title=Share aria-label=Share data-clipboard data-clipboard-text data-md-component=search-share tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg> </a> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> <div class=md-search__suggest data-md-component=search-suggest></div> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> </nav> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Home </a> </li> <li class=md-tabs__item> <a href=../../getting-started/ class=md-tabs__link> Getting Started </a> </li> <li class=md-tabs__item> <a href=../../concepts/ class=md-tabs__link> Concepts </a> </li> <li class=md-tabs__item> <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 md-tabs__item--active"> <a href=../emit-shorthands/ class=md-tabs__link> Advanced </a> </li> <li class=md-tabs__item> <a href=../../integrations/ class=md-tabs__link> Integrations </a> </li> <li class=md-tabs__item> <a href=../../examples/end-to-end/ class=md-tabs__link> Examples </a> </li> <li class=md-tabs__item> <a href=../../reference/reference/ class=md-tabs__link> Reference </a> </li> </ul> </div> </nav> </header> <div class=md-container data-md-component=container> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="DxMessaging Documentation" class="md-nav__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> DxMessaging Documentation </label> <div class=md-nav__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Home </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_2> <div class="md-nav__link md-nav__container"> <a href=../../getting-started/ class="md-nav__link "> <span class=md-ellipsis> Getting Started </span> </a> <label class="md-nav__link " for=__nav_2 id=__nav_2_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_2_label aria-expanded=false> <label class=md-nav__title for=__nav_2> <span class="md-nav__icon md-icon"></span> Getting Started </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../getting-started/overview/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/install/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/quick-start/ class=md-nav__link> <span class=md-ellipsis> Quick Start </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/getting-started/ class=md-nav__link> <span class=md-ellipsis> Getting Started Guide </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/visual-guide/ class=md-nav__link> <span class=md-ellipsis> Visual Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_3> <div class="md-nav__link md-nav__container"> <a href=../../concepts/ class="md-nav__link "> <span class=md-ellipsis> Concepts </span> </a> <label class="md-nav__link " for=__nav_3 id=__nav_3_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3> <span class="md-nav__icon md-icon"></span> Concepts </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../concepts/mental-model/ class=md-nav__link> <span class=md-ellipsis> Mental Model </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/message-types/ class=md-nav__link> <span class=md-ellipsis> Message Types </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/listening-patterns/ class=md-nav__link> <span class=md-ellipsis> Listening Patterns </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/targeting-and-context/ class=md-nav__link> <span class=md-ellipsis> Targeting & Context </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/interceptors-and-ordering/ class=md-nav__link> <span class=md-ellipsis> Interceptors & Ordering </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--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--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6 checked> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex> <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=true> <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=../emit-shorthands/ class=md-nav__link> <span class=md-ellipsis> Emit Shorthands </span> </a> </li> <li class=md-nav__item> <a href=../message-bus-providers/ class=md-nav__link> <span class=md-ellipsis> Message Bus Providers </span> </a> </li> <li class=md-nav__item> <a href=../registration-builders/ class=md-nav__link> <span class=md-ellipsis> Registration Builders </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> Runtime Configuration </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Runtime Configuration </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=#table-of-contents class=md-nav__link> <span class=md-ellipsis> Table of Contents </span> </a> </li> <li class=md-nav__item> <a href=#when-you-need-this class=md-nav__link> <span class=md-ellipsis> When You Need This </span> </a> </li> <li class=md-nav__item> <a href=#global-message-bus-management class=md-nav__link> <span class=md-ellipsis> Global Message Bus Management </span> </a> <nav class=md-nav aria-label="Global Message Bus Management"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#replacing-the-global-bus class=md-nav__link> <span class=md-ellipsis> Replacing the Global Bus </span> </a> <nav class=md-nav aria-label="Replacing the Global Bus"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#temporarily-overriding-the-global-bus class=md-nav__link> <span class=md-ellipsis> Temporarily Overriding the Global Bus </span> </a> <nav class=md-nav aria-label="Temporarily Overriding the Global Bus"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_1 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#resetting-to-the-default-bus class=md-nav__link> <span class=md-ellipsis> Resetting to the Default Bus </span> </a> <nav class=md-nav aria-label="Resetting to the Default Bus"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_2 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#accessing-the-original-startup-bus class=md-nav__link> <span class=md-ellipsis> Accessing the Original Startup Bus </span> </a> <nav class=md-nav aria-label="Accessing the Original Startup Bus"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_3 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#example-bootstrapping-a-di-container class=md-nav__link> <span class=md-ellipsis> Example: Bootstrapping a DI Container </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#re-binding-registrations class=md-nav__link> <span class=md-ellipsis> Re-binding Registrations </span> </a> <nav class=md-nav aria-label="Re-binding Registrations"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#the-messagebusrebindmode-enum class=md-nav__link> <span class=md-ellipsis> The MessageBusRebindMode Enum </span> </a> <nav class=md-nav aria-label="The MessageBusRebindMode Enum"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#preserveregistrations class=md-nav__link> <span class=md-ellipsis> PreserveRegistrations </span> </a> <nav class=md-nav aria-label=PreserveRegistrations> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_4 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#rebindactive class=md-nav__link> <span class=md-ellipsis> RebindActive </span> </a> <nav class=md-nav aria-label=RebindActive> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_5 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#retarget-a-token-directly class=md-nav__link> <span class=md-ellipsis> Retarget a Token Directly </span> </a> <nav class=md-nav aria-label="Retarget a Token Directly"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_6 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#example-scene-specific-buses class=md-nav__link> <span class=md-ellipsis> Example: Scene-Specific Buses </span> </a> <nav class=md-nav aria-label="Example: Scene-Specific Buses"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#why-this-is-useful class=md-nav__link> <span class=md-ellipsis> Why this is useful </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#common-patterns class=md-nav__link> <span class=md-ellipsis> Common Patterns </span> </a> <nav class=md-nav aria-label="Common Patterns"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#pattern-1-test-isolation class=md-nav__link> <span class=md-ellipsis> Pattern 1: Test Isolation </span> </a> </li> <li class=md-nav__item> <a href=#pattern-2-temporary-override-with-automatic-cleanup class=md-nav__link> <span class=md-ellipsis> Pattern 2: Temporary Override with Automatic Cleanup </span> </a> </li> <li class=md-nav__item> <a href=#pattern-3-di-container-integration class=md-nav__link> <span class=md-ellipsis> Pattern 3: DI Container Integration </span> </a> </li> <li class=md-nav__item> <a href=#pattern-4-dynamic-component-reconfiguration class=md-nav__link> <span class=md-ellipsis> Pattern 4: Dynamic Component Reconfiguration </span> </a> </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=../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=#table-of-contents class=md-nav__link> <span class=md-ellipsis> Table of Contents </span> </a> </li> <li class=md-nav__item> <a href=#when-you-need-this class=md-nav__link> <span class=md-ellipsis> When You Need This </span> </a> </li> <li class=md-nav__item> <a href=#global-message-bus-management class=md-nav__link> <span class=md-ellipsis> Global Message Bus Management </span> </a> <nav class=md-nav aria-label="Global Message Bus Management"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#replacing-the-global-bus class=md-nav__link> <span class=md-ellipsis> Replacing the Global Bus </span> </a> <nav class=md-nav aria-label="Replacing the Global Bus"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#temporarily-overriding-the-global-bus class=md-nav__link> <span class=md-ellipsis> Temporarily Overriding the Global Bus </span> </a> <nav class=md-nav aria-label="Temporarily Overriding the Global Bus"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_1 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#resetting-to-the-default-bus class=md-nav__link> <span class=md-ellipsis> Resetting to the Default Bus </span> </a> <nav class=md-nav aria-label="Resetting to the Default Bus"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_2 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#accessing-the-original-startup-bus class=md-nav__link> <span class=md-ellipsis> Accessing the Original Startup Bus </span> </a> <nav class=md-nav aria-label="Accessing the Original Startup Bus"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_3 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#example-bootstrapping-a-di-container class=md-nav__link> <span class=md-ellipsis> Example: Bootstrapping a DI Container </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#re-binding-registrations class=md-nav__link> <span class=md-ellipsis> Re-binding Registrations </span> </a> <nav class=md-nav aria-label="Re-binding Registrations"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#the-messagebusrebindmode-enum class=md-nav__link> <span class=md-ellipsis> The MessageBusRebindMode Enum </span> </a> <nav class=md-nav aria-label="The MessageBusRebindMode Enum"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#preserveregistrations class=md-nav__link> <span class=md-ellipsis> PreserveRegistrations </span> </a> <nav class=md-nav aria-label=PreserveRegistrations> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_4 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#rebindactive class=md-nav__link> <span class=md-ellipsis> RebindActive </span> </a> <nav class=md-nav aria-label=RebindActive> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_5 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#retarget-a-token-directly class=md-nav__link> <span class=md-ellipsis> Retarget a Token Directly </span> </a> <nav class=md-nav aria-label="Retarget a Token Directly"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#when-to-use-this_6 class=md-nav__link> <span class=md-ellipsis> When to use this </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#example-scene-specific-buses class=md-nav__link> <span class=md-ellipsis> Example: Scene-Specific Buses </span> </a> <nav class=md-nav aria-label="Example: Scene-Specific Buses"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#why-this-is-useful class=md-nav__link> <span class=md-ellipsis> Why this is useful </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#common-patterns class=md-nav__link> <span class=md-ellipsis> Common Patterns </span> </a> <nav class=md-nav aria-label="Common Patterns"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#pattern-1-test-isolation class=md-nav__link> <span class=md-ellipsis> Pattern 1: Test Isolation </span> </a> </li> <li class=md-nav__item> <a href=#pattern-2-temporary-override-with-automatic-cleanup class=md-nav__link> <span class=md-ellipsis> Pattern 2: Temporary Override with Automatic Cleanup </span> </a> </li> <li class=md-nav__item> <a href=#pattern-3-di-container-integration class=md-nav__link> <span class=md-ellipsis> Pattern 3: DI Container Integration </span> </a> </li> <li class=md-nav__item> <a href=#pattern-4-dynamic-component-reconfiguration class=md-nav__link> <span class=md-ellipsis> Pattern 4: Dynamic Component Reconfiguration </span> </a> </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=../emit-shorthands/ class=md-path__link> <span class=md-ellipsis> Advanced </span> </a> </li> </ol> </nav> <article class="md-content__inner md-typeset"> <a href=https://github.com/wallstop/DxMessaging/edit/master/docs/advanced/runtime-configuration.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/advanced/runtime-configuration.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=runtime-message-bus-configuration>Runtime Message Bus Configuration<a class=headerlink href=#runtime-message-bus-configuration title="Anchor link to this section">&para;</a></h1> <p>This guide covers how to configure message buses at runtime and retarget existing registrations. These features enable advanced scenarios like dependency injection, testing with isolated buses, and dynamic reconfiguration of messaging hierarchies.</p> <h2 id=table-of-contents>Table of Contents<a class=headerlink href=#table-of-contents title="Anchor link to this section">&para;</a></h2> <ul> <li><a href=#runtime-message-bus-configuration>Runtime Message Bus Configuration</a></li> <li><a href=#when-you-need-this>When You Need This</a></li> <li><a href=#global-message-bus-management>Global Message Bus Management</a></li> <li><a href=#re-binding-registrations>Re-binding Registrations</a></li> <li><a href=#common-patterns>Common Patterns</a></li> </ul> <hr> <h2 id=when-you-need-this>When You Need This<a class=headerlink href=#when-you-need-this title="Anchor link to this section">&para;</a></h2> <p>You'll use runtime configuration when you need to:</p> <ul> <li><strong>Integrate with DI containers</strong> — Replace the global bus with a container-managed instance</li> <li><strong>Isolate tests</strong> — Ensure each test uses its own bus to prevent interference</li> <li><strong>Support multiple game modes</strong> — Use different buses for different gameplay contexts (e.g., main game vs. mini-games)</li> <li><strong>Dynamically reconfigure components</strong> — Change which bus a component listens to after it's been created</li> </ul> <p>If you're just getting started with DxMessaging, you probably don't need these features yet. The default global bus works great for most scenarios.</p> <hr> <h2 id=global-message-bus-management>Global Message Bus Management<a class=headerlink href=#global-message-bus-management title="Anchor link to this section">&para;</a></h2> <p>By default, DxMessaging creates a single process-wide message bus during static initialization. This bus is available through <code>MessageHandler.MessageBus</code> and works great for most scenarios.</p> <h3 id=replacing-the-global-bus>Replacing the Global Bus<a class=headerlink href=#replacing-the-global-bus title="Anchor link to this section">&para;</a></h3> <p>Use <code>SetGlobalMessageBus()</code> when you want to permanently replace the default bus:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-0-1><a id=__codelineno-0-1 name=__codelineno-0-1 href=#__codelineno-0-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-0-2><a id=__codelineno-0-2 name=__codelineno-0-2 href=#__codelineno-0-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-0-3><a id=__codelineno-0-3 name=__codelineno-0-3 href=#__codelineno-0-3></a>
-</span><span id=__span-0-4><a id=__codelineno-0-4 name=__codelineno-0-4 href=#__codelineno-0-4></a><span class=c1>// Create a custom bus (often from a DI container)</span>
-</span><span id=__span-0-5><a id=__codelineno-0-5 name=__codelineno-0-5 href=#__codelineno-0-5></a><span class=n>IMessageBus</span><span class=w> </span><span class=n>customBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
-</span><span id=__span-0-6><a id=__codelineno-0-6 name=__codelineno-0-6 href=#__codelineno-0-6></a>
-</span><span id=__span-0-7><a id=__codelineno-0-7 name=__codelineno-0-7 href=#__codelineno-0-7></a><span class=c1>// Replace the global bus</span>
-</span><span id=__span-0-8><a id=__codelineno-0-8 name=__codelineno-0-8 href=#__codelineno-0-8></a><span class=n>MessageHandler</span><span class=p>.</span><span class=n>SetGlobalMessageBus</span><span class=p>(</span><span class=n>customBus</span><span class=p>);</span>
-</span><span id=__span-0-9><a id=__codelineno-0-9 name=__codelineno-0-9 href=#__codelineno-0-9></a>
-</span><span id=__span-0-10><a id=__codelineno-0-10 name=__codelineno-0-10 href=#__codelineno-0-10></a><span class=c1>// All new registrations will now use customBus</span>
-</span><span id=__span-0-11><a id=__codelineno-0-11 name=__codelineno-0-11 href=#__codelineno-0-11></a><span class=kt>var</span><span class=w> </span><span class=n>handler</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>MessageHandler</span><span class=p>(</span><span class=k>new</span><span class=w> </span><span class=n>InstanceId</span><span class=p>(</span><span class=mi>1</span><span class=p>))</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=n>active</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>true</span><span class=w> </span><span class=p>};</span>
-</span><span id=__span-0-12><a id=__codelineno-0-12 name=__codelineno-0-12 href=#__codelineno-0-12></a><span class=c1>// handler.MessageBus is now customBus</span>
-</span></code></pre></div> <h4 id=when-to-use-this>When to use this<a class=headerlink href=#when-to-use-this title="Anchor link to this section">&para;</a></h4> <ul> <li>During application startup when integrating with DI containers</li> <li>When you want all message traffic to flow through a specific bus instance</li> <li>In integration tests that need complete control over message routing</li> </ul> <p><strong>Important:</strong> This permanently replaces the global bus for the lifetime of the application. All subsequent registrations will use the new bus unless explicitly configured otherwise.</p> <h3 id=temporarily-overriding-the-global-bus>Temporarily Overriding the Global Bus<a class=headerlink href=#temporarily-overriding-the-global-bus title="Anchor link to this section">&para;</a></h3> <p>Use <code>OverrideGlobalMessageBus()</code> when you want to temporarily replace the bus and automatically restore it later:</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=n>IMessageBus</span><span class=w> </span><span class=n>originalBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>;</span>
-</span><span id=__span-1-2><a id=__codelineno-1-2 name=__codelineno-1-2 href=#__codelineno-1-2></a><span class=n>IMessageBus</span><span class=w> </span><span class=n>temporaryBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
-</span><span id=__span-1-3><a id=__codelineno-1-3 name=__codelineno-1-3 href=#__codelineno-1-3></a>
-</span><span id=__span-1-4><a id=__codelineno-1-4 name=__codelineno-1-4 href=#__codelineno-1-4></a><span class=c1>// Temporarily override</span>
-</span><span id=__span-1-5><a id=__codelineno-1-5 name=__codelineno-1-5 href=#__codelineno-1-5></a><span class=k>using</span><span class=w> </span><span class=p>(</span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>OverrideGlobalMessageBus</span><span class=p>(</span><span class=n>temporaryBus</span><span class=p>))</span>
-</span><span id=__span-1-6><a id=__codelineno-1-6 name=__codelineno-1-6 href=#__codelineno-1-6></a><span class=p>{</span>
-</span><span id=__span-1-7><a id=__codelineno-1-7 name=__codelineno-1-7 href=#__codelineno-1-7></a><span class=w>    </span><span class=c1>// Inside this scope, MessageHandler.MessageBus returns temporaryBus</span>
-</span><span id=__span-1-8><a id=__codelineno-1-8 name=__codelineno-1-8 href=#__codelineno-1-8></a><span class=w>    </span><span class=n>Assert</span><span class=p>.</span><span class=n>AreSame</span><span class=p>(</span><span class=n>temporaryBus</span><span class=p>,</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>);</span>
-</span><span id=__span-1-9><a id=__codelineno-1-9 name=__codelineno-1-9 href=#__codelineno-1-9></a>
-</span><span id=__span-1-10><a id=__codelineno-1-10 name=__codelineno-1-10 href=#__codelineno-1-10></a><span class=w>    </span><span class=c1>// Any message handlers created here use temporaryBus</span>
-</span><span id=__span-1-11><a id=__codelineno-1-11 name=__codelineno-1-11 href=#__codelineno-1-11></a><span class=w>    </span><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MyMessage</span><span class=p>();</span>
-</span><span id=__span-1-12><a id=__codelineno-1-12 name=__codelineno-1-12 href=#__codelineno-1-12></a><span class=w>    </span><span class=n>msg</span><span class=p>.</span><span class=n>EmitUntargeted</span><span class=p>();</span><span class=w>  </span><span class=c1>// Goes to temporaryBus</span>
-</span><span id=__span-1-13><a id=__codelineno-1-13 name=__codelineno-1-13 href=#__codelineno-1-13></a><span class=p>}</span>
-</span><span id=__span-1-14><a id=__codelineno-1-14 name=__codelineno-1-14 href=#__codelineno-1-14></a>
-</span><span id=__span-1-15><a id=__codelineno-1-15 name=__codelineno-1-15 href=#__codelineno-1-15></a><span class=c1>// Outside the scope, the original bus is restored</span>
-</span><span id=__span-1-16><a id=__codelineno-1-16 name=__codelineno-1-16 href=#__codelineno-1-16></a><span class=n>Assert</span><span class=p>.</span><span class=n>AreSame</span><span class=p>(</span><span class=n>originalBus</span><span class=p>,</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>);</span>
-</span></code></pre></div> <h4 id=when-to-use-this_1>When to use this<a class=headerlink href=#when-to-use-this_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>In unit tests to isolate message traffic</li> <li>When temporarily redirecting messages for debugging or logging</li> <li>For scoped gameplay features that need their own message channel</li> </ul> <p><strong>Pattern:</strong> This returns an <code>IDisposable</code>, so you can use it with <code>using</code> statements for automatic cleanup. When the scope exits (either normally or via exception), the previous bus is restored.</p> <h3 id=resetting-to-the-default-bus>Resetting to the Default Bus<a class=headerlink href=#resetting-to-the-default-bus title="Anchor link to this section">&para;</a></h3> <p>Use <code>ResetGlobalMessageBus()</code> to restore the original startup bus:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-2-1><a id=__codelineno-2-1 name=__codelineno-2-1 href=#__codelineno-2-1></a><span class=c1>// Replace the global bus</span>
-</span><span id=__span-2-2><a id=__codelineno-2-2 name=__codelineno-2-2 href=#__codelineno-2-2></a><span class=n>MessageHandler</span><span class=p>.</span><span class=n>SetGlobalMessageBus</span><span class=p>(</span><span class=n>containerBus</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><span id=__span-2-4><a id=__codelineno-2-4 name=__codelineno-2-4 href=#__codelineno-2-4></a><span class=c1>// Later, restore the original default bus</span>
-</span><span id=__span-2-5><a id=__codelineno-2-5 name=__codelineno-2-5 href=#__codelineno-2-5></a><span class=n>MessageHandler</span><span class=p>.</span><span class=n>ResetGlobalMessageBus</span><span class=p>();</span>
-</span><span id=__span-2-6><a id=__codelineno-2-6 name=__codelineno-2-6 href=#__codelineno-2-6></a>
-</span><span id=__span-2-7><a id=__codelineno-2-7 name=__codelineno-2-7 href=#__codelineno-2-7></a><span class=c1>// MessageHandler.MessageBus is now back to the original startup bus</span>
-</span></code></pre></div> <h4 id=when-to-use-this_2>When to use this<a class=headerlink href=#when-to-use-this_2 title="Anchor link to this section">&para;</a></h4> <ul> <li>After tests that called <code>SetGlobalMessageBus()</code></li> <li>When tearing down a DI container and reverting to default behavior</li> <li>In development/debug scenarios where you want to reset state</li> </ul> <h3 id=accessing-the-original-startup-bus>Accessing the Original Startup Bus<a class=headerlink href=#accessing-the-original-startup-bus title="Anchor link to this section">&para;</a></h3> <p><code>MessageHandler.InitialGlobalMessageBus</code> always returns the original bus that was created during static initialization, regardless of any calls to <code>SetGlobalMessageBus()</code>:</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=n>IMessageBus</span><span class=w> </span><span class=n>startupBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>InitialGlobalMessageBus</span><span class=p>;</span>
-</span><span id=__span-3-2><a id=__codelineno-3-2 name=__codelineno-3-2 href=#__codelineno-3-2></a>
-</span><span id=__span-3-3><a id=__codelineno-3-3 name=__codelineno-3-3 href=#__codelineno-3-3></a><span class=c1>// Replace the global bus</span>
-</span><span id=__span-3-4><a id=__codelineno-3-4 name=__codelineno-3-4 href=#__codelineno-3-4></a><span class=n>MessageHandler</span><span class=p>.</span><span class=n>SetGlobalMessageBus</span><span class=p>(</span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>());</span>
-</span><span id=__span-3-5><a id=__codelineno-3-5 name=__codelineno-3-5 href=#__codelineno-3-5></a>
-</span><span id=__span-3-6><a id=__codelineno-3-6 name=__codelineno-3-6 href=#__codelineno-3-6></a><span class=c1>// InitialGlobalMessageBus is unchanged</span>
-</span><span id=__span-3-7><a id=__codelineno-3-7 name=__codelineno-3-7 href=#__codelineno-3-7></a><span class=n>Assert</span><span class=p>.</span><span class=n>AreSame</span><span class=p>(</span><span class=n>startupBus</span><span class=p>,</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>InitialGlobalMessageBus</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>// But MessageBus returns the new bus</span>
-</span><span id=__span-3-10><a id=__codelineno-3-10 name=__codelineno-3-10 href=#__codelineno-3-10></a><span class=n>Assert</span><span class=p>.</span><span class=n>AreNotSame</span><span class=p>(</span><span class=n>startupBus</span><span class=p>,</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>);</span>
-</span></code></pre></div> <h4 id=when-to-use-this_3>When to use this<a class=headerlink href=#when-to-use-this_3 title="Anchor link to this section">&para;</a></h4> <ul> <li>In diagnostic tools that need a stable reference point</li> <li>When you want to compare against the original bus for debugging</li> <li>In tests that need to verify bus isolation while still accessing the original</li> </ul> <h3 id=example-bootstrapping-a-di-container>Example: Bootstrapping a DI Container<a class=headerlink href=#example-bootstrapping-a-di-container title="Anchor link to this section">&para;</a></h3> <p>Here's a complete example of integrating DxMessaging with a DI container:</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>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-4-2><a id=__codelineno-4-2 name=__codelineno-4-2 href=#__codelineno-4-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-4-3><a id=__codelineno-4-3 name=__codelineno-4-3 href=#__codelineno-4-3></a>
-</span><span id=__span-4-4><a id=__codelineno-4-4 name=__codelineno-4-4 href=#__codelineno-4-4></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>GameBootstrapper</span>
-</span><span id=__span-4-5><a id=__codelineno-4-5 name=__codelineno-4-5 href=#__codelineno-4-5></a><span class=p>{</span>
-</span><span id=__span-4-6><a id=__codelineno-4-6 name=__codelineno-4-6 href=#__codelineno-4-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>Bootstrap</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 class=w>        </span><span class=c1>// Create container-managed bus</span>
-</span><span id=__span-4-9><a id=__codelineno-4-9 name=__codelineno-4-9 href=#__codelineno-4-9></a><span class=w>        </span><span class=n>IMessageBus</span><span class=w> </span><span class=n>containerBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
-</span><span id=__span-4-10><a id=__codelineno-4-10 name=__codelineno-4-10 href=#__codelineno-4-10></a>
-</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=c1>// Register with container</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=n>container</span><span class=p>.</span><span class=n>RegisterInstance</span><span class=o>&lt;</span><span class=n>IMessageBus</span><span class=o>&gt;</span><span class=p>(</span><span class=n>containerBus</span><span class=p>);</span>
-</span><span id=__span-4-13><a id=__codelineno-4-13 name=__codelineno-4-13 href=#__codelineno-4-13></a>
-</span><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=c1>// Replace global bus so all subsequent registrations use it</span>
-</span><span id=__span-4-15><a id=__codelineno-4-15 name=__codelineno-4-15 href=#__codelineno-4-15></a><span class=w>        </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>SetGlobalMessageBus</span><span class=p>(</span><span class=n>containerBus</span><span class=p>);</span>
-</span><span id=__span-4-16><a id=__codelineno-4-16 name=__codelineno-4-16 href=#__codelineno-4-16></a>
-</span><span id=__span-4-17><a id=__codelineno-4-17 name=__codelineno-4-17 href=#__codelineno-4-17></a><span class=w>        </span><span class=c1>// Now when MessagingComponents are created, they automatically</span>
-</span><span id=__span-4-18><a id=__codelineno-4-18 name=__codelineno-4-18 href=#__codelineno-4-18></a><span class=w>        </span><span class=c1>// use the container-managed bus</span>
-</span><span id=__span-4-19><a id=__codelineno-4-19 name=__codelineno-4-19 href=#__codelineno-4-19></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-4-20><a id=__codelineno-4-20 name=__codelineno-4-20 href=#__codelineno-4-20></a><span class=p>}</span>
-</span></code></pre></div> <hr> <h2 id=re-binding-registrations>Re-binding Registrations<a class=headerlink href=#re-binding-registrations title="Anchor link to this section">&para;</a></h2> <p>Sometimes you need to change which bus a component listens to after it's already been set up. This is called "re-binding."</p> <h3 id=the-messagebusrebindmode-enum>The MessageBusRebindMode Enum<a class=headerlink href=#the-messagebusrebindmode-enum title="Anchor link to this section">&para;</a></h3> <p>When re-binding, you have two options:</p> <h4 id=preserveregistrations>PreserveRegistrations<a class=headerlink href=#preserveregistrations title="Anchor link to this section">&para;</a></h4> <p>Keeps existing active registrations on their current bus, but sets the specified bus for future registrations:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-5-1><a id=__codelineno-5-1 name=__codelineno-5-1 href=#__codelineno-5-1></a><span class=c1>// Component is currently using busA</span>
-</span><span id=__span-5-2><a id=__codelineno-5-2 name=__codelineno-5-2 href=#__codelineno-5-2></a><span class=n>component</span><span class=p>.</span><span class=n>Configure</span><span class=p>(</span><span class=n>busA</span><span class=p>,</span><span class=w> </span><span class=n>MessageBusRebindMode</span><span class=p>.</span><span class=n>RebindActive</span><span class=p>);</span>
-</span><span id=__span-5-3><a id=__codelineno-5-3 name=__codelineno-5-3 href=#__codelineno-5-3></a>
-</span><span id=__span-5-4><a id=__codelineno-5-4 name=__codelineno-5-4 href=#__codelineno-5-4></a><span class=c1>// Later, switch to busB but preserve existing registrations</span>
-</span><span id=__span-5-5><a id=__codelineno-5-5 name=__codelineno-5-5 href=#__codelineno-5-5></a><span class=n>component</span><span class=p>.</span><span class=n>Configure</span><span class=p>(</span><span class=n>busB</span><span class=p>,</span><span class=w> </span><span class=n>MessageBusRebindMode</span><span class=p>.</span><span class=n>PreserveRegistrations</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><span id=__span-5-7><a id=__codelineno-5-7 name=__codelineno-5-7 href=#__codelineno-5-7></a><span class=c1>// Existing handlers still listen on busA</span>
-</span><span id=__span-5-8><a id=__codelineno-5-8 name=__codelineno-5-8 href=#__codelineno-5-8></a><span class=c1>// New registrations will use busB</span>
-</span></code></pre></div> <h5 id=when-to-use-this_4>When to use this<a class=headerlink href=#when-to-use-this_4 title="Anchor link to this section">&para;</a></h5> <ul> <li>When you want to gradually migrate a component to a new bus</li> <li>If you need to maintain backwards compatibility during refactoring</li> <li>When existing registrations must continue processing messages from their original source</li> </ul> <h4 id=rebindactive>RebindActive<a class=headerlink href=#rebindactive title="Anchor link to this section">&para;</a></h4> <p>Immediately moves all active registrations to the new bus:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-6-1><a id=__codelineno-6-1 name=__codelineno-6-1 href=#__codelineno-6-1></a><span class=c1>// Component is listening on busA</span>
-</span><span id=__span-6-2><a id=__codelineno-6-2 name=__codelineno-6-2 href=#__codelineno-6-2></a><span class=n>component</span><span class=p>.</span><span class=n>Configure</span><span class=p>(</span><span class=n>busA</span><span class=p>,</span><span class=w> </span><span class=n>MessageBusRebindMode</span><span class=p>.</span><span class=n>RebindActive</span><span class=p>);</span>
-</span><span id=__span-6-3><a id=__codelineno-6-3 name=__codelineno-6-3 href=#__codelineno-6-3></a>
-</span><span id=__span-6-4><a id=__codelineno-6-4 name=__codelineno-6-4 href=#__codelineno-6-4></a><span class=c1>// Switch everything to busB</span>
-</span><span id=__span-6-5><a id=__codelineno-6-5 name=__codelineno-6-5 href=#__codelineno-6-5></a><span class=n>component</span><span class=p>.</span><span class=n>Configure</span><span class=p>(</span><span class=n>busB</span><span class=p>,</span><span class=w> </span><span class=n>MessageBusRebindMode</span><span class=p>.</span><span class=n>RebindActive</span><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><span id=__span-6-7><a id=__codelineno-6-7 name=__codelineno-6-7 href=#__codelineno-6-7></a><span class=c1>// All handlers now listen on busB</span>
-</span><span id=__span-6-8><a id=__codelineno-6-8 name=__codelineno-6-8 href=#__codelineno-6-8></a><span class=c1>// busA handlers are deregistered and re-registered on busB</span>
-</span></code></pre></div> <h5 id=when-to-use-this_5>When to use this<a class=headerlink href=#when-to-use-this_5 title="Anchor link to this section">&para;</a></h5> <ul> <li>When you want complete, immediate migration to a new bus</li> <li>In DI scenarios where the container provides a new bus instance</li> <li>When you need atomic switching without mixed-bus behavior</li> </ul> <h3 id=retarget-a-token-directly>Retarget a Token Directly<a class=headerlink href=#retarget-a-token-directly title="Anchor link to this section">&para;</a></h3> <p>You can also retarget individual <code>MessageRegistrationToken</code> instances:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-7-1><a id=__codelineno-7-1 name=__codelineno-7-1 href=#__codelineno-7-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-7-2><a id=__codelineno-7-2 name=__codelineno-7-2 href=#__codelineno-7-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-7-3><a id=__codelineno-7-3 name=__codelineno-7-3 href=#__codelineno-7-3></a>
-</span><span id=__span-7-4><a id=__codelineno-7-4 name=__codelineno-7-4 href=#__codelineno-7-4></a><span class=n>IMessageBus</span><span class=w> </span><span class=n>busA</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
-</span><span id=__span-7-5><a id=__codelineno-7-5 name=__codelineno-7-5 href=#__codelineno-7-5></a><span class=n>IMessageBus</span><span class=w> </span><span class=n>busB</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
-</span><span id=__span-7-6><a id=__codelineno-7-6 name=__codelineno-7-6 href=#__codelineno-7-6></a>
-</span><span id=__span-7-7><a id=__codelineno-7-7 name=__codelineno-7-7 href=#__codelineno-7-7></a><span class=kt>var</span><span class=w> </span><span class=n>handler</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>MessageHandler</span><span class=p>(</span><span class=k>new</span><span class=w> </span><span class=n>InstanceId</span><span class=p>(</span><span class=mi>1</span><span class=p>),</span><span class=w> </span><span class=n>busA</span><span class=p>)</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=n>active</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>true</span><span class=w> </span><span class=p>};</span>
-</span><span id=__span-7-8><a id=__codelineno-7-8 name=__codelineno-7-8 href=#__codelineno-7-8></a><span class=kt>var</span><span class=w> </span><span class=n>token</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageRegistrationToken</span><span class=p>.</span><span class=n>Create</span><span class=p>(</span><span class=n>handler</span><span class=p>,</span><span class=w> </span><span class=n>busA</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=n>token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>MyMessage</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnMessage</span><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=n>token</span><span class=p>.</span><span class=n>Enable</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><span id=__span-7-12><a id=__codelineno-7-12 name=__codelineno-7-12 href=#__codelineno-7-12></a><span class=c1>// Later, retarget to busB</span>
-</span><span id=__span-7-13><a id=__codelineno-7-13 name=__codelineno-7-13 href=#__codelineno-7-13></a><span class=n>token</span><span class=p>.</span><span class=n>RetargetMessageBus</span><span class=p>(</span><span class=n>busB</span><span class=p>,</span><span class=w> </span><span class=n>MessageBusRebindMode</span><span class=p>.</span><span class=n>RebindActive</span><span class=p>);</span>
-</span><span id=__span-7-14><a id=__codelineno-7-14 name=__codelineno-7-14 href=#__codelineno-7-14></a>
-</span><span id=__span-7-15><a id=__codelineno-7-15 name=__codelineno-7-15 href=#__codelineno-7-15></a><span class=c1>// All registrations are now on busB</span>
-</span></code></pre></div> <h4 id=when-to-use-this_6>When to use this<a class=headerlink href=#when-to-use-this_6 title="Anchor link to this section">&para;</a></h4> <ul> <li>When you have direct access to a token and want fine-grained control</li> <li>In advanced scenarios like dynamic message routing or pooling</li> <li>When building custom messaging abstractions</li> </ul> <h3 id=example-scene-specific-buses>Example: Scene-Specific Buses<a class=headerlink href=#example-scene-specific-buses title="Anchor link to this section">&para;</a></h3> <p>Here's a practical example of using re-binding for scene isolation:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-8-1><a id=__codelineno-8-1 name=__codelineno-8-1 href=#__codelineno-8-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-8-2><a id=__codelineno-8-2 name=__codelineno-8-2 href=#__codelineno-8-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Unity</span><span class=p>;</span>
-</span><span id=__span-8-3><a id=__codelineno-8-3 name=__codelineno-8-3 href=#__codelineno-8-3></a><span class=k>using</span><span class=w> </span><span class=nn>UnityEngine</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=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>SceneMessagingManager</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-8-6><a id=__codelineno-8-6 name=__codelineno-8-6 href=#__codelineno-8-6></a><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 class=w>    </span><span class=k>private</span><span class=w> </span><span class=n>IMessageBus</span><span class=w> </span><span class=n>_sceneLocalBus</span><span class=p>;</span>
-</span><span id=__span-8-8><a id=__codelineno-8-8 name=__codelineno-8-8 href=#__codelineno-8-8></a>
-</span><span id=__span-8-9><a id=__codelineno-8-9 name=__codelineno-8-9 href=#__codelineno-8-9></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>Awake</span><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=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>// Create a bus specific to this scene</span>
-</span><span id=__span-8-12><a id=__codelineno-8-12 name=__codelineno-8-12 href=#__codelineno-8-12></a><span class=w>        </span><span class=n>_sceneLocalBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
-</span><span id=__span-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=w>        </span><span class=c1>// Find all messaging components in this scene</span>
-</span><span id=__span-8-15><a id=__codelineno-8-15 name=__codelineno-8-15 href=#__codelineno-8-15></a><span class=w>        </span><span class=n>MessagingComponent</span><span class=p>[]</span><span class=w> </span><span class=n>components</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>FindObjectsOfType</span><span class=o>&lt;</span><span class=n>MessagingComponent</span><span class=o>&gt;</span><span class=p>();</span>
-</span><span id=__span-8-16><a id=__codelineno-8-16 name=__codelineno-8-16 href=#__codelineno-8-16></a>
-</span><span id=__span-8-17><a id=__codelineno-8-17 name=__codelineno-8-17 href=#__codelineno-8-17></a><span class=w>        </span><span class=c1>// Retarget them to the scene-local bus</span>
-</span><span id=__span-8-18><a id=__codelineno-8-18 name=__codelineno-8-18 href=#__codelineno-8-18></a><span class=w>        </span><span class=k>foreach</span><span class=w> </span><span class=p>(</span><span class=kt>var</span><span class=w> </span><span class=n>component</span><span class=w> </span><span class=k>in</span><span class=w> </span><span class=n>components</span><span class=p>)</span>
-</span><span id=__span-8-19><a id=__codelineno-8-19 name=__codelineno-8-19 href=#__codelineno-8-19></a><span class=w>        </span><span class=p>{</span>
-</span><span id=__span-8-20><a id=__codelineno-8-20 name=__codelineno-8-20 href=#__codelineno-8-20></a><span class=w>            </span><span class=n>component</span><span class=p>.</span><span class=n>Configure</span><span class=p>(</span><span class=n>_sceneLocalBus</span><span class=p>,</span><span class=w> </span><span class=n>MessageBusRebindMode</span><span class=p>.</span><span class=n>RebindActive</span><span class=p>);</span>
-</span><span id=__span-8-21><a id=__codelineno-8-21 name=__codelineno-8-21 href=#__codelineno-8-21></a><span class=w>        </span><span class=p>}</span>
-</span><span id=__span-8-22><a id=__codelineno-8-22 name=__codelineno-8-22 href=#__codelineno-8-22></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-8-23><a id=__codelineno-8-23 name=__codelineno-8-23 href=#__codelineno-8-23></a>
-</span><span id=__span-8-24><a id=__codelineno-8-24 name=__codelineno-8-24 href=#__codelineno-8-24></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>OnDestroy</span><span class=p>()</span>
-</span><span id=__span-8-25><a id=__codelineno-8-25 name=__codelineno-8-25 href=#__codelineno-8-25></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-8-26><a id=__codelineno-8-26 name=__codelineno-8-26 href=#__codelineno-8-26></a><span class=w>        </span><span class=c1>// When scene unloads, components are destroyed automatically</span>
-</span><span id=__span-8-27><a id=__codelineno-8-27 name=__codelineno-8-27 href=#__codelineno-8-27></a><span class=w>        </span><span class=c1>// No need to manually clean up registrations</span>
-</span><span id=__span-8-28><a id=__codelineno-8-28 name=__codelineno-8-28 href=#__codelineno-8-28></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-8-29><a id=__codelineno-8-29 name=__codelineno-8-29 href=#__codelineno-8-29></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=why-this-is-useful>Why this is useful<a class=headerlink href=#why-this-is-useful title="Anchor link to this section">&para;</a></h4> <ul> <li>Messages sent in this scene won't leak to other scenes</li> <li>When the scene unloads, all message traffic stops cleanly</li> <li>Perfect for additive scene workflows or mini-games</li> </ul> <hr> <h2 id=common-patterns>Common Patterns<a class=headerlink href=#common-patterns title="Anchor link to this section">&para;</a></h2> <h3 id=pattern-1-test-isolation>Pattern 1: Test Isolation<a class=headerlink href=#pattern-1-test-isolation title="Anchor link to this section">&para;</a></h3> <p>Ensure each test has its own isolated bus:</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=k>using</span><span class=w> </span><span class=nn>NUnit.Framework</span><span class=p>;</span>
-</span><span id=__span-9-2><a id=__codelineno-9-2 name=__codelineno-9-2 href=#__codelineno-9-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-9-3><a id=__codelineno-9-3 name=__codelineno-9-3 href=#__codelineno-9-3></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
-</span><span id=__span-9-4><a id=__codelineno-9-4 name=__codelineno-9-4 href=#__codelineno-9-4></a>
-</span><span id=__span-9-5><a id=__codelineno-9-5 name=__codelineno-9-5 href=#__codelineno-9-5></a><span class=na>[TestFixture]</span>
-</span><span id=__span-9-6><a id=__codelineno-9-6 name=__codelineno-9-6 href=#__codelineno-9-6></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>MySystemTests</span>
-</span><span id=__span-9-7><a id=__codelineno-9-7 name=__codelineno-9-7 href=#__codelineno-9-7></a><span class=p>{</span>
-</span><span id=__span-9-8><a id=__codelineno-9-8 name=__codelineno-9-8 href=#__codelineno-9-8></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=n>IMessageBus</span><span class=w> </span><span class=n>_testBus</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><span id=__span-9-10><a id=__codelineno-9-10 name=__codelineno-9-10 href=#__codelineno-9-10></a><span class=w>    </span><span class=na>[SetUp]</span>
-</span><span id=__span-9-11><a id=__codelineno-9-11 name=__codelineno-9-11 href=#__codelineno-9-11></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>SetUp</span><span class=p>()</span>
-</span><span id=__span-9-12><a id=__codelineno-9-12 name=__codelineno-9-12 href=#__codelineno-9-12></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-9-13><a id=__codelineno-9-13 name=__codelineno-9-13 href=#__codelineno-9-13></a><span class=w>        </span><span class=c1>// Create a fresh bus for each test</span>
-</span><span id=__span-9-14><a id=__codelineno-9-14 name=__codelineno-9-14 href=#__codelineno-9-14></a><span class=w>        </span><span class=n>_testBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
-</span><span id=__span-9-15><a id=__codelineno-9-15 name=__codelineno-9-15 href=#__codelineno-9-15></a><span class=w>        </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>SetGlobalMessageBus</span><span class=p>(</span><span class=n>_testBus</span><span class=p>);</span>
-</span><span id=__span-9-16><a id=__codelineno-9-16 name=__codelineno-9-16 href=#__codelineno-9-16></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-9-17><a id=__codelineno-9-17 name=__codelineno-9-17 href=#__codelineno-9-17></a>
-</span><span id=__span-9-18><a id=__codelineno-9-18 name=__codelineno-9-18 href=#__codelineno-9-18></a><span class=w>    </span><span class=na>[TearDown]</span>
-</span><span id=__span-9-19><a id=__codelineno-9-19 name=__codelineno-9-19 href=#__codelineno-9-19></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>TearDown</span><span class=p>()</span>
-</span><span id=__span-9-20><a id=__codelineno-9-20 name=__codelineno-9-20 href=#__codelineno-9-20></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-9-21><a id=__codelineno-9-21 name=__codelineno-9-21 href=#__codelineno-9-21></a><span class=w>        </span><span class=c1>// Restore the default bus</span>
-</span><span id=__span-9-22><a id=__codelineno-9-22 name=__codelineno-9-22 href=#__codelineno-9-22></a><span class=w>        </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>ResetGlobalMessageBus</span><span class=p>();</span>
-</span><span id=__span-9-23><a id=__codelineno-9-23 name=__codelineno-9-23 href=#__codelineno-9-23></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-9-24><a id=__codelineno-9-24 name=__codelineno-9-24 href=#__codelineno-9-24></a>
-</span><span id=__span-9-25><a id=__codelineno-9-25 name=__codelineno-9-25 href=#__codelineno-9-25></a><span class=w>    </span><span class=na>[Test]</span>
-</span><span id=__span-9-26><a id=__codelineno-9-26 name=__codelineno-9-26 href=#__codelineno-9-26></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>MyTest</span><span class=p>()</span>
-</span><span id=__span-9-27><a id=__codelineno-9-27 name=__codelineno-9-27 href=#__codelineno-9-27></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-9-28><a id=__codelineno-9-28 name=__codelineno-9-28 href=#__codelineno-9-28></a><span class=w>        </span><span class=c1>// This test uses _testBus exclusively</span>
-</span><span id=__span-9-29><a id=__codelineno-9-29 name=__codelineno-9-29 href=#__codelineno-9-29></a><span class=w>        </span><span class=c1>// No interference from other tests</span>
-</span><span id=__span-9-30><a id=__codelineno-9-30 name=__codelineno-9-30 href=#__codelineno-9-30></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-9-31><a id=__codelineno-9-31 name=__codelineno-9-31 href=#__codelineno-9-31></a><span class=p>}</span>
-</span></code></pre></div> <h3 id=pattern-2-temporary-override-with-automatic-cleanup>Pattern 2: Temporary Override with Automatic Cleanup<a class=headerlink href=#pattern-2-temporary-override-with-automatic-cleanup title="Anchor link to this section">&para;</a></h3> <p>Use <code>using</code> statements for scoped overrides:</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=na>[Test]</span>
-</span><span id=__span-10-2><a id=__codelineno-10-2 name=__codelineno-10-2 href=#__codelineno-10-2></a><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>TestWithIsolation</span><span class=p>()</span>
-</span><span id=__span-10-3><a id=__codelineno-10-3 name=__codelineno-10-3 href=#__codelineno-10-3></a><span class=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=n>IMessageBus</span><span class=w> </span><span class=n>isolatedBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
-</span><span id=__span-10-5><a id=__codelineno-10-5 name=__codelineno-10-5 href=#__codelineno-10-5></a>
-</span><span id=__span-10-6><a id=__codelineno-10-6 name=__codelineno-10-6 href=#__codelineno-10-6></a><span class=w>    </span><span class=k>using</span><span class=w> </span><span class=p>(</span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>OverrideGlobalMessageBus</span><span class=p>(</span><span class=n>isolatedBus</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 class=w>        </span><span class=c1>// Test code here uses isolatedBus</span>
-</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=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>TestMessage</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=n>msg</span><span class=p>.</span><span class=n>EmitUntargeted</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><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=c1>// Verify only this test&#39;s bus received the message</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=p>}</span>
-</span><span id=__span-10-14><a id=__codelineno-10-14 name=__codelineno-10-14 href=#__codelineno-10-14></a>
-</span><span id=__span-10-15><a id=__codelineno-10-15 name=__codelineno-10-15 href=#__codelineno-10-15></a><span class=w>    </span><span class=c1>// Original bus automatically restored</span>
-</span><span id=__span-10-16><a id=__codelineno-10-16 name=__codelineno-10-16 href=#__codelineno-10-16></a><span class=p>}</span>
-</span></code></pre></div> <h3 id=pattern-3-di-container-integration>Pattern 3: DI Container Integration<a class=headerlink href=#pattern-3-di-container-integration title="Anchor link to this section">&para;</a></h3> <p>Bootstrap with container-managed bus:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-11-1><a id=__codelineno-11-1 name=__codelineno-11-1 href=#__codelineno-11-1></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>DependencyInjectionBootstrap</span>
-</span><span id=__span-11-2><a id=__codelineno-11-2 name=__codelineno-11-2 href=#__codelineno-11-2></a><span class=p>{</span>
-</span><span id=__span-11-3><a id=__codelineno-11-3 name=__codelineno-11-3 href=#__codelineno-11-3></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>Initialize</span><span class=p>(</span><span class=n>IContainer</span><span class=w> </span><span class=n>container</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=w>    </span><span class=p>{</span>
-</span><span id=__span-11-5><a id=__codelineno-11-5 name=__codelineno-11-5 href=#__codelineno-11-5></a><span class=w>        </span><span class=c1>// Container creates the bus</span>
-</span><span id=__span-11-6><a id=__codelineno-11-6 name=__codelineno-11-6 href=#__codelineno-11-6></a><span class=w>        </span><span class=n>IMessageBus</span><span class=w> </span><span class=n>containerBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>container</span><span class=p>.</span><span class=n>Resolve</span><span class=o>&lt;</span><span class=n>IMessageBus</span><span class=o>&gt;</span><span class=p>();</span>
-</span><span id=__span-11-7><a id=__codelineno-11-7 name=__codelineno-11-7 href=#__codelineno-11-7></a>
-</span><span id=__span-11-8><a id=__codelineno-11-8 name=__codelineno-11-8 href=#__codelineno-11-8></a><span class=w>        </span><span class=c1>// Make it the global default</span>
-</span><span id=__span-11-9><a id=__codelineno-11-9 name=__codelineno-11-9 href=#__codelineno-11-9></a><span class=w>        </span><span class=n>MessageHandler</span><span class=p>.</span><span class=n>SetGlobalMessageBus</span><span class=p>(</span><span class=n>containerBus</span><span class=p>);</span>
-</span><span id=__span-11-10><a id=__codelineno-11-10 name=__codelineno-11-10 href=#__codelineno-11-10></a>
-</span><span id=__span-11-11><a id=__codelineno-11-11 name=__codelineno-11-11 href=#__codelineno-11-11></a><span class=w>        </span><span class=c1>// Now all MessagingComponents use the container bus by default</span>
-</span><span id=__span-11-12><a id=__codelineno-11-12 name=__codelineno-11-12 href=#__codelineno-11-12></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-11-13><a id=__codelineno-11-13 name=__codelineno-11-13 href=#__codelineno-11-13></a><span class=p>}</span>
-</span></code></pre></div> <h3 id=pattern-4-dynamic-component-reconfiguration>Pattern 4: Dynamic Component Reconfiguration<a class=headerlink href=#pattern-4-dynamic-component-reconfiguration title="Anchor link to this section">&para;</a></h3> <p>Change a component's bus at runtime:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-12-1><a id=__codelineno-12-1 name=__codelineno-12-1 href=#__codelineno-12-1></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>DynamicComponentManager</span>
-</span><span id=__span-12-2><a id=__codelineno-12-2 name=__codelineno-12-2 href=#__codelineno-12-2></a><span class=p>{</span>
-</span><span id=__span-12-3><a id=__codelineno-12-3 name=__codelineno-12-3 href=#__codelineno-12-3></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>SwitchComponentToBus</span><span class=p>(</span><span class=n>MessagingComponent</span><span class=w> </span><span class=n>component</span><span class=p>,</span><span class=w> </span><span class=n>IMessageBus</span><span class=w> </span><span class=n>newBus</span><span class=p>)</span>
-</span><span id=__span-12-4><a id=__codelineno-12-4 name=__codelineno-12-4 href=#__codelineno-12-4></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-12-5><a id=__codelineno-12-5 name=__codelineno-12-5 href=#__codelineno-12-5></a><span class=w>        </span><span class=c1>// Immediately move all handlers to the new bus</span>
-</span><span id=__span-12-6><a id=__codelineno-12-6 name=__codelineno-12-6 href=#__codelineno-12-6></a><span class=w>        </span><span class=n>component</span><span class=p>.</span><span class=n>Configure</span><span class=p>(</span><span class=n>newBus</span><span class=p>,</span><span class=w> </span><span class=n>MessageBusRebindMode</span><span class=p>.</span><span class=n>RebindActive</span><span class=p>);</span>
-</span><span id=__span-12-7><a id=__codelineno-12-7 name=__codelineno-12-7 href=#__codelineno-12-7></a>
-</span><span id=__span-12-8><a id=__codelineno-12-8 name=__codelineno-12-8 href=#__codelineno-12-8></a><span class=w>        </span><span class=c1>// Component now listens on newBus</span>
-</span><span id=__span-12-9><a id=__codelineno-12-9 name=__codelineno-12-9 href=#__codelineno-12-9></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-12-10><a id=__codelineno-12-10 name=__codelineno-12-10 href=#__codelineno-12-10></a><span class=p>}</span>
-</span></code></pre></div> <hr> <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>API</th> <th>Purpose</th> <th>Use Case</th> </tr> </thead> <tbody> <tr> <td><code>MessageHandler.MessageBus</code></td> <td>Access current global bus</td> <td>Normal message emission</td> </tr> <tr> <td><code>MessageHandler.InitialGlobalMessageBus</code></td> <td>Access original startup bus</td> <td>Diagnostics, debugging</td> </tr> <tr> <td><code>MessageHandler.SetGlobalMessageBus(bus)</code></td> <td>Permanently replace global bus</td> <td>DI integration, test setup</td> </tr> <tr> <td><code>MessageHandler.OverrideGlobalMessageBus(bus)</code></td> <td>Temporarily override (returns IDisposable)</td> <td>Test isolation, scoped features</td> </tr> <tr> <td><code>MessageHandler.ResetGlobalMessageBus()</code></td> <td>Restore original startup bus</td> <td>Test teardown, reset state</td> </tr> <tr> <td><code>component.Configure(bus, mode)</code></td> <td>Set component's bus</td> <td>Component configuration</td> </tr> <tr> <td><code>token.RetargetMessageBus(bus, mode)</code></td> <td>Retarget a token</td> <td>Fine-grained control</td> </tr> <tr> <td><code>MessageBusRebindMode.PreserveRegistrations</code></td> <td>Keep existing registrations on old bus</td> <td>Gradual migration</td> </tr> <tr> <td><code>MessageBusRebindMode.RebindActive</code></td> <td>Move all registrations to new bus</td> <td>Atomic switching</td> </tr> </tbody> </table> <hr> <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=../message-bus-providers/ >Message Bus Providers</a></strong> — ScriptableObject-based provider system for design-time configuration</li> <li><strong><a href=../registration-builders/ >Registration Builders</a></strong> — Fluent API for building message registrations with priority and lifecycle control</li> <li><strong><a href=../../integrations/ >DI Integration Guides</a></strong> — Zenject, VContainer, and Reflex integration patterns</li> <li><strong><a href=../../guides/testing/ >Testing Guide</a></strong> — Comprehensive testing patterns with DxMessaging</li> <li><strong><a href=../../getting-started/ >Back to Documentation Hub</a></strong> — Browse all docs</li> </ul> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 27, 2026 04:59:07 UTC"><span class=timeago datetime=2026-01-27T04:59:07+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 27, 2026 04:59:07 UTC">2026-01-27</span> </span> <span class=md-source-file__fact> <span class=md-icon title=Created> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M14.47 15.08 11 13V7h1.5v5.25l3.08 1.83c-.41.28-.79.62-1.11 1m-1.39 4.84c-.36.05-.71.08-1.08.08-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8c0 .37-.03.72-.08 1.08.69.1 1.33.32 1.92.64.1-.56.16-1.13.16-1.72 0-5.5-4.5-10-10-10S2 6.5 2 12s4.47 10 10 10c.59 0 1.16-.06 1.72-.16-.32-.59-.54-1.23-.64-1.92M18 15v3h-3v2h3v3h2v-3h3v-2h-3v-3z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 27, 2026 04:59:07 UTC"><span class=timeago datetime=2026-01-27T04:59:07+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 27, 2026 04:59:07 UTC">2026-01-27</span> </span> </aside> </article> </div> <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg> Back to top </button> </main> <footer class=md-footer> <nav class="md-footer__inner md-grid" aria-label=Footer> <a href=../registration-builders/ class="md-footer__link md-footer__link--prev" aria-label="Previous: Registration Builders"> <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> Registration Builders </div> </div> </a> <a href=../string-messages/ class="md-footer__link md-footer__link--next" aria-label="Next: String Messages"> <div class=md-footer__title> <span class=md-footer__direction> Next </span> <div class=md-ellipsis> String Messages </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/advanced/runtime-configuration/index.html.meta DELETED Viewed

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

package/site/advanced/runtime-configuration.meta DELETED Viewed

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