# @colyseus/redis-presence 中文文档 规范地址：https://npmcn.com/package/%40colyseus/redis-presence/ 版本：0\.18\.6 npm 元数据更新时间：2026-10-22T14:37:49.714Z 中文译文更新时间：2026-11-10T11:28:54.462Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40colyseus/redis-presence 原文对照：https://npmcn.com/package/%40colyseus/redis-presence/?lang=original 项目主页：https://colyseus.io/ 源码仓库：https://github.com/colyseus/colyseus ## 关键信息（来自 npm 元数据） - 包体积（解压后）：73.6 kB，9 个文件 - 模块格式：ESM + CJS - TypeScript 类型：包内自带 - Node.js 要求：\>= 22\.x - 运行依赖：2 个 - 首次发布：2021-07-02T17:33:39.772Z - 最新版本发布：2026-10-22T11:31:01.616Z - 近 30 天下载量：239005（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：53（近 12 个月 17 个） ## 中文简介 [![](https://npmcn.com/package/%40colyseus/redis-presence/media/logo.svg?raw=true)](https://github.com/colyseus/colyseus) [](https://npmjs.com/package/colyseus) ## 安装 ```sh npm install @colyseus/redis-presence ``` 也可以使用：`pnpm add @colyseus/redis-presence`、`yarn add @colyseus/redis-presence`、`bun add @colyseus/redis-presence` ## README [![](https://npmcn.com/package/%40colyseus/redis-presence/media/logo.svg?raw=true)](https://github.com/colyseus/colyseus) [![](https://img.shields.io/npm/dm/colyseus.svg?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAAmJLR0QAAKqNIzIAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAHdElNRQfjAgETESWYxR33AAAAtElEQVQoz4WQMQrCQBRE38Z0QoTcwF4Qg1h4BO0sxGOk80iCtViksrIQRRBTewWxMI1mbELYjYu+4rPMDPtn12ChMT3gavb4US5Jym0tcBIta3oDHv4Gwmr7nC4QAxBrCdzM2q6XqUnm9m9r59h7Rc0n2pFv24k4ttGMUXW+sGELTJjSr7QDKuqLS6UKFChVWWuFkZw9Z2AAvAirKT+JTlppIRnd6XgaP4goefI2Shj++OnjB3tBmHYK8z9zAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDE5LTAyLTAxVDE4OjE3OjM3KzAxOjAwGQQixQAAACV0RVh0ZGF0ZTptb2RpZnkAMjAxOS0wMi0wMVQxODoxNzozNyswMTowMGhZmnkAAAAZdEVYdFNvZnR3YXJlAHd3dy5pbmtzY2FwZS5vcmeb7jwaAAAAAElFTkSuQmCC)](https://npmjs.com/package/colyseus)[![](https://img.shields.io/discord/525739117951320081.svg?style=for-the-badge&colorB=7581dc&logo=discord&logoColor=white) ](http://chat.colyseus.io/)[![Discussion forum](https://img.shields.io/badge/discuss-forum-brightgreen.svg?style=for-the-badge&colorB=0069b8&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAAmJLR0QAAKqNIzIAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAHdElNRQfjAgETDROxCNUzAAABB0lEQVQoz4WRvyvEARjGP193CnWRH+dHQmGwKZtFGcSmxHAL400GN95ktIpV2dzlLzDJgsGgGNRdDAzoQueS/PgY3HXHyT3T+/Y87/s89UANBKXBdoZo5J6L4K1K5ZxHfnjnlQUf3bKvkgy57a0r9hS3cXfMO1kWJMza++tj3Ac7/LY343x1NA9cNmYMwnSS/SP8JVFuSJmr44iFqvtmpjhmhBCrOOazCesq6H4P3bPBjFoIBydOk2bUA17I080Es+wSZ51B4DIA2zgjSpYcEe44Js01G0XjRcCU+y4ZMrDeLmfc9EnVd5M/o0VMeu6nJZxWJivLmhyw1WHTvrr2b4+2OFqra+ALwouTMDcqmjMAAAAldEVYdGRhdGU6Y3JlYXRlADIwMTktMDItMDFUMTg6MTM6MTkrMDE6MDAC9f6fAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDE5LTAyLTAxVDE4OjEzOjE5KzAxOjAwc6hGIwAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAAASUVORK5CYII=)](https://github.com/colyseus/colyseus/discussions "Discuss Forum") ### 节点.js的多人框架. [查看文档](https://docs.colyseus.io/) Colyseus是一款面向Node.js的授权多人游戏框架,有 SDKs 供所有主要平台和引擎使用. ## 客户端 SDKs | 平台 | 安装 | 文档 | 演示 | | --- | --- | --- | --- | | 类型脚本 | `npm install @colyseus/sdk` | [开始](https://docs.colyseus.io/getting-started/typescript) | [播放 Canvas 游戏](https://github.com/endel/tank-battle-multiplayer/tree/master/web-playcanvas) | | 反应 | `npm install @colyseus/react` | [开始](https://docs.colyseus.io/getting-started/react) | [R3F大厅](https://github.com/endel/r3f-lobby-car-prototype) | | 团结 | [下载](https://github.com/colyseus/colyseus-unity3d/releases/latest/download/Colyseus_Plugin.unitypackage) | [开始](https://docs.colyseus.io/getting-started/unity) | [坦克战](https://github.com/endel/tank-battle-multiplayer/tree/master/unity) | | 古多特语 | [下载](https://github.com/colyseus/native-sdk/releases?q=godot+sdk&expanded=true) | [开始](https://docs.colyseus.io/getting-started/godot) | [坦克战](https://github.com/endel/tank-battle-multiplayer/tree/master/godot) | | 游戏Maker | [下载](https://github.com/colyseus/native-sdk/releases?q=gamemaker+sdk&expanded=true) | [开始](https://docs.colyseus.io/getting-started/gamemaker) | [坦克战](https://github.com/endel/tank-battle-multiplayer/tree/master/gamemaker) | | 折叠 | 参见文件 | [开始](https://docs.colyseus.io/getting-started/defold) | [坦克战](https://github.com/endel/tank-battle-multiplayer/tree/master/defold) | | 构造 | [下载](https://www.construct.net/en/make-games/addons/111/colyseus-multiplayer-sdk) | [开始](https://docs.colyseus.io/getting-started/construct3) | [原始演示](https://github.com/colyseus/construct3-demo) | | 哈克丝 | `haxelib install colyseus` | [开始](https://docs.colyseus.io/getting-started/haxe) | [坦克战](https://github.com/endel/tank-battle-multiplayer/tree/master/haxe) | | C/静态图书馆 | [下载](https://github.com/colyseus/native-sdk/releases?q=%22Colyseus+Native+SDK+-+Static+Library%22&expanded=true) | [GitHub 图像](https://github.com/colyseus/native-sdk) | [光谱](https://github.com/colyseus/native-sdk/tree/main/platforms/raylib) | 该项目的重点是提供实时和实时同步数据结构 基于回合制的游戏,匹配,以及在服务器和 客户端. 框架的任务是成为一个标准网码和匹配解决方案 任何你能想到的项目! ## 为何开发者选择 Colyseus : - ⚡️ **实时状态同步即时工作** ^ 在服务器上定义您的状态, 它会自动同步到所有客户端, 三角压缩和二进制编码 . - ⚔️ **内建配对** ^ 室内建筑有过滤,排队,再连接支持出框. - 📈 **可缩放** + 与Redis和负载平衡器垂直或水平地缩放,从10到10 000+CCU. - 🛡️ **设计时防骗** ——权威服务器模型确保游戏逻辑运行在服务器上,而不是客户端. - 🛠️ **使用您已经知道的工具** ^ 建于Node.js和TypeScript上,服务器和客户端都有一个简单而熟悉的API. - 💙 **永远自由** 麻省理工学院有执照,即使是商业游戏. 见 [公共路线图](https://docs.colyseus.io/roadmap) 用于1.0版本. # QQ 快速启动 为您的游戏设置自己的 Colyseus 服务器项目 `npm create colyseus-app@latest`数字 : ``` npm create colyseus-app@latest ./my-server cd my-server npm start ``` # 发起人 项目的可持续性取决于 **科利赛斯云** 订阅和赞助。 如果你没有使用 Colyseus Cloud,请考虑 [赞助项目](https://github.com/sponsors/endel) 💖 [![](https://cdn.jsdelivr.net/gh/colyseus/.github/sponsorkit/sponsors.svg)](https://cdn.jsdelivr.net/gh/colyseus/.github/sponsorkit/sponsors.svg) # 贡献者 感谢这些伟大的人[emoji 密钥](https://github.com/kentcdodds/all-contributors#emoji-key):

