用途:为 Godot 派对游戏(小游戏合集、本地多人同乐)提供架构蓝图,覆盖大厅加入、元游戏/棋盘、小游戏、计分再循环的核心循环。
主要能力:用 .tres 资源定义小游戏(场景路径、规则、时长、1v3 等标记);动态输入路由把物理手柄映射到玩家(pN_* 动作);2–4 人分屏用 SubViewportContainer 网格与每视口 CanvasLayer;小游戏编排与延迟安全切换场景;说明页期间用线程后台预加载;断线暂停与重连覆盖层;持久化单例保存分数与名单;每设备振动、共享相机取景。
使用方式:先实现匹配系统的必读脚本 party_input_router.gd、minigame_orchestrator.gd、connection_monitor.gd;其余模块按需选用(如 split_screen_setup.gd、minigame_async_loader.gd、tournament_state.gd 等)。输入侧用 Input.get_connected_joypads() 动态查询手柄,在 _unhandled_input() 解析原始 InputEventJoypadButton 完成加入,用 Input.get_vector() 处理摇杆与死区。
限制与注意:不得把输入硬编码到固定手柄 ID 或把玩家 ID 写进输入映射;不得用布尔轮询读模拟摇杆;分屏时不得用全局 CanvasLayer,子视口容器需设 mouse_filter 为 PASS;断线不得直接移除玩家,应暂停并处理重连;手柄菜单须设置焦点邻居。资料未提供具体安装命令、收费或平台信息。