boardgame.io 事件系统Events完全指南从ctx状态机到客户端触发的实战解析【免费下载链接】boardgame.ioState Management and Multiplayer Networking for Turn-Based Games项目地址: https://gitcode.com/gh_mirrors/bo/boardgame.io导读本文围绕 boardgame.io 的events机制展开系统讲解如何通过事件驱动回合制游戏的流程推进与直接修改G的 move 不同event 由框架内置提供专门用于修改ctx回合、阶段、舞台、游戏结束状态。你将掌握 7 种内置事件endTurn、endPhase、setStage等的语义与参数、在游戏逻辑与客户端Plain JS / React中的触发方式、按配置禁用事件的方法以及 hooks 中事件调用限制矩阵文末结合仓库源码src/plugins/events/events.ts、src/core/flow.ts等剖析事件排队、防死循环保护与阶段/回合联动等底层实现帮助你在实战中写出既正确又安全的游戏流程代码。一、事件Event与走子Move的本质区别boardgame.io 的核心状态分为两部分G游戏数据与ctx游戏流程上下文。文档开篇就点明二者的分工move走子由开发者编写用于修改Gevent事件由框架内置提供用于修改ctx。例如endTurn改变的是ctx.turn与ctx.currentPlayerendPhase改变的是ctx.phaseendGame写入的是ctx.gameover。这也是事件被称为“推进游戏状态”的根本原因——move 负责“游戏内容”event 负责“流程控制”。从源码看事件最终会经由flow.processEvent进入src/core/flow.ts中的eventHandlers分发见 flow.ts每个事件对应一个处理函数它们内部再调用EndTurn、EndPhase、EndGame、EndStage、SetActivePlayers等底层例程来改写ctx。二、内置事件类型详解1.endStage将调用它的玩家移出当前所在stage舞台。如果当前 stage 在游戏配置中指定了next选项则该玩家进入下一个 stage否则玩家回到“不在任何 stage”的状态。endStage();源码层面EndStage会先从phaseConfig.turn.stages[activePlayers[playerID]]读取当前 stage 定义若存在stage.next则自动作为目标舞台见 flow.ts然后从ctx.activePlayers中删除该玩家并在activePlayers清空时通过UpdateActivePlayersOnceEmpty自动推进流程见 flow.ts。另外若该玩家在 stage 中尚未达到_activePlayersMinMoves规定的最少走子数endStage会被拒绝并记录日志见 flow.ts。2.endTurn结束当前回合。默认行为是将ctx.turn加1并按照配置的 回合顺序turn order默认是轮转制 round-robin把currentPlayer推进到下一名玩家。该事件支持传入一个参数用于直接指定下一回合的玩家endTurn(); // 无参数按回合顺序自然流转 endTurn({ next: 2 }); // 指定 Player 2 为下一个玩家此外从源码结构看endTurn并非唯一结束回合的途径flow.ts中还存在一个pass事件PassEvent它等价于“强制结束回合”内部以force: true调用EndTurn可跳过minMoves的最少走子数校验见 flow.ts常用于“过牌/放弃”类操作pass同样支持{ remove: true }参数表示将玩家从playOrder中移除见 flow.ts。3.endPhase结束当前阶段。如果当前 phase 在游戏配置中指定了next选项则游戏进入该阶段否则回到“无阶段激活”的状态。endPhase();值得注意的实现细节EndPhase内部会先结束当前回合以force: true, automatic: true调用EndTurn再执行当前阶段的onEnd清理钩子最后将ctx.phase置为null或切换目标阶段见 flow.ts。这意味着“阶段结束”天然携带“回合收尾”语义编写阶段级清理逻辑时要有这个预期。4.endGame结束整局游戏。若传入参数该参数会写入ctx.gameover不传参时源码会将其置为true见 flow.ts。游戏结束后任何针对G的进一步修改move 或 event都不再生效——events 队列处理时若检测到state.ctx.gameover会直接终止后续事件见 events.ts。endGame(); // ctx.gameover true endGame({ winner: 0 }); // ctx.gameover { winner: 0 }EndGame还会在设置gameover后运行游戏级的onEnd钩子见 flow.ts适合做比分结算、冠军宣布等收尾工作。5.setStage将调用事件的玩家放入指定的 stagesetStage(stage-name);6.setPhase将游戏切换到指定 phase。与endPhase不同它显式接收目标阶段名且在切换前会先结束当前激活的阶段setPhase(phase-name);实现上SetPhaseEvent会构造一个携带{ next: newPhase }的EndPhase调用见 flow.ts因此与endPhase一样会先收尾当前回合。7.setActivePlayers向“活跃玩家集合”中追加玩家并可为它们指定所处的 stage。常用于多玩家并行操作、秘密状态secret state等场景详细用法见 Stages 指南。setActivePlayers({ others: stage-name }); // 示例让其他玩家进入指定舞台setActivePlayers在源码中直接调用SetActivePlayers更新ctx.activePlayers见 flow.ts其参数格式单玩家、all、others、currentPlayer以及每个玩家对应的 stage 名与阶段配置里的turn.activePlayers一致可参考 flow.ts 的 turn-order 模块与 turn-order.ts 中SetActivePlayers的实现。三、在游戏逻辑中触发事件事件可以在 move 内部或游戏逻辑代码中触发例如某个阶段的onBegin钩子。触发方式是使用 move 函数第一个参数对象中的eventsAPImoves: { drawCard: ({ G, ctx, events }) { events.endPhase(); }; }关键机制事件排队move 之后统一执行。文档特别强调Events are queued up and triggeredaftera move. Any changes you make toGwill be applied before events are triggered, even if the event is called first in your move function.也就是说即使在 move 函数的第一行调用events.endPhase()你对G的所有修改依然会先于事件生效。源码印证了这一设计Events类的api()只是把事件调用压入this.dispatch队列见 events.ts真正的执行发生在插件flush阶段——PluginEvents通过dangerouslyFlushRawState调用api._private.update(state)见 plugin-events.ts而update会遍历dispatch队列为每个事件生成一个带automatic: true标记的automaticGameEventaction 并交给flow.processEvent处理见 events.ts 与 action-creators.ts。自动标记automatic意味着这些事件是 move 的副作用会在日志中标注automatic: true见 flow.ts。这种“先改G、再触发事件”的语义保证了回合内状态变更的原子性与可预测性也是事件机制最需要牢记的一条规则。四、在客户端触发事件事件除了能在服务端游戏逻辑中触发也能由客户端直接调用例如玩家点击“结束回合”按钮。boardgame.io 为不同前端技术栈提供了统一的events入口。Plain JS原生客户端事件位于 boardgame.io 客户端实例的events属性中import { Client } from boardgame.io/client; const client Client({ /* options */ }); const clickHandler () { client.events.endTurn(); }React事件通过props中的events对象提供给组件import React from react; function Board({ events }) { const onClick () { events.endTurn(); }; return button onClick{onClick}End Turn/button; }两种方式的触发结果完全一致客户端会派发一个对应事件类型的 action如GAME_EVENT最终在 master/reducer 侧由flow.processEvent落地到ctx。关于客户端整体架构可参考 Client 文档。五、禁用事件events: false出于安全与玩法设计考虑你可能不希望玩家直接调用某些事件——例如允许endGame在服务端逻辑中触发却不允许客户端任意调用它。只需在游戏配置的events段中将对应事件名设为falseconst game { events: { endGame: false, // ... }, };适用范围说明禁用只影响“从客户端直接调用”的能力不影响在 moves 或 hooks 中的使用。也就是说events: { endGame: false }之后client.events.endGame()不再可用但你仍然可以在某个 move 里调用events.endGame()来判定胜负。源码层面Flow构造时会根据配置生成enabledEventNames列表每个事件只有在其配置不为false时才被加入见 flow.ts而Events插件的api()正是遍历this.flow.eventNames生成可调用方法见 events.ts禁用后的事件不会出现在客户端 API 中。可禁用的事件包括endTurn、pass、endPhase、setPhase、endGame、setActivePlayers、endStage、setStage。六、从 hooks 调用事件的限制矩阵eventsAPI 在游戏钩子hooks中同样可用但由于钩子与事件之间存在执行时机冲突某些事件不能在特定钩子中调用。官方给出的支持矩阵如下turnonMoveturnonBeginturnonEndphaseonBeginphaseonEndgameonEndsetStage✅❌❌❌❌❌endStage✅❌❌❌❌❌setActivePlayers✅✅❌❌❌❌endTurn✅✅❌✅❌❌setPhase✅✅✅✅❌❌endPhase✅✅✅✅❌❌endGame✅✅✅✅✅❌✅ 支持 ❌ 不支持这些限制并不是随意的“软约束”而是由Events.update()在消费队列时硬性校验并报错的。src/plugins/events/events.ts顶部定义了一组错误枚举见 events.ts规则包括endTurn不允许在turn.onEnd/phase.onEnd中调用——回合/阶段已经在结束流程中Errors.EndTurnInOnEndsetPhase与endPhase不允许在phase.onEnd中调用——若需动态决定下一阶段应使用阶段的next触发器Errors.PhaseEventInOnEndsetStage、endStage、setActivePlayers不允许在onEnd钩子中调用Errors.StageEventInOnEndstage 事件不允许在phase.onBegin中调用推荐改用turn.onBegin或turn.activePlayers声明式配置Errors.StageEventInPhaseBeginsetStage与endStage不允许在turn.onBegin中调用Errors.StageEventInTurnBegin。校验通过的事件会被依次执行一旦发现违规插件会把错误信息写入plugins.events.data.error并由PluginEvents.isInvalid判定该次状态更新无效见 plugin-events.ts从而保证流程状态机不被非法事件破坏。七、底层原理事件队列与防死循环保护理解事件系统的实现有助于排查疑难问题。Events类src/plugins/events/events.ts的运行机制可概括为三阶段入队dispatchmove/hook 执行期间任何events.xxx()调用只做一件事——把{ type, args, phase, turn, calledFrom, error }压入this.dispatch队列见 events.ts。其中calledFrom记录调用发生时所在的钩子类型GameMethod这是第六节限制校验的依据error字段预存了一个Error对象用于在需要时报错时提供堆栈。上下文追踪fnWrapPluginEvents的fnWrap会在每次 move 或 hook 执行前调用updateTurnContext(ctx, methodType)刷新插件内部的“当前阶段/当前回合/当前钩子”执行后再unsetCurrentMethod()复位见 plugin-events.ts。这保证了即使事件是在回合或阶段切换之后被调用也能派发到正确的回合与阶段上下文。统一执行updatemove 执行完毕后插件flush阶段调用update(state)遍历队列逐事件检查后生成自动事件交由flow.processEvent落地见 events.ts。update中还有两道重要的安全阀重复事件跳过若某事件派发时记录的turn与当前ctx.turn不一致说明回合已被其他方式结束stage/回合类事件会被跳过turnHasEnded检查阶段类事件则会比对派发时记录的phase与当前ctx.phase避免对已结束阶段重复操作见 events.ts。死循环保护maxEndedTurnsPerAction被初始化为ctx.numPlayers * 100若单次 move 触发的回合结束次数超过该阈值立即终止并返回MaxTurnEndings错误提示“游戏代码可能触发了无限循环”见 [events.ts](https://link.gitcode.com/i/ae027836ee6ac5146174fed13138c051#L68-L83, L143-L146)。此外PluginEvents的noClient返回api._private.isUsed()即本回合是否产生了事件用于告诉客户端该次更新是否需要等待 master 的权威结果见 plugin-events.ts——这也是多人模式下事件驱动流程保持一致性的关键一环。这些行为均有对应测试覆盖src/plugins/events/events.test.ts中包含了构造函数、dispatch 入队、update ctx上下文更新、no duplicate endTurn重复 endTurn 去重、no duplicate endPhase重复 endPhase 去重等用例可作为深入阅读事件实现的入口。八、实战小结与常见用法对照需求场景推荐事件备注玩家点击“结束回合”endTurn()客户端直接触发服务端可用turn.endIf自动结束指定下一回合玩家endTurn({ next: 2 })或通过 turn order 自定义流转抽卡后立即结束阶段move 内events.endPhase()注意G的修改先于事件生效达到条件结束游戏move 内events.endGame({ winner })ctx.gameover携带结果游戏结束玩家进入秘密阶段setActivePlayers({ ... })详见 Stages 指南禁止客户端直接结束游戏events: { endGame: false }不影响服务端 move/hook 内调用编写游戏流程时建议遵循“能用声明式配置endIf、next、activePlayers就不用命令式事件”的原则事件适合表达玩家驱动的操作点击结束回合、出牌触发阶段切换而自动判定类逻辑优先放在endIf/next等触发器里这样既简洁又能规避 hooks 调用限制带来的报错。若在钩子中触发事件遇到报错可对照第六节的限制矩阵与 events.ts 中的错误提示信息快速定位是哪个钩子与事件的组合不合法。【免费下载链接】boardgame.ioState Management and Multiplayer Networking for Turn-Based Games项目地址: https://gitcode.com/gh_mirrors/bo/boardgame.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 boardgame.io 事件系统（Events）完全指南：从 `ctx` 状态机到客户端触发的实战解析
boardgame.io 事件系统Events完全指南从ctx状态机到客户端触发的实战解析【免费下载链接】boardgame.ioState Management and Multiplayer Networking for Turn-Based Games项目地址: https://gitcode.com/gh_mirrors/bo/boardgame.io导读本文围绕 boardgame.io 的events机制展开系统讲解如何通过事件驱动回合制游戏的流程推进与直接修改G的 move 不同event 由框架内置提供专门用于修改ctx回合、阶段、舞台、游戏结束状态。你将掌握 7 种内置事件endTurn、endPhase、setStage等的语义与参数、在游戏逻辑与客户端Plain JS / React中的触发方式、按配置禁用事件的方法以及 hooks 中事件调用限制矩阵文末结合仓库源码src/plugins/events/events.ts、src/core/flow.ts等剖析事件排队、防死循环保护与阶段/回合联动等底层实现帮助你在实战中写出既正确又安全的游戏流程代码。一、事件Event与走子Move的本质区别boardgame.io 的核心状态分为两部分G游戏数据与ctx游戏流程上下文。文档开篇就点明二者的分工move走子由开发者编写用于修改Gevent事件由框架内置提供用于修改ctx。例如endTurn改变的是ctx.turn与ctx.currentPlayerendPhase改变的是ctx.phaseendGame写入的是ctx.gameover。这也是事件被称为“推进游戏状态”的根本原因——move 负责“游戏内容”event 负责“流程控制”。从源码看事件最终会经由flow.processEvent进入src/core/flow.ts中的eventHandlers分发见 flow.ts每个事件对应一个处理函数它们内部再调用EndTurn、EndPhase、EndGame、EndStage、SetActivePlayers等底层例程来改写ctx。二、内置事件类型详解1.endStage将调用它的玩家移出当前所在stage舞台。如果当前 stage 在游戏配置中指定了next选项则该玩家进入下一个 stage否则玩家回到“不在任何 stage”的状态。endStage();源码层面EndStage会先从phaseConfig.turn.stages[activePlayers[playerID]]读取当前 stage 定义若存在stage.next则自动作为目标舞台见 flow.ts然后从ctx.activePlayers中删除该玩家并在activePlayers清空时通过UpdateActivePlayersOnceEmpty自动推进流程见 flow.ts。另外若该玩家在 stage 中尚未达到_activePlayersMinMoves规定的最少走子数endStage会被拒绝并记录日志见 flow.ts。2.endTurn结束当前回合。默认行为是将ctx.turn加1并按照配置的 回合顺序turn order默认是轮转制 round-robin把currentPlayer推进到下一名玩家。该事件支持传入一个参数用于直接指定下一回合的玩家endTurn(); // 无参数按回合顺序自然流转 endTurn({ next: 2 }); // 指定 Player 2 为下一个玩家此外从源码结构看endTurn并非唯一结束回合的途径flow.ts中还存在一个pass事件PassEvent它等价于“强制结束回合”内部以force: true调用EndTurn可跳过minMoves的最少走子数校验见 flow.ts常用于“过牌/放弃”类操作pass同样支持{ remove: true }参数表示将玩家从playOrder中移除见 flow.ts。3.endPhase结束当前阶段。如果当前 phase 在游戏配置中指定了next选项则游戏进入该阶段否则回到“无阶段激活”的状态。endPhase();值得注意的实现细节EndPhase内部会先结束当前回合以force: true, automatic: true调用EndTurn再执行当前阶段的onEnd清理钩子最后将ctx.phase置为null或切换目标阶段见 flow.ts。这意味着“阶段结束”天然携带“回合收尾”语义编写阶段级清理逻辑时要有这个预期。4.endGame结束整局游戏。若传入参数该参数会写入ctx.gameover不传参时源码会将其置为true见 flow.ts。游戏结束后任何针对G的进一步修改move 或 event都不再生效——events 队列处理时若检测到state.ctx.gameover会直接终止后续事件见 events.ts。endGame(); // ctx.gameover true endGame({ winner: 0 }); // ctx.gameover { winner: 0 }EndGame还会在设置gameover后运行游戏级的onEnd钩子见 flow.ts适合做比分结算、冠军宣布等收尾工作。5.setStage将调用事件的玩家放入指定的 stagesetStage(stage-name);6.setPhase将游戏切换到指定 phase。与endPhase不同它显式接收目标阶段名且在切换前会先结束当前激活的阶段setPhase(phase-name);实现上SetPhaseEvent会构造一个携带{ next: newPhase }的EndPhase调用见 flow.ts因此与endPhase一样会先收尾当前回合。7.setActivePlayers向“活跃玩家集合”中追加玩家并可为它们指定所处的 stage。常用于多玩家并行操作、秘密状态secret state等场景详细用法见 Stages 指南。setActivePlayers({ others: stage-name }); // 示例让其他玩家进入指定舞台setActivePlayers在源码中直接调用SetActivePlayers更新ctx.activePlayers见 flow.ts其参数格式单玩家、all、others、currentPlayer以及每个玩家对应的 stage 名与阶段配置里的turn.activePlayers一致可参考 flow.ts 的 turn-order 模块与 turn-order.ts 中SetActivePlayers的实现。三、在游戏逻辑中触发事件事件可以在 move 内部或游戏逻辑代码中触发例如某个阶段的onBegin钩子。触发方式是使用 move 函数第一个参数对象中的eventsAPImoves: { drawCard: ({ G, ctx, events }) { events.endPhase(); }; }关键机制事件排队move 之后统一执行。文档特别强调Events are queued up and triggeredaftera move. Any changes you make toGwill be applied before events are triggered, even if the event is called first in your move function.也就是说即使在 move 函数的第一行调用events.endPhase()你对G的所有修改依然会先于事件生效。源码印证了这一设计Events类的api()只是把事件调用压入this.dispatch队列见 events.ts真正的执行发生在插件flush阶段——PluginEvents通过dangerouslyFlushRawState调用api._private.update(state)见 plugin-events.ts而update会遍历dispatch队列为每个事件生成一个带automatic: true标记的automaticGameEventaction 并交给flow.processEvent处理见 events.ts 与 action-creators.ts。自动标记automatic意味着这些事件是 move 的副作用会在日志中标注automatic: true见 flow.ts。这种“先改G、再触发事件”的语义保证了回合内状态变更的原子性与可预测性也是事件机制最需要牢记的一条规则。四、在客户端触发事件事件除了能在服务端游戏逻辑中触发也能由客户端直接调用例如玩家点击“结束回合”按钮。boardgame.io 为不同前端技术栈提供了统一的events入口。Plain JS原生客户端事件位于 boardgame.io 客户端实例的events属性中import { Client } from boardgame.io/client; const client Client({ /* options */ }); const clickHandler () { client.events.endTurn(); }React事件通过props中的events对象提供给组件import React from react; function Board({ events }) { const onClick () { events.endTurn(); }; return button onClick{onClick}End Turn/button; }两种方式的触发结果完全一致客户端会派发一个对应事件类型的 action如GAME_EVENT最终在 master/reducer 侧由flow.processEvent落地到ctx。关于客户端整体架构可参考 Client 文档。五、禁用事件events: false出于安全与玩法设计考虑你可能不希望玩家直接调用某些事件——例如允许endGame在服务端逻辑中触发却不允许客户端任意调用它。只需在游戏配置的events段中将对应事件名设为falseconst game { events: { endGame: false, // ... }, };适用范围说明禁用只影响“从客户端直接调用”的能力不影响在 moves 或 hooks 中的使用。也就是说events: { endGame: false }之后client.events.endGame()不再可用但你仍然可以在某个 move 里调用events.endGame()来判定胜负。源码层面Flow构造时会根据配置生成enabledEventNames列表每个事件只有在其配置不为false时才被加入见 flow.ts而Events插件的api()正是遍历this.flow.eventNames生成可调用方法见 events.ts禁用后的事件不会出现在客户端 API 中。可禁用的事件包括endTurn、pass、endPhase、setPhase、endGame、setActivePlayers、endStage、setStage。六、从 hooks 调用事件的限制矩阵eventsAPI 在游戏钩子hooks中同样可用但由于钩子与事件之间存在执行时机冲突某些事件不能在特定钩子中调用。官方给出的支持矩阵如下turnonMoveturnonBeginturnonEndphaseonBeginphaseonEndgameonEndsetStage✅❌❌❌❌❌endStage✅❌❌❌❌❌setActivePlayers✅✅❌❌❌❌endTurn✅✅❌✅❌❌setPhase✅✅✅✅❌❌endPhase✅✅✅✅❌❌endGame✅✅✅✅✅❌✅ 支持 ❌ 不支持这些限制并不是随意的“软约束”而是由Events.update()在消费队列时硬性校验并报错的。src/plugins/events/events.ts顶部定义了一组错误枚举见 events.ts规则包括endTurn不允许在turn.onEnd/phase.onEnd中调用——回合/阶段已经在结束流程中Errors.EndTurnInOnEndsetPhase与endPhase不允许在phase.onEnd中调用——若需动态决定下一阶段应使用阶段的next触发器Errors.PhaseEventInOnEndsetStage、endStage、setActivePlayers不允许在onEnd钩子中调用Errors.StageEventInOnEndstage 事件不允许在phase.onBegin中调用推荐改用turn.onBegin或turn.activePlayers声明式配置Errors.StageEventInPhaseBeginsetStage与endStage不允许在turn.onBegin中调用Errors.StageEventInTurnBegin。校验通过的事件会被依次执行一旦发现违规插件会把错误信息写入plugins.events.data.error并由PluginEvents.isInvalid判定该次状态更新无效见 plugin-events.ts从而保证流程状态机不被非法事件破坏。七、底层原理事件队列与防死循环保护理解事件系统的实现有助于排查疑难问题。Events类src/plugins/events/events.ts的运行机制可概括为三阶段入队dispatchmove/hook 执行期间任何events.xxx()调用只做一件事——把{ type, args, phase, turn, calledFrom, error }压入this.dispatch队列见 events.ts。其中calledFrom记录调用发生时所在的钩子类型GameMethod这是第六节限制校验的依据error字段预存了一个Error对象用于在需要时报错时提供堆栈。上下文追踪fnWrapPluginEvents的fnWrap会在每次 move 或 hook 执行前调用updateTurnContext(ctx, methodType)刷新插件内部的“当前阶段/当前回合/当前钩子”执行后再unsetCurrentMethod()复位见 plugin-events.ts。这保证了即使事件是在回合或阶段切换之后被调用也能派发到正确的回合与阶段上下文。统一执行updatemove 执行完毕后插件flush阶段调用update(state)遍历队列逐事件检查后生成自动事件交由flow.processEvent落地见 events.ts。update中还有两道重要的安全阀重复事件跳过若某事件派发时记录的turn与当前ctx.turn不一致说明回合已被其他方式结束stage/回合类事件会被跳过turnHasEnded检查阶段类事件则会比对派发时记录的phase与当前ctx.phase避免对已结束阶段重复操作见 events.ts。死循环保护maxEndedTurnsPerAction被初始化为ctx.numPlayers * 100若单次 move 触发的回合结束次数超过该阈值立即终止并返回MaxTurnEndings错误提示“游戏代码可能触发了无限循环”见 [events.ts](https://link.gitcode.com/i/ae027836ee6ac5146174fed13138c051#L68-L83, L143-L146)。此外PluginEvents的noClient返回api._private.isUsed()即本回合是否产生了事件用于告诉客户端该次更新是否需要等待 master 的权威结果见 plugin-events.ts——这也是多人模式下事件驱动流程保持一致性的关键一环。这些行为均有对应测试覆盖src/plugins/events/events.test.ts中包含了构造函数、dispatch 入队、update ctx上下文更新、no duplicate endTurn重复 endTurn 去重、no duplicate endPhase重复 endPhase 去重等用例可作为深入阅读事件实现的入口。八、实战小结与常见用法对照需求场景推荐事件备注玩家点击“结束回合”endTurn()客户端直接触发服务端可用turn.endIf自动结束指定下一回合玩家endTurn({ next: 2 })或通过 turn order 自定义流转抽卡后立即结束阶段move 内events.endPhase()注意G的修改先于事件生效达到条件结束游戏move 内events.endGame({ winner })ctx.gameover携带结果游戏结束玩家进入秘密阶段setActivePlayers({ ... })详见 Stages 指南禁止客户端直接结束游戏events: { endGame: false }不影响服务端 move/hook 内调用编写游戏流程时建议遵循“能用声明式配置endIf、next、activePlayers就不用命令式事件”的原则事件适合表达玩家驱动的操作点击结束回合、出牌触发阶段切换而自动判定类逻辑优先放在endIf/next等触发器里这样既简洁又能规避 hooks 调用限制带来的报错。若在钩子中触发事件遇到报错可对照第六节的限制矩阵与 events.ts 中的错误提示信息快速定位是哪个钩子与事件的组合不合法。【免费下载链接】boardgame.ioState Management and Multiplayer Networking for Turn-Based Games项目地址: https://gitcode.com/gh_mirrors/bo/boardgame.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考