当前位置：首页 > news >正文

5 分钟快速上手 D-Zone：从零部署 Discord 活动模拟器的新手入门教程

news 2026/8/22 15:01:33

5 分钟快速上手 D-Zone：从零部署 Discord 活动模拟器的新手入门教程

【免费下载链接】d-zoneAn ambient life simulation driven by user activity within a Discord server项目地址: https://gitcode.com/gh_mirrors/dz/d-zone

D-Zone是一个由 Discord 服务器聊天活动驱动的Discord 活动模拟器（Ambient Life Simulation）：服务器里每来一条消息，画面中就会蹦出像素小人，聊天越热闹，场景越鲜活。本教程面向新手，带你用 5 个步骤从零把它跑起来，亲眼看自己服务器的"数字生活"。

🧊 D-Zone 是什么？

D-Zone 不是一个监控或诊断工具，而是一个把聊天室数据抽象为自主角色的实验性项目：

实时联动：Discord 消息通过 WebSocket 实时推送到浏览器
像素生活：聊天活动被转化为在场景中漫步、跳跃的像素小人
纯粹观赏：不采集敏感数据，只是"看一场由社区驱动的模拟"

📁 技术栈与目录结构一览

层次	技术	关键位置
Discord 接入	Eris（Discord 机器人库）	`server/source/chat/discord/`
实时推送	Socket.IO	`server/source/socket/`
HTTP 服务	Koa	`server/source/http/`
数据存储	Prisma + SQLite	`server/prisma/schema.prisma`
前端渲染	React + PixiJS（ECS 游戏引擎）	`web/source/modules/game/`

项目采用yarn workspaces管理 Monorepo，server/与web/两个工作区各司其职。前端游戏引擎是一套 ECS 实现，组件与系统代码集中在web/source/modules/game/engine/下，包含animation、hop（跳跃）、transform（位移）等模块，这正是消息能"跳"成动画的原因。

🚀 5 分钟快速上手：四步从零到跑通

第 1 步：环境准备与克隆仓库

开始前请确保已安装Node.js（建议 16+）和Yarn，然后克隆仓库：

git clone https://gitcode.com/gh_mirrors/dz/d-zone cd d-zone

第 2 步：安装依赖

yarn install

第 3 步：配置 Discord 机器人 Token 与环境变量

服务器入口 server/source/main.ts 依赖以下环境变量，建议统一写入根目录的.env文件（项目已集成dotenv自动加载）：

变量	必填	说明
`DISCORD_TOKEN`	✅	Discord 机器人 Token，在 Discord Developer Portal 创建机器人后获取
`DATABASE_URL`	✅	SQLite 数据库地址，例如`file:./dev.db`（数据源定义见`server/prisma/schema.prisma`）
`PORT`	❌	服务端口，默认`8080`

⚠️隐私提示：D-Zone 允许任何拿到地址的人查看机器人可访问频道的聊天活动，部署时请权衡服务器隐私。

第 4 步：一键启动 Discord 活动模拟器

# 开发模式：同时启动前端 webpack dev server 与后端 yarn dev

看到Listening on 8080日志后，打开浏览器进入模拟场景，即可看到像素角色随聊天"活"起来。

生产部署则先执行yarn build构建前端，再运行yarn workspace server start启动服务（根目录Procfile已为平台部署预置了该命令）。

🔍 它是怎么工作的？从聊天到动画的路径

server/source/chat/discord/index.ts创建 Eris 机器人，events/ready.ts在上线时拉取频道列表并写入 SQLite（ChatChannel模型）
events/message-create.ts监听每条新消息并生成事件
server/source/socket/通过 Socket.IO 把事件推送给所有观看者
前端 React + PixiJS ECS 引擎消费事件，驱动角色动画、位移与跳跃