介绍
@cardsgame/server 是一个基于 Node.js 构建的多人卡牌游戏后端框架，它提供了诸如实时通信、消息广播、玩家管理等功能，让开发者可以将精力集中在游戏本身的构建上而非重复造轮子。
在本文中，我们将提供详尽的使用教程来帮助你了解 @cardsgame/server 的基础用法，并教你如何将其运用到你自己的多人卡牌游戏开发中。
安装
首先，我们需要在项目根目录下使用 npm 来安装 @cardsgame/server：
npm install @cardsgame/server
当安装完成后，我们需要在项目中引入它：
const Server = require("@cardsgame/server");初始化
我们需要创建一个新的 Server 实例来启动服务。在启动前，你需要提供一个包含完整游戏规则、卡牌、效果等信息的配置对象。
这个配置对象长成这样：
-- -------------------- ---- -------
----- ------ - -
----- -
------- -
--------------- --
--
----- -
----- --
--
----- -
-------- -- ---
-
--
------- -
------------ -- -- - --
---------- -- -- - -
-
--其中包含了游戏核心规则（player、deck、turn），以及一系列常见的游戏事件（onGameStart、onGameEnd）。这些事件可以帮助游戏开发者处理游戏中的一些行为，比如角色扣血、游戏获胜判断等。
接下来，我们可以构建并启动服务器：
const server = new Server(config); server.start();
如果一切顺利，你将在控制台看到类似如下输出：
Listening on port 8080.
创建房间
Server 实例提供了一个 createRoom() 方法，可以帮助我们创建一个新的游戏房间，其传入参数包括房间名和创建者等信息：
const room = server.createRoom({
name: "roomName",
creator: player
});其中的 player 是一个 Player 对象，它代表了房主。
每个房间内都存在一张牌桌（Table），Player 对象还包含了该玩家在一局游戏中的虚拟角色（Actor）。Player 对象可以视为该玩家在房间中的代理人，它可以接收来自客户端的请求，并通过 Actor 处理这些请求。
在创建完房间后，我们还需要为房间中的所有玩家分配 Actor，在分配前你需要保证房间的人数已经足够：
room.assignActors();
分配完成后，每个玩家将会被赋予对应的 Actor。
自定义游戏逻辑
在回到游戏创建的配置对象中，我们可以为 game 对象下的属性添加任意自定义属性。
-- -------------------- ---- -------
----- ------ - -
----- -
------- -
--------------- --
--
----- -
----- --
--
----- -
-------- ---
------------ -
--
------------ --
--------------- ------- --------
------------- ---------- -
---------------------------------
-
-
--发送消息
Server 实例提供了广播（broadcast()）方法和针对指定玩家（sendTo()）的发送方法。
可以在房间游戏开始时广播游戏参数：
-- -------------------- ---- -------
----------------
----- ------------
----- -
----------- ----------------
--------- --------------
--------------- --------------------
----------------- ---------------------
-
---或向指定玩家发送消息：
player.send({
type: "endTurn",
data: {
turn: game.turn.currentTurn
}
});结束游戏
当游戏结束时，我们可以调用 Server 实例的 close() 方法来关闭服务器，并将所有房间中的玩家移除：
server.close();
示例代码
-- -------------------- ---- -------
----- ------ - -----------------------------
----- ------ - -
----- -
------- -
--------------- --
--
----- -
----- --
--
----- -
-------- --- ---
------------ -
--
------------ --
--------------- ------- --------
------------- ---------- -
---------------------------------
-
--
------- -
------------ -- -- -
----------------- --------
--
---------- -- -- -
----------------- ------
-
-
--
----- ------ - --- ---------------
---------------
----- ---- - -------------------
----- -----------
-------- ------
---
--------------------
----------------
----- ------------
----- -
----------- ----------------
--------- --------------
--------------- --------------------
----------------- ---------------------
-
---
----- ------ - -------------------
-------------
----- ----------
----- -
----- ---------------------
-
---
---------------总结
@cardsgame/server 是一个基于 Node.js 的多人卡牌游戏后端框架，它提供了丰富的游戏功能，让游戏开发者能够专注于游戏本身，而不必花费大量时间在处理复杂的服务器逻辑上。
在本文中，我们提供了对 @cardsgame/server 使用的详细教程，让你能够快速上手将其应用于你的游戏开发中，希望本文对你有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/144289