EM UiKit

创作者: wuyuwan39

已更新:2026-07-28 04:45:32

866KB

关于此 MOD

EM2026系列Mod的公共UI基础库：游戏内通知、原生数据表格、选手/战队头像、本地图片加载。本身不产生任何改动。

EM UiKit

共享 UI 基础设施 用于EM2026模组。一个提供游戏内通知、原生数据表、玩家/球队头像以及本地图片加载的库——这样每个模组就不必重复实现这些功能了。

它本身不会改变任何东西：不改变游戏数值，不改变界面，也不改变存档。只有当安装了使用它的模组时，它才会发挥作用。

公告/通知：

如果你有任何错误报告或想讨论任何内容，可以加入这个Discord服务器：
https://discord.gg/MgvmC9RE83

如果您有bug反馈或者交流的需求，您可以加入这个Discord服务器：
https://discord.gg/MgvmC9RE83

能力

游戏内通知右上角弹出提示——图标加粗标题、自动换行的正文，配一条彩色强调条（信息、成功、警告、错误）。淡入、停留、淡出；多个提示可堆叠；时长和视觉样式可自定义。
数据表：原生TextMeshPro表格（表头行+数据行，支持显式或自动列宽、富文本单元格），可直接嵌入任意UI容器——视觉效果与游戏内数据界面完全一致。
玩家/队伍头像：通过游戏原生图像加载器，将玩家照片和战队标志附加到任意UI Image上——使用的资源与游戏本身显示的完全相同。
本地图片加载：将磁盘中的 PNG 文件加载到 UI 图像中，具备缓存、GC 保护和静默回退机制——用于文章插图、通知图标等。
一切失败都会无声降级。缺失的资源或失败弹窗绝不会破坏调用它的模组或游戏本身。

用于

锦标赛统计 — 玩家/队伍/MVP榜单中的内联头像（可选：无UiKit时不显示头像）
EMTV 颁奖典礼 — 表格、通知和文章图片（必填）
EM模组更新检查器 — 更新通知（可选：不使用 UiKit 的内置 toast）

随着时间推移，会有更多EM模组使用它——安装一次即可升级所有模组。

安装

安装 BepInEx（EM2026 版本）。
安装 EM.框架（五个框架DLL，全局一份，位于BepInEx/plugins/EM.Framework/）。
将mod文件夹EM.UiKit/放入BepInEx/plugins/中。 全局仅保留一份副本 — 绝不嵌套在其他模组的文件夹内。
开始游戏。

兼容性

游戏：电竞经理 2026
需要：EM.Framework 0.2.3+
模组可选不使用 UiKit 也能工作（功能会优雅降级）；那些需要它（例如EMTV Awards）需要安装它。

面向模组开发者——如何使用UiKit

所有入口点都是静态外观，并且每一个都遵循相同的契约： 永不抛错，永不崩溃游戏 — 失败时返回 null/false，并静默降级。

通知 — EM.UiKit.通知.通知管理器
bool Show(string title, string body, NotificationLevel level = Info, string iconPath = null)
bool Show(NotificationSpec spec) — 规格添加持续时间（屏幕显示秒数）以及完整的通知样式 (宽度、边距、颜色、字体大小)。
预热() 预先创建宿主画布（可选）；清除() 驳回一切。
桌子 — UI套件.表格渲染器
变换渲染(变换父级, 表规格) 或简写渲染表格(parent, headers, rows, style). 表格规格：表头 / 行 / 可选列宽 / 表格样式。单元格接受纯文本或 TMP 富文本。不包含滚动容器——请将其放入你自己的 ScrollRect 中。该简写形式的参数在结构上与 Markdown2Tmp 表格块兼容（单行衔接，无需引用）。
头像 — EM.UiKit.Avatar.AvatarProvider
void Attach(Image image, AvatarKind kind, string id) 与玩家化身/队伍化身以及游戏侧实体ID。封装游戏原生的ImageLoader。
图片 — EM.UiKit.Images.ImageAssetProvider
加载精灵(string absolutePath) — 磁盘 PNG → 缓存 Sprite（HideAndDontSave，软缓存上限）。传入绝对路径；从你自己的插件文件夹中推导它们。

两种集成方式:

