NekoParty

独立于 Fika 主体的组队扩展模组，为 SPT + Fika 提供更完整、更贴近联机使用习惯的队伍与战局邀请体验。

NekoParty 由客户端扩展和服务端扩展两部分组成，在保持对 Fika 依赖的前提下，将组队、邀请、状态同步、战局加入流程拆分为独立模块，方便安装、更新和维护。

---

模组信息

项目	说明
模组名称	NekoParty
当前版本	0.1.0
作者	Neko17
适配 SPT	~4.0.12(基于fika支持的SPT版本）
依赖	Fika >= 2.2.1
客户端插件	NekoParty.Client
服务端插件	NekoParty.Server
许可协议

---

模组简介

这个模组的目标，是把原本需要直接改 Fika 源码的组队功能，整理成一个可以独立分发的扩展包。

它提供了更完整的队伍系统，包括主菜单在线玩家列表内联邀请、队长与队员权限区分、队伍邀请确认弹窗、战局创建后的队伍成员联动加入、离队与解散反馈、以及匹配界面的队伍显示与操作。

相比直接把功能写死在 Fika 里，NekoParty 更适合后续单独更新，也更方便做定制化扩展。

---

主要功能

1. 主菜单在线玩家列表内联组队

• 直接在主菜单在线玩家列表中完成邀请、移除、退出队伍、解散队伍等操作

• 不再依赖单独的主菜单组队面板

• 按队伍身份动态显示不同按钮

• 队长和队员看到的操作逻辑不同，更符合实际使用场景

2. 队伍邀请确认流程

• 被邀请玩家会收到是否加入队伍的确认弹窗

• 被邀请方可以接受或拒绝邀请

• 如果被邀请方拒绝，队长端会收到反馈

• 队伍状态会即时同步，不需要手动刷新整个游戏流程

3. 战局创建后的队伍联动邀请

• 队长创建战局后，队员会自动收到战局加入邀请

• 支持从主菜单直接进入后续流程

• 战局邀请与普通队伍邀请分开处理，逻辑更清晰

• 复用了 Fika 的通知链路，并扩展了自定义数据结构

4. 队员准备与加入流程优化

• 队员不会被粗暴地直接塞进队长战局

• 在进入最终战局前，仍然可以先走装备投保和确认流程

• 队员完成必要步骤后，再自动衔接进入队长的战局

• 更贴近正常 EFT/Fika 的使用逻辑，避免流程被跳过

5. 匹配界面队伍信息整合

• 匹配界面加入了独立的队伍信息展示和联动逻辑

• 队伍成员、状态、操作项会和主菜单逻辑保持一致

• 主菜单与匹配界面的队伍体验更统一

• 队伍成员状态切换时能及时反映在界面上

6. 完整的队伍状态反馈

• 队员被踢出时会收到反馈

• 队员主动离队时，队长会收到反馈

• 队长解散队伍时，全体成员都会收到通知

• 被移除、离队、解散后，本地队伍状态会立即清理，避免界面残留

7. 独立扩展式架构

• 服务端使用独立的 /nekoparty/* 接口

• 客户端使用独立的请求、状态和通知处理层

• 不直接修改 Fika 的网络请求接口定义和通知枚举

• 通过 Harmony Patch 与反射接入 Fika 运行时

• 更适合后续单独维护、迁移和发布

---

功能亮点

• 独立模组化，不必继续把功能硬改进 Fika 主体源码

• 客户端与服务端拆分清晰，安装结构明确

• 与 Fika 的现有联机流程兼容，依赖 Fika 但不捆绑发布 Fika 文件

• 队伍逻辑、战局邀请逻辑、本地状态同步逻辑彼此独立，后续更容易扩展

• 更适合继续增加队伍准备检查、队伍房主设置联动、更多 UI 优化等功能

---

安装说明

将压缩包中的文件分别放入以下目录：

客户端

放入：

.\BepInEx\plugins\NekoParty.Client\

客户端核心文件：

NekoParty.Client.dll

服务端

放入：

\SPT\user\mods\NekoParty.Server\

服务端核心文件：

NekoParty.Server.dll

说明：

• 本模组依赖 Fika，本体文件请自行保持正常安装

• 发布包默认不携带任何 Fika 相关文件

• 当前版本的本地化内容由服务端启动时动态注入，不依赖独立的 locale 资源文件

---

使用方式

创建队伍

进入主菜单后，在在线玩家列表中找到目标玩家，点击邀请即可发起组队。

接受队伍邀请

被邀请玩家会收到确认弹窗，确认后加入队伍。

创建战局

队长进入匹配界面后可以正常选择地图、时间和战局参数，并创建战局。

队员加入战局

队长创建战局后，队员会收到战局邀请，并在完成必要的准备流程后自动加入队长战局。

队伍管理

• 队长可以邀请成员、移除成员、解散队伍

• 队员可以退出当前队伍

• 所有关键状态变化都会有反馈通知

---

技术说明

NekoParty 采用独立扩展方案实现：

• NekoParty.Server 负责服务端路由、队伍状态、邀请逻辑和通知分发

• NekoParty.Client 负责客户端 UI、请求转发、状态同步和通知处理

• 使用 Fika 的 websocket 通道传输自定义 nekoType 通知

• 通过 Patch 挂接到 Fika 的战局创建、战局结束、主菜单 UI、匹配界面 UI 和通知接收流程中

这意味着它依赖 Fika 运行，但又不需要把整套功能继续直接写进 Fika 主体内部。

---

适合人群

• 想要更完整队伍体验的 SPT + Fika 玩家

• 想把组队功能做成独立扩展，而不是长期维护源码魔改的开发者

• 想在现有 Fika 基础上继续做私人联机功能扩展的整合作者

---

当前版本说明

当前版本已经实现：

• 主菜单在线玩家列表内联组队

• 队伍邀请确认与反馈

• 战局邀请联动

• 队员离队、被踢、队长解散通知

• 客户端和服务端独立扩展化

• 基础本地化支持

后续仍可继续扩展：

• 更多原生化 UI 细节

• 更丰富的准备状态检查

• 更细分的房主同步逻辑

• 更完善的资源文件式本地化方案

---

已知说明

• 本模组不是 Fika 本体替代品，而是 Fika 的扩展模组

• 安装前请确保 Fika 已正常运行