艾默里克·乔文
💬 💡
布莱恩·海
🖋
达米安·帕斯塔里尼
💬 📖 🐛
达雷克·格林利
💬 🐛 💻
戴维·雷德万斯基
💬 💻
伯顿博士
🧑‍🏫
安德尔·德雷尔
💻 📖 💡

恩里克托
💼
法兹里·祖拜尔
💼
费德里科
🐛 💻
詹姆斯·雅各比
💬 💡 🖋
乔纳斯·沃兰德
💬 🐛 💻 🤔 💡
凯尔·肯普(Kyle J
💬 🐛 💻 🤔
卢克·伍德
💬 🐛 💻

米拉德·多尔巴什
🐛 💻
尼基塔·鲍里索夫
🐛 💻 💼 🤔
菲尔・哈维
📖
谢尔盖
🐛 💻
苏菲
💬 🐛 🤔
梁汤米
🧑‍🏫
数字
📖
本项目遵循 [全部贡献者](https://github.com/kentcdodds/all-contributors) 规格. 欢迎任何捐助! # 捐款 我们鼓励你们为科利修斯捐款! 请检查一下 [捐款 指南](https://npmcn.com/package/%40colyseus/redis-presence/.github/CONTRIBUTING.md) 指导如何进行。 加入我们! 每个人在Colyseus 及其子项目的代码库中互动 发行跟踪器 和聊天室 [行为守则](https://npmcn.com/package/%40colyseus/redis-presence/CODE_OF_CONDUCT.md)。 。 。 . # 许可证 麻省理工学院 ## 常见问题 ### 如何安装 @colyseus/redis-presence？ 在项目目录运行 npm install @colyseus/redis-presence，或使用 pnpm add / yarn add / bun add。 ### @colyseus/redis-presence 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @colyseus/redis-presence 支持 ESM 还是 CommonJS？ 同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。 ### @colyseus/redis-presence 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>= 22\.x。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @colyseus/redis-presence 可以商用吗？ @colyseus/redis-presence 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @colyseus/redis-presence 的下载量有多少？ 根据 npm 官方下载统计，@colyseus/redis-presence 在 2026/10/11 – 2026/11/09 这 30 天内被下载 239,005 次，日均约 7,967 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @colyseus/redis-presence 还在维护吗？ 最新版本 0\.18\.6 发布于 2026/10/22（19 天前）；至今共发布 53 个版本，其中过去 12 个月发布了 17 个；首次发布于 2021/07/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。