硬依赖 (最简单)：添加 [BepInDependency("com.esportsmanager.modkit.uikit")]，编译时引用 EM.UiKit.dll，使用 Private=false （关闭本地复制），直接调用外观层。 绝不要在你自己的模组包中附带 EM.UiKit.dll ——仅需一份全局副本，并作为要求列在你的模组页面上。
软依赖 (零编译时耦合)：探针 EM.UiKit.通知.通知管理器（或另一种外观类型）在运行时跨已加载程序集按名称查找，缓存结果，并在缺失时回退到你自己的最小 UI。即使用户未安装 UiKit 也能正常工作。

EM UiKit

2026年电磁系列模组之公共 UI 基础设施一个库提供游戏内通知、原生数据表格、选手/战队头像、本地图片加载——各 Mod 不必重复造轮子。

本身不改任何东西：不动数值、不动界面、不碰存档。只有装了使用它的 Mod 时才会工作。

能力

游戏内通知屏幕右上角 Toast 弹窗——图标 + 粗体标题 + 自动换行正文 + 等级色条（信息/成功/警告/错误）。淡入停留淡出、多条堆叠，停留时长与视觉样式可定制。
数据表格原生 TextMeshPro 表格（表头 + 数据行、显式或自动列宽、富文本单元格），直接构建进任意 UI 容器，观感与游戏自带数据页一致。
选手 / 战队头像经游戏原生图片加载器给任意 UI Image 贴选手照片、战队 logo——素材与游戏内其它界面完全相同。
本地图片加载磁盘 PNG 加载为 UI 图片，带缓存、防回收、失败静默降级——用于文章配图、通知图标等。
所有能力失败时静默降级，绝不影响调用方 Mod 的其它功能，更不崩游戏。

谁在用

锦标赛统计——选手榜/战队榜/MVP 行内头像（可选：不装只是不显示头像）
EMTV颁奖典礼——表格、通知与文章配图（必需）
EM模组更新检查器——更新通知（可选：不装用内置提示条）

后续会有更多 EM 系 Mod 用到它——装一次，全体受益。

安装

安装 BepInEx（EM2026 版）。
安装 EM.Framework（框架五件套，全局一份，放 BepInEx/plugins/EM.Framework/）。
把本 Mod 目录 EM.UiKit/ 放进 BepInEx/plugins/。全局只保留一份，绝不要塞进其它 Mod 的目录里。
启动游戏。

兼容性

游戏版本：Esports Manager 2026
依赖：EM.Framework 0.2.3+
「可选」使用本库的 Mod 不安装也能运行（对应功能会优雅降级）；「必需」使用本库的 Mod（如 EMTV Awards）则需要安装。

给 Mod 开发者——如何使用 UiKit

所有入口都是静态门面，共同契约：永不抛异常、永不崩游戏——失败返回 null/false 并静默降级。

通知——通知管理器
bool Show(string title, string body, NotificationLevel level = Info, string iconPath = null)
bool Show(NotificationSpec spec)——规格额外支持持续（停留秒数）与完整通知样式（宽度、边距、配色、字号）。
预热() 可提前创建宿主 Canvas（可选）；清除() 清空全部离线通知。
表格——EM.UiKit.TableRenderer
变换渲染(变换父级, 表格规格)，或便捷重载渲染表格(父级, 表头, 行, 样式)。表格规格：表头/行/可选列宽/表格样式。单元格接受纯文本或TMP富文本。不含滚动容器——请放入你自己的ScrollRect中。便捷重载的参数与Markdown2Tmp表格块同构（一行胶水对接，无需引用）。
头像——EM.UiKit.Avatar.AvatarProvider
void Attach(Image image, AvatarKind kind, string id)，玩家类型 / 队伍类型 + 游戏侧实体 id。封装游戏原生 ImageLoader。
图片——EM.UiKit.Images.ImageAssetProvider
Sprite LoadSprite(string absolutePath)——磁盘 PNG → 带缓存的 Sprite（HideAndDontSave 防回收、缓存软上限）。只接受绝对路径，请从你自己的插件目录推导。

两种接入方式：

硬依赖（最简单）：加 [BepInDependency("com.esportsmanager.modkit.uikit")]，编译期引用 EM.UiKit.dll（Private=false 不随包拷贝），直接调用门面。绝不要把 EM.UiKit.dll 打进你自己的 Mod 包——全局只能有一份，在你的 Mod 页把它挂为 Requirement 即可。
软依赖（零编译期耦合）：运行时按类型名（如通知管理器）反射探测已加载程序集，缓存结果，不在场时回退到自己的极简 UI。用户不装 UiKit 也能正常用你的 Mod。