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/architecture/comparisons/index.html DELETED Viewed

@@ -1,356 +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/architecture/comparisons/ rel=canonical><link href=../design-and-architecture/ rel=prev><link href=../performance/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.1"><title>Comparisons - 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=#comparisons-dxmessaging-and-alternatives 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> Comparisons </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 md-tabs__item--active"> <a href=../design-and-architecture/ class=md-tabs__link> Architecture </a> </li> <li class=md-tabs__item> <a href=../../advanced/emit-shorthands/ class=md-tabs__link> Advanced </a> </li> <li class=md-tabs__item> <a href=../../integrations/ class=md-tabs__link> Integrations </a> </li> <li class=md-tabs__item> <a href=../../examples/end-to-end/ class=md-tabs__link> Examples </a> </li> <li class=md-tabs__item> <a href=../../reference/reference/ class=md-tabs__link> Reference </a> </li> </ul> </div> </nav> </header> <div class=md-container data-md-component=container> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="DxMessaging Documentation" class="md-nav__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> DxMessaging Documentation </label> <div class=md-nav__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Home </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_2> <div class="md-nav__link md-nav__container"> <a href=../../getting-started/ class="md-nav__link "> <span class=md-ellipsis> Getting Started </span> </a> <label class="md-nav__link " for=__nav_2 id=__nav_2_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_2_label aria-expanded=false> <label class=md-nav__title for=__nav_2> <span class="md-nav__icon md-icon"></span> Getting Started </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../getting-started/overview/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/install/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/quick-start/ class=md-nav__link> <span class=md-ellipsis> Quick Start </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/getting-started/ class=md-nav__link> <span class=md-ellipsis> Getting Started Guide </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/visual-guide/ class=md-nav__link> <span class=md-ellipsis> Visual Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_3> <div class="md-nav__link md-nav__container"> <a href=../../concepts/ class="md-nav__link "> <span class=md-ellipsis> Concepts </span> </a> <label class="md-nav__link " for=__nav_3 id=__nav_3_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3> <span class="md-nav__icon md-icon"></span> Concepts </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../concepts/mental-model/ class=md-nav__link> <span class=md-ellipsis> Mental Model </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/message-types/ class=md-nav__link> <span class=md-ellipsis> Message Types </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/listening-patterns/ class=md-nav__link> <span class=md-ellipsis> Listening Patterns </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/targeting-and-context/ class=md-nav__link> <span class=md-ellipsis> Targeting & Context </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/interceptors-and-ordering/ class=md-nav__link> <span class=md-ellipsis> Interceptors & Ordering </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--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--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_5 checked> <label class=md-nav__link for=__nav_5 id=__nav_5_label tabindex> <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=true> <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=../design-and-architecture/ class=md-nav__link> <span class=md-ellipsis> Design & Architecture </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> Comparisons </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Comparisons </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=#this-guide-shows class=md-nav__link> <span class=md-ellipsis> This guide shows </span> </a> <nav class=md-nav aria-label="This guide shows"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#table-of-contents class=md-nav__link> <span class=md-ellipsis> Table of Contents </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#performance-benchmarks class=md-nav__link> <span class=md-ellipsis> Performance Benchmarks </span> </a> <nav class=md-nav aria-label="Performance Benchmarks"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#comparisons-windows class=md-nav__link> <span class=md-ellipsis> Comparisons (Windows) </span> </a> </li> <li class=md-nav__item> <a href=#comparisons-macos class=md-nav__link> <span class=md-ellipsis> Comparisons (macOS) </span> </a> </li> <li class=md-nav__item> <a href=#comparisons-linux class=md-nav__link> <span class=md-ellipsis> Comparisons (Linux) </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#unity-messaging-frameworks class=md-nav__link> <span class=md-ellipsis> Unity Messaging Frameworks </span> </a> <nav class=md-nav aria-label="Unity Messaging Frameworks"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#quick-summary-which-framework-to-choose class=md-nav__link> <span class=md-ellipsis> Quick Summary: Which Framework to Choose? </span> </a> <nav class=md-nav aria-label="Quick Summary: Which Framework to Choose?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#tldr-decision-tree class=md-nav__link> <span class=md-ellipsis> TL;DR Decision Tree </span> </a> <nav class=md-nav aria-label="TL;DR Decision Tree"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#one-line-summary-for-each class=md-nav__link> <span class=md-ellipsis> One-Line Summary for Each </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#unirx-reactive-extensions-for-unity class=md-nav__link> <span class=md-ellipsis> UniRx (Reactive Extensions for Unity) </span> </a> <nav class=md-nav aria-label="UniRx (Reactive Extensions for Unity)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#simple-messagebroker-setup-pubsub class=md-nav__link> <span class=md-ellipsis> Simple MessageBroker Setup (Pub/Sub) </span> </a> </li> <li class=md-nav__item> <a href=#advanced-stream-transformations-reactive-programming class=md-nav__link> <span class=md-ellipsis> Advanced Stream Transformations (Reactive Programming) </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-unirx-wins class=md-nav__link> <span class=md-ellipsis> When UniRx Wins </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#messagepipe-high-performance-messaging class=md-nav__link> <span class=md-ellipsis> MessagePipe (High-Performance Messaging) </span> </a> <nav class=md-nav aria-label="MessagePipe (High-Performance Messaging)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_1 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_1 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_1 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_1 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_1 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_1 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_1 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-messagepipe-wins class=md-nav__link> <span class=md-ellipsis> When MessagePipe Wins </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_1 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_1 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#zenject-signals-di-based-messaging class=md-nav__link> <span class=md-ellipsis> Zenject Signals (DI-Based Messaging) </span> </a> <nav class=md-nav aria-label="Zenject Signals (DI-Based Messaging)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_2 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_2 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_2 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_2 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_2 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_2 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_2 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-zenject-signals-win class=md-nav__link> <span class=md-ellipsis> When Zenject Signals Win </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_2 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_2 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#scriptable-object-architecture-soa class=md-nav__link> <span class=md-ellipsis> Scriptable Object Architecture (SOA) </span> </a> <nav class=md-nav aria-label="Scriptable Object Architecture (SOA)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#quick-comparison class=md-nav__link> <span class=md-ellipsis> Quick Comparison </span> </a> </li> <li class=md-nav__item> <a href=#when-to-use-each class=md-nav__link> <span class=md-ellipsis> When to Use Each </span> </a> <nav class=md-nav aria-label="When to Use Each"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#choose-soa-when class=md-nav__link> <span class=md-ellipsis> Choose SOA when </span> </a> <nav class=md-nav aria-label="Choose SOA when"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#choose-dxmessaging-when class=md-nav__link> <span class=md-ellipsis> Choose DxMessaging when </span> </a> <nav class=md-nav aria-label="Choose DxMessaging when"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-both-when class=md-nav__link> <span class=md-ellipsis> Use Both when </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#full-comparison-guide class=md-nav__link> <span class=md-ellipsis> Full Comparison Guide </span> </a> <nav class=md-nav aria-label="Full Comparison Guide"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#-soa-compatibility-guide class=md-nav__link> <span class=md-ellipsis> → SOA Compatibility Guide </span> </a> <nav class=md-nav aria-label="→ SOA Compatibility Guide"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#resources class=md-nav__link> <span class=md-ellipsis> Resources </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#traditional-approaches class=md-nav__link> <span class=md-ellipsis> Traditional Approaches </span> </a> <nav class=md-nav aria-label="Traditional Approaches"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#standard-c-eventsactions class=md-nav__link> <span class=md-ellipsis> Standard C# Events/Actions </span> </a> <nav class=md-nav aria-label="Standard C# Events/Actions"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_3 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_3 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_3 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_3 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_3 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_3 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_3 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-c-events-win class=md-nav__link> <span class=md-ellipsis> When C# Events Win </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_3 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_3 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#unityevents-inspector-wiring class=md-nav__link> <span class=md-ellipsis> UnityEvents (Inspector Wiring) </span> </a> <nav class=md-nav aria-label="UnityEvents (Inspector Wiring)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_4 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_4 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_4 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_4 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_4 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_4 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_4 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-unityevents-win class=md-nav__link> <span class=md-ellipsis> When UnityEvents Win </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_4 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_4 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#unity-sendmessage class=md-nav__link> <span class=md-ellipsis> Unity SendMessage </span> </a> <nav class=md-nav aria-label="Unity SendMessage"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_5 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_5 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_5 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_5 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_5 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_5 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_5 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-unity-sendmessage-wins class=md-nav__link> <span class=md-ellipsis> When Unity SendMessage Wins </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_5 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_5 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#global-event-bus-singletons class=md-nav__link> <span class=md-ellipsis> Global Event Bus Singletons </span> </a> <nav class=md-nav aria-label="Global Event Bus Singletons"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_6 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_6 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_6 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_6 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_6 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_6 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_6 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-static-event-bus-wins class=md-nav__link> <span class=md-ellipsis> When Static Event Bus Wins </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_6 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_6 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#honest-trade-offs-what-you-give-up-what-you-gain class=md-nav__link> <span class=md-ellipsis> Honest Trade-offs: What You Give Up, What You Gain </span> </a> <nav class=md-nav aria-label="Honest Trade-offs: What You Give Up, What You Gain"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#learning-curve_7 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> <nav class=md-nav aria-label="Learning Curve"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> <nav class=md-nav aria-label="What You Gain"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#verdict class=md-nav__link> <span class=md-ellipsis> Verdict </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#boilerplate class=md-nav__link> <span class=md-ellipsis> Boilerplate </span> </a> <nav class=md-nav aria-label=Boilerplate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_1 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_1 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#example-comparison class=md-nav__link> <span class=md-ellipsis> Example Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#performance class=md-nav__link> <span class=md-ellipsis> Performance </span> </a> <nav class=md-nav aria-label=Performance> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_2 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_2 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#hard-numbers class=md-nav__link> <span class=md-ellipsis> Hard Numbers </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#flexibility class=md-nav__link> <span class=md-ellipsis> Flexibility </span> </a> <nav class=md-nav aria-label=Flexibility> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_3 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_3 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#when-limitations-hurt class=md-nav__link> <span class=md-ellipsis> When Limitations Hurt </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#debuggability class=md-nav__link> <span class=md-ellipsis> Debuggability </span> </a> <nav class=md-nav aria-label=Debuggability> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_4 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_4 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#example-finding-who-fired-a-message class=md-nav__link> <span class=md-ellipsis> Example: Finding Who Fired a Message </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#coupling-and-architecture class=md-nav__link> <span class=md-ellipsis> Coupling and Architecture </span> </a> <nav class=md-nav aria-label="Coupling and Architecture"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_5 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_5 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#impact-on-architecture class=md-nav__link> <span class=md-ellipsis> Impact on Architecture </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#testing class=md-nav__link> <span class=md-ellipsis> Testing </span> </a> <nav class=md-nav aria-label=Testing> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_6 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_6 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> <nav class=md-nav aria-label="What You Gain"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example class=md-nav__link> <span class=md-ellipsis> Example </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#feature-by-feature-comparison-matrix class=md-nav__link> <span class=md-ellipsis> Feature-by-Feature Comparison Matrix </span> </a> <nav class=md-nav aria-label="Feature-by-Feature Comparison Matrix"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#unity-messaging-frameworks-comparison class=md-nav__link> <span class=md-ellipsis> Unity Messaging Frameworks Comparison </span> </a> </li> <li class=md-nav__item> <a href=#traditional-approaches-comparison class=md-nav__link> <span class=md-ellipsis> Traditional Approaches Comparison </span> </a> </li> <li class=md-nav__item> <a href=#overall-verdict-by-use-case class=md-nav__link> <span class=md-ellipsis> Overall Verdict by Use Case </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#when-each-approach-actually-wins class=md-nav__link> <span class=md-ellipsis> When Each Approach ACTUALLY Wins </span> </a> <nav class=md-nav aria-label="When Each Approach ACTUALLY Wins"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#dxmessaging-wins-when class=md-nav__link> <span class=md-ellipsis> DxMessaging Wins When </span> </a> </li> <li class=md-nav__item> <a href=#unirx-wins-when class=md-nav__link> <span class=md-ellipsis> UniRx Wins When </span> </a> </li> <li class=md-nav__item> <a href=#messagepipe-wins-when class=md-nav__link> <span class=md-ellipsis> MessagePipe Wins When </span> </a> </li> <li class=md-nav__item> <a href=#zenject-signals-win-when class=md-nav__link> <span class=md-ellipsis> Zenject Signals Win When </span> </a> </li> <li class=md-nav__item> <a href=#c-events-win-when class=md-nav__link> <span class=md-ellipsis> C# Events Win When </span> </a> </li> <li class=md-nav__item> <a href=#unityevents-win-when class=md-nav__link> <span class=md-ellipsis> UnityEvents Win When </span> </a> </li> <li class=md-nav__item> <a href=#soa-gameeventvariables-wins-when class=md-nav__link> <span class=md-ellipsis> SOA (GameEvent/Variables) Wins When </span> </a> </li> <li class=md-nav__item> <a href=#static-event-bus-wins-when class=md-nav__link> <span class=md-ellipsis> Static Event Bus Wins When </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#cost-benefit-summary class=md-nav__link> <span class=md-ellipsis> Cost-Benefit Summary </span> </a> <nav class=md-nav aria-label="Cost-Benefit Summary"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#costs class=md-nav__link> <span class=md-ellipsis> Costs </span> </a> </li> <li class=md-nav__item> <a href=#benefits class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#making-the-decision-be-honest-with-yourself class=md-nav__link> <span class=md-ellipsis> Making the Decision (Be Honest With Yourself) </span> </a> <nav class=md-nav aria-label="Making the Decision (Be Honest With Yourself)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#answer-these-questions-honestly class=md-nav__link> <span class=md-ellipsis> Answer these questions honestly </span> </a> </li> <li class=md-nav__item> <a href=#1-project-lifespan class=md-nav__link> <span class=md-ellipsis> 1. Project Lifespan? </span> </a> </li> <li class=md-nav__item> <a href=#2-team-size class=md-nav__link> <span class=md-ellipsis> 2. Team Size? </span> </a> </li> <li class=md-nav__item> <a href=#3-codebase-size class=md-nav__link> <span class=md-ellipsis> 3. Codebase Size? </span> </a> </li> <li class=md-nav__item> <a href=#4-how-many-systems-need-to-communicate class=md-nav__link> <span class=md-ellipsis> 4. How Many Systems Need to Communicate? </span> </a> </li> <li class=md-nav__item> <a href=#5-have-you-had-memory-leaks-from-forgotten-unsubscribes class=md-nav__link> <span class=md-ellipsis> 5. Have You Had Memory Leaks From Forgotten Unsubscribes? </span> </a> </li> <li class=md-nav__item> <a href=#6-how-often-do-you-debug-what-fired-when class=md-nav__link> <span class=md-ellipsis> 6. How Often Do You Debug "What Fired When?" </span> </a> </li> <li class=md-nav__item> <a href=#quick-decision-matrix class=md-nav__link> <span class=md-ellipsis> Quick Decision Matrix </span> </a> </li> <li class=md-nav__item> <a href=#the-real-question class=md-nav__link> <span class=md-ellipsis> The Real Question </span> </a> <nav class=md-nav aria-label="The Real Question"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#will-this-project-still-exist-in-3-months class=md-nav__link> <span class=md-ellipsis> "Will this project still exist in 3 months?" </span> </a> <nav class=md-nav aria-label='"Will this project still exist in 3 months?"'> <ul class=md-nav__list> <li class=md-nav__item> <a href=#will-anyone-else-work-on-this-code class=md-nav__link> <span class=md-ellipsis> "Will anyone else work on this code?" </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#rule-of-thumb class=md-nav__link> <span class=md-ellipsis> Rule of Thumb </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../performance/ class=md-nav__link> <span class=md-ellipsis> Performance </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Advanced </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Advanced </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../advanced/emit-shorthands/ class=md-nav__link> <span class=md-ellipsis> Emit Shorthands </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/message-bus-providers/ class=md-nav__link> <span class=md-ellipsis> Message Bus Providers </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/registration-builders/ class=md-nav__link> <span class=md-ellipsis> Registration Builders </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/runtime-configuration/ class=md-nav__link> <span class=md-ellipsis> Runtime Configuration </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/string-messages/ class=md-nav__link> <span class=md-ellipsis> String Messages </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_7> <div class="md-nav__link md-nav__container"> <a href=../../integrations/ class="md-nav__link "> <span class=md-ellipsis> Integrations </span> </a> <label class="md-nav__link " for=__nav_7 id=__nav_7_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Integrations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../integrations/vcontainer/ class=md-nav__link> <span class=md-ellipsis> VContainer </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/zenject/ class=md-nav__link> <span class=md-ellipsis> Zenject </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/reflex/ class=md-nav__link> <span class=md-ellipsis> Reflex </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Examples </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Examples </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../examples/end-to-end/ class=md-nav__link> <span class=md-ellipsis> End-to-End </span> </a> </li> <li class=md-nav__item> <a href=../../examples/end-to-end-scene-transitions/ class=md-nav__link> <span class=md-ellipsis> Scene Transitions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/reference/ class=md-nav__link> <span class=md-ellipsis> API Reference (Practical) </span> </a> </li> <li class=md-nav__item> <a href=../../reference/quick-reference/ class=md-nav__link> <span class=md-ellipsis> Quick Reference </span> </a> </li> <li class=md-nav__item> <a href=../../reference/helpers/ class=md-nav__link> <span class=md-ellipsis> Helpers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/faq/ class=md-nav__link> <span class=md-ellipsis> FAQ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/glossary/ class=md-nav__link> <span class=md-ellipsis> Glossary </span> </a> </li> <li class=md-nav__item> <a href=../../reference/troubleshooting/ class=md-nav__link> <span class=md-ellipsis> Troubleshooting </span> </a> </li> <li class=md-nav__item> <a href=../../reference/compatibility/ class=md-nav__link> <span class=md-ellipsis> Compatibility </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#this-guide-shows class=md-nav__link> <span class=md-ellipsis> This guide shows </span> </a> <nav class=md-nav aria-label="This guide shows"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#table-of-contents class=md-nav__link> <span class=md-ellipsis> Table of Contents </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#performance-benchmarks class=md-nav__link> <span class=md-ellipsis> Performance Benchmarks </span> </a> <nav class=md-nav aria-label="Performance Benchmarks"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#comparisons-windows class=md-nav__link> <span class=md-ellipsis> Comparisons (Windows) </span> </a> </li> <li class=md-nav__item> <a href=#comparisons-macos class=md-nav__link> <span class=md-ellipsis> Comparisons (macOS) </span> </a> </li> <li class=md-nav__item> <a href=#comparisons-linux class=md-nav__link> <span class=md-ellipsis> Comparisons (Linux) </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#unity-messaging-frameworks class=md-nav__link> <span class=md-ellipsis> Unity Messaging Frameworks </span> </a> <nav class=md-nav aria-label="Unity Messaging Frameworks"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#quick-summary-which-framework-to-choose class=md-nav__link> <span class=md-ellipsis> Quick Summary: Which Framework to Choose? </span> </a> <nav class=md-nav aria-label="Quick Summary: Which Framework to Choose?"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#tldr-decision-tree class=md-nav__link> <span class=md-ellipsis> TL;DR Decision Tree </span> </a> <nav class=md-nav aria-label="TL;DR Decision Tree"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#one-line-summary-for-each class=md-nav__link> <span class=md-ellipsis> One-Line Summary for Each </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#unirx-reactive-extensions-for-unity class=md-nav__link> <span class=md-ellipsis> UniRx (Reactive Extensions for Unity) </span> </a> <nav class=md-nav aria-label="UniRx (Reactive Extensions for Unity)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#simple-messagebroker-setup-pubsub class=md-nav__link> <span class=md-ellipsis> Simple MessageBroker Setup (Pub/Sub) </span> </a> </li> <li class=md-nav__item> <a href=#advanced-stream-transformations-reactive-programming class=md-nav__link> <span class=md-ellipsis> Advanced Stream Transformations (Reactive Programming) </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-unirx-wins class=md-nav__link> <span class=md-ellipsis> When UniRx Wins </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#messagepipe-high-performance-messaging class=md-nav__link> <span class=md-ellipsis> MessagePipe (High-Performance Messaging) </span> </a> <nav class=md-nav aria-label="MessagePipe (High-Performance Messaging)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_1 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_1 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_1 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_1 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_1 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_1 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_1 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-messagepipe-wins class=md-nav__link> <span class=md-ellipsis> When MessagePipe Wins </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_1 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_1 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#zenject-signals-di-based-messaging class=md-nav__link> <span class=md-ellipsis> Zenject Signals (DI-Based Messaging) </span> </a> <nav class=md-nav aria-label="Zenject Signals (DI-Based Messaging)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_2 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_2 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_2 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_2 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_2 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_2 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_2 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-zenject-signals-win class=md-nav__link> <span class=md-ellipsis> When Zenject Signals Win </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_2 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_2 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#scriptable-object-architecture-soa class=md-nav__link> <span class=md-ellipsis> Scriptable Object Architecture (SOA) </span> </a> <nav class=md-nav aria-label="Scriptable Object Architecture (SOA)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#quick-comparison class=md-nav__link> <span class=md-ellipsis> Quick Comparison </span> </a> </li> <li class=md-nav__item> <a href=#when-to-use-each class=md-nav__link> <span class=md-ellipsis> When to Use Each </span> </a> <nav class=md-nav aria-label="When to Use Each"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#choose-soa-when class=md-nav__link> <span class=md-ellipsis> Choose SOA when </span> </a> <nav class=md-nav aria-label="Choose SOA when"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#choose-dxmessaging-when class=md-nav__link> <span class=md-ellipsis> Choose DxMessaging when </span> </a> <nav class=md-nav aria-label="Choose DxMessaging when"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-both-when class=md-nav__link> <span class=md-ellipsis> Use Both when </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#full-comparison-guide class=md-nav__link> <span class=md-ellipsis> Full Comparison Guide </span> </a> <nav class=md-nav aria-label="Full Comparison Guide"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#-soa-compatibility-guide class=md-nav__link> <span class=md-ellipsis> → SOA Compatibility Guide </span> </a> <nav class=md-nav aria-label="→ SOA Compatibility Guide"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#resources class=md-nav__link> <span class=md-ellipsis> Resources </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#traditional-approaches class=md-nav__link> <span class=md-ellipsis> Traditional Approaches </span> </a> <nav class=md-nav aria-label="Traditional Approaches"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#standard-c-eventsactions class=md-nav__link> <span class=md-ellipsis> Standard C# Events/Actions </span> </a> <nav class=md-nav aria-label="Standard C# Events/Actions"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_3 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_3 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_3 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_3 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_3 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_3 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_3 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-c-events-win class=md-nav__link> <span class=md-ellipsis> When C# Events Win </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_3 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_3 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#unityevents-inspector-wiring class=md-nav__link> <span class=md-ellipsis> UnityEvents (Inspector Wiring) </span> </a> <nav class=md-nav aria-label="UnityEvents (Inspector Wiring)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_4 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_4 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_4 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_4 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_4 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_4 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_4 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-unityevents-win class=md-nav__link> <span class=md-ellipsis> When UnityEvents Win </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_4 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_4 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#unity-sendmessage class=md-nav__link> <span class=md-ellipsis> Unity SendMessage </span> </a> <nav class=md-nav aria-label="Unity SendMessage"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_5 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_5 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_5 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_5 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_5 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_5 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_5 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-unity-sendmessage-wins class=md-nav__link> <span class=md-ellipsis> When Unity SendMessage Wins </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_5 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_5 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#global-event-bus-singletons class=md-nav__link> <span class=md-ellipsis> Global Event Bus Singletons </span> </a> <nav class=md-nav aria-label="Global Event Bus Singletons"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#key-features_6 class=md-nav__link> <span class=md-ellipsis> Key Features </span> </a> </li> <li class=md-nav__item> <a href=#code-example_6 class=md-nav__link> <span class=md-ellipsis> Code Example </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-solves_6 class=md-nav__link> <span class=md-ellipsis> What Problems It Solves </span> </a> </li> <li class=md-nav__item> <a href=#what-problems-it-doesnt-solve-well_6 class=md-nav__link> <span class=md-ellipsis> What Problems It Doesn't Solve Well </span> </a> </li> <li class=md-nav__item> <a href=#performance-characteristics_6 class=md-nav__link> <span class=md-ellipsis> Performance Characteristics </span> </a> </li> <li class=md-nav__item> <a href=#learning-curve_6 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> </li> <li class=md-nav__item> <a href=#ease-of-understanding_6 class=md-nav__link> <span class=md-ellipsis> Ease of Understanding </span> </a> </li> <li class=md-nav__item> <a href=#when-static-event-bus-wins class=md-nav__link> <span class=md-ellipsis> When Static Event Bus Wins </span> </a> </li> <li class=md-nav__item> <a href=#when-dxmessaging-wins_6 class=md-nav__link> <span class=md-ellipsis> When DxMessaging Wins </span> </a> </li> <li class=md-nav__item> <a href=#direct-comparison_6 class=md-nav__link> <span class=md-ellipsis> Direct Comparison </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#honest-trade-offs-what-you-give-up-what-you-gain class=md-nav__link> <span class=md-ellipsis> Honest Trade-offs: What You Give Up, What You Gain </span> </a> <nav class=md-nav aria-label="Honest Trade-offs: What You Give Up, What You Gain"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#learning-curve_7 class=md-nav__link> <span class=md-ellipsis> Learning Curve </span> </a> <nav class=md-nav aria-label="Learning Curve"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> <nav class=md-nav aria-label="What You Gain"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#verdict class=md-nav__link> <span class=md-ellipsis> Verdict </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#boilerplate class=md-nav__link> <span class=md-ellipsis> Boilerplate </span> </a> <nav class=md-nav aria-label=Boilerplate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_1 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_1 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#example-comparison class=md-nav__link> <span class=md-ellipsis> Example Comparison </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#performance class=md-nav__link> <span class=md-ellipsis> Performance </span> </a> <nav class=md-nav aria-label=Performance> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_2 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_2 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#hard-numbers class=md-nav__link> <span class=md-ellipsis> Hard Numbers </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#flexibility class=md-nav__link> <span class=md-ellipsis> Flexibility </span> </a> <nav class=md-nav aria-label=Flexibility> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_3 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_3 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#when-limitations-hurt class=md-nav__link> <span class=md-ellipsis> When Limitations Hurt </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#debuggability class=md-nav__link> <span class=md-ellipsis> Debuggability </span> </a> <nav class=md-nav aria-label=Debuggability> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_4 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_4 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#example-finding-who-fired-a-message class=md-nav__link> <span class=md-ellipsis> Example: Finding Who Fired a Message </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#coupling-and-architecture class=md-nav__link> <span class=md-ellipsis> Coupling and Architecture </span> </a> <nav class=md-nav aria-label="Coupling and Architecture"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_5 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_5 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> </li> <li class=md-nav__item> <a href=#impact-on-architecture class=md-nav__link> <span class=md-ellipsis> Impact on Architecture </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#testing class=md-nav__link> <span class=md-ellipsis> Testing </span> </a> <nav class=md-nav aria-label=Testing> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-give-up_6 class=md-nav__link> <span class=md-ellipsis> What You Give Up </span> </a> </li> <li class=md-nav__item> <a href=#what-you-gain_6 class=md-nav__link> <span class=md-ellipsis> What You Gain </span> </a> <nav class=md-nav aria-label="What You Gain"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example class=md-nav__link> <span class=md-ellipsis> Example </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#feature-by-feature-comparison-matrix class=md-nav__link> <span class=md-ellipsis> Feature-by-Feature Comparison Matrix </span> </a> <nav class=md-nav aria-label="Feature-by-Feature Comparison Matrix"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#unity-messaging-frameworks-comparison class=md-nav__link> <span class=md-ellipsis> Unity Messaging Frameworks Comparison </span> </a> </li> <li class=md-nav__item> <a href=#traditional-approaches-comparison class=md-nav__link> <span class=md-ellipsis> Traditional Approaches Comparison </span> </a> </li> <li class=md-nav__item> <a href=#overall-verdict-by-use-case class=md-nav__link> <span class=md-ellipsis> Overall Verdict by Use Case </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#when-each-approach-actually-wins class=md-nav__link> <span class=md-ellipsis> When Each Approach ACTUALLY Wins </span> </a> <nav class=md-nav aria-label="When Each Approach ACTUALLY Wins"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#dxmessaging-wins-when class=md-nav__link> <span class=md-ellipsis> DxMessaging Wins When </span> </a> </li> <li class=md-nav__item> <a href=#unirx-wins-when class=md-nav__link> <span class=md-ellipsis> UniRx Wins When </span> </a> </li> <li class=md-nav__item> <a href=#messagepipe-wins-when class=md-nav__link> <span class=md-ellipsis> MessagePipe Wins When </span> </a> </li> <li class=md-nav__item> <a href=#zenject-signals-win-when class=md-nav__link> <span class=md-ellipsis> Zenject Signals Win When </span> </a> </li> <li class=md-nav__item> <a href=#c-events-win-when class=md-nav__link> <span class=md-ellipsis> C# Events Win When </span> </a> </li> <li class=md-nav__item> <a href=#unityevents-win-when class=md-nav__link> <span class=md-ellipsis> UnityEvents Win When </span> </a> </li> <li class=md-nav__item> <a href=#soa-gameeventvariables-wins-when class=md-nav__link> <span class=md-ellipsis> SOA (GameEvent/Variables) Wins When </span> </a> </li> <li class=md-nav__item> <a href=#static-event-bus-wins-when class=md-nav__link> <span class=md-ellipsis> Static Event Bus Wins When </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#cost-benefit-summary class=md-nav__link> <span class=md-ellipsis> Cost-Benefit Summary </span> </a> <nav class=md-nav aria-label="Cost-Benefit Summary"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#costs class=md-nav__link> <span class=md-ellipsis> Costs </span> </a> </li> <li class=md-nav__item> <a href=#benefits class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#making-the-decision-be-honest-with-yourself class=md-nav__link> <span class=md-ellipsis> Making the Decision (Be Honest With Yourself) </span> </a> <nav class=md-nav aria-label="Making the Decision (Be Honest With Yourself)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#answer-these-questions-honestly class=md-nav__link> <span class=md-ellipsis> Answer these questions honestly </span> </a> </li> <li class=md-nav__item> <a href=#1-project-lifespan class=md-nav__link> <span class=md-ellipsis> 1. Project Lifespan? </span> </a> </li> <li class=md-nav__item> <a href=#2-team-size class=md-nav__link> <span class=md-ellipsis> 2. Team Size? </span> </a> </li> <li class=md-nav__item> <a href=#3-codebase-size class=md-nav__link> <span class=md-ellipsis> 3. Codebase Size? </span> </a> </li> <li class=md-nav__item> <a href=#4-how-many-systems-need-to-communicate class=md-nav__link> <span class=md-ellipsis> 4. How Many Systems Need to Communicate? </span> </a> </li> <li class=md-nav__item> <a href=#5-have-you-had-memory-leaks-from-forgotten-unsubscribes class=md-nav__link> <span class=md-ellipsis> 5. Have You Had Memory Leaks From Forgotten Unsubscribes? </span> </a> </li> <li class=md-nav__item> <a href=#6-how-often-do-you-debug-what-fired-when class=md-nav__link> <span class=md-ellipsis> 6. How Often Do You Debug "What Fired When?" </span> </a> </li> <li class=md-nav__item> <a href=#quick-decision-matrix class=md-nav__link> <span class=md-ellipsis> Quick Decision Matrix </span> </a> </li> <li class=md-nav__item> <a href=#the-real-question class=md-nav__link> <span class=md-ellipsis> The Real Question </span> </a> <nav class=md-nav aria-label="The Real Question"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#will-this-project-still-exist-in-3-months class=md-nav__link> <span class=md-ellipsis> "Will this project still exist in 3 months?" </span> </a> <nav class=md-nav aria-label='"Will this project still exist in 3 months?"'> <ul class=md-nav__list> <li class=md-nav__item> <a href=#will-anyone-else-work-on-this-code class=md-nav__link> <span class=md-ellipsis> "Will anyone else work on this code?" </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#rule-of-thumb class=md-nav__link> <span class=md-ellipsis> Rule of Thumb </span> </a> </li> </ul> </nav> </li> </ul> </nav> </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=../design-and-architecture/ class=md-path__link> <span class=md-ellipsis> Architecture </span> </a> </li> </ol> </nav> <article class="md-content__inner md-typeset"> <a href=https://github.com/wallstop/DxMessaging/edit/master/docs/architecture/comparisons.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/architecture/comparisons.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=comparisons-dxmessaging-and-alternatives>Comparisons: DxMessaging and Alternatives<a class=headerlink href=#comparisons-dxmessaging-and-alternatives title="Anchor link to this section">&para;</a></h1> <p><strong>TL;DR:</strong> This guide compares DxMessaging with other messaging approaches. Each has legitimate strengths and trade-offs. DxMessaging takes a different approach with its own trade-offs.</p> <h2 id=this-guide-shows>This guide shows<a class=headerlink href=#this-guide-shows title="Anchor link to this section">&para;</a></h2> <ul> <li>Characteristics of each approach (with real code examples)</li> <li>How DxMessaging takes a different approach (with real code examples)</li> <li>Trade-offs for each option (what you give up, what you gain)</li> <li>When to use each approach based on your needs</li> </ul> <h3 id=table-of-contents>Table of Contents<a class=headerlink href=#table-of-contents title="Anchor link to this section">&para;</a></h3> <ul> <li><a href=#performance-benchmarks>Performance Benchmarks</a></li> <li><a href=#unity-messaging-frameworks>Unity Messaging Frameworks</a></li> <li><a href=#unirx-reactive-extensions-for-unity>UniRx</a></li> <li><a href=#messagepipe-high-performance-messaging>MessagePipe</a></li> <li><a href=#zenject-signals-di-based-messaging>Zenject Signals</a></li> <li><a href=#scriptable-object-architecture-soa>Scriptable Object Architecture (SOA)</a></li> <li><a href=#traditional-approaches>Traditional Approaches</a></li> <li><a href=#standard-c-eventsactions>C# Events/Delegates</a></li> <li><a href=#unityevents-inspector-wiring>UnityEvents</a></li> <li><a href=#unity-sendmessage>Unity SendMessage</a></li> <li><a href=#global-event-bus-singletons>Static Event Buses</a></li> <li><a href=#honest-trade-offs-what-you-give-up-what-you-gain>Trade-offs</a></li> <li><a href=#feature-by-feature-comparison-matrix>Feature Matrix</a></li> <li><a href=#when-each-approach-actually-wins>Decision Guide</a></li> </ul> <h2 id=performance-benchmarks>Performance Benchmarks<a class=headerlink href=#performance-benchmarks title="Anchor link to this section">&para;</a></h2> <p>These sections are auto-updated by the PlayMode comparison benchmarks in the <a href=https://github.com/wallstop/DxMessaging/blob/master/Tests/Runtime/Benchmarks/ComparisonPerformanceTests.cs>Comparison Performance PlayMode tests</a>. Run the suite locally to refresh the tables.</p> <h3 id=comparisons-windows>Comparisons (Windows)<a class=headerlink href=#comparisons-windows title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Message Tech</th> <th>Operations / Second</th> <th>Allocations?</th> </tr> </thead> <tbody> <tr> <td>DxMessaging (Untargeted) - No-Copy</td> <td>19,886,000</td> <td>No</td> </tr> <tr> <td>UniRx MessageBroker</td> <td>18,002,000</td> <td>No</td> </tr> <tr> <td>MessagePipe (Global)</td> <td>97,748,000</td> <td>No</td> </tr> <tr> <td>Zenject SignalBus</td> <td>2,350,000</td> <td>Yes</td> </tr> </tbody> </table> <h3 id=comparisons-macos>Comparisons (macOS)<a class=headerlink href=#comparisons-macos title="Anchor link to this section">&para;</a></h3> <p>Run the PlayMode comparison benchmarks on macOS to populate this section.</p> <h3 id=comparisons-linux>Comparisons (Linux)<a class=headerlink href=#comparisons-linux title="Anchor link to this section">&para;</a></h3> <p>Run the PlayMode comparison benchmarks on Linux to populate this section.</p> <hr> <h2 id=unity-messaging-frameworks>Unity Messaging Frameworks<a class=headerlink href=#unity-messaging-frameworks title="Anchor link to this section">&para;</a></h2> <p>This section compares DxMessaging with other popular Unity messaging/eventing libraries. Each offers different approaches to solving communication and decoupling problems in Unity.</p> <h3 id=quick-summary-which-framework-to-choose>Quick Summary: Which Framework to Choose?<a class=headerlink href=#quick-summary-which-framework-to-choose title="Anchor link to this section">&para;</a></h3> <h4 id=tldr-decision-tree>TL;DR Decision Tree<a class=headerlink href=#tldr-decision-tree title="Anchor link to this section">&para;</a></h4> <div class="language-text highlight"><span class=filename>Text Only</span><pre><span></span><code><span id=__span-0-1><a id=__codelineno-0-1 name=__codelineno-0-1 href=#__codelineno-0-1></a>Need absolute simplest pub/sub setup (zero boilerplate)?
-</span><span id=__span-0-2><a id=__codelineno-0-2 name=__codelineno-0-2 href=#__codelineno-0-2></a>  → Use UniRx MessageBroker (publish/receive in 2 lines)
-</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>Need complex event stream transformations (debounce, throttle, combine)?
-</span><span id=__span-0-5><a id=__codelineno-0-5 name=__codelineno-0-5 href=#__codelineno-0-5></a>  → Use UniRx (reactive programming paradigm)
-</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>Already using Dependency Injection (Zenject, VContainer, Reflex)?
-</span><span id=__span-0-8><a id=__codelineno-0-8 name=__codelineno-0-8 href=#__codelineno-0-8></a>  → Use MessagePipe (DI-first, best performance) or Zenject Signals (if on Zenject)
-</span><span id=__span-0-9><a id=__codelineno-0-9 name=__codelineno-0-9 href=#__codelineno-0-9></a>  → Or DxMessaging (integrates with DI, see Integrations guides for Zenject/VContainer/Reflex)
-</span><span id=__span-0-10><a id=__codelineno-0-10 name=__codelineno-0-10 href=#__codelineno-0-10></a>
-</span><span id=__span-0-11><a id=__codelineno-0-11 name=__codelineno-0-11 href=#__codelineno-0-11></a>Need Unity-specific features (GameObject targeting, Inspector debugging, global observers)?
-</span><span id=__span-0-12><a id=__codelineno-0-12 name=__codelineno-0-12 href=#__codelineno-0-12></a>  → Use DxMessaging (Unity-first design)
-</span><span id=__span-0-13><a id=__codelineno-0-13 name=__codelineno-0-13 href=#__codelineno-0-13></a>
-</span><span id=__span-0-14><a id=__codelineno-0-14 name=__codelineno-0-14 href=#__codelineno-0-14></a>Want plug-and-play with zero dependencies?
-</span><span id=__span-0-15><a id=__codelineno-0-15 name=__codelineno-0-15 href=#__codelineno-0-15></a>  → Use DxMessaging (no setup required)
-</span><span id=__span-0-16><a id=__codelineno-0-16 name=__codelineno-0-16 href=#__codelineno-0-16></a>
-</span><span id=__span-0-17><a id=__codelineno-0-17 name=__codelineno-0-17 href=#__codelineno-0-17></a>Maximum raw throughput is a top priority?
-</span><span id=__span-0-18><a id=__codelineno-0-18 name=__codelineno-0-18 href=#__codelineno-0-18></a>  → Use MessagePipe (highest ops/sec in benchmarks)
-</span><span id=__span-0-19><a id=__codelineno-0-19 name=__codelineno-0-19 href=#__codelineno-0-19></a>
-</span><span id=__span-0-20><a id=__codelineno-0-20 name=__codelineno-0-20 href=#__codelineno-0-20></a>Need message validation, interception, or ordered execution?
-</span><span id=__span-0-21><a id=__codelineno-0-21 name=__codelineno-0-21 href=#__codelineno-0-21></a>  → Use DxMessaging (interceptor pipeline, priority-based ordering)
-</span><span id=__span-0-22><a id=__codelineno-0-22 name=__codelineno-0-22 href=#__codelineno-0-22></a>
-</span><span id=__span-0-23><a id=__codelineno-0-23 name=__codelineno-0-23 href=#__codelineno-0-23></a>Simple pub/sub with automatic lifecycle management and debugging?
-</span><span id=__span-0-24><a id=__codelineno-0-24 name=__codelineno-0-24 href=#__codelineno-0-24></a>  → Use DxMessaging (automatic cleanup, priorities, validation, Inspector)
-</span></code></pre></div> <h5 id=one-line-summary-for-each>One-Line Summary for Each<a class=headerlink href=#one-line-summary-for-each title="Anchor link to this section">&para;</a></h5> <ul> <li><strong>DxMessaging:</strong> Unity-first pub/sub with automatic lifecycle and Inspector debugging</li> <li><strong>UniRx:</strong> Reactive programming with LINQ-style stream operators for complex event transformations</li> <li><strong>MessagePipe:</strong> DI-first, highest throughput for high-frequency messaging in DI architectures</li> <li><strong>Zenject Signals:</strong> Decoupled messaging integrated with Zenject dependency injection</li> </ul> <blockquote> <p><strong>💡 Note:</strong> DxMessaging works both standalone (zero dependencies) AND with DI frameworks. See <a href=../../integrations/ >Integration Guides</a> for Zenject, VContainer, and Reflex.</p> </blockquote> <hr> <h3 id=unirx-reactive-extensions-for-unity>UniRx (Reactive Extensions for Unity)<a class=headerlink href=#unirx-reactive-extensions-for-unity title="Anchor link to this section">&para;</a></h3> <p><strong>What It Is:</strong> A reactive programming library that treats events as observable streams. Based on .NET Reactive Extensions (Rx), reimplemented for Unity with IL2CPP compatibility.</p> <p><strong>Core Philosophy:</strong> Everything is a stream that can be observed, filtered, combined, and transformed using LINQ-style operators.</p> <h4 id=key-features>Key Features<a class=headerlink href=#key-features title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Stream-based programming:</strong> Transform events into observable sequences</li> <li><strong>LINQ operators:</strong> <code>Where</code>, <code>Select</code>, <code>Merge</code>, <code>CombineLatest</code>, <code>Buffer</code>, etc.</li> <li><strong>Async operations:</strong> Convert coroutines to observables with cancellation support</li> <li><strong>Multithreading:</strong> Thread-safe operations with main thread synchronization</li> <li><strong>Time operators:</strong> Frame-based and time-based event handling</li> <li><strong>UI integration:</strong> Observable extensions for Unity UI events</li> </ul> <h4 id=code-example>Code Example<a class=headerlink href=#code-example title="Anchor link to this section">&para;</a></h4> <h4 id=simple-messagebroker-setup-pubsub>Simple MessageBroker Setup (Pub/Sub)<a class=headerlink href=#simple-messagebroker-setup-pubsub title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-1-1><a id=__codelineno-1-1 name=__codelineno-1-1 href=#__codelineno-1-1></a><span class=k>using</span><span class=w> </span><span class=nn>UniRx</span><span class=p>;</span>
-</span><span id=__span-1-2><a id=__codelineno-1-2 name=__codelineno-1-2 href=#__codelineno-1-2></a><span class=k>using</span><span class=w> </span><span class=nn>UnityEngine</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=k>public</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>EnemySpawned</span>
-</span><span id=__span-1-5><a id=__codelineno-1-5 name=__codelineno-1-5 href=#__codelineno-1-5></a><span class=p>{</span>
-</span><span id=__span-1-6><a id=__codelineno-1-6 name=__codelineno-1-6 href=#__codelineno-1-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>EnemyId</span><span class=p>;</span>
-</span><span id=__span-1-7><a id=__codelineno-1-7 name=__codelineno-1-7 href=#__codelineno-1-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=n>Vector3</span><span class=w> </span><span class=n>Position</span><span class=p>;</span>
-</span><span id=__span-1-8><a id=__codelineno-1-8 name=__codelineno-1-8 href=#__codelineno-1-8></a><span 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=c1>// Publisher - straightforward, no setup required</span>
-</span><span id=__span-1-11><a id=__codelineno-1-11 name=__codelineno-1-11 href=#__codelineno-1-11></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>EnemySpawner</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-1-12><a id=__codelineno-1-12 name=__codelineno-1-12 href=#__codelineno-1-12></a><span class=p>{</span>
-</span><span id=__span-1-13><a id=__codelineno-1-13 name=__codelineno-1-13 href=#__codelineno-1-13></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>SpawnEnemy</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>id</span><span class=p>)</span>
-</span><span id=__span-1-14><a id=__codelineno-1-14 name=__codelineno-1-14 href=#__codelineno-1-14></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-1-15><a id=__codelineno-1-15 name=__codelineno-1-15 href=#__codelineno-1-15></a><span class=w>        </span><span class=n>MessageBroker</span><span class=p>.</span><span class=n>Default</span><span class=p>.</span><span class=n>Publish</span><span class=p>(</span><span class=k>new</span><span class=w> </span><span class=n>EnemySpawned</span>
-</span><span id=__span-1-16><a id=__codelineno-1-16 name=__codelineno-1-16 href=#__codelineno-1-16></a><span class=w>        </span><span class=p>{</span>
-</span><span id=__span-1-17><a id=__codelineno-1-17 name=__codelineno-1-17 href=#__codelineno-1-17></a><span class=w>            </span><span class=n>EnemyId</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>id</span><span class=p>,</span>
-</span><span id=__span-1-18><a id=__codelineno-1-18 name=__codelineno-1-18 href=#__codelineno-1-18></a><span class=w>            </span><span class=n>Position</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>transform</span><span class=p>.</span><span class=n>position</span>
-</span><span id=__span-1-19><a id=__codelineno-1-19 name=__codelineno-1-19 href=#__codelineno-1-19></a><span class=w>        </span><span class=p>});</span>
-</span><span id=__span-1-20><a id=__codelineno-1-20 name=__codelineno-1-20 href=#__codelineno-1-20></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-1-21><a id=__codelineno-1-21 name=__codelineno-1-21 href=#__codelineno-1-21></a><span class=p>}</span>
-</span><span id=__span-1-22><a id=__codelineno-1-22 name=__codelineno-1-22 href=#__codelineno-1-22></a>
-</span><span id=__span-1-23><a id=__codelineno-1-23 name=__codelineno-1-23 href=#__codelineno-1-23></a><span class=c1>// Subscriber - also straightforward</span>
-</span><span id=__span-1-24><a id=__codelineno-1-24 name=__codelineno-1-24 href=#__codelineno-1-24></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>AchievementSystem</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-1-25><a id=__codelineno-1-25 name=__codelineno-1-25 href=#__codelineno-1-25></a><span class=p>{</span>
-</span><span id=__span-1-26><a id=__codelineno-1-26 name=__codelineno-1-26 href=#__codelineno-1-26></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>Start</span><span class=p>()</span>
-</span><span id=__span-1-27><a id=__codelineno-1-27 name=__codelineno-1-27 href=#__codelineno-1-27></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-1-28><a id=__codelineno-1-28 name=__codelineno-1-28 href=#__codelineno-1-28></a><span class=w>        </span><span class=n>MessageBroker</span><span class=p>.</span><span class=n>Default</span><span class=p>.</span><span class=n>Receive</span><span class=o>&lt;</span><span class=n>EnemySpawned</span><span class=o>&gt;</span><span class=p>()</span>
-</span><span id=__span-1-29><a id=__codelineno-1-29 name=__codelineno-1-29 href=#__codelineno-1-29></a><span class=w>            </span><span class=p>.</span><span class=n>Subscribe</span><span class=p>(</span><span class=n>msg</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;Enemy {msg.EnemyId} spawned!&quot;</span><span class=p>))</span>
-</span><span id=__span-1-30><a id=__codelineno-1-30 name=__codelineno-1-30 href=#__codelineno-1-30></a><span class=w>            </span><span class=p>.</span><span class=n>AddTo</span><span class=p>(</span><span class=k>this</span><span class=p>);</span><span class=w> </span><span class=c1>// Automatic cleanup on destroy</span>
-</span><span id=__span-1-31><a id=__codelineno-1-31 name=__codelineno-1-31 href=#__codelineno-1-31></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-1-32><a id=__codelineno-1-32 name=__codelineno-1-32 href=#__codelineno-1-32></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=advanced-stream-transformations-reactive-programming>Advanced Stream Transformations (Reactive Programming)<a class=headerlink href=#advanced-stream-transformations-reactive-programming title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-2-1><a id=__codelineno-2-1 name=__codelineno-2-1 href=#__codelineno-2-1></a><span class=c1>// Double-click detection using reactive operators</span>
-</span><span id=__span-2-2><a id=__codelineno-2-2 name=__codelineno-2-2 href=#__codelineno-2-2></a><span class=n>Observable</span><span class=p>.</span><span class=n>EveryUpdate</span><span class=p>()</span>
-</span><span id=__span-2-3><a id=__codelineno-2-3 name=__codelineno-2-3 href=#__codelineno-2-3></a><span class=w>    </span><span class=p>.</span><span class=n>Where</span><span class=p>(</span><span class=n>_</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Input</span><span class=p>.</span><span class=n>GetMouseButtonDown</span><span class=p>(</span><span class=mi>0</span><span class=p>))</span>
-</span><span id=__span-2-4><a id=__codelineno-2-4 name=__codelineno-2-4 href=#__codelineno-2-4></a><span class=w>    </span><span class=p>.</span><span class=n>Buffer</span><span class=p>(</span><span class=n>Observable</span><span class=p>.</span><span class=n>Timer</span><span class=p>(</span><span class=n>TimeSpan</span><span class=p>.</span><span class=n>FromMilliseconds</span><span class=p>(</span><span class=mi>250</span><span class=p>)))</span>
-</span><span id=__span-2-5><a id=__codelineno-2-5 name=__codelineno-2-5 href=#__codelineno-2-5></a><span class=w>    </span><span class=p>.</span><span class=n>Where</span><span class=p>(</span><span class=n>xs</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>xs</span><span class=p>.</span><span class=n>Count</span><span class=w> </span><span class=o>&gt;=</span><span class=w> </span><span class=mi>2</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 class=w>    </span><span class=p>.</span><span class=n>Subscribe</span><span class=p>(</span><span class=n>_</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>&quot;Double Click!&quot;</span><span class=p>));</span>
-</span><span id=__span-2-7><a id=__codelineno-2-7 name=__codelineno-2-7 href=#__codelineno-2-7></a>
-</span><span id=__span-2-8><a id=__codelineno-2-8 name=__codelineno-2-8 href=#__codelineno-2-8></a><span class=c1>// Combine multiple input streams</span>
-</span><span id=__span-2-9><a id=__codelineno-2-9 name=__codelineno-2-9 href=#__codelineno-2-9></a><span class=kt>var</span><span class=w> </span><span class=n>leftClick</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Observable</span><span class=p>.</span><span class=n>EveryUpdate</span><span class=p>().</span><span class=n>Where</span><span class=p>(</span><span class=n>_</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Input</span><span class=p>.</span><span class=n>GetMouseButtonDown</span><span class=p>(</span><span class=mi>0</span><span class=p>));</span>
-</span><span id=__span-2-10><a id=__codelineno-2-10 name=__codelineno-2-10 href=#__codelineno-2-10></a><span class=kt>var</span><span class=w> </span><span class=n>rightClick</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Observable</span><span class=p>.</span><span class=n>EveryUpdate</span><span class=p>().</span><span class=n>Where</span><span class=p>(</span><span class=n>_</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Input</span><span class=p>.</span><span class=n>GetMouseButtonDown</span><span class=p>(</span><span class=mi>1</span><span class=p>));</span>
-</span><span id=__span-2-11><a id=__codelineno-2-11 name=__codelineno-2-11 href=#__codelineno-2-11></a><span class=n>leftClick</span><span class=p>.</span><span class=n>Merge</span><span class=p>(</span><span class=n>rightClick</span><span class=p>).</span><span class=n>Subscribe</span><span class=p>(</span><span class=n>_</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>&quot;Any click!&quot;</span><span class=p>));</span>
-</span></code></pre></div> <h4 id=what-problems-it-solves>What Problems It Solves<a class=headerlink href=#what-problems-it-solves title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Complex event streams:</strong> Chain, filter, combine, and transform events with operators</li> <li>✅ <strong>Async operations:</strong> Better async/await alternative with cancellation</li> <li>✅ <strong>Temporal logic:</strong> Time-based operations (throttle, debounce, sample)</li> <li>✅ <strong>UI reactivity:</strong> Bind UI elements to data streams reactively</li> <li>✅ <strong>Memory management:</strong> Disposable subscriptions prevent leaks</li> </ul> <h4 id=what-problems-it-doesnt-solve-well>What Problems It Doesn't Solve Well<a class=headerlink href=#what-problems-it-doesnt-solve-well title="Anchor link to this section">&para;</a></h4> <ul> <li>⚠️ <strong>Simple pub/sub:</strong> MessageBroker handles this well, but reactive operators may add complexity for simple use cases</li> <li>❌ <strong>Execution order control:</strong> No built-in priority system for handler ordering</li> <li>❌ <strong>Message validation/interception:</strong> No pre-processing pipeline to validate or transform messages before handlers</li> <li>❌ <strong>Unity Inspector debugging:</strong> No Inspector integration to visualize message flow</li> <li>❌ <strong>GameObject/Component targeting:</strong> Not designed for Unity-specific targeting patterns</li> <li>❌ <strong>Global message observation:</strong> Cannot easily listen to all instances of a message type across different sources</li> </ul> <h4 id=performance-characteristics>Performance Characteristics<a class=headerlink href=#performance-characteristics title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Allocations:</strong> MessageBroker is zero-allocation for basic operations. Stream operators (Select, Where, Buffer) may allocate. For simple pub/sub, UniRx matches DxMessaging's allocation profile.</li> <li><strong>Overhead:</strong> Higher than simple events due to observable infrastructure</li> <li><strong>Use case:</strong> Best for complex event transformations; overhead justified by functionality</li> </ul> <h4 id=learning-curve>Learning Curve<a class=headerlink href=#learning-curve title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Simple MessageBroker (basic pub/sub):</strong> Very easy - just <code>Publish()</code> and <code>Receive()</code>, similar to events</li> <li><strong>Advanced stream operators:</strong> Steep - requires understanding reactive programming paradigm</li> <li><strong>Mental model shift:</strong> For complex features, must think in streams, not events</li> <li><strong>Documentation:</strong> Extensive examples, but reactive concepts take time to master</li> <li><strong>Estimated learning time:</strong> 15 minutes for MessageBroker; 1-2 weeks for reactive stream mastery</li> </ul> <h4 id=ease-of-understanding>Ease of Understanding<a class=headerlink href=#ease-of-understanding title="Anchor link to this section">&para;</a></h4> <ul> <li>⭐⭐⭐⭐⭐ (Very easy) - MessageBroker pub/sub is intuitive and straightforward</li> <li>⭐⭐⭐ (Moderate to difficult) - Advanced reactive operators require learning</li> <li>Stream operator code is concise but requires understanding of reactive patterns</li> <li>Hard to debug complex observable chains without Rx knowledge</li> <li>For advanced features: Team buy-in essential; not intuitive for traditional event-driven developers</li> </ul> <h4 id=when-unirx-wins>When UniRx Wins<a class=headerlink href=#when-unirx-wins title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Simple pub/sub with minimal setup (MessageBroker is straightforward)</li> <li>✅ Complex event transformations (e.g., double-click, gesture detection)</li> <li>✅ Combining multiple input sources</li> <li>✅ Time-based logic (debounce, throttle, sample)</li> <li>✅ UI data binding with reactive updates</li> <li>✅ Teams familiar with reactive programming</li> </ul> <h4 id=when-dxmessaging-wins>When DxMessaging Wins<a class=headerlink href=#when-dxmessaging-wins title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Need Unity-specific features (GameObject targeting, lifecycle management)</li> <li>✅ Execution order matters (priority-based ordering)</li> <li>✅ Message validation/interception needed (interceptor pipeline)</li> <li>✅ Inspector debugging required (message history, registration view)</li> <li>✅ Direct GameObject/Component targeting</li> <li>✅ Global message observation (listen to all instances of a message type)</li> <li>✅ Late-stage processing (post-processors after all handlers)</li> <li>✅ Automatic lifecycle management (prevents common memory leaks)</li> <li>✅ Teams unfamiliar with reactive programming (and don't need reactive features)</li> </ul> <h4 id=direct-comparison>Direct Comparison<a class=headerlink href=#direct-comparison title="Anchor link to this section">&para;</a></h4> <table> <thead> <tr> <th>Aspect</th> <th>UniRx</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Primary Use Case</strong></td> <td>Stream transformations</td> <td>Pub/sub messaging</td> </tr> <tr> <td><strong>Unity Compatibility</strong></td> <td>✅ Built for Unity</td> <td>✅ Built for Unity</td> </tr> <tr> <td><strong>Dependencies</strong></td> <td>✅ Standalone</td> <td>✅ Standalone</td> </tr> <tr> <td><strong>Performance</strong></td> <td>18M ops/sec</td> <td>14M ops/sec</td> </tr> <tr> <td><strong>Allocations</strong></td> <td>⚠️ Can allocate</td> <td>✅ Zero (structs)</td> </tr> <tr> <td><strong>Learning Curve</strong></td> <td>⭐ Steep (Rx paradigm)</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>Setup Complexity</strong></td> <td>⭐⭐⭐⭐⭐ Low</td> <td>⭐⭐⭐⭐⭐ Plug-and-play</td> </tr> <tr> <td><strong>DI Integration</strong></td> <td>⚠️ Optional</td> <td>⚠️ Optional</td> </tr> <tr> <td><strong>Async/Await</strong></td> <td>✅ Observables</td> <td>⚠️ Manual</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>✅ Strong</td> <td>✅ Strong</td> </tr> <tr> <td><strong>Lifecycle Management</strong></td> <td>⚠️ Manual dispose</td> <td>✅ Automatic</td> </tr> <tr> <td><strong>Execution Order</strong></td> <td>❌ Not built-in</td> <td>✅ Priority-based</td> </tr> <tr> <td><strong>GameObject Targeting</strong></td> <td>❌ Not designed for</td> <td>✅ Built-in</td> </tr> <tr> <td><strong>Unity Integration</strong></td> <td>⭐⭐⭐⭐ Good (UI)</td> <td>⭐⭐⭐⭐⭐ Deep</td> </tr> <tr> <td><strong>Inspector Debugging</strong></td> <td>❌ No</td> <td>✅ History + stats</td> </tr> <tr> <td><strong>Interceptors</strong></td> <td>❌ Not built-in</td> <td>✅ Full pipeline</td> </tr> <tr> <td><strong>Global Observers</strong></td> <td>❌ Not built-in</td> <td>✅ Listen to all</td> </tr> <tr> <td><strong>Post-Processing</strong></td> <td>❌ Not built-in</td> <td>✅ Dedicated stage</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⭐⭐⭐⭐ Good</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> <tr> <td><strong>Decoupling</strong></td> <td>⭐⭐⭐⭐⭐ Excellent</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> <tr> <td><strong>Temporal Operators</strong></td> <td>✅ Extensive (Rx)</td> <td>❌ Not built-in</td> </tr> <tr> <td><strong>Complex Stream Logic</strong></td> <td>✅ LINQ-style</td> <td>❌ Not designed for</td> </tr> </tbody> </table> <p><strong>Bottom Line:</strong> UniRx is well-suited for complex event stream transformations and reactive programming patterns, with MessageBroker providing straightforward pub/sub setup. DxMessaging focuses on straightforward pub/sub communication with control, validation, debugging, and Unity-specific features. Both are viable options depending on your needs: choose UniRx when you need stream operators, reactive patterns, or simple zero-setup pub/sub; choose DxMessaging when you need Unity-native lifecycle integration, execution control, and debugging tools.</p> <hr> <h3 id=messagepipe-high-performance-messaging>MessagePipe (High-Performance Messaging)<a class=headerlink href=#messagepipe-high-performance-messaging title="Anchor link to this section">&para;</a></h3> <p><strong>What It Is:</strong> A high-performance, DI-first messaging library by Cysharp (creators of UniTask). Designed for in-memory and distributed messaging with zero-allocation focus.</p> <p><strong>Core Philosophy:</strong> Maximum performance with dependency injection integration. Support all messaging patterns with a unified, generic interface.</p> <h4 id=key-features_1>Key Features<a class=headerlink href=#key-features_1 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Multiple patterns:</strong> Pub/Sub, Request/Response, Mediator patterns</li> <li><strong>Sync and async:</strong> Full async/await support with configurable strategies (sequential/parallel)</li> <li><strong>Keyed messaging:</strong> Type-based or key-based message routing</li> <li><strong>DI-first design:</strong> Deep integration with dependency injection containers</li> <li><strong>Filters:</strong> Pre/post execution customization (similar to interceptors)</li> <li><strong>Zero allocation:</strong> Struct messages with zero GC per publish</li> <li><strong>Roslyn analyzer:</strong> Detects subscription leaks at compile-time</li> <li><strong>Global and scoped:</strong> Support for global message bus or scoped instances</li> </ul> <h4 id=code-example_1>Code Example<a class=headerlink href=#code-example_1 title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-3-1><a id=__codelineno-3-1 name=__codelineno-3-1 href=#__codelineno-3-1></a><span class=c1>// Using MessagePipe with DI</span>
-</span><span id=__span-3-2><a id=__codelineno-3-2 name=__codelineno-3-2 href=#__codelineno-3-2></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>GameManager</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-3-3><a id=__codelineno-3-3 name=__codelineno-3-3 href=#__codelineno-3-3></a><span class=p>{</span>
-</span><span id=__span-3-4><a id=__codelineno-3-4 name=__codelineno-3-4 href=#__codelineno-3-4></a><span class=w>    </span><span class=k>private</span><span class=w> </span><span class=n>IPublisher</span><span class=o>&lt;</span><span class=n>EnemySpawned</span><span class=o>&gt;</span><span class=w> </span><span class=n>_publisher</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 class=w>    </span><span class=k>private</span><span class=w> </span><span class=n>IDisposable</span><span class=w> </span><span class=n>_subscription</span><span class=p>;</span>
-</span><span id=__span-3-6><a id=__codelineno-3-6 name=__codelineno-3-6 href=#__codelineno-3-6></a>
-</span><span id=__span-3-7><a id=__codelineno-3-7 name=__codelineno-3-7 href=#__codelineno-3-7></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>Start</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 class=w>    </span><span class=p>{</span>
-</span><span id=__span-3-9><a id=__codelineno-3-9 name=__codelineno-3-9 href=#__codelineno-3-9></a><span class=w>        </span><span class=c1>// Injected via DI container</span>
-</span><span id=__span-3-10><a id=__codelineno-3-10 name=__codelineno-3-10 href=#__codelineno-3-10></a><span class=w>        </span><span class=n>_publisher</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>GlobalMessagePipe</span><span class=p>.</span><span class=n>GetPublisher</span><span class=o>&lt;</span><span class=n>EnemySpawned</span><span class=o>&gt;</span><span class=p>();</span>
-</span><span id=__span-3-11><a id=__codelineno-3-11 name=__codelineno-3-11 href=#__codelineno-3-11></a><span class=w>        </span><span class=kt>var</span><span class=w> </span><span class=n>subscriber</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>GlobalMessagePipe</span><span class=p>.</span><span class=n>GetSubscriber</span><span class=o>&lt;</span><span class=n>EnemySpawned</span><span class=o>&gt;</span><span class=p>();</span>
-</span><span id=__span-3-12><a id=__codelineno-3-12 name=__codelineno-3-12 href=#__codelineno-3-12></a>
-</span><span id=__span-3-13><a id=__codelineno-3-13 name=__codelineno-3-13 href=#__codelineno-3-13></a><span class=w>        </span><span class=n>_subscription</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>subscriber</span><span class=p>.</span><span class=n>Subscribe</span><span class=p>(</span><span class=n>msg</span><span class=w> </span><span class=o>=&gt;</span>
-</span><span id=__span-3-14><a id=__codelineno-3-14 name=__codelineno-3-14 href=#__codelineno-3-14></a><span class=w>        </span><span class=p>{</span>
-</span><span id=__span-3-15><a id=__codelineno-3-15 name=__codelineno-3-15 href=#__codelineno-3-15></a><span class=w>            </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;Enemy spawned: {msg.EnemyId}&quot;</span><span class=p>);</span>
-</span><span id=__span-3-16><a id=__codelineno-3-16 name=__codelineno-3-16 href=#__codelineno-3-16></a><span class=w>        </span><span class=p>});</span>
-</span><span id=__span-3-17><a id=__codelineno-3-17 name=__codelineno-3-17 href=#__codelineno-3-17></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-3-18><a id=__codelineno-3-18 name=__codelineno-3-18 href=#__codelineno-3-18></a>
-</span><span id=__span-3-19><a id=__codelineno-3-19 name=__codelineno-3-19 href=#__codelineno-3-19></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>SpawnEnemy</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>id</span><span class=p>)</span>
-</span><span id=__span-3-20><a id=__codelineno-3-20 name=__codelineno-3-20 href=#__codelineno-3-20></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-3-21><a id=__codelineno-3-21 name=__codelineno-3-21 href=#__codelineno-3-21></a><span class=w>        </span><span class=n>_publisher</span><span class=p>.</span><span class=n>Publish</span><span class=p>(</span><span class=k>new</span><span class=w> </span><span class=n>EnemySpawned</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=n>EnemyId</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>id</span><span class=w> </span><span class=p>});</span>
-</span><span id=__span-3-22><a id=__codelineno-3-22 name=__codelineno-3-22 href=#__codelineno-3-22></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-3-23><a id=__codelineno-3-23 name=__codelineno-3-23 href=#__codelineno-3-23></a>
-</span><span id=__span-3-24><a id=__codelineno-3-24 name=__codelineno-3-24 href=#__codelineno-3-24></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnDestroy</span><span class=p>()</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>_subscription</span><span class=o>?.</span><span class=n>Dispose</span><span class=p>();</span>
-</span><span id=__span-3-25><a id=__codelineno-3-25 name=__codelineno-3-25 href=#__codelineno-3-25></a><span class=p>}</span>
-</span><span id=__span-3-26><a id=__codelineno-3-26 name=__codelineno-3-26 href=#__codelineno-3-26></a>
-</span><span id=__span-3-27><a id=__codelineno-3-27 name=__codelineno-3-27 href=#__codelineno-3-27></a><span class=c1>// Async handler with filters</span>
-</span><span id=__span-3-28><a id=__codelineno-3-28 name=__codelineno-3-28 href=#__codelineno-3-28></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>AchievementSystem</span>
-</span><span id=__span-3-29><a id=__codelineno-3-29 name=__codelineno-3-29 href=#__codelineno-3-29></a><span class=p>{</span>
-</span><span id=__span-3-30><a id=__codelineno-3-30 name=__codelineno-3-30 href=#__codelineno-3-30></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=nf>AchievementSystem</span><span class=p>(</span><span class=n>IAsyncSubscriber</span><span class=o>&lt;</span><span class=n>EnemyKilled</span><span class=o>&gt;</span><span class=w> </span><span class=n>subscriber</span><span class=p>)</span>
-</span><span id=__span-3-31><a id=__codelineno-3-31 name=__codelineno-3-31 href=#__codelineno-3-31></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-3-32><a id=__codelineno-3-32 name=__codelineno-3-32 href=#__codelineno-3-32></a><span class=w>        </span><span class=n>subscriber</span><span class=p>.</span><span class=n>Subscribe</span><span class=p>(</span><span class=k>async</span><span class=w> </span><span class=p>(</span><span class=n>msg</span><span class=p>,</span><span class=w> </span><span class=n>cancellationToken</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span>
-</span><span id=__span-3-33><a id=__codelineno-3-33 name=__codelineno-3-33 href=#__codelineno-3-33></a><span class=w>        </span><span class=p>{</span>
-</span><span id=__span-3-34><a id=__codelineno-3-34 name=__codelineno-3-34 href=#__codelineno-3-34></a><span class=w>            </span><span class=k>await</span><span class=w> </span><span class=nf>SaveAchievementAsync</span><span class=p>(</span><span class=n>msg</span><span class=p>.</span><span class=n>EnemyType</span><span class=p>);</span>
-</span><span id=__span-3-35><a id=__codelineno-3-35 name=__codelineno-3-35 href=#__codelineno-3-35></a><span class=w>        </span><span class=p>});</span>
-</span><span id=__span-3-36><a id=__codelineno-3-36 name=__codelineno-3-36 href=#__codelineno-3-36></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-3-37><a id=__codelineno-3-37 name=__codelineno-3-37 href=#__codelineno-3-37></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=what-problems-it-solves_1>What Problems It Solves<a class=headerlink href=#what-problems-it-solves_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Performance:</strong> Zero allocations with struct-based messages (see <a href=https://github.com/wallstop/DxMessaging/tree/master/Tests/Runtime/Benchmarks>benchmarks</a> for comparison data)</li> <li>✅ <strong>DI integration:</strong> First-class support for dependency injection</li> <li>✅ <strong>Async messaging:</strong> Native async/await without blocking</li> <li>✅ <strong>Leak detection:</strong> Analyzer catches forgotten subscriptions at compile-time</li> <li>✅ <strong>Flexibility:</strong> Keyed, keyless, buffered, request/response patterns</li> <li>✅ <strong>Cross-platform:</strong> Works in Unity, .NET, Blazor, etc.</li> </ul> <h4 id=what-problems-it-doesnt-solve-well_1>What Problems It Doesn't Solve Well<a class=headerlink href=#what-problems-it-doesnt-solve-well_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ <strong>Unity-specific integration:</strong> No built-in Unity MonoBehaviour lifecycle management or GameObject targeting</li> <li>❌ <strong>Inspector debugging:</strong> No visual debugging or message history in Unity Inspector</li> <li>❌ <strong>Execution order control:</strong> No priority system (handlers execute in subscription order)</li> <li>❌ <strong>Setup complexity:</strong> Requires DI container configuration (VContainer/Zenject setup needed)</li> <li>❌ <strong>Global message observation:</strong> No built-in way to listen to all instances of a message across different keys/sources</li> <li>❌ <strong>Standalone use:</strong> Designed for DI-first architecture (less suitable for non-DI projects)</li> </ul> <h4 id=performance-characteristics_1>Performance Characteristics<a class=headerlink href=#performance-characteristics_1 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>High throughput:</strong> MessagePipe is optimized for high-frequency messaging scenarios</li> <li><strong>Zero allocation:</strong> Struct-based messages with no GC per publish</li> <li><strong>Benchmark data:</strong> See performance section above for actual numbers</li> <li><strong>Use case:</strong> Optimized for high-frequency messaging (thousands/frame)</li> </ul> <h4 id=learning-curve_1>Learning Curve<a class=headerlink href=#learning-curve_1 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Moderate:</strong> Requires understanding of dependency injection</li> <li><strong>DI knowledge:</strong> Must be comfortable with service provider pattern</li> <li><strong>Generic interfaces:</strong> Multiple generic types can be confusing initially</li> <li><strong>Estimated learning time:</strong> 2-3 days with DI experience; 1 week without</li> </ul> <h4 id=ease-of-understanding_1>Ease of Understanding<a class=headerlink href=#ease-of-understanding_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>⭐⭐⭐⭐ (Moderate)</li> <li>Clean, generic interfaces once you understand DI</li> <li>Code is straightforward for developers familiar with DI patterns</li> <li>Harder for teams without DI experience</li> </ul> <h4 id=when-messagepipe-wins>When MessagePipe Wins<a class=headerlink href=#when-messagepipe-wins title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Performance-critical applications (high message throughput)</li> <li>✅ Projects already using DI (VContainer, Zenject, etc.)</li> <li>✅ Cross-platform .NET projects (not Unity-only)</li> <li>✅ Need async messaging with cancellation</li> <li>✅ Large-scale projects with DI architecture</li> <li>✅ Teams experienced with DI patterns</li> </ul> <h4 id=when-dxmessaging-wins_1>When DxMessaging Wins<a class=headerlink href=#when-dxmessaging-wins_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Unity-first projects (not cross-platform .NET)</li> <li>✅ Unity lifecycle management needed (automatic MonoBehaviour cleanup)</li> <li>✅ Inspector debugging essential (message history visualization)</li> <li>✅ Execution order control needed (priority-based handlers)</li> <li>✅ Message validation/interception required (interceptor pipeline)</li> <li>✅ Global message observation needed (listen to all message instances)</li> <li>✅ Post-processing stage needed (analytics, logging after handlers)</li> <li>✅ Teams without DI experience or projects not using DI</li> <li>✅ Plug-and-play simplicity preferred over DI configuration</li> </ul> <h4 id=direct-comparison_1>Direct Comparison<a class=headerlink href=#direct-comparison_1 title="Anchor link to this section">&para;</a></h4> <table> <thead> <tr> <th>Aspect</th> <th>MessagePipe</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Primary Use Case</strong></td> <td>High-perf DI messaging</td> <td>Pub/sub messaging</td> </tr> <tr> <td><strong>Unity Compatibility</strong></td> <td>✅ Built for Unity</td> <td>✅ Built for Unity</td> </tr> <tr> <td><strong>Dependencies</strong></td> <td>⚠️ DI container required</td> <td>✅ Standalone</td> </tr> <tr> <td><strong>Performance</strong></td> <td>97M ops/sec</td> <td>14M ops/sec</td> </tr> <tr> <td><strong>Allocations</strong></td> <td>✅ Zero (structs)</td> <td>✅ Zero (structs)</td> </tr> <tr> <td><strong>Learning Curve</strong></td> <td>⭐⭐⭐⭐ Moderate (DI)</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>Setup Complexity</strong></td> <td>⭐⭐⭐ DI setup required</td> <td>⭐⭐⭐⭐⭐ Plug-and-play</td> </tr> <tr> <td><strong>DI Integration</strong></td> <td>✅ First-class</td> <td>⚠️ Optional</td> </tr> <tr> <td><strong>Async/Await</strong></td> <td>✅ Native</td> <td>⚠️ Manual</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>✅ Strong</td> <td>✅ Strong</td> </tr> <tr> <td><strong>Lifecycle Management</strong></td> <td>⚠️ Manual dispose</td> <td>✅ Automatic</td> </tr> <tr> <td><strong>Execution Order</strong></td> <td>❌ Subscription order</td> <td>✅ Priority-based</td> </tr> <tr> <td><strong>GameObject Targeting</strong></td> <td>❌ Not built-in</td> <td>✅ Built-in</td> </tr> <tr> <td><strong>Unity Integration</strong></td> <td>⭐⭐⭐ Basic (no lifecycle)</td> <td>⭐⭐⭐⭐⭐ Deep</td> </tr> <tr> <td><strong>Inspector Debugging</strong></td> <td>❌ No</td> <td>✅ History + stats</td> </tr> <tr> <td><strong>Interceptors</strong></td> <td>⚠️ Filters</td> <td>✅ Full pipeline</td> </tr> <tr> <td><strong>Global Observers</strong></td> <td>❌ Not built-in</td> <td>✅ Listen to all</td> </tr> <tr> <td><strong>Post-Processing</strong></td> <td>⚠️ Via filters</td> <td>✅ Dedicated stage</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⭐⭐⭐⭐⭐ DI mocking</td> <td>⭐⭐⭐⭐⭐ Local buses</td> </tr> <tr> <td><strong>Decoupling</strong></td> <td>⭐⭐⭐⭐⭐ Excellent</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> <tr> <td><strong>Leak Detection</strong></td> <td>✅ Roslyn analyzer</td> <td>✅ Automatic lifecycle</td> </tr> </tbody> </table> <p><strong>Bottom Line:</strong> MessagePipe is the performance king with DI-first design. DxMessaging is Unity-first with lifecycle awareness and debugging. Use MessagePipe if you have DI infrastructure and need maximum performance. Use DxMessaging if you want Unity-native messaging with automatic lifecycle management.</p> <p><strong>Note on Performance:</strong> MessagePipe's ~95M ops/sec vs DxMessaging's ~20M ops/sec shows a significant throughput advantage. This matters primarily for high-frequency messaging scenarios (thousands of messages per frame). For typical gameplay events, both are fast enough that performance is not a distinguishing factor.</p> <blockquote> <p><strong>💡 Want both?</strong> DxMessaging integrates with DI frameworks! See <a href=../../integrations/ >DI Integration Guides</a> for Zenject, VContainer, and Reflex. Use DI for service construction, DxMessaging for event communication.</p> </blockquote> <hr> <h3 id=zenject-signals-di-based-messaging>Zenject Signals (DI-Based Messaging)<a class=headerlink href=#zenject-signals-di-based-messaging title="Anchor link to this section">&para;</a></h3> <p><strong>What It Is:</strong> The built-in messaging system for Zenject (Extenject), a dependency injection framework for Unity. Signals are an optional extension that provides decoupled communication.</p> <p><strong>Core Philosophy:</strong> Loosely coupled messaging integrated with dependency injection. Reduce direct dependencies between classes while maintaining testability.</p> <h4 id=key-features_2>Key Features<a class=headerlink href=#key-features_2 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>DI-integrated:</strong> Signals declared and resolved via Zenject container</li> <li><strong>Typed signals:</strong> Strongly-typed signal classes with parameters</li> <li><strong>Synchronous and async:</strong> Sync (RunSync) and async (RunAsync) execution modes</li> <li><strong>Subscription modes:</strong> Require, optional, or optional-with-warning subscribers</li> <li><strong>Installer-based setup:</strong> Declare signals in installers for container binding</li> <li><strong>Multiple subscription methods:</strong> Direct binding, SignalBus subscription, stream-based (with UniRx)</li> <li><strong>Testable:</strong> Easy to mock and test with dependency injection</li> </ul> <h4 id=code-example_2>Code Example<a class=headerlink href=#code-example_2 title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-4-1><a id=__codelineno-4-1 name=__codelineno-4-1 href=#__codelineno-4-1></a><span class=c1>// 1. Define signal</span>
-</span><span id=__span-4-2><a id=__codelineno-4-2 name=__codelineno-4-2 href=#__codelineno-4-2></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>EnemyKilledSignal</span>
-</span><span id=__span-4-3><a id=__codelineno-4-3 name=__codelineno-4-3 href=#__codelineno-4-3></a><span class=p>{</span>
-</span><span id=__span-4-4><a id=__codelineno-4-4 name=__codelineno-4-4 href=#__codelineno-4-4></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>EnemyType</span><span class=p>;</span>
-</span><span id=__span-4-5><a id=__codelineno-4-5 name=__codelineno-4-5 href=#__codelineno-4-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>Score</span><span class=p>;</span>
-</span><span id=__span-4-6><a id=__codelineno-4-6 name=__codelineno-4-6 href=#__codelineno-4-6></a><span class=p>}</span>
-</span><span id=__span-4-7><a id=__codelineno-4-7 name=__codelineno-4-7 href=#__codelineno-4-7></a>
-</span><span id=__span-4-8><a id=__codelineno-4-8 name=__codelineno-4-8 href=#__codelineno-4-8></a><span class=c1>// 2. Install and declare in installer</span>
-</span><span id=__span-4-9><a id=__codelineno-4-9 name=__codelineno-4-9 href=#__codelineno-4-9></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>GameInstaller</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoInstaller</span>
-</span><span id=__span-4-10><a id=__codelineno-4-10 name=__codelineno-4-10 href=#__codelineno-4-10></a><span class=p>{</span>
-</span><span id=__span-4-11><a id=__codelineno-4-11 name=__codelineno-4-11 href=#__codelineno-4-11></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>override</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>InstallBindings</span><span class=p>()</span>
-</span><span id=__span-4-12><a id=__codelineno-4-12 name=__codelineno-4-12 href=#__codelineno-4-12></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-4-13><a id=__codelineno-4-13 name=__codelineno-4-13 href=#__codelineno-4-13></a><span class=w>        </span><span class=n>SignalBusInstaller</span><span class=p>.</span><span class=n>Install</span><span class=p>(</span><span class=n>Container</span><span class=p>);</span>
-</span><span id=__span-4-14><a id=__codelineno-4-14 name=__codelineno-4-14 href=#__codelineno-4-14></a><span class=w>        </span><span class=n>Container</span><span class=p>.</span><span class=n>DeclareSignal</span><span class=o>&lt;</span><span class=n>EnemyKilledSignal</span><span class=o>&gt;</span><span class=p>();</span>
-</span><span id=__span-4-15><a id=__codelineno-4-15 name=__codelineno-4-15 href=#__codelineno-4-15></a><span class=w>        </span><span class=n>Container</span><span class=p>.</span><span class=n>BindSignal</span><span class=o>&lt;</span><span class=n>EnemyKilledSignal</span><span class=o>&gt;</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 class=w>            </span><span class=p>.</span><span class=n>ToMethod</span><span class=o>&lt;</span><span class=n>AchievementSystem</span><span class=o>&gt;</span><span class=p>(</span><span class=n>x</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>x</span><span class=p>.</span><span class=n>OnEnemyKilled</span><span class=p>)</span>
-</span><span id=__span-4-17><a id=__codelineno-4-17 name=__codelineno-4-17 href=#__codelineno-4-17></a><span class=w>            </span><span class=p>.</span><span class=n>FromResolve</span><span class=p>();</span>
-</span><span id=__span-4-18><a id=__codelineno-4-18 name=__codelineno-4-18 href=#__codelineno-4-18></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-4-19><a id=__codelineno-4-19 name=__codelineno-4-19 href=#__codelineno-4-19></a><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><span id=__span-4-21><a id=__codelineno-4-21 name=__codelineno-4-21 href=#__codelineno-4-21></a><span class=c1>// 3. Fire signal</span>
-</span><span id=__span-4-22><a id=__codelineno-4-22 name=__codelineno-4-22 href=#__codelineno-4-22></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>Enemy</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-4-23><a id=__codelineno-4-23 name=__codelineno-4-23 href=#__codelineno-4-23></a><span class=p>{</span>
-</span><span id=__span-4-24><a id=__codelineno-4-24 name=__codelineno-4-24 href=#__codelineno-4-24></a><span class=w>    </span><span class=na>[Inject]</span><span class=w> </span><span class=k>private</span><span class=w> </span><span class=n>SignalBus</span><span class=w> </span><span class=n>_signalBus</span><span class=p>;</span>
-</span><span id=__span-4-25><a id=__codelineno-4-25 name=__codelineno-4-25 href=#__codelineno-4-25></a>
-</span><span id=__span-4-26><a id=__codelineno-4-26 name=__codelineno-4-26 href=#__codelineno-4-26></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>Die</span><span class=p>()</span>
-</span><span id=__span-4-27><a id=__codelineno-4-27 name=__codelineno-4-27 href=#__codelineno-4-27></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-4-28><a id=__codelineno-4-28 name=__codelineno-4-28 href=#__codelineno-4-28></a><span class=w>        </span><span class=n>_signalBus</span><span class=p>.</span><span class=n>Fire</span><span class=p>(</span><span class=k>new</span><span class=w> </span><span class=n>EnemyKilledSignal</span>
-</span><span id=__span-4-29><a id=__codelineno-4-29 name=__codelineno-4-29 href=#__codelineno-4-29></a><span class=w>        </span><span class=p>{</span>
-</span><span id=__span-4-30><a id=__codelineno-4-30 name=__codelineno-4-30 href=#__codelineno-4-30></a><span class=w>            </span><span class=n>EnemyType</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=s>&quot;Orc&quot;</span><span class=p>,</span>
-</span><span id=__span-4-31><a id=__codelineno-4-31 name=__codelineno-4-31 href=#__codelineno-4-31></a><span class=w>            </span><span class=n>Score</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>100</span>
-</span><span id=__span-4-32><a id=__codelineno-4-32 name=__codelineno-4-32 href=#__codelineno-4-32></a><span class=w>        </span><span class=p>});</span>
-</span><span id=__span-4-33><a id=__codelineno-4-33 name=__codelineno-4-33 href=#__codelineno-4-33></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-4-34><a id=__codelineno-4-34 name=__codelineno-4-34 href=#__codelineno-4-34></a><span class=p>}</span>
-</span><span id=__span-4-35><a id=__codelineno-4-35 name=__codelineno-4-35 href=#__codelineno-4-35></a>
-</span><span id=__span-4-36><a id=__codelineno-4-36 name=__codelineno-4-36 href=#__codelineno-4-36></a><span class=c1>// 4. Subscribe to signal</span>
-</span><span id=__span-4-37><a id=__codelineno-4-37 name=__codelineno-4-37 href=#__codelineno-4-37></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>AchievementSystem</span>
-</span><span id=__span-4-38><a id=__codelineno-4-38 name=__codelineno-4-38 href=#__codelineno-4-38></a><span class=p>{</span>
-</span><span id=__span-4-39><a id=__codelineno-4-39 name=__codelineno-4-39 href=#__codelineno-4-39></a><span class=w>    </span><span class=na>[Inject]</span><span class=w> </span><span class=k>private</span><span class=w> </span><span class=n>SignalBus</span><span class=w> </span><span class=n>_signalBus</span><span class=p>;</span>
-</span><span id=__span-4-40><a id=__codelineno-4-40 name=__codelineno-4-40 href=#__codelineno-4-40></a>
-</span><span id=__span-4-41><a id=__codelineno-4-41 name=__codelineno-4-41 href=#__codelineno-4-41></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><span id=__span-4-42><a id=__codelineno-4-42 name=__codelineno-4-42 href=#__codelineno-4-42></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-4-43><a id=__codelineno-4-43 name=__codelineno-4-43 href=#__codelineno-4-43></a><span class=w>        </span><span class=n>_signalBus</span><span class=p>.</span><span class=n>Subscribe</span><span class=o>&lt;</span><span class=n>EnemyKilledSignal</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnEnemyKilled</span><span class=p>);</span>
-</span><span id=__span-4-44><a id=__codelineno-4-44 name=__codelineno-4-44 href=#__codelineno-4-44></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-4-45><a id=__codelineno-4-45 name=__codelineno-4-45 href=#__codelineno-4-45></a>
-</span><span id=__span-4-46><a id=__codelineno-4-46 name=__codelineno-4-46 href=#__codelineno-4-46></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnEnemyKilled</span><span class=p>(</span><span class=n>EnemyKilledSignal</span><span class=w> </span><span class=n>signal</span><span class=p>)</span>
-</span><span id=__span-4-47><a id=__codelineno-4-47 name=__codelineno-4-47 href=#__codelineno-4-47></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-4-48><a id=__codelineno-4-48 name=__codelineno-4-48 href=#__codelineno-4-48></a><span class=w>        </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;Killed {signal.EnemyType} for {signal.Score} points!&quot;</span><span class=p>);</span>
-</span><span id=__span-4-49><a id=__codelineno-4-49 name=__codelineno-4-49 href=#__codelineno-4-49></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-4-50><a id=__codelineno-4-50 name=__codelineno-4-50 href=#__codelineno-4-50></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=what-problems-it-solves_2>What Problems It Solves<a class=headerlink href=#what-problems-it-solves_2 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Decoupling:</strong> Classes communicate without direct references</li> <li>✅ <strong>DI integration:</strong> Seamless with Zenject dependency injection</li> <li>✅ <strong>Testability:</strong> Easy to mock SignalBus in tests</li> <li>✅ <strong>Type safety:</strong> Strongly-typed signal classes</li> <li>✅ <strong>Subscriber validation:</strong> Can enforce required subscribers</li> <li>✅ <strong>Async support:</strong> Fire signals synchronously or asynchronously</li> </ul> <h4 id=what-problems-it-doesnt-solve-well_2>What Problems It Doesn't Solve Well<a class=headerlink href=#what-problems-it-doesnt-solve-well_2 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ <strong>Zenject dependency:</strong> Must use Zenject/Extenject framework; not standalone</li> <li>❌ <strong>Performance overhead:</strong> Higher than lightweight messaging (DI resolution cost)</li> <li>❌ <strong>Execution order control:</strong> No priority system for handler ordering</li> <li>❌ <strong>Inspector debugging:</strong> No visual message history or flow visualization</li> <li>❌ <strong>Allocations:</strong> Signal parameters can cause allocations depending on usage</li> <li>❌ <strong>Validation pipeline:</strong> No built-in interceptor or pre-processing stage</li> <li>❌ <strong>Global observation:</strong> Cannot easily listen to all signal fires across the system</li> <li>❌ <strong>Post-processing:</strong> No dedicated after-handler stage for analytics/logging</li> </ul> <h4 id=performance-characteristics_2>Performance Characteristics<a class=headerlink href=#performance-characteristics_2 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Overhead:</strong> Higher than lightweight messaging (DI resolution + boxing)</li> <li><strong>Allocations:</strong> Signal parameters can cause allocations (depends on implementation)</li> <li><strong>Benchmark data:</strong> See performance section above for actual numbers</li> <li><strong>Use case:</strong> Performance trade-off for testability and DI benefits</li> </ul> <h4 id=learning-curve_2>Learning Curve<a class=headerlink href=#learning-curve_2 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Moderate to steep:</strong> Requires understanding Zenject dependency injection</li> <li><strong>Zenject knowledge:</strong> Must learn Zenject before signals</li> <li><strong>Setup overhead:</strong> Installers, bindings, container configuration</li> <li><strong>Estimated learning time:</strong> 1 week for Zenject + signals together</li> </ul> <h4 id=ease-of-understanding_2>Ease of Understanding<a class=headerlink href=#ease-of-understanding_2 title="Anchor link to this section">&para;</a></h4> <ul> <li>⭐⭐⭐ (Moderate)</li> <li>Clear once you understand Zenject</li> <li>Signal concept is straightforward</li> <li>Setup (installers, bindings) adds complexity</li> </ul> <h4 id=when-zenject-signals-win>When Zenject Signals Win<a class=headerlink href=#when-zenject-signals-win title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Already using Zenject for dependency injection</li> <li>✅ Testability is critical (DI makes mocking easy)</li> <li>✅ Need subscriber validation (ensure handlers exist)</li> <li>✅ Team experienced with Zenject</li> <li>✅ Want DI-managed lifecycle</li> </ul> <h4 id=when-dxmessaging-wins_2>When DxMessaging Wins<a class=headerlink href=#when-dxmessaging-wins_2 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Not using Zenject/Extenject (or prefer standalone solution)</li> <li>✅ Performance critical (lower overhead than DI-based signals)</li> <li>✅ Execution order control needed (priority-based handlers)</li> <li>✅ Inspector debugging required (message history visualization)</li> <li>✅ Message validation/interception needed (interceptor pipeline)</li> <li>✅ Global message observation needed (listen to all signal fires)</li> <li>✅ Post-processing stage needed (analytics after handlers)</li> <li>✅ Zero-allocation messaging essential (struct-based)</li> <li>✅ GameObject/Component targeting needed (Unity-specific patterns)</li> <li>✅ Plug-and-play simplicity preferred over DI setup</li> </ul> <h4 id=direct-comparison_2>Direct Comparison<a class=headerlink href=#direct-comparison_2 title="Anchor link to this section">&para;</a></h4> <table> <thead> <tr> <th>Aspect</th> <th>Zenject Signals</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Primary Use Case</strong></td> <td>DI-integrated messaging</td> <td>Pub/sub messaging</td> </tr> <tr> <td><strong>Unity Compatibility</strong></td> <td>✅ Built for Unity</td> <td>✅ Built for Unity</td> </tr> <tr> <td><strong>Dependencies</strong></td> <td>❌ Zenject required</td> <td>✅ Standalone</td> </tr> <tr> <td><strong>Performance</strong></td> <td>2.5M ops/sec</td> <td>14M ops/sec</td> </tr> <tr> <td><strong>Allocations</strong></td> <td>⚠️ Can allocate</td> <td>✅ Zero (structs)</td> </tr> <tr> <td><strong>Learning Curve</strong></td> <td>⭐⭐ Steep (Zenject+Signals)</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>Setup Complexity</strong></td> <td>⭐⭐ Installers required</td> <td>⭐⭐⭐⭐⭐ Plug-and-play</td> </tr> <tr> <td><strong>DI Integration</strong></td> <td>✅ Required (Zenject)</td> <td>⚠️ Optional</td> </tr> <tr> <td><strong>Async/Await</strong></td> <td>✅ RunAsync support</td> <td>⚠️ Manual</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>✅ Strong</td> <td>✅ Strong</td> </tr> <tr> <td><strong>Lifecycle Management</strong></td> <td>⚠️ DI-managed</td> <td>✅ Automatic</td> </tr> <tr> <td><strong>Execution Order</strong></td> <td>❌ Not built-in</td> <td>✅ Priority-based</td> </tr> <tr> <td><strong>GameObject Targeting</strong></td> <td>❌ Not built-in</td> <td>✅ Built-in</td> </tr> <tr> <td><strong>Unity Integration</strong></td> <td>⭐⭐⭐⭐ DI-managed</td> <td>⭐⭐⭐⭐⭐ Deep</td> </tr> <tr> <td><strong>Inspector Debugging</strong></td> <td>❌ No</td> <td>✅ History + stats</td> </tr> <tr> <td><strong>Interceptors</strong></td> <td>⚠️ Subscriber validation</td> <td>✅ Full pipeline</td> </tr> <tr> <td><strong>Global Observers</strong></td> <td>❌ Not built-in</td> <td>✅ Listen to all</td> </tr> <tr> <td><strong>Post-Processing</strong></td> <td>❌ Not built-in</td> <td>✅ Dedicated stage</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⭐⭐⭐⭐⭐ DI mocking</td> <td>⭐⭐⭐⭐⭐ Local buses</td> </tr> <tr> <td><strong>Decoupling</strong></td> <td>⭐⭐⭐⭐⭐ Excellent</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> </tbody> </table> <p><strong>Bottom Line:</strong> Zenject Signals are well-suited if you're already invested in Zenject and value testability through DI. DxMessaging offers standalone messaging without requiring DI setup, and includes Unity-specific features.</p> <blockquote> <p><strong>💡 Using Zenject?</strong> DxMessaging integrates with Zenject! See <a href=../../integrations/zenject/ >DxMessaging + Zenject Integration Guide</a> for step-by-step setup. Get DxMessaging's features (priorities, interceptors, Inspector debugging) with Zenject's DI.</p> </blockquote> <hr> <h2 id=scriptable-object-architecture-soa>Scriptable Object Architecture (SOA)<a class=headerlink href=#scriptable-object-architecture-soa title="Anchor link to this section">&para;</a></h2> <p><strong>What It Is:</strong> A Unity-specific pattern popularized by Ryan Hipple's <a href="https://www.youtube.com/watch?v=raQ3iHhE_Kk">Unite 2017 talk</a> that uses ScriptableObject assets for runtime communication (GameEvent, FloatVariable, etc.).</p> <p><strong>Core Philosophy:</strong> Designer-driven, asset-based communication where systems communicate through serialized SO assets instead of direct references.</p> <p><strong>⚠️ Contested Pattern:</strong> SOA has both proponents and critics. Supporters value its designer-friendly workflow and Inspector-based event wiring. Critics raise concerns about scalability and maintainability at scale. See <a href=https://github.com/cathei/AntiScriptableObjectArchitecture>Anti-ScriptableObject Architecture</a> for one perspective on the criticisms. Unity recommends ScriptableObjects for <strong>immutable design data</strong>, not mutable runtime state.</p> <h3 id=quick-comparison>Quick Comparison<a class=headerlink href=#quick-comparison title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Aspect</th> <th>SOA (GameEvent/Variables)</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Designer Control</strong></td> <td>✅ High (create events in Inspector)</td> <td>❌ Low (code-driven)</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>⚠️ Mixed (SO refs typed, but UnityEvent wiring loses compile-time safety)</td> <td>✅ Strong (compile-time validation)</td> </tr> <tr> <td><strong>Lifecycle</strong></td> <td>⚠️ Manual (assets persist)</td> <td>✅ Automatic (tokens clean up)</td> </tr> <tr> <td><strong>Performance</strong></td> <td>⚠️ List iteration, UnityAction overhead</td> <td>✅ Zero-allocation structs</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⚠️ Requires SO asset cleanup</td> <td>✅ Isolated buses per test</td> </tr> </tbody> </table> <h3 id=when-to-use-each>When to Use Each<a class=headerlink href=#when-to-use-each title="Anchor link to this section">&para;</a></h3> <h4 id=choose-soa-when>Choose SOA when<a class=headerlink href=#choose-soa-when title="Anchor link to this section">&para;</a></h4> <ul> <li>Designers need to create and wire events in the Inspector without code</li> <li>Your team is already deeply invested in SOA with existing assets</li> <li>Designer empowerment is more important than code maintainability</li> </ul> <h5 id=choose-dxmessaging-when>Choose DxMessaging when<a class=headerlink href=#choose-dxmessaging-when title="Anchor link to this section">&para;</a></h5> <ul> <li>You need type-safe, code-driven messaging</li> <li>Performance and zero-allocation are priorities</li> <li>You want automatic lifecycle management</li> <li>You need interceptors, priorities, or global observers</li> </ul> <h6 id=use-both-when>Use Both when<a class=headerlink href=#use-both-when title="Anchor link to this section">&para;</a></h6> <ul> <li>ScriptableObjects for <strong>immutable config data</strong> (weapon stats, level configs)</li> <li>DxMessaging for <strong>runtime events and communication</strong></li> <li>This is the recommended approach - use each tool correctly</li> </ul> <h3 id=full-comparison-guide>Full Comparison Guide<a class=headerlink href=#full-comparison-guide title="Anchor link to this section">&para;</a></h3> <p>For detailed migration patterns, interoperability strategies, and code examples, see:</p> <h4 id=-soa-compatibility-guide>→ <a href=../../guides/patterns/#14-compatibility-with-scriptable-object-architecture-soa>SOA Compatibility Guide</a><a class=headerlink href=#-soa-compatibility-guide title="Anchor link to this section">&para;</a></h4> <p>Includes:</p> <ul> <li>Pattern A: Bridging SOA GameEvents to DxMessaging</li> <li>Pattern B: Proper ScriptableObject usage (configs + messaging)</li> <li>Migration path from SOA to DxMessaging</li> <li>When to keep using ScriptableObjects</li> </ul> <h5 id=resources>Resources<a class=headerlink href=#resources title="Anchor link to this section">&para;</a></h5> <ul> <li><a href="https://www.youtube.com/watch?v=raQ3iHhE_Kk">Unite 2017 Talk</a> - Original SOA presentation</li> <li><a href=https://github.com/cathei/AntiScriptableObjectArchitecture>Anti-SOA Critique</a> - Detailed criticisms</li> <li><a href=https://unity.com/how-to/architect-game-code-scriptable-objects>Unity Official Guide</a> - Unity's perspective</li> </ul> <hr> <h2 id=traditional-approaches>Traditional Approaches<a class=headerlink href=#traditional-approaches title="Anchor link to this section">&para;</a></h2> <h3 id=standard-c-eventsactions>Standard C# Events/Actions<a class=headerlink href=#standard-c-eventsactions title="Anchor link to this section">&para;</a></h3> <p><strong>What It Is:</strong> C#'s built-in event and delegate system. The default way to handle callbacks and notifications in .NET and Unity.</p> <p><strong>Core Philosophy:</strong> Direct, type-safe callbacks between objects. Simple, familiar, and built into the language.</p> <h4 id=key-features_3>Key Features<a class=headerlink href=#key-features_3 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Language-native:</strong> Built into C#, no dependencies</li> <li><strong>Type-safe:</strong> Compile-time checking of event signatures</li> <li><strong>Return values:</strong> Events can return values and use <code>out</code> parameters</li> <li><strong>Inline lambdas:</strong> Subscribe with anonymous functions</li> <li><strong>Multicast:</strong> Multiple subscribers per event</li> <li><strong>Fast:</strong> Direct method invocation with minimal overhead</li> </ul> <h4 id=code-example_3>Code Example<a class=headerlink href=#code-example_3 title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-5-1><a id=__codelineno-5-1 name=__codelineno-5-1 href=#__codelineno-5-1></a><span class=c1>// Define and use C# events</span>
-</span><span id=__span-5-2><a id=__codelineno-5-2 name=__codelineno-5-2 href=#__codelineno-5-2></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>GameManager</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-5-3><a id=__codelineno-5-3 name=__codelineno-5-3 href=#__codelineno-5-3></a><span class=p>{</span>
-</span><span id=__span-5-4><a id=__codelineno-5-4 name=__codelineno-5-4 href=#__codelineno-5-4></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>event</span><span class=w> </span><span class=n>Action</span><span class=o>&lt;</span><span class=kt>int</span><span class=o>&gt;</span><span class=w> </span><span class=n>OnScoreChanged</span><span class=p>;</span>
-</span><span id=__span-5-5><a id=__codelineno-5-5 name=__codelineno-5-5 href=#__codelineno-5-5></a>
-</span><span id=__span-5-6><a id=__codelineno-5-6 name=__codelineno-5-6 href=#__codelineno-5-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>AddScore</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>points</span><span class=p>)</span>
-</span><span id=__span-5-7><a id=__codelineno-5-7 name=__codelineno-5-7 href=#__codelineno-5-7></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-5-8><a id=__codelineno-5-8 name=__codelineno-5-8 href=#__codelineno-5-8></a><span class=w>        </span><span class=n>OnScoreChanged</span><span class=o>?.</span><span class=n>Invoke</span><span class=p>(</span><span class=n>points</span><span class=p>);</span>
-</span><span id=__span-5-9><a id=__codelineno-5-9 name=__codelineno-5-9 href=#__codelineno-5-9></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-5-10><a id=__codelineno-5-10 name=__codelineno-5-10 href=#__codelineno-5-10></a><span class=p>}</span>
-</span><span id=__span-5-11><a id=__codelineno-5-11 name=__codelineno-5-11 href=#__codelineno-5-11></a>
-</span><span id=__span-5-12><a id=__codelineno-5-12 name=__codelineno-5-12 href=#__codelineno-5-12></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>UI</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-5-13><a id=__codelineno-5-13 name=__codelineno-5-13 href=#__codelineno-5-13></a><span class=p>{</span>
-</span><span id=__span-5-14><a id=__codelineno-5-14 name=__codelineno-5-14 href=#__codelineno-5-14></a><span class=w>    </span><span class=na>[SerializeField]</span><span class=w> </span><span class=k>private</span><span class=w> </span><span class=n>GameManager</span><span class=w> </span><span class=n>gameManager</span><span class=p>;</span>
-</span><span id=__span-5-15><a id=__codelineno-5-15 name=__codelineno-5-15 href=#__codelineno-5-15></a>
-</span><span id=__span-5-16><a id=__codelineno-5-16 name=__codelineno-5-16 href=#__codelineno-5-16></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnEnable</span><span class=p>()</span>
-</span><span id=__span-5-17><a id=__codelineno-5-17 name=__codelineno-5-17 href=#__codelineno-5-17></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-5-18><a id=__codelineno-5-18 name=__codelineno-5-18 href=#__codelineno-5-18></a><span class=w>        </span><span class=n>gameManager</span><span class=p>.</span><span class=n>OnScoreChanged</span><span class=w> </span><span class=o>+=</span><span class=w> </span><span class=n>UpdateScore</span><span class=p>;</span>
-</span><span id=__span-5-19><a id=__codelineno-5-19 name=__codelineno-5-19 href=#__codelineno-5-19></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-5-20><a id=__codelineno-5-20 name=__codelineno-5-20 href=#__codelineno-5-20></a>
-</span><span id=__span-5-21><a id=__codelineno-5-21 name=__codelineno-5-21 href=#__codelineno-5-21></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnDisable</span><span class=p>()</span>
-</span><span id=__span-5-22><a id=__codelineno-5-22 name=__codelineno-5-22 href=#__codelineno-5-22></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-5-23><a id=__codelineno-5-23 name=__codelineno-5-23 href=#__codelineno-5-23></a><span class=w>        </span><span class=n>gameManager</span><span class=p>.</span><span class=n>OnScoreChanged</span><span class=w> </span><span class=o>-=</span><span class=w> </span><span class=n>UpdateScore</span><span class=p>;</span>
-</span><span id=__span-5-24><a id=__codelineno-5-24 name=__codelineno-5-24 href=#__codelineno-5-24></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-5-25><a id=__codelineno-5-25 name=__codelineno-5-25 href=#__codelineno-5-25></a>
-</span><span id=__span-5-26><a id=__codelineno-5-26 name=__codelineno-5-26 href=#__codelineno-5-26></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>UpdateScore</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>points</span><span class=p>)</span>
-</span><span id=__span-5-27><a id=__codelineno-5-27 name=__codelineno-5-27 href=#__codelineno-5-27></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-5-28><a id=__codelineno-5-28 name=__codelineno-5-28 href=#__codelineno-5-28></a><span class=w>        </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;Score: {points}&quot;</span><span class=p>);</span>
-</span><span id=__span-5-29><a id=__codelineno-5-29 name=__codelineno-5-29 href=#__codelineno-5-29></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-5-30><a id=__codelineno-5-30 name=__codelineno-5-30 href=#__codelineno-5-30></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=what-problems-it-solves_3>What Problems It Solves<a class=headerlink href=#what-problems-it-solves_3 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Simple callbacks:</strong> Straightforward notification pattern</li> <li>✅ <strong>Type safety:</strong> Compile-time checking prevents errors</li> <li>✅ <strong>Return values:</strong> Can get feedback from event handlers</li> <li>✅ <strong>Performance:</strong> Minimal overhead, direct invocation</li> <li>✅ <strong>Familiarity:</strong> Every C# developer knows events</li> <li>✅ <strong>No dependencies:</strong> Built into the language</li> </ul> <h4 id=what-problems-it-doesnt-solve-well_3>What Problems It Doesn't Solve Well<a class=headerlink href=#what-problems-it-doesnt-solve-well_3 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ <strong>Memory leaks:</strong> Forgetting to unsubscribe causes leaks</li> <li>❌ <strong>Tight coupling:</strong> Subscribers need direct references to event sources</li> <li>❌ <strong>Execution order:</strong> Undefined handler invocation order</li> <li>❌ <strong>Lifecycle management:</strong> Manual subscribe/unsubscribe in OnEnable/OnDisable</li> <li>❌ <strong>Debugging:</strong> No visibility into who's subscribed or when events fire</li> <li>❌ <strong>Validation/interception:</strong> No pipeline to modify or validate before handlers</li> <li>❌ <strong>Global observation:</strong> Cannot listen to all events across the system</li> </ul> <h4 id=performance-characteristics_3>Performance Characteristics<a class=headerlink href=#performance-characteristics_3 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Fastest option:</strong> Direct method invocation (~50ns per call)</li> <li><strong>Zero allocation:</strong> No GC pressure for basic events</li> <li><strong>Inline-able:</strong> JIT can optimize simple event calls</li> <li><strong>Use case:</strong> Best raw performance for simple notifications</li> </ul> <h4 id=learning-curve_3>Learning Curve<a class=headerlink href=#learning-curve_3 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Zero for C# developers:</strong> Standard language feature</li> <li><strong>Immediate productivity:</strong> No new concepts to learn</li> <li><strong>Estimated learning time:</strong> Already know it</li> </ul> <h4 id=ease-of-understanding_3>Ease of Understanding<a class=headerlink href=#ease-of-understanding_3 title="Anchor link to this section">&para;</a></h4> <ul> <li>⭐⭐⭐⭐⭐ (Very easy)</li> <li>Familiar to all C# developers</li> <li>Straightforward mental model</li> <li>Easy to debug with breakpoints</li> </ul> <h4 id=when-c-events-win>When C# Events Win<a class=headerlink href=#when-c-events-win title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Small, stable scope (5-10 events max)</li> <li>✅ Need return values or <code>out</code> parameters</li> <li>✅ Writing a library (DxMessaging is Unity-specific)</li> <li>✅ Simple, local communication within a class or module</li> <li>✅ Team is C# experts, Unity beginners</li> <li>✅ Performance is absolutely critical (lowest overhead)</li> <li>✅ Quick prototypes or game jams</li> </ul> <h4 id=when-dxmessaging-wins_3>When DxMessaging Wins<a class=headerlink href=#when-dxmessaging-wins_3 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Memory leaks are a problem (automatic lifecycle management)</li> <li>✅ Need decoupling (systems don't reference each other)</li> <li>✅ Execution order matters (priority-based handlers)</li> <li>✅ Debugging "what fired when" (Inspector message history)</li> <li>✅ Message validation/interception needed (interceptor pipeline)</li> <li>✅ Global observation needed (listen to all message instances)</li> <li>✅ Cross-system communication (10+ systems)</li> <li>✅ Long-term maintenance (months/years)</li> <li>✅ GameObject/Component targeting needed</li> <li>✅ Post-processing stage needed (analytics after handlers)</li> </ul> <h4 id=direct-comparison_3>Direct Comparison<a class=headerlink href=#direct-comparison_3 title="Anchor link to this section">&para;</a></h4> <table> <thead> <tr> <th>Aspect</th> <th>C# Events</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Primary Use Case</strong></td> <td>Simple callbacks</td> <td>Pub/sub messaging</td> </tr> <tr> <td><strong>Unity Compatibility</strong></td> <td>✅ Built into C#</td> <td>✅ Built for Unity</td> </tr> <tr> <td><strong>Dependencies</strong></td> <td>✅ None (language)</td> <td>✅ Standalone</td> </tr> <tr> <td><strong>Performance</strong></td> <td>~50ns/call (fastest)</td> <td>~60ns/call</td> </tr> <tr> <td><strong>Allocations</strong></td> <td>✅ Zero (basic)</td> <td>✅ Zero (structs)</td> </tr> <tr> <td><strong>Learning Curve</strong></td> <td>⭐⭐⭐⭐⭐ None</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>Setup Complexity</strong></td> <td>⭐⭐⭐⭐⭐ Minimal</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>DI Integration</strong></td> <td>⚠️ Manual</td> <td>⚠️ Optional</td> </tr> <tr> <td><strong>Async/Await</strong></td> <td>⚠️ Manual</td> <td>⚠️ Manual</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>✅ Strong</td> <td>✅ Strong</td> </tr> <tr> <td><strong>Lifecycle Management</strong></td> <td>❌ Manual unsubscribe</td> <td>✅ Automatic</td> </tr> <tr> <td><strong>Execution Order</strong></td> <td>❌ Undefined</td> <td>✅ Priority-based</td> </tr> <tr> <td><strong>GameObject Targeting</strong></td> <td>❌ Not built-in</td> <td>✅ Built-in</td> </tr> <tr> <td><strong>Unity Integration</strong></td> <td>⭐ None</td> <td>⭐⭐⭐⭐⭐ Deep</td> </tr> <tr> <td><strong>Inspector Debugging</strong></td> <td>❌ No</td> <td>✅ History + stats</td> </tr> <tr> <td><strong>Interceptors</strong></td> <td>❌ Not built-in</td> <td>✅ Full pipeline</td> </tr> <tr> <td><strong>Global Observers</strong></td> <td>❌ Not built-in</td> <td>✅ Listen to all</td> </tr> <tr> <td><strong>Post-Processing</strong></td> <td>❌ Not built-in</td> <td>✅ Dedicated stage</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⭐⭐ Hard to isolate</td> <td>⭐⭐⭐⭐⭐ Local buses</td> </tr> <tr> <td><strong>Decoupling</strong></td> <td>⭐ Tight coupling</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> <tr> <td><strong>Return Values</strong></td> <td>✅ Yes</td> <td>❌ Fire-and-forget</td> </tr> </tbody> </table> <p><strong>Bottom Line:</strong> C# events are the fastest and simplest for basic callbacks. DxMessaging is better for complex, decoupled systems where lifecycle management, debugging, and execution control matter.</p> <hr> <h3 id=unityevents-inspector-wiring>UnityEvents (Inspector Wiring)<a class=headerlink href=#unityevents-inspector-wiring title="Anchor link to this section">&para;</a></h3> <p><strong>What It Is:</strong> Unity's serializable event system that allows wiring callbacks in the Inspector. Designed for designer-friendly event hookups without code.</p> <p><strong>Core Philosophy:</strong> Visual, Inspector-based event connections. Enable non-programmers to wire game logic through the editor.</p> <h4 id=key-features_4>Key Features<a class=headerlink href=#key-features_4 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Inspector wiring:</strong> Drag-and-drop connections in Unity Inspector</li> <li><strong>Serializable:</strong> Events saved with scenes and prefabs</li> <li><strong>Designer-friendly:</strong> Non-programmers can wire logic</li> <li><strong>Persistent references:</strong> Connections survive across sessions</li> <li><strong>Dynamic parameters:</strong> Pass values from Inspector to callbacks</li> <li><strong>No code required:</strong> Can wire entire behaviors without scripting</li> </ul> <h4 id=code-example_4>Code Example<a class=headerlink href=#code-example_4 title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-6-1><a id=__codelineno-6-1 name=__codelineno-6-1 href=#__codelineno-6-1></a><span class=k>using</span><span class=w> </span><span class=nn>UnityEngine</span><span class=p>;</span>
-</span><span id=__span-6-2><a id=__codelineno-6-2 name=__codelineno-6-2 href=#__codelineno-6-2></a><span class=k>using</span><span class=w> </span><span class=nn>UnityEngine.Events</span><span class=p>;</span>
-</span><span id=__span-6-3><a id=__codelineno-6-3 name=__codelineno-6-3 href=#__codelineno-6-3></a>
-</span><span id=__span-6-4><a id=__codelineno-6-4 name=__codelineno-6-4 href=#__codelineno-6-4></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>Button</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-6-5><a id=__codelineno-6-5 name=__codelineno-6-5 href=#__codelineno-6-5></a><span class=p>{</span>
-</span><span id=__span-6-6><a id=__codelineno-6-6 name=__codelineno-6-6 href=#__codelineno-6-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=n>UnityEvent</span><span class=w> </span><span class=n>onClick</span><span class=p>;</span>
-</span><span id=__span-6-7><a id=__codelineno-6-7 name=__codelineno-6-7 href=#__codelineno-6-7></a>
-</span><span id=__span-6-8><a id=__codelineno-6-8 name=__codelineno-6-8 href=#__codelineno-6-8></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnMouseDown</span><span class=p>()</span>
-</span><span id=__span-6-9><a id=__codelineno-6-9 name=__codelineno-6-9 href=#__codelineno-6-9></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-6-10><a id=__codelineno-6-10 name=__codelineno-6-10 href=#__codelineno-6-10></a><span class=w>        </span><span class=n>onClick</span><span class=o>?.</span><span class=n>Invoke</span><span class=p>();</span>
-</span><span id=__span-6-11><a id=__codelineno-6-11 name=__codelineno-6-11 href=#__codelineno-6-11></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-6-12><a id=__codelineno-6-12 name=__codelineno-6-12 href=#__codelineno-6-12></a><span class=p>}</span>
-</span><span id=__span-6-13><a id=__codelineno-6-13 name=__codelineno-6-13 href=#__codelineno-6-13></a>
-</span><span id=__span-6-14><a id=__codelineno-6-14 name=__codelineno-6-14 href=#__codelineno-6-14></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>UI</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-6-15><a id=__codelineno-6-15 name=__codelineno-6-15 href=#__codelineno-6-15></a><span class=p>{</span>
-</span><span id=__span-6-16><a id=__codelineno-6-16 name=__codelineno-6-16 href=#__codelineno-6-16></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>ShowMenu</span><span class=p>()</span>
-</span><span id=__span-6-17><a id=__codelineno-6-17 name=__codelineno-6-17 href=#__codelineno-6-17></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-6-18><a id=__codelineno-6-18 name=__codelineno-6-18 href=#__codelineno-6-18></a><span class=w>        </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>&quot;Menu shown&quot;</span><span class=p>);</span>
-</span><span id=__span-6-19><a id=__codelineno-6-19 name=__codelineno-6-19 href=#__codelineno-6-19></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-6-20><a id=__codelineno-6-20 name=__codelineno-6-20 href=#__codelineno-6-20></a>
-</span><span id=__span-6-21><a id=__codelineno-6-21 name=__codelineno-6-21 href=#__codelineno-6-21></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>HideMenu</span><span class=p>()</span>
-</span><span id=__span-6-22><a id=__codelineno-6-22 name=__codelineno-6-22 href=#__codelineno-6-22></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-6-23><a id=__codelineno-6-23 name=__codelineno-6-23 href=#__codelineno-6-23></a><span class=w>        </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>&quot;Menu hidden&quot;</span><span class=p>);</span>
-</span><span id=__span-6-24><a id=__codelineno-6-24 name=__codelineno-6-24 href=#__codelineno-6-24></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-6-25><a id=__codelineno-6-25 name=__codelineno-6-25 href=#__codelineno-6-25></a><span class=p>}</span>
-</span><span id=__span-6-26><a id=__codelineno-6-26 name=__codelineno-6-26 href=#__codelineno-6-26></a>
-</span><span id=__span-6-27><a id=__codelineno-6-27 name=__codelineno-6-27 href=#__codelineno-6-27></a><span class=c1>// In Inspector: Drag UI component to Button&#39;s onClick event</span>
-</span><span id=__span-6-28><a id=__codelineno-6-28 name=__codelineno-6-28 href=#__codelineno-6-28></a><span class=c1>// Select ShowMenu from dropdown</span>
-</span><span id=__span-6-29><a id=__codelineno-6-29 name=__codelineno-6-29 href=#__codelineno-6-29></a><span class=c1>// No additional code needed</span>
-</span></code></pre></div> <h4 id=what-problems-it-solves_4>What Problems It Solves<a class=headerlink href=#what-problems-it-solves_4 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Visual wiring:</strong> See connections in Inspector</li> <li>✅ <strong>No code required:</strong> Designers can hook up events</li> <li>✅ <strong>Persistence:</strong> Connections saved with scenes/prefabs</li> <li>✅ <strong>Rapid prototyping:</strong> Quick iteration without scripting</li> <li>✅ <strong>Prefab workflows:</strong> Events work across prefab instances</li> </ul> <h4 id=what-problems-it-doesnt-solve-well_4>What Problems It Doesn't Solve Well<a class=headerlink href=#what-problems-it-doesnt-solve-well_4 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ <strong>Hidden dependencies:</strong> Connections invisible in code, hard to find during refactoring</li> <li>❌ <strong>Brittle at scale:</strong> Renaming methods breaks wiring, no compile-time safety</li> <li>❌ <strong>Execution order:</strong> Undefined call order for multiple subscribers</li> <li>❌ <strong>No validation:</strong> No way to validate or intercept before invocation</li> <li>❌ <strong>Performance:</strong> Slower than C# events due to reflection and boxing</li> <li>❌ <strong>Debugging:</strong> Hard to trace "who called what" at runtime</li> <li>❌ <strong>Merge conflicts:</strong> Inspector changes cause git conflicts</li> <li>❌ <strong>Refactoring challenges:</strong> Renaming/moving methods silently breaks connections</li> </ul> <h4 id=performance-characteristics_4>Performance Characteristics<a class=headerlink href=#performance-characteristics_4 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Slow compared to alternatives:</strong> Reflection overhead, boxing for value types</li> <li><strong>Allocations:</strong> Parameters boxed as objects, causes GC pressure</li> <li><strong>Use case:</strong> Acceptable for UI and low-frequency events, avoid for high-frequency gameplay</li> </ul> <h4 id=learning-curve_4>Learning Curve<a class=headerlink href=#learning-curve_4 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Very easy:</strong> Point-and-click in Inspector</li> <li><strong>No coding knowledge needed:</strong> Accessible to designers</li> <li><strong>Estimated learning time:</strong> 5-10 minutes</li> </ul> <h4 id=ease-of-understanding_4>Ease of Understanding<a class=headerlink href=#ease-of-understanding_4 title="Anchor link to this section">&para;</a></h4> <ul> <li>⭐⭐⭐⭐ (Easy for wiring, hard for debugging)</li> <li>Simple to connect in Inspector</li> <li>Difficult to understand flow when reading code</li> <li>Hard to track down at scale (where is this method called from?)</li> </ul> <h4 id=when-unityevents-win>When UnityEvents Win<a class=headerlink href=#when-unityevents-win title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Designers need to wire logic without code</li> <li>✅ Rapid prototyping with prefabs</li> <li>✅ Very simple games (mobile casual, hyper-casual)</li> <li>✅ UI interactions with minimal logic</li> <li>✅ Small projects (&lt;5 scripts)</li> <li>✅ One-off connections that rarely change</li> </ul> <h4 id=when-dxmessaging-wins_4>When DxMessaging Wins<a class=headerlink href=#when-dxmessaging-wins_4 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Code-first development (programmers prefer code visibility)</li> <li>✅ Refactoring frequently (compile-time safety)</li> <li>✅ Execution order matters (priority-based handlers)</li> <li>✅ Need validation/interception (interceptor pipeline)</li> <li>✅ Performance-sensitive (zero allocation required)</li> <li>✅ Debugging observability (message history)</li> <li>✅ Cross-system communication (10+ components)</li> <li>✅ Team collaboration (merge-friendly code over Inspector)</li> <li>✅ Long-term maintenance (find usages, refactor safely)</li> </ul> <h4 id=direct-comparison_4>Direct Comparison<a class=headerlink href=#direct-comparison_4 title="Anchor link to this section">&para;</a></h4> <table> <thead> <tr> <th>Aspect</th> <th>UnityEvents</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Primary Use Case</strong></td> <td>Inspector wiring</td> <td>Pub/sub messaging</td> </tr> <tr> <td><strong>Unity Compatibility</strong></td> <td>✅ Built into Unity</td> <td>✅ Built for Unity</td> </tr> <tr> <td><strong>Dependencies</strong></td> <td>✅ None (Unity)</td> <td>✅ Standalone</td> </tr> <tr> <td><strong>Performance</strong></td> <td>Slow (serialization)</td> <td>~60ns/call</td> </tr> <tr> <td><strong>Allocations</strong></td> <td>❌ Boxing</td> <td>✅ Zero (structs)</td> </tr> <tr> <td><strong>Learning Curve</strong></td> <td>⭐⭐⭐⭐⭐ Minimal</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>Setup Complexity</strong></td> <td>⭐⭐⭐⭐⭐ Inspector</td> <td>⭐⭐⭐ Code-based</td> </tr> <tr> <td><strong>DI Integration</strong></td> <td>❌ No</td> <td>⚠️ Optional</td> </tr> <tr> <td><strong>Async/Await</strong></td> <td>❌ No</td> <td>⚠️ Manual</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>⭐⭐ Weak (serialized)</td> <td>✅ Strong</td> </tr> <tr> <td><strong>Lifecycle Management</strong></td> <td>⚠️ Unity-managed</td> <td>✅ Automatic</td> </tr> <tr> <td><strong>Execution Order</strong></td> <td>❌ Undefined</td> <td>✅ Priority-based</td> </tr> <tr> <td><strong>GameObject Targeting</strong></td> <td>⚠️ Manual references</td> <td>✅ Built-in</td> </tr> <tr> <td><strong>Unity Integration</strong></td> <td>⭐⭐⭐ Inspector-based</td> <td>⭐⭐⭐⭐⭐ Deep</td> </tr> <tr> <td><strong>Inspector Debugging</strong></td> <td>⭐⭐ Connections only</td> <td>✅ History + stats</td> </tr> <tr> <td><strong>Interceptors</strong></td> <td>❌ Not built-in</td> <td>✅ Full pipeline</td> </tr> <tr> <td><strong>Global Observers</strong></td> <td>❌ Not possible</td> <td>✅ Listen to all</td> </tr> <tr> <td><strong>Post-Processing</strong></td> <td>❌ Not built-in</td> <td>✅ Dedicated stage</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⭐⭐ Scene setup</td> <td>⭐⭐⭐⭐⭐ Local buses</td> </tr> <tr> <td><strong>Decoupling</strong></td> <td>⭐⭐ Hidden refs</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> <tr> <td><strong>Refactoring Safety</strong></td> <td>❌ Silent breakage</td> <td>✅ Compile-time errors</td> </tr> <tr> <td><strong>Code Visibility</strong></td> <td>❌ Hidden in Inspector</td> <td>✅ Explicit in code</td> </tr> </tbody> </table> <p><strong>Bottom Line:</strong> UnityEvents are well-suited for simple Inspector-based wiring and designer workflows. DxMessaging is better for code-first development, refactoring safety, and complex messaging needs.</p> <hr> <h3 id=unity-sendmessage>Unity SendMessage<a class=headerlink href=#unity-sendmessage title="Anchor link to this section">&para;</a></h3> <p><strong>What It Is:</strong> Unity's legacy reflection-based message system. Calls methods by name on GameObjects and their components.</p> <p><strong>Core Philosophy:</strong> String-based, reflection-driven communication. Designed for simplicity and GameObject hierarchy traversal.</p> <h4 id=key-features_5>Key Features<a class=headerlink href=#key-features_5 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>String-based:</strong> Call methods by name without references</li> <li><strong>Hierarchy traversal:</strong> SendMessageUpwards, BroadcastMessage for parent/child searching</li> <li><strong>No dependencies:</strong> Built into Unity GameObject</li> <li><strong>Simple API:</strong> One-line method calls</li> <li><strong>GameObject-centric:</strong> Works with Unity's component model</li> <li><strong>Optional receivers:</strong> Methods don't need to exist (SendMessageOptions.DontRequireReceiver)</li> </ul> <h4 id=code-example_5>Code Example<a class=headerlink href=#code-example_5 title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-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>UnityEngine</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><span id=__span-7-3><a id=__codelineno-7-3 name=__codelineno-7-3 href=#__codelineno-7-3></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>Enemy</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-7-4><a id=__codelineno-7-4 name=__codelineno-7-4 href=#__codelineno-7-4></a><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=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>TakeDamage</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>)</span>
-</span><span id=__span-7-6><a id=__codelineno-7-6 name=__codelineno-7-6 href=#__codelineno-7-6></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-7-7><a id=__codelineno-7-7 name=__codelineno-7-7 href=#__codelineno-7-7></a><span class=w>        </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;Took {amount} damage&quot;</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=w>    </span><span class=p>}</span>
-</span><span id=__span-7-9><a id=__codelineno-7-9 name=__codelineno-7-9 href=#__codelineno-7-9></a><span class=p>}</span>
-</span><span id=__span-7-10><a id=__codelineno-7-10 name=__codelineno-7-10 href=#__codelineno-7-10></a>
-</span><span id=__span-7-11><a id=__codelineno-7-11 name=__codelineno-7-11 href=#__codelineno-7-11></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>Weapon</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-7-12><a id=__codelineno-7-12 name=__codelineno-7-12 href=#__codelineno-7-12></a><span class=p>{</span>
-</span><span id=__span-7-13><a id=__codelineno-7-13 name=__codelineno-7-13 href=#__codelineno-7-13></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>Attack</span><span class=p>(</span><span class=n>GameObject</span><span class=w> </span><span class=n>target</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 class=w>    </span><span class=p>{</span>
-</span><span id=__span-7-15><a id=__codelineno-7-15 name=__codelineno-7-15 href=#__codelineno-7-15></a><span class=w>        </span><span class=c1>// Call TakeDamage on target GameObject</span>
-</span><span id=__span-7-16><a id=__codelineno-7-16 name=__codelineno-7-16 href=#__codelineno-7-16></a><span class=w>        </span><span class=n>target</span><span class=p>.</span><span class=n>SendMessage</span><span class=p>(</span><span class=s>&quot;TakeDamage&quot;</span><span class=p>,</span><span class=w> </span><span class=mi>10</span><span class=p>);</span>
-</span><span id=__span-7-17><a id=__codelineno-7-17 name=__codelineno-7-17 href=#__codelineno-7-17></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-7-18><a id=__codelineno-7-18 name=__codelineno-7-18 href=#__codelineno-7-18></a>
-</span><span id=__span-7-19><a id=__codelineno-7-19 name=__codelineno-7-19 href=#__codelineno-7-19></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>AttackUpwards</span><span class=p>()</span>
-</span><span id=__span-7-20><a id=__codelineno-7-20 name=__codelineno-7-20 href=#__codelineno-7-20></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-7-21><a id=__codelineno-7-21 name=__codelineno-7-21 href=#__codelineno-7-21></a><span class=w>        </span><span class=c1>// Call on this GameObject and all parents</span>
-</span><span id=__span-7-22><a id=__codelineno-7-22 name=__codelineno-7-22 href=#__codelineno-7-22></a><span class=w>        </span><span class=n>SendMessageUpwards</span><span class=p>(</span><span class=s>&quot;TakeDamage&quot;</span><span class=p>,</span><span class=w> </span><span class=mi>5</span><span class=p>,</span><span class=w> </span><span class=n>SendMessageOptions</span><span class=p>.</span><span class=n>DontRequireReceiver</span><span class=p>);</span>
-</span><span id=__span-7-23><a id=__codelineno-7-23 name=__codelineno-7-23 href=#__codelineno-7-23></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-7-24><a id=__codelineno-7-24 name=__codelineno-7-24 href=#__codelineno-7-24></a>
-</span><span id=__span-7-25><a id=__codelineno-7-25 name=__codelineno-7-25 href=#__codelineno-7-25></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>AttackChildren</span><span class=p>()</span>
-</span><span id=__span-7-26><a id=__codelineno-7-26 name=__codelineno-7-26 href=#__codelineno-7-26></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-7-27><a id=__codelineno-7-27 name=__codelineno-7-27 href=#__codelineno-7-27></a><span class=w>        </span><span class=c1>// Call on this GameObject and all children</span>
-</span><span id=__span-7-28><a id=__codelineno-7-28 name=__codelineno-7-28 href=#__codelineno-7-28></a><span class=w>        </span><span class=n>BroadcastMessage</span><span class=p>(</span><span class=s>&quot;TakeDamage&quot;</span><span class=p>,</span><span class=w> </span><span class=mi>3</span><span class=p>);</span>
-</span><span id=__span-7-29><a id=__codelineno-7-29 name=__codelineno-7-29 href=#__codelineno-7-29></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-7-30><a id=__codelineno-7-30 name=__codelineno-7-30 href=#__codelineno-7-30></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=what-problems-it-solves_5>What Problems It Solves<a class=headerlink href=#what-problems-it-solves_5 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>No references needed:</strong> Call methods without GetComponent</li> <li>✅ <strong>Hierarchy traversal:</strong> Easy parent/child communication</li> <li>✅ <strong>Simple API:</strong> One-line method invocation</li> <li>✅ <strong>Optional receivers:</strong> Can call non-existent methods safely</li> <li>✅ <strong>Built-in:</strong> No setup or dependencies</li> </ul> <h4 id=what-problems-it-doesnt-solve-well_5>What Problems It Doesn't Solve Well<a class=headerlink href=#what-problems-it-doesnt-solve-well_5 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ <strong>No type safety:</strong> String-based, typos cause silent failures</li> <li>❌ <strong>Slow performance:</strong> Reflection overhead on every call</li> <li>❌ <strong>Limited parameters:</strong> Only 0 or 1 parameter supported</li> <li>❌ <strong>Boxing allocations:</strong> Value types boxed to object, causes GC</li> <li>❌ <strong>Hard to debug:</strong> No compile-time checking, no IDE "Find Usages"</li> <li>❌ <strong>Refactoring difficulty:</strong> Renaming methods breaks string references</li> <li>❌ <strong>No validation:</strong> No way to validate or intercept messages</li> <li>❌ <strong>Execution order:</strong> Undefined call order for multiple receivers</li> </ul> <h4 id=performance-characteristics_5>Performance Characteristics<a class=headerlink href=#performance-characteristics_5 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Very slow:</strong> Reflection overhead much worse than events or messaging systems</li> <li><strong>Allocations:</strong> Boxing value type parameters causes GC pressure</li> <li><strong>Use case:</strong> Legacy code only; avoid for new development</li> </ul> <h4 id=learning-curve_5>Learning Curve<a class=headerlink href=#learning-curve_5 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Very easy:</strong> Simple one-line API</li> <li><strong>Immediate productivity:</strong> No setup required</li> <li><strong>Estimated learning time:</strong> 5 minutes</li> </ul> <h4 id=ease-of-understanding_5>Ease of Understanding<a class=headerlink href=#ease-of-understanding_5 title="Anchor link to this section">&para;</a></h4> <ul> <li>⭐⭐⭐ (Simple to use, hard to maintain)</li> <li>Easy to write initially</li> <li>Difficult to track method calls (no Find Usages)</li> <li>Refactoring breaks string references silently</li> </ul> <h4 id=when-unity-sendmessage-wins>When Unity SendMessage Wins<a class=headerlink href=#when-unity-sendmessage-wins title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Legacy code that already uses it</li> <li>✅ Quick prototypes (throwaway code)</li> <li>✅ Simple tutorials or learning examples</li> <li>✅ Calling optional methods that may not exist</li> <li>✅ GameObject hierarchies with optional components (DontRequireReceiver pattern)</li> </ul> <h4 id=when-dxmessaging-wins_5>When DxMessaging Wins<a class=headerlink href=#when-dxmessaging-wins_5 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Type safety required (compile-time checking)</li> <li>✅ Performance matters (zero allocation, no reflection)</li> <li>✅ Multiple parameters needed (struct fields)</li> <li>✅ Refactoring frequently (find usages, rename safely)</li> <li>✅ Debugging observability (message history)</li> <li>✅ Execution order control (priority-based handlers)</li> <li>✅ Message validation/interception (interceptor pipeline)</li> <li>✅ Production code (maintainability over simplicity)</li> <li>✅ Modern projects (avoid legacy patterns)</li> </ul> <h4 id=direct-comparison_5>Direct Comparison<a class=headerlink href=#direct-comparison_5 title="Anchor link to this section">&para;</a></h4> <table> <thead> <tr> <th>Aspect</th> <th>Unity SendMessage</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Primary Use Case</strong></td> <td>Legacy GameObject calls</td> <td>Pub/sub messaging</td> </tr> <tr> <td><strong>Unity Compatibility</strong></td> <td>✅ Built into Unity</td> <td>✅ Built for Unity</td> </tr> <tr> <td><strong>Dependencies</strong></td> <td>✅ None (Unity)</td> <td>✅ Standalone</td> </tr> <tr> <td><strong>Performance</strong></td> <td>Very slow (reflection)</td> <td>~60ns/call</td> </tr> <tr> <td><strong>Allocations</strong></td> <td>❌ Heavy boxing</td> <td>✅ Zero (structs)</td> </tr> <tr> <td><strong>Learning Curve</strong></td> <td>⭐⭐⭐⭐⭐ Minimal</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>Setup Complexity</strong></td> <td>⭐⭐⭐⭐⭐ None</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>DI Integration</strong></td> <td>❌ No</td> <td>⚠️ Optional</td> </tr> <tr> <td><strong>Async/Await</strong></td> <td>❌ No</td> <td>⚠️ Manual</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>❌ String-based</td> <td>✅ Strong</td> </tr> <tr> <td><strong>Lifecycle Management</strong></td> <td>❌ None</td> <td>✅ Automatic</td> </tr> <tr> <td><strong>Execution Order</strong></td> <td>❌ Undefined</td> <td>✅ Priority-based</td> </tr> <tr> <td><strong>GameObject Targeting</strong></td> <td>✅ Hierarchy traversal</td> <td>✅ Built-in (ID-based)</td> </tr> <tr> <td><strong>Unity Integration</strong></td> <td>⭐⭐ Legacy API</td> <td>⭐⭐⭐⭐⭐ Deep</td> </tr> <tr> <td><strong>Inspector Debugging</strong></td> <td>❌ No</td> <td>✅ History + stats</td> </tr> <tr> <td><strong>Interceptors</strong></td> <td>❌ Not built-in</td> <td>✅ Full pipeline</td> </tr> <tr> <td><strong>Global Observers</strong></td> <td>❌ Not possible</td> <td>✅ Listen to all</td> </tr> <tr> <td><strong>Post-Processing</strong></td> <td>❌ Not built-in</td> <td>✅ Dedicated stage</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⭐⭐ Requires GameObjects</td> <td>⭐⭐⭐⭐⭐ Local buses</td> </tr> <tr> <td><strong>Decoupling</strong></td> <td>⭐⭐ String-based</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> <tr> <td><strong>Refactoring Safety</strong></td> <td>❌ Silent breakage</td> <td>✅ Compile-time errors</td> </tr> <tr> <td><strong>Parameters</strong></td> <td>⚠️ 0 or 1 only</td> <td>✅ Unlimited (struct fields)</td> </tr> </tbody> </table> <p><strong>Bottom Line:</strong> SendMessage is legacy Unity API. Use only for maintaining old code. DxMessaging provides all the same capabilities with type safety, performance, and modern tooling.</p> <p><strong>Migration Path:</strong> DxMessaging provides <code>ReflexiveMessage</code> to bridge legacy SendMessage behavior:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-8-1><a id=__codelineno-8-1 name=__codelineno-8-1 href=#__codelineno-8-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
-</span><span id=__span-8-2><a id=__codelineno-8-2 name=__codelineno-8-2 href=#__codelineno-8-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Messages</span><span class=p>;</span>
-</span><span id=__span-8-3><a id=__codelineno-8-3 name=__codelineno-8-3 href=#__codelineno-8-3></a>
-</span><span id=__span-8-4><a id=__codelineno-8-4 name=__codelineno-8-4 href=#__codelineno-8-4></a><span class=c1>// Legacy SendMessage equivalent</span>
-</span><span id=__span-8-5><a id=__codelineno-8-5 name=__codelineno-8-5 href=#__codelineno-8-5></a><span class=n>InstanceId</span><span class=w> </span><span class=n>target</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>gameObject</span><span class=p>;</span>
-</span><span id=__span-8-6><a id=__codelineno-8-6 name=__codelineno-8-6 href=#__codelineno-8-6></a><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>ReflexiveMessage</span><span class=p>(</span><span class=s>&quot;OnHit&quot;</span><span class=p>,</span><span class=w> </span><span class=n>ReflexiveSendMode</span><span class=p>.</span><span class=n>Upwards</span><span class=p>,</span><span class=w> </span><span class=mi>10</span><span class=p>);</span>
-</span><span id=__span-8-7><a id=__codelineno-8-7 name=__codelineno-8-7 href=#__codelineno-8-7></a><span class=n>MessageHandler</span><span class=p>.</span><span class=n>MessageBus</span><span class=p>.</span><span class=n>TargetedBroadcast</span><span class=p>(</span><span class=k>ref</span><span class=w> </span><span class=n>target</span><span class=p>,</span><span class=w> </span><span class=k>ref</span><span class=w> </span><span class=n>msg</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=c1>// Prefer typed messages for new code:</span>
-</span><span id=__span-8-10><a id=__codelineno-8-10 name=__codelineno-8-10 href=#__codelineno-8-10></a><span class=c1>// - Multiple parameters via struct fields</span>
-</span><span id=__span-8-11><a id=__codelineno-8-11 name=__codelineno-8-11 href=#__codelineno-8-11></a><span class=c1>// - By-ref handlers avoid boxing</span>
-</span><span id=__span-8-12><a id=__codelineno-8-12 name=__codelineno-8-12 href=#__codelineno-8-12></a><span class=c1>// - Compile-time safety</span>
-</span></code></pre></div> <hr> <h3 id=global-event-bus-singletons>Global Event Bus Singletons<a class=headerlink href=#global-event-bus-singletons title="Anchor link to this section">&para;</a></h3> <p><strong>What It Is:</strong> A static/singleton class that centralizes all events in one global location. Common pattern for decoupling without dependency injection.</p> <p><strong>Core Philosophy:</strong> Central event hub accessible from anywhere. Simplify communication through a single global entry point.</p> <h4 id=key-features_6>Key Features<a class=headerlink href=#key-features_6 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Global access:</strong> Static class available everywhere</li> <li><strong>No references needed:</strong> No GetComponent or serialized fields</li> <li><strong>Simple pattern:</strong> Easy to understand and implement</li> <li><strong>Decoupling:</strong> Publishers and subscribers don't know about each other</li> <li><strong>Flexibility:</strong> Can add events without changing existing code</li> </ul> <h4 id=code-example_6>Code Example<a class=headerlink href=#code-example_6 title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-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>System</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>UnityEngine</span><span class=p>;</span>
-</span><span id=__span-9-3><a id=__codelineno-9-3 name=__codelineno-9-3 href=#__codelineno-9-3></a>
-</span><span id=__span-9-4><a id=__codelineno-9-4 name=__codelineno-9-4 href=#__codelineno-9-4></a><span class=k>public</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>EventHub</span>
-</span><span id=__span-9-5><a id=__codelineno-9-5 name=__codelineno-9-5 href=#__codelineno-9-5></a><span class=p>{</span>
-</span><span id=__span-9-6><a id=__codelineno-9-6 name=__codelineno-9-6 href=#__codelineno-9-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=k>event</span><span class=w> </span><span class=n>Action</span><span class=o>&lt;</span><span class=kt>int</span><span class=o>&gt;</span><span class=w> </span><span class=n>OnDamage</span><span class=p>;</span>
-</span><span id=__span-9-7><a id=__codelineno-9-7 name=__codelineno-9-7 href=#__codelineno-9-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=k>event</span><span class=w> </span><span class=n>Action</span><span class=o>&lt;</span><span class=kt>string</span><span class=o>&gt;</span><span class=w> </span><span class=n>OnEnemyKilled</span><span class=p>;</span>
-</span><span id=__span-9-8><a id=__codelineno-9-8 name=__codelineno-9-8 href=#__codelineno-9-8></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=k>event</span><span class=w> </span><span class=n>Action</span><span class=w> </span><span class=n>OnGameOver</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=k>public</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RaiseDamage</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>OnDamage</span><span class=o>?.</span><span class=n>Invoke</span><span class=p>(</span><span class=n>amount</span><span class=p>);</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>static</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RaiseEnemyKilled</span><span class=p>(</span><span class=kt>string</span><span class=w> </span><span class=n>enemyType</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>OnEnemyKilled</span><span class=o>?.</span><span class=n>Invoke</span><span class=p>(</span><span class=n>enemyType</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=k>public</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>RaiseGameOver</span><span class=p>()</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>OnGameOver</span><span class=o>?.</span><span class=n>Invoke</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=p>}</span>
-</span><span id=__span-9-14><a id=__codelineno-9-14 name=__codelineno-9-14 href=#__codelineno-9-14></a>
-</span><span id=__span-9-15><a id=__codelineno-9-15 name=__codelineno-9-15 href=#__codelineno-9-15></a><span class=c1>// Producer</span>
-</span><span id=__span-9-16><a id=__codelineno-9-16 name=__codelineno-9-16 href=#__codelineno-9-16></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>Enemy</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-9-17><a id=__codelineno-9-17 name=__codelineno-9-17 href=#__codelineno-9-17></a><span class=p>{</span>
-</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=k>void</span><span class=w> </span><span class=nf>Die</span><span class=p>()</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=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=n>EventHub</span><span class=p>.</span><span class=n>RaiseEnemyKilled</span><span class=p>(</span><span class=s>&quot;Orc&quot;</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=p>}</span>
-</span><span id=__span-9-22><a id=__codelineno-9-22 name=__codelineno-9-22 href=#__codelineno-9-22></a><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><span id=__span-9-24><a id=__codelineno-9-24 name=__codelineno-9-24 href=#__codelineno-9-24></a><span class=c1>// Consumer</span>
-</span><span id=__span-9-25><a id=__codelineno-9-25 name=__codelineno-9-25 href=#__codelineno-9-25></a><span class=k>public</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>UI</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>MonoBehaviour</span>
-</span><span id=__span-9-26><a id=__codelineno-9-26 name=__codelineno-9-26 href=#__codelineno-9-26></a><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=k>void</span><span class=w> </span><span class=nf>OnEnable</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=p>{</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=n>EventHub</span><span class=p>.</span><span class=n>OnEnemyKilled</span><span class=w> </span><span class=o>+=</span><span class=w> </span><span class=n>HandleEnemyKilled</span><span class=p>;</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><span id=__span-9-32><a id=__codelineno-9-32 name=__codelineno-9-32 href=#__codelineno-9-32></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>OnDisable</span><span class=p>()</span>
-</span><span id=__span-9-33><a id=__codelineno-9-33 name=__codelineno-9-33 href=#__codelineno-9-33></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-9-34><a id=__codelineno-9-34 name=__codelineno-9-34 href=#__codelineno-9-34></a><span class=w>        </span><span class=n>EventHub</span><span class=p>.</span><span class=n>OnEnemyKilled</span><span class=w> </span><span class=o>-=</span><span class=w> </span><span class=n>HandleEnemyKilled</span><span class=p>;</span>
-</span><span id=__span-9-35><a id=__codelineno-9-35 name=__codelineno-9-35 href=#__codelineno-9-35></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-9-36><a id=__codelineno-9-36 name=__codelineno-9-36 href=#__codelineno-9-36></a>
-</span><span id=__span-9-37><a id=__codelineno-9-37 name=__codelineno-9-37 href=#__codelineno-9-37></a><span class=w>    </span><span class=k>void</span><span class=w> </span><span class=nf>HandleEnemyKilled</span><span class=p>(</span><span class=kt>string</span><span class=w> </span><span class=n>enemyType</span><span class=p>)</span>
-</span><span id=__span-9-38><a id=__codelineno-9-38 name=__codelineno-9-38 href=#__codelineno-9-38></a><span class=w>    </span><span class=p>{</span>
-</span><span id=__span-9-39><a id=__codelineno-9-39 name=__codelineno-9-39 href=#__codelineno-9-39></a><span class=w>        </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;Enemy killed: {enemyType}&quot;</span><span class=p>);</span>
-</span><span id=__span-9-40><a id=__codelineno-9-40 name=__codelineno-9-40 href=#__codelineno-9-40></a><span class=w>    </span><span class=p>}</span>
-</span><span id=__span-9-41><a id=__codelineno-9-41 name=__codelineno-9-41 href=#__codelineno-9-41></a><span class=p>}</span>
-</span></code></pre></div> <h4 id=what-problems-it-solves_6>What Problems It Solves<a class=headerlink href=#what-problems-it-solves_6 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Global decoupling:</strong> No direct references between systems</li> <li>✅ <strong>Easy to add events:</strong> Just add to static class</li> <li>✅ <strong>Simple pattern:</strong> Straightforward to implement and understand</li> <li>✅ <strong>No setup:</strong> No DI container or framework needed</li> </ul> <h4 id=what-problems-it-doesnt-solve-well_6>What Problems It Doesn't Solve Well<a class=headerlink href=#what-problems-it-doesnt-solve-well_6 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ <strong>Memory leaks:</strong> Still manual subscribe/unsubscribe (same as C# events)</li> <li>❌ <strong>Global state:</strong> Everything in one bag, hard to organize at scale</li> <li>❌ <strong>Execution order:</strong> Undefined handler invocation order</li> <li>❌ <strong>Testing difficulty:</strong> Global state makes unit testing hard</li> <li>❌ <strong>Naming conflicts:</strong> All events in same namespace, naming gets messy</li> <li>❌ <strong>No validation:</strong> No way to intercept or validate messages</li> <li>❌ <strong>No observability:</strong> Can't see who's subscribed or message history</li> <li>❌ <strong>Ownership unclear:</strong> Who manages what events?</li> <li>❌ <strong>Lifecycle management:</strong> Manual subscribe/unsubscribe required</li> </ul> <h4 id=performance-characteristics_6>Performance Characteristics<a class=headerlink href=#performance-characteristics_6 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Good performance:</strong> Similar to C# events (static overhead is minimal)</li> <li><strong>Zero allocation:</strong> No GC pressure for basic events</li> <li><strong>Use case:</strong> Acceptable for most scenarios</li> </ul> <h4 id=learning-curve_6>Learning Curve<a class=headerlink href=#learning-curve_6 title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>Very easy:</strong> Just a static class with events</li> <li><strong>Immediate productivity:</strong> No new concepts</li> <li><strong>Estimated learning time:</strong> 10 minutes</li> </ul> <h4 id=ease-of-understanding_6>Ease of Understanding<a class=headerlink href=#ease-of-understanding_6 title="Anchor link to this section">&para;</a></h4> <ul> <li>⭐⭐⭐⭐ (Easy initially, hard at scale)</li> <li>Simple pattern to grasp</li> <li>Becomes messy with 20+ events</li> <li>Hard to track ownership and responsibilities</li> </ul> <h4 id=when-static-event-bus-wins>When Static Event Bus Wins<a class=headerlink href=#when-static-event-bus-wins title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ You've already built one and it works</li> <li>✅ Very simple use cases (just need globals)</li> <li>✅ Small projects (&lt;10 events)</li> <li>✅ No framework dependencies desired</li> <li>✅ Quick prototypes</li> </ul> <h4 id=when-dxmessaging-wins_6>When DxMessaging Wins<a class=headerlink href=#when-dxmessaging-wins_6 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ More than 10-15 events (organization becomes important)</li> <li>✅ Memory leaks are a concern (automatic lifecycle management)</li> <li>✅ Execution order matters (priority-based handlers)</li> <li>✅ Need message validation/interception (interceptor pipeline)</li> <li>✅ Testing is important (local buses for isolation)</li> <li>✅ Observability needed (Inspector debugging, message history)</li> <li>✅ Multiple subsystems (namespacing and organization)</li> <li>✅ GameObject/Component targeting needed</li> <li>✅ Global observation needed (listen to all message instances)</li> <li>✅ Post-processing needed (analytics after handlers)</li> <li>✅ Long-term maintenance (structure prevents chaos)</li> </ul> <h4 id=direct-comparison_6>Direct Comparison<a class=headerlink href=#direct-comparison_6 title="Anchor link to this section">&para;</a></h4> <table> <thead> <tr> <th>Aspect</th> <th>Static Event Bus</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Primary Use Case</strong></td> <td>Global event hub</td> <td>Pub/sub messaging</td> </tr> <tr> <td><strong>Unity Compatibility</strong></td> <td>✅ Works in Unity</td> <td>✅ Built for Unity</td> </tr> <tr> <td><strong>Dependencies</strong></td> <td>✅ None (custom)</td> <td>✅ Standalone</td> </tr> <tr> <td><strong>Performance</strong></td> <td>~50ns/call (fast)</td> <td>~60ns/call</td> </tr> <tr> <td><strong>Allocations</strong></td> <td>✅ Zero (basic)</td> <td>✅ Zero (structs)</td> </tr> <tr> <td><strong>Learning Curve</strong></td> <td>⭐⭐⭐⭐⭐ Minimal</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>Setup Complexity</strong></td> <td>⭐⭐⭐⭐⭐ Minimal</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>DI Integration</strong></td> <td>⚠️ Manual</td> <td>⚠️ Optional</td> </tr> <tr> <td><strong>Async/Await</strong></td> <td>⚠️ Manual</td> <td>⚠️ Manual</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>✅ Strong</td> <td>✅ Strong</td> </tr> <tr> <td><strong>Lifecycle Management</strong></td> <td>❌ Manual unsubscribe</td> <td>✅ Automatic</td> </tr> <tr> <td><strong>Execution Order</strong></td> <td>❌ Undefined</td> <td>✅ Priority-based</td> </tr> <tr> <td><strong>GameObject Targeting</strong></td> <td>❌ Not built-in</td> <td>✅ Built-in</td> </tr> <tr> <td><strong>Unity Integration</strong></td> <td>⭐ None</td> <td>⭐⭐⭐⭐⭐ Deep</td> </tr> <tr> <td><strong>Inspector Debugging</strong></td> <td>❌ No</td> <td>✅ History + stats</td> </tr> <tr> <td><strong>Interceptors</strong></td> <td>❌ Not built-in</td> <td>✅ Full pipeline</td> </tr> <tr> <td><strong>Global Observers</strong></td> <td>❌ Not built-in</td> <td>✅ Listen to all</td> </tr> <tr> <td><strong>Post-Processing</strong></td> <td>❌ Not built-in</td> <td>✅ Dedicated stage</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⭐ Hard (global)</td> <td>⭐⭐⭐⭐⭐ Local buses</td> </tr> <tr> <td><strong>Decoupling</strong></td> <td>⭐⭐⭐⭐ Good</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> <tr> <td><strong>Organization</strong></td> <td>⭐⭐ One big class</td> <td>⭐⭐⭐⭐⭐ Structured</td> </tr> </tbody> </table> <p><strong>Bottom Line:</strong> Static event buses solve global access but inherit all the problems of C# events (leaks, undefined order, no observability). DxMessaging provides the same global access with lifecycle safety, structure, and debugging tools.</p> <p><strong>Migration Path:</strong> DxMessaging can replace static event buses gradually:</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=c1>// Old static event bus</span>
-</span><span id=__span-10-2><a id=__codelineno-10-2 name=__codelineno-10-2 href=#__codelineno-10-2></a><span class=n>EventHub</span><span class=p>.</span><span class=n>RaiseDamage</span><span class=p>(</span><span class=mi>5</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><span id=__span-10-4><a id=__codelineno-10-4 name=__codelineno-10-4 href=#__codelineno-10-4></a><span class=c1>// DxMessaging equivalent (global bus)</span>
-</span><span id=__span-10-5><a id=__codelineno-10-5 name=__codelineno-10-5 href=#__codelineno-10-5></a><span class=kt>var</span><span class=w> </span><span class=n>damage</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>TookDamage</span><span class=p>(</span><span class=mi>5</span><span class=p>);</span>
-</span><span id=__span-10-6><a id=__codelineno-10-6 name=__codelineno-10-6 href=#__codelineno-10-6></a><span class=n>damage</span><span class=p>.</span><span class=n>Emit</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><span id=__span-10-8><a id=__codelineno-10-8 name=__codelineno-10-8 href=#__codelineno-10-8></a><span class=c1>// Or use local buses for subsystems</span>
-</span><span id=__span-10-9><a id=__codelineno-10-9 name=__codelineno-10-9 href=#__codelineno-10-9></a><span class=kt>var</span><span class=w> </span><span class=n>combatBus</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-10><a id=__codelineno-10-10 name=__codelineno-10-10 href=#__codelineno-10-10></a><span class=kt>var</span><span class=w> </span><span class=n>combatDamage</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>TookDamage</span><span class=p>(</span><span class=mi>5</span><span class=p>);</span>
-</span><span id=__span-10-11><a id=__codelineno-10-11 name=__codelineno-10-11 href=#__codelineno-10-11></a><span class=n>combatDamage</span><span class=p>.</span><span class=n>Emit</span><span class=p>(</span><span class=n>combatBus</span><span class=p>);</span>
-</span></code></pre></div> <hr> <h2 id=honest-trade-offs-what-you-give-up-what-you-gain>Honest Trade-offs: What You Give Up, What You Gain<a class=headerlink href=#honest-trade-offs-what-you-give-up-what-you-gain title="Anchor link to this section">&para;</a></h2> <p>DxMessaging involves trade-offs like any architectural choice. This section describes what you gain and what you sacrifice when adopting it.</p> <p><strong>Bottom line first:</strong> For game jam prototypes, C# events are faster to write. For projects you'll maintain for months, DxMessaging becomes more valuable as project complexity increases.</p> <h3 id=learning-curve_7>Learning Curve<a class=headerlink href=#learning-curve_7 title="Anchor link to this section">&para;</a></h3> <h4 id=what-you-give-up>What You Give Up<a class=headerlink href=#what-you-give-up title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ <strong>Immediate productivity</strong> - ~1-2 days to feel comfortable (reading docs, trying examples)</li> <li>❌ <strong>Familiarity</strong> - Your team knows C# events already; DxMessaging is new</li> <li>❌ <strong>"Just works" intuition</strong> - You need to think: "Which message type? What priority?"</li> </ul> <p>Your first message will take 15 minutes. By the 10<sup>th</sup> message, you'll be faster than with events.</p> <h4 id=what-you-gain>What You Gain<a class=headerlink href=#what-you-gain title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Long-term velocity</strong> - Adding new features doesn't require touching 5 existing systems</li> <li>✅ <strong>Debugging is faster</strong> - Inspector shows "what fired when" instantly</li> <li>✅ <strong>Onboarding is easier</strong> - New devs see explicit message contracts, not hidden event chains</li> </ul> <p><strong>Example:</strong> Junior dev asks "How does damage work?"</p> <ul> <li><strong>C# events:</strong> "Uh, Player has an OnDamaged event, and HealthBar subscribes in line 47, and..."</li> <li><strong>DxMessaging:</strong> "Search for <code>TookDamage</code> message, see who emits it and who listens."</li> </ul> <h5 id=verdict>Verdict<a class=headerlink href=#verdict title="Anchor link to this section">&para;</a></h5> <ul> <li>Game jam (1 week project): Learning curve not worth it → Stick with C# events</li> <li>Mid-size game (1+ month): Pays off by week 2</li> <li>Large game (6+ months): Highly beneficial</li> </ul> <h3 id=boilerplate>Boilerplate<a class=headerlink href=#boilerplate title="Anchor link to this section">&para;</a></h3> <h4 id=what-you-give-up_1>What You Give Up<a class=headerlink href=#what-you-give-up_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ "One-liners" - C# events can be <code>public event Action OnClick;</code> done</li> <li>❌ Quick and dirty - Need to define message struct, attributes, handler registration</li> </ul> <h4 id=what-you-gain_1>What You Gain<a class=headerlink href=#what-you-gain_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Explicit contracts - Messages are discoverable types, not hidden delegates</li> <li>✅ Auto-generated code - <code>[DxAutoConstructor]</code> reduces boilerplate</li> <li>✅ Compile-time safety - Refactors update all usages</li> </ul> <h4 id=example-comparison>Example Comparison<a class=headerlink href=#example-comparison title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-11-1><a id=__codelineno-11-1 name=__codelineno-11-1 href=#__codelineno-11-1></a><span class=c1>// C# Event (minimal boilerplate)</span>
-</span><span id=__span-11-2><a id=__codelineno-11-2 name=__codelineno-11-2 href=#__codelineno-11-2></a><span class=k>public</span><span class=w> </span><span class=k>event</span><span class=w> </span><span class=n>Action</span><span class=o>&lt;</span><span class=kt>int</span><span class=o>&gt;</span><span class=w> </span><span class=n>OnDamage</span><span class=p>;</span>
-</span><span id=__span-11-3><a id=__codelineno-11-3 name=__codelineno-11-3 href=#__codelineno-11-3></a><span class=n>OnDamage</span><span class=o>?.</span><span class=n>Invoke</span><span class=p>(</span><span class=mi>5</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><span id=__span-11-5><a id=__codelineno-11-5 name=__codelineno-11-5 href=#__codelineno-11-5></a><span class=c1>// DxMessaging (more upfront definition)</span>
-</span><span id=__span-11-6><a id=__codelineno-11-6 name=__codelineno-11-6 href=#__codelineno-11-6></a><span class=na>[DxBroadcastMessage]</span>
-</span><span id=__span-11-7><a id=__codelineno-11-7 name=__codelineno-11-7 href=#__codelineno-11-7></a><span class=na>[DxAutoConstructor]</span>
-</span><span id=__span-11-8><a id=__codelineno-11-8 name=__codelineno-11-8 href=#__codelineno-11-8></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>TookDamage</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span><span class=w> </span><span class=p>}</span>
-</span><span id=__span-11-9><a id=__codelineno-11-9 name=__codelineno-11-9 href=#__codelineno-11-9></a>
-</span><span id=__span-11-10><a id=__codelineno-11-10 name=__codelineno-11-10 href=#__codelineno-11-10></a><span class=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>TookDamage</span><span class=p>(</span><span class=mi>5</span><span class=p>);</span>
-</span><span id=__span-11-11><a id=__codelineno-11-11 name=__codelineno-11-11 href=#__codelineno-11-11></a><span class=n>msg</span><span class=p>.</span><span class=n>EmitGameObjectBroadcast</span><span class=p>(</span><span class=n>gameObject</span><span class=p>);</span>
-</span></code></pre></div> <p><strong>Verdict:</strong> For 1-3 simple events, C# events win on brevity. For 10+ events with complex flows, DxMessaging's structure pays dividends.</p> <h3 id=performance>Performance<a class=headerlink href=#performance title="Anchor link to this section">&para;</a></h3> <h4 id=what-you-give-up_2>What You Give Up<a class=headerlink href=#what-you-give-up_2 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ Absolute minimal overhead - Raw C# events/delegates are faster (~10ns per call)</li> <li>❌ Zero abstraction cost - Direct calls can be inlined by the compiler</li> <li>❌ Simplicity in profiler - One extra layer in call stack</li> </ul> <h4 id=what-you-gain_2>What You Gain<a class=headerlink href=#what-you-gain_2 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Zero-allocation struct messages - No GC pressure from boxing</li> <li>✅ Predictable performance - No hidden allocations from lambdas</li> <li>✅ Scalable diagnostics - Built-in profiling/logging without custom instrumentation</li> </ul> <h4 id=hard-numbers>Hard Numbers<a class=headerlink href=#hard-numbers title="Anchor link to this section">&para;</a></h4> <ul> <li>C# event invoke: ~50ns baseline</li> <li>DxMessaging handler: ~60ns (~10ns overhead)</li> <li>Memory: Zero allocations for struct messages</li> </ul> <p><strong>Verdict:</strong> For UI, gameplay events, scene management → DxMessaging overhead is negligible. For ECS architectures processing millions of events per frame → consider raw delegates or native code, which are better suited for that specific use case.</p> <h3 id=flexibility>Flexibility<a class=headerlink href=#flexibility title="Anchor link to this section">&para;</a></h3> <h4 id=what-you-give-up_3>What You Give Up<a class=headerlink href=#what-you-give-up_3 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ Return values - DxMessaging is fire-and-forget (no synchronous responses)</li> <li>❌ Out parameters - Can't use <code>out</code> or <code>ref</code> for bidirectional communication</li> <li>❌ Dynamic subscriptions - Can't easily pass lambdas inline</li> </ul> <h4 id=what-you-gain_3>What You Gain<a class=headerlink href=#what-you-gain_3 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Interception - Validate/transform messages before handlers</li> <li>✅ Post-processing - Analytics/logging without polluting handlers</li> <li>✅ Priority control - Explicit execution order</li> <li>✅ Context - Always know who sent/received</li> </ul> <h4 id=when-limitations-hurt>When Limitations Hurt<a class=headerlink href=#when-limitations-hurt title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-12-1><a id=__codelineno-12-1 name=__codelineno-12-1 href=#__codelineno-12-1></a><span class=c1>// C# events can return values (DxMessaging can&#39;t)</span>
-</span><span id=__span-12-2><a id=__codelineno-12-2 name=__codelineno-12-2 href=#__codelineno-12-2></a><span class=k>public</span><span class=w> </span><span class=k>delegate</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=nf>DamageValidator</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><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=k>public</span><span class=w> </span><span class=k>event</span><span class=w> </span><span class=n>DamageValidator</span><span class=w> </span><span class=n>OnValidateDamage</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><span id=__span-12-5><a id=__codelineno-12-5 name=__codelineno-12-5 href=#__codelineno-12-5></a><span class=k>if</span><span class=w> </span><span class=p>(</span><span class=n>OnValidateDamage</span><span class=o>?.</span><span class=n>Invoke</span><span class=p>(</span><span class=n>damage</span><span class=p>)</span><span class=w> </span><span class=o>==</span><span class=w> </span><span class=k>true</span><span class=p>)</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-12-6><a id=__codelineno-12-6 name=__codelineno-12-6 href=#__codelineno-12-6></a><span class=w>    </span><span class=c1>// Allowed</span>
-</span><span id=__span-12-7><a id=__codelineno-12-7 name=__codelineno-12-7 href=#__codelineno-12-7></a><span class=p>}</span>
-</span><span id=__span-12-8><a id=__codelineno-12-8 name=__codelineno-12-8 href=#__codelineno-12-8></a>
-</span><span id=__span-12-9><a id=__codelineno-12-9 name=__codelineno-12-9 href=#__codelineno-12-9></a><span class=c1>// DxMessaging workaround: Use interceptors or separate query pattern</span>
-</span></code></pre></div> <p><strong>Verdict:</strong> If you need synchronous request/response, C# delegates/events or direct method calls are better. DxMessaging is designed for notifications and commands.</p> <h3 id=debuggability>Debuggability<a class=headerlink href=#debuggability title="Anchor link to this section">&para;</a></h3> <h4 id=what-you-give-up_4>What You Give Up<a class=headerlink href=#what-you-give-up_4 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ Simplicity - Stack traces show message bus internals</li> <li>❌ Step-through - Can't F11 directly from emit to handler (need breakpoints)</li> </ul> <h4 id=what-you-gain_4>What You Gain<a class=headerlink href=#what-you-gain_4 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Message history - See last N messages in Inspector</li> <li>✅ Registration view - Know exactly who's listening</li> <li>✅ Global observability - Track all messages without instrumenting code</li> <li>✅ Filtering - Intercept messages for debugging without changing code</li> </ul> <h4 id=example-finding-who-fired-a-message>Example: Finding Who Fired a Message<a class=headerlink href=#example-finding-who-fired-a-message title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-13-1><a id=__codelineno-13-1 name=__codelineno-13-1 href=#__codelineno-13-1></a><span class=c1>// C# events: Set breakpoint on every possible Invoke(), or add logging everywhere</span>
-</span><span id=__span-13-2><a id=__codelineno-13-2 name=__codelineno-13-2 href=#__codelineno-13-2></a><span class=n>OnDamage</span><span class=o>?.</span><span class=n>Invoke</span><span class=p>(</span><span class=mi>5</span><span class=p>);</span><span class=w> </span><span class=c1>// Where did this come from??</span>
-</span><span id=__span-13-3><a id=__codelineno-13-3 name=__codelineno-13-3 href=#__codelineno-13-3></a>
-</span><span id=__span-13-4><a id=__codelineno-13-4 name=__codelineno-13-4 href=#__codelineno-13-4></a><span class=c1>// DxMessaging: Check Inspector message history or add global logger</span>
-</span><span id=__span-13-5><a id=__codelineno-13-5 name=__codelineno-13-5 href=#__codelineno-13-5></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>debugToken</span><span class=p>.</span><span class=n>RegisterBroadcastWithoutSource</span><span class=o>&lt;</span><span class=n>TookDamage</span><span class=o>&gt;</span><span class=p>(</span>
-</span><span id=__span-13-6><a id=__codelineno-13-6 name=__codelineno-13-6 href=#__codelineno-13-6></a><span class=w>    </span><span class=p>(</span><span class=n>src</span><span class=p>,</span><span class=w> </span><span class=n>msg</span><span class=p>)</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=n>Debug</span><span class=p>.</span><span class=n>Log</span><span class=p>(</span><span class=s>$&quot;Damage from {src}: {msg.amount}&quot;</span><span class=p>)</span>
-</span><span id=__span-13-7><a id=__codelineno-13-7 name=__codelineno-13-7 href=#__codelineno-13-7></a><span class=p>);</span>
-</span></code></pre></div> <p><strong>Verdict:</strong> Initial debugging is slightly harder (extra layer), but systemic debugging is easier (observability tools).</p> <h3 id=coupling-and-architecture>Coupling and Architecture<a class=headerlink href=#coupling-and-architecture title="Anchor link to this section">&para;</a></h3> <h4 id=what-you-give-up_5>What You Give Up<a class=headerlink href=#what-you-give-up_5 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ Quick hacks - Can't just <code>GetComponent&lt;T&gt;().DoThing()</code> anymore</li> <li>❌ Direct inspector wiring - Can't drag-and-drop references to emit messages</li> </ul> <h4 id=what-you-gain_5>What You Gain<a class=headerlink href=#what-you-gain_5 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ True decoupling - Systems don't know about each other</li> <li>✅ Testability - Easy to isolate with local buses</li> <li>✅ Refactorability - Move/rename components without breaking wiring</li> </ul> <h4 id=impact-on-architecture>Impact on Architecture<a class=headerlink href=#impact-on-architecture title="Anchor link to this section">&para;</a></h4> <p>Before (tight coupling):</p> <div class="language-text highlight"><span class=filename>Text Only</span><pre><span></span><code><span id=__span-14-1><a id=__codelineno-14-1 name=__codelineno-14-1 href=#__codelineno-14-1></a>UI → References 15 systems
-</span><span id=__span-14-2><a id=__codelineno-14-2 name=__codelineno-14-2 href=#__codelineno-14-2></a>System A → References System B, C, D
-</span><span id=__span-14-3><a id=__codelineno-14-3 name=__codelineno-14-3 href=#__codelineno-14-3></a>Every change ripples through dependencies
-</span></code></pre></div> <p>After (loose coupling):</p> <div class="language-text highlight"><span class=filename>Text Only</span><pre><span></span><code><span id=__span-15-1><a id=__codelineno-15-1 name=__codelineno-15-1 href=#__codelineno-15-1></a>All systems → Emit messages
-</span><span id=__span-15-2><a id=__codelineno-15-2 name=__codelineno-15-2 href=#__codelineno-15-2></a>All systems → Listen to messages
-</span><span id=__span-15-3><a id=__codelineno-15-3 name=__codelineno-15-3 href=#__codelineno-15-3></a>Add/remove systems without affecting others
-</span></code></pre></div> <p><strong>Verdict:</strong> If your project is &lt;5k lines, tight coupling is manageable. For larger projects, DxMessaging's decoupling significantly improves maintainability.</p> <h3 id=testing>Testing<a class=headerlink href=#testing title="Anchor link to this section">&para;</a></h3> <h4 id=what-you-give-up_6>What You Give Up<a class=headerlink href=#what-you-give-up_6 title="Anchor link to this section">&para;</a></h4> <ul> <li>❌ Simplicity - Can't just mock an event subscription</li> </ul> <h4 id=what-you-gain_6>What You Gain<a class=headerlink href=#what-you-gain_6 title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Isolation - Local buses per test, zero global state</li> <li>✅ Observability - Count messages, inspect payloads easily</li> <li>✅ Determinism - Priority-based ordering eliminates flakiness</li> </ul> <h5 id=example>Example<a class=headerlink href=#example title="Anchor link to this section">&para;</a></h5> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-16-1><a id=__codelineno-16-1 name=__codelineno-16-1 href=#__codelineno-16-1></a><span class=c1>// Test with isolated bus</span>
-</span><span id=__span-16-2><a id=__codelineno-16-2 name=__codelineno-16-2 href=#__codelineno-16-2></a><span class=na>[Test]</span>
-</span><span id=__span-16-3><a id=__codelineno-16-3 name=__codelineno-16-3 href=#__codelineno-16-3></a><span class=k>public</span><span class=w> </span><span class=k>void</span><span class=w> </span><span class=nf>TestAchievementSystem</span><span class=p>()</span><span class=w> </span><span class=p>{</span>
-</span><span id=__span-16-4><a id=__codelineno-16-4 name=__codelineno-16-4 href=#__codelineno-16-4></a><span class=w>    </span><span class=kt>var</span><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-16-5><a id=__codelineno-16-5 name=__codelineno-16-5 href=#__codelineno-16-5></a><span class=w>    </span><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>achievementHandler</span><span class=p>,</span><span class=w> </span><span class=n>testBus</span><span class=p>);</span>
-</span><span id=__span-16-6><a id=__codelineno-16-6 name=__codelineno-16-6 href=#__codelineno-16-6></a>
-</span><span id=__span-16-7><a id=__codelineno-16-7 name=__codelineno-16-7 href=#__codelineno-16-7></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>EnemyKilled</span><span class=p>(</span><span class=s>&quot;Boss&quot;</span><span class=p>,</span><span class=w> </span><span class=mi>10</span><span class=p>);</span>
-</span><span id=__span-16-8><a id=__codelineno-16-8 name=__codelineno-16-8 href=#__codelineno-16-8></a><span class=w>    </span><span class=n>msg</span><span class=p>.</span><span class=n>EmitGameObjectBroadcast</span><span class=p>(</span><span class=n>enemy</span><span class=p>,</span><span class=w> </span><span class=n>testBus</span><span class=p>);</span>
-</span><span id=__span-16-9><a id=__codelineno-16-9 name=__codelineno-16-9 href=#__codelineno-16-9></a>
-</span><span id=__span-16-10><a id=__codelineno-16-10 name=__codelineno-16-10 href=#__codelineno-16-10></a><span class=w>    </span><span class=n>Assert</span><span class=p>.</span><span class=n>IsTrue</span><span class=p>(</span><span class=n>achievementSystem</span><span class=p>.</span><span class=n>Unlocked</span><span class=p>(</span><span class=s>&quot;BossSlayer&quot;</span><span class=p>));</span>
-</span><span id=__span-16-11><a id=__codelineno-16-11 name=__codelineno-16-11 href=#__codelineno-16-11></a><span class=p>}</span>
-</span></code></pre></div> <p><strong>Verdict:</strong> DxMessaging makes integration testing easier, unit testing slightly more verbose.</p> <h2 id=feature-by-feature-comparison-matrix>Feature-by-Feature Comparison Matrix<a class=headerlink href=#feature-by-feature-comparison-matrix title="Anchor link to this section">&para;</a></h2> <h3 id=unity-messaging-frameworks-comparison>Unity Messaging Frameworks Comparison<a class=headerlink href=#unity-messaging-frameworks-comparison title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Aspect</th> <th>DxMessaging</th> <th>UniRx</th> <th>MessagePipe</th> <th>Zenject Signals</th> </tr> </thead> <tbody> <tr> <td><strong>Primary Use Case</strong></td> <td>Pub/sub messaging</td> <td>Stream transformations</td> <td>High-perf DI messaging</td> <td>DI-integrated messaging</td> </tr> <tr> <td><strong>Unity Compatibility</strong></td> <td>✅ Built for Unity</td> <td>✅ Built for Unity</td> <td>✅ Built for Unity</td> <td>✅ Built for Unity</td> </tr> <tr> <td><strong>Performance</strong></td> <td>⭐⭐⭐⭐ Good (14M)</td> <td>⭐⭐⭐⭐ Good (18M)</td> <td>⭐⭐⭐⭐⭐ Best (97M)</td> <td>⭐⭐ Moderate (2.5M)</td> </tr> <tr> <td><strong>Zero Allocations</strong></td> <td>✅ Yes (structs)</td> <td>⚠️ Can allocate</td> <td>✅ Yes (structs)</td> <td>⚠️ Can allocate</td> </tr> <tr> <td><strong>Unity Integration</strong></td> <td>⭐⭐⭐⭐⭐ Deep (lifecycle)</td> <td>⭐⭐⭐⭐ Good (UI/async)</td> <td>⭐⭐⭐ Basic (no lifecycle)</td> <td>⭐⭐⭐⭐ Good (DI-managed)</td> </tr> <tr> <td><strong>Inspector Debugging</strong></td> <td>✅ Yes (history + stats)</td> <td>❌ No</td> <td>❌ No</td> <td>❌ No</td> </tr> <tr> <td><strong>Execution Order</strong></td> <td>✅ Priority-based</td> <td>❌ Not built-in</td> <td>❌ Subscription order</td> <td>❌ Not built-in</td> </tr> <tr> <td><strong>Lifecycle Management</strong></td> <td>✅ Automatic (MonoBehaviour)</td> <td>⚠️ Manual dispose</td> <td>⚠️ Manual dispose</td> <td>⚠️ DI-managed</td> </tr> <tr> <td><strong>Learning Curve</strong></td> <td>⭐⭐⭐ Moderate</td> <td>⭐⭐ Steep (Rx paradigm)</td> <td>⭐⭐⭐⭐ Moderate (DI)</td> <td>⭐⭐ Steep (DI+Signals)</td> </tr> <tr> <td><strong>Setup Complexity</strong></td> <td>⭐⭐⭐⭐⭐ Plug-and-play</td> <td>⭐⭐⭐⭐⭐ Low</td> <td>⭐⭐⭐ DI setup required</td> <td>⭐⭐ Installers required</td> </tr> <tr> <td><strong>DI Integration</strong></td> <td>⚠️ Optional</td> <td>⚠️ Optional</td> <td>✅ First-class</td> <td>✅ Required (Zenject)</td> </tr> <tr> <td><strong>Async/Await</strong></td> <td>⚠️ Manual</td> <td>✅ Native (observables)</td> <td>✅ Native</td> <td>✅ Yes</td> </tr> <tr> <td><strong>Message Validation</strong></td> <td>✅ Interceptor pipeline</td> <td>❌ Not built-in</td> <td>⚠️ Filters (middleware)</td> <td>❌ Not built-in</td> </tr> <tr> <td><strong>GameObject Targeting</strong></td> <td>✅ Built-in</td> <td>❌ Not designed for</td> <td>❌ Not built-in</td> <td>❌ Not built-in</td> </tr> <tr> <td><strong>Global Observers</strong></td> <td>✅ Listen to all sources</td> <td>❌ Not built-in</td> <td>❌ Not built-in</td> <td>❌ Not built-in</td> </tr> <tr> <td><strong>Post-Processing</strong></td> <td>✅ Dedicated stage</td> <td>❌ Not built-in</td> <td>⚠️ Via filters</td> <td>❌ Not built-in</td> </tr> <tr> <td><strong>Stream Operators</strong></td> <td>❌ Not built-in</td> <td>✅ Extensive (LINQ)</td> <td>❌ Not built-in</td> <td>⚠️ With UniRx</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⭐⭐⭐⭐⭐ Local buses</td> <td>⭐⭐⭐⭐ Good</td> <td>⭐⭐⭐⭐⭐ DI mocking</td> <td>⭐⭐⭐⭐⭐ DI mocking</td> </tr> <tr> <td><strong>Decoupling</strong></td> <td>⭐⭐⭐⭐⭐ Excellent</td> <td>⭐⭐⭐⭐⭐ Excellent</td> <td>⭐⭐⭐⭐⭐ Excellent</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>⭐⭐⭐⭐⭐ Strong</td> <td>⭐⭐⭐⭐⭐ Strong</td> <td>⭐⭐⭐⭐⭐ Strong</td> <td>⭐⭐⭐⭐⭐ Strong</td> </tr> <tr> <td><strong>Dependencies</strong></td> <td>✅ None</td> <td>✅ None</td> <td>⚠️ MessagePipe package</td> <td>❌ Zenject required</td> </tr> </tbody> </table> <h3 id=traditional-approaches-comparison>Traditional Approaches Comparison<a class=headerlink href=#traditional-approaches-comparison title="Anchor link to this section">&para;</a></h3> <table> <thead> <tr> <th>Aspect</th> <th>C# Events</th> <th>UnityEvents</th> <th>SOA (GameEvent)</th> <th>Static Bus</th> <th>DxMessaging</th> </tr> </thead> <tbody> <tr> <td><strong>Setup Complexity</strong></td> <td>⭐⭐⭐⭐⭐ Minimal</td> <td>⭐⭐⭐⭐ Simple</td> <td>⭐⭐ Asset creation</td> <td>⭐⭐⭐ Moderate</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>Boilerplate</strong></td> <td>⭐⭐⭐⭐⭐ Low</td> <td>⭐⭐⭐⭐⭐ Low</td> <td>⭐⭐ High</td> <td>⭐⭐⭐ Medium</td> <td>⭐⭐⭐ Medium</td> </tr> <tr> <td><strong>Performance</strong></td> <td>⭐⭐⭐⭐⭐ Fastest</td> <td>⭐⭐ Slow (boxing)</td> <td>⭐⭐⭐ Moderate</td> <td>⭐⭐⭐⭐ Fast</td> <td>⭐⭐⭐⭐ Fast</td> </tr> <tr> <td><strong>Decoupling</strong></td> <td>⭐ Tight</td> <td>⭐⭐ Hidden</td> <td>⭐⭐⭐⭐ Good</td> <td>⭐⭐⭐⭐ Good</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> <tr> <td><strong>Designer Control</strong></td> <td>⭐ None</td> <td>⭐⭐⭐⭐⭐ High</td> <td>⭐⭐⭐⭐⭐ High</td> <td>⭐ None</td> <td>⭐ None</td> </tr> <tr> <td><strong>Lifecycle Safety</strong></td> <td>⭐ Manual</td> <td>⭐⭐⭐ Unity-managed</td> <td>⭐⭐ Manual persist</td> <td>⭐ Manual</td> <td>⭐⭐⭐⭐⭐ Automatic</td> </tr> <tr> <td><strong>Observability</strong></td> <td>⭐ None</td> <td>⭐ None</td> <td>⭐ Inspector only</td> <td>⭐ None</td> <td>⭐⭐⭐⭐⭐ Built-in</td> </tr> <tr> <td><strong>Execution Order</strong></td> <td>⭐ Undefined</td> <td>⭐ Undefined</td> <td>⭐ Undefined</td> <td>⭐ Undefined</td> <td>⭐⭐⭐⭐⭐ Priority-based</td> </tr> <tr> <td><strong>Type Safety</strong></td> <td>⭐⭐⭐⭐⭐ Strong</td> <td>⭐⭐ Weak</td> <td>⭐⭐⭐ Mixed</td> <td>⭐⭐⭐ Varies</td> <td>⭐⭐⭐⭐⭐ Strong</td> </tr> <tr> <td><strong>Testability</strong></td> <td>⭐⭐ Hard</td> <td>⭐⭐ Hard</td> <td>⭐ Very Hard</td> <td>⭐ Very Hard</td> <td>⭐⭐⭐⭐⭐ Easy</td> </tr> <tr> <td><strong>Learning Curve</strong></td> <td>⭐⭐⭐⭐⭐ Minimal</td> <td>⭐⭐⭐⭐⭐ Minimal</td> <td>⭐⭐⭐ Moderate</td> <td>⭐⭐⭐⭐ Low</td> <td>⭐⭐⭐ Moderate</td> </tr> <tr> <td><strong>Memory Safety</strong></td> <td>⭐ Leak-prone</td> <td>⭐⭐⭐ Unity-managed</td> <td>⭐⭐ Asset persist</td> <td>⭐ Leak-prone</td> <td>⭐⭐⭐⭐⭐ Leak-free</td> </tr> <tr> <td><strong>Debugging</strong></td> <td>⭐⭐ Hard at scale</td> <td>⭐⭐ Hard at scale</td> <td>⭐⭐ Inspector-only</td> <td>⭐ Very Hard</td> <td>⭐⭐⭐⭐⭐ Excellent</td> </tr> </tbody> </table> <h3 id=overall-verdict-by-use-case>Overall Verdict by Use Case<a class=headerlink href=#overall-verdict-by-use-case title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>Small prototype/jam:</strong> C# Events or UnityEvents win (simplicity &gt; all)</li> <li><strong>Mid-size game (5-20k lines):</strong> DxMessaging starts paying off (decoupling, debugging)</li> <li><strong>Large game (20k+ lines):</strong> DxMessaging essential for maintainability</li> <li><strong>Designer-driven workflow:</strong> SOA has value (Inspector wiring) but consider maintenance costs</li> <li><strong>Legacy SOA project:</strong> Use Pattern B (keep SOs for configs, migrate events to DxMessaging)</li> <li><strong>Performance-critical (millions of messages/frame):</strong> MessagePipe offers the highest throughput</li> <li><strong>Performance-critical (Unity-specific):</strong> DxMessaging (strong performance + Unity integration)</li> <li><strong>UI-heavy:</strong> DxMessaging provides decoupled updates and global observers for UI state</li> <li><strong>Complex event transformations:</strong> UniRx provides reactive stream operators</li> <li><strong>DI-first architecture:</strong> MessagePipe or Zenject Signals win (DI integration)</li> <li><strong>Analytics/diagnostics heavy:</strong> DxMessaging provides built-in support (global observers, post-processors, Inspector)</li> <li><strong>Need execution control:</strong> DxMessaging offers priorities, interceptors, and ordered stages</li> </ul> <h2 id=when-each-approach-actually-wins>When Each Approach ACTUALLY Wins<a class=headerlink href=#when-each-approach-actually-wins title="Anchor link to this section">&para;</a></h2> <h3 id=dxmessaging-wins-when>DxMessaging Wins When<a class=headerlink href=#dxmessaging-wins-when title="Anchor link to this section">&para;</a></h3> <ul> <li>✅ Unity-first projects (MonoBehaviour lifecycle integration)</li> <li>✅ 10+ systems that communicate (pub/sub decoupling)</li> <li>✅ Observability essential (Inspector debugging, message history)</li> <li>✅ Memory leaks are a concern (automatic lifecycle management)</li> <li>✅ Cross-team development (clear message contracts)</li> <li>✅ Long-term maintenance (years, not weeks)</li> <li>✅ GameObject/Component targeting needed (Unity-specific patterns)</li> <li>✅ Execution order control essential (priority-based handlers)</li> <li>✅ Message validation/transformation needed (interceptor pipeline)</li> <li>✅ Global observation needed (listen to all message instances)</li> <li>✅ Post-processing needed (analytics, logging after handlers)</li> <li>✅ Late update semantics needed (timing-specific processing)</li> <li>✅ Teams without DI experience (no framework dependencies)</li> <li>✅ Want plug-and-play solution (zero dependencies, immediate use)</li> </ul> <h3 id=unirx-wins-when>UniRx Wins When<a class=headerlink href=#unirx-wins-when title="Anchor link to this section">&para;</a></h3> <ul> <li>✅ Simple pub/sub with minimal setup (MessageBroker is straightforward)</li> <li>✅ Complex event stream transformations needed</li> <li>✅ Time-based operations (throttle, debounce, buffer)</li> <li>✅ Combining multiple input sources</li> <li>✅ Reactive UI data binding</li> <li>✅ Team familiar with reactive programming</li> <li>✅ Need LINQ-style query operators on events</li> <li>✅ Async operations with cancellation and composition</li> </ul> <h3 id=messagepipe-wins-when>MessagePipe Wins When<a class=headerlink href=#messagepipe-wins-when title="Anchor link to this section">&para;</a></h3> <ul> <li>✅ Performance is THE priority (highest throughput)</li> <li>✅ Already using DI (VContainer, Zenject, etc.)</li> <li>✅ Cross-platform .NET projects (not Unity-only)</li> <li>✅ Need native async/await support</li> <li>✅ Large-scale projects with DI architecture</li> <li>✅ Want compile-time leak detection (Roslyn analyzer)</li> <li>✅ High message frequency (thousands/frame)</li> </ul> <h3 id=zenject-signals-win-when>Zenject Signals Win When<a class=headerlink href=#zenject-signals-win-when title="Anchor link to this section">&para;</a></h3> <ul> <li>✅ Already using Zenject for dependency injection</li> <li>✅ Testability through DI is critical</li> <li>✅ Need subscriber validation (ensure handlers exist)</li> <li>✅ Team experienced with Zenject</li> <li>✅ Want DI-managed lifecycle</li> <li>✅ Integration with existing Zenject architecture</li> </ul> <h3 id=c-events-win-when>C# Events Win When<a class=headerlink href=#c-events-win-when title="Anchor link to this section">&para;</a></h3> <ul> <li>✅ You need return values or out parameters</li> <li>✅ Writing a library (DxMessaging is Unity-specific)</li> <li>✅ Small, stable scope (5-10 events max)</li> <li>✅ Team is C# experts, Unity beginners</li> </ul> <h3 id=unityevents-win-when>UnityEvents Win When<a class=headerlink href=#unityevents-win-when title="Anchor link to this section">&para;</a></h3> <ul> <li>✅ Designers need to wire logic without code</li> <li>✅ Rapid prototyping with prefabs</li> <li>✅ Very simple games (mobile casual, hyper-casual)</li> </ul> <h3 id=soa-gameeventvariables-wins-when>SOA (GameEvent/Variables) Wins When<a class=headerlink href=#soa-gameeventvariables-wins-when title="Anchor link to this section">&para;</a></h3> <ul> <li>✅ Designers must create and wire events without touching code</li> <li>✅ Team is already heavily invested in SOA with many existing assets</li> <li>✅ Designer empowerment is the absolute top priority</li> <li>⚠️ <strong>BUT:</strong> Consider migration costs and maintainability issues (see <a href=https://github.com/cathei/AntiScriptableObjectArchitecture>Anti-SOA critique</a>)</li> <li>⚠️ <strong>Alternative:</strong> Use ScriptableObjects for configs only + DxMessaging for events (Pattern B in <a href=../../guides/patterns/#14-compatibility-with-scriptable-object-architecture-soa>SOA Guide</a>)</li> </ul> <h3 id=static-event-bus-wins-when>Static Event Bus Wins When<a class=headerlink href=#static-event-bus-wins-when title="Anchor link to this section">&para;</a></h3> <ul> <li>✅ You've already built one and it works</li> <li>✅ Very simple use cases (just need globals)</li> </ul> <h2 id=cost-benefit-summary>Cost-Benefit Summary<a class=headerlink href=#cost-benefit-summary title="Anchor link to this section">&para;</a></h2> <h3 id=costs>Costs<a class=headerlink href=#costs title="Anchor link to this section">&para;</a></h3> <ol> <li>Learning curve (~1-2 days to feel comfortable)</li> <li>More upfront code (message definitions)</li> <li>Slightly slower than raw C# events (~10ns/call)</li> <li>Can't return values (fire-and-forget only)</li> </ol> <h3 id=benefits>Benefits<a class=headerlink href=#benefits title="Anchor link to this section">&para;</a></h3> <ol> <li>Automatic lifecycle prevents common memory leaks</li> <li>Full decoupling (systems don't reference each other)</li> <li>Observability (Inspector diagnostics, message history)</li> <li>Predictable ordering (priority-based execution)</li> <li>Interception/validation (before handlers run)</li> <li>Testability (isolated buses)</li> </ol> <p><strong>Break-even point:</strong> Usually around 10-20 hours into a project, when event management becomes painful.</p> <h2 id=making-the-decision-be-honest-with-yourself>Making the Decision (Be Honest With Yourself)<a class=headerlink href=#making-the-decision-be-honest-with-yourself title="Anchor link to this section">&para;</a></h2> <h3 id=answer-these-questions-honestly>Answer these questions honestly<a class=headerlink href=#answer-these-questions-honestly title="Anchor link to this section">&para;</a></h3> <h3 id=1-project-lifespan>1. Project Lifespan?<a class=headerlink href=#1-project-lifespan title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>&lt;1 week (game jam):</strong> Skip DxMessaging → Use C# events or direct calls</li> <li><strong>1-4 weeks (prototype):</strong> Maybe → If you plan to continue, use DxMessaging</li> <li><strong>1+ months (real project):</strong> Yes → DxMessaging will save you time</li> <li><strong>6+ months (production):</strong> Absolutely → You'll thank yourself later</li> </ul> <h3 id=2-team-size>2. Team Size?<a class=headerlink href=#2-team-size title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>Solo dev:</strong> Optional → Depends on project complexity</li> <li><strong>2-3 devs:</strong> Valuable → Reduces communication overhead</li> <li><strong>4+ devs:</strong> Highly recommended → Clear contracts between systems</li> <li><strong>Remote/distributed team:</strong> Essential → Explicit message contracts prevent miscommunication</li> </ul> <h3 id=3-codebase-size>3. Codebase Size?<a class=headerlink href=#3-codebase-size title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>&lt;1k lines:</strong> Skip it → Direct method calls are fine</li> <li><strong>1k-5k lines:</strong> Consider it → If you're growing fast</li> <li><strong>5k-20k lines:</strong> Recommended → Coupling becomes painful</li> <li><strong>20k+ lines:</strong> Absolutely → Refactoring becomes significantly more challenging without it</li> </ul> <h3 id=4-how-many-systems-need-to-communicate>4. How Many Systems Need to Communicate?<a class=headerlink href=#4-how-many-systems-need-to-communicate title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>1-2 systems:</strong> Skip → Just call methods directly</li> <li><strong>3-5 systems:</strong> Consider → If they don't share references</li> <li><strong>6-10 systems:</strong> Recommended → Coupling becomes unmanageable</li> <li><strong>10+ systems:</strong> Essential → Managing many SerializeField references becomes difficult</li> </ul> <h3 id=5-have-you-had-memory-leaks-from-forgotten-unsubscribes>5. Have You Had Memory Leaks From Forgotten Unsubscribes?<a class=headerlink href=#5-have-you-had-memory-leaks-from-forgotten-unsubscribes title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>Never:</strong> Optional → You may not need automatic lifecycle management</li> <li><strong>Once or twice:</strong> Consider it → Prevention is cheaper than debugging</li> <li><strong>Multiple times:</strong> Recommended → Automatic cleanup would help</li> <li><strong>Currently debugging one:</strong> Strongly recommended → Consider adopting DxMessaging</li> </ul> <h3 id=6-how-often-do-you-debug-what-fired-when>6. How Often Do You Debug "What Fired When?"<a class=headerlink href=#6-how-often-do-you-debug-what-fired-when title="Anchor link to this section">&para;</a></h3> <ul> <li><strong>Never:</strong> Likely not needed → Small projects may not require message debugging tools</li> <li><strong>Rarely:</strong> Optional, but would help</li> <li><strong>Monthly:</strong> Recommended → Inspector diagnostics will save hours</li> <li><strong>Weekly:</strong> Strongly recommended → Debugging tools would provide significant time savings</li> </ul> <h3 id=quick-decision-matrix>Quick Decision Matrix<a class=headerlink href=#quick-decision-matrix title="Anchor link to this section">&para;</a></h3> <div class="language-text highlight"><span class=filename>Text Only</span><pre><span></span><code><span id=__span-17-1><a id=__codelineno-17-1 name=__codelineno-17-1 href=#__codelineno-17-1></a>Game Jam         → C# Events (speed over safety)
-</span><span id=__span-17-2><a id=__codelineno-17-2 name=__codelineno-17-2 href=#__codelineno-17-2></a>Prototype        → DxMessaging IF continuing, else C# Events
-</span><span id=__span-17-3><a id=__codelineno-17-3 name=__codelineno-17-3 href=#__codelineno-17-3></a>Production       → DxMessaging (unless &lt;1k lines)
-</span><span id=__span-17-4><a id=__codelineno-17-4 name=__codelineno-17-4 href=#__codelineno-17-4></a>Legacy codebase  → Migrate gradually (see Migration Guide)
-</span></code></pre></div> <h3 id=the-real-question>The Real Question<a class=headerlink href=#the-real-question title="Anchor link to this section">&para;</a></h3> <h4 id=will-this-project-still-exist-in-3-months>"Will this project still exist in 3 months?"<a class=headerlink href=#will-this-project-still-exist-in-3-months title="Anchor link to this section">&para;</a></h4> <ul> <li><strong>No:</strong> C# events are fine</li> <li><strong>Yes:</strong> Use DxMessaging</li> </ul> <h5 id=will-anyone-else-work-on-this-code>"Will anyone else work on this code?"<a class=headerlink href=#will-anyone-else-work-on-this-code title="Anchor link to this section">&para;</a></h5> <ul> <li><strong>No:</strong> C# events might be okay</li> <li><strong>Yes:</strong> Use DxMessaging (future you counts as "someone else")</li> </ul> <h3 id=rule-of-thumb>Rule of Thumb<a class=headerlink href=#rule-of-thumb title="Anchor link to this section">&para;</a></h3> <p>If you're reading this and thinking:</p> <ul> <li><strong>"I've experienced these pain points"</strong> → DxMessaging will help</li> <li><strong>"This seems like overkill"</strong> → You probably don't need it yet</li> <li><strong>"I need this yesterday"</strong> → DxMessaging may be a good fit</li> </ul> <p>See also</p> <ul> <li><a href=../../concepts/message-types/ >Message Types</a></li> <li><a href=../../guides/diagnostics/ >Diagnostics (Editor inspector)</a></li> <li><a href=../../guides/migration-guide/ >Migration Guide</a> - How to adopt gradually</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=../design-and-architecture/ class="md-footer__link md-footer__link--prev" aria-label="Previous: Design & Architecture"> <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> Design & Architecture </div> </div> </a> <a href=../performance/ class="md-footer__link md-footer__link--next" aria-label="Next: Performance"> <div class=md-footer__title> <span class=md-footer__direction> Next </span> <div class=md-ellipsis> Performance </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>