返回资讯中心
外部精选
软件工程
#开发者实时流

Gami.Fied:开源可自托管的游戏化引擎,支持经验值与排行榜

来源标题:Show HN: Gami.Fied – Self-hosted gamification engine (XP, streaks, leaderboards)

Gami.Fied 是一个开源、可自托管的游戏化引擎,能为任意应用添加 XP、等级、连续签到、徽章、排行榜和奖励,玩家数据保留在自有服务器上。服务端采用 AGPL-3.0 协议,SDK、React 组件和 Web 组件为 MIT 协议,提供 amd64 和 arm64 预构建镜像,一条 docker compose up 命令即可运行,且不按用户数收费。

Hacker News 最新ronak00202026/11/17 · 今天17 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

自托管、开源的游戏化引擎。为任何应用添加 XP、等级、连续打卡、徽章、排行榜和奖励,并将玩家数据保留在你自己的服务器上。 网站 · 文档 · 在线体验 · 产品导览 · 讨论区 🏠 数据始终归你所有。它运行在你自己的服务器上,紧邻你的应用。任何玩家数据都不会流向第三方。 💸 不按用户数收费。无论你有多少玩家,唯一的成本就是你自己的托管费用。 🔓 开源。服务端采用 AGPL-3.0 协议。SDK、React 组件和 Web Components 采用 MIT 协议,因此可以用于闭源应用。 🐳 一条命令即可运行。提供 amd64 和 arm64 的预构建镜像,只需 docker compose up。 工作原理 flowchart LR A["你的应用"] -- "事件<br>(lesson_completed)" --> B["Gami.Fied"] B -- "规则、连续打卡、<br>挑战" --> C["XP、等级、徽章、<br>宝石、联赛"] C -- "SDK、React、<br>Web Components" --> D["你的玩家"] B -- "签名 webhook、<br>Slack、邮件、推送" --> E["你的其他系统"] 加载中 你的应用发送发生了什么。你在仪表盘中设置的规则决定它的价值,worker 在后台完成结算。玩家通过现成的组件查看进度,或者使用你自己的 UI 调用 API。 预构建镜像已发布 linux/amd64 和 linux/arm64 版本,因此无需自行构建。 curl -LO https://github.com/gami-fied/gami.fied/releases/latest/download/docker-compose.yml curl -LO https://github.com/gami-fied/gami.fied/releases/latest/download/env.example cp env.example .env 填写 .env 中的密钥,然后运行 docker compose up -d。仪表盘位于 http://localhost:3000。 端口仅绑定在 127.0.0.1 上。若要从另一台机器访问仪表盘,请将其置于带 TLS 的反向代理之后,或在 .env 中设置 BIND_ADDRESS=0.0.0.0 以在私有网络中使用。参见《使用 Docker Compose 安装》、生产环境检查清单和升级指南。 从你的服务器发送事件并读取进度: npm install @gami.fied/sdk import { Gami } from '@gami.fied/sdk'; const gami = new Gami({ baseUrl: 'http://localhost:3001', apiKey: 'gami_live_your_project_api_key' }); // 发送发生了什么。规则、连续打卡和挑战在后台运行。 await gami.events.track({ userId: 'user_123', type: 'lesson_completed', properties: { score: 100 } }); // 读取玩家的进度。这需要一个具有 levels:read 作用域的密钥。 const progress = await gami.levels.getUserProgress({ userId: 'user_123' }); console.log(Level ${progress.level.number}, ${progress.totalXp} XP); 在玩家的浏览器中,切勿使用 API key。你的服务器为单个玩家生成短期 token,页面使用该 token: // 在你的服务器上 const { token } = await gami.endUserTokens.create({ userId: 'user_123' }); token 默认只读,除非你请求 access: 'write',玩家在购买奖励、开箱或添加好友时需要该权限。 import { GamiProvider, LevelProgress, Leaderboard, ToastHost } from '@gami.fied/react'; import '@gami.fied/react/styles.css'; <GamiProvider endUserToken={token} baseUrl="https://gami.example.com"> <LevelProgress /> <Leaderboard period="weekly" /> <ToastHost /> </GamiProvider>;

<script src="https://unpkg.com/@gami.fied/elements/dist/gami-elements.js"></script> <script> GamiElements.configure({ baseUrl: 'https://gami.example.com', token }); </script>

<gami-level-progress></gami-level-progress> <gami-leaderboard period="weekly"></gami-leaderboard> 参见 SDK 指南、React 组件和 Web Components,或在组件库中在线查看所有组件。 领域 你将获得 ⚡ 规则 将事件转化为 XP、徽章和货币,支持条件、时间累计、草稿、对历史事件进行测试,以及规则触发原因追踪。 📈 成长体系 等级、分级成就、带冻结功能的每日和每周连续打卡、带步骤的挑战、串联挑战的旅程,以及赛季通行证。 🪙 经济系统 带过期时间的货币和钱包、带库存和兑换码的奖励商店、公布概率的神秘盒子、外观道具,以及防止刷取的增长倍率和限制。 🏆 竞技 按日、周、月的排行榜,为榜首设置奖品,支持分群榜单,以及带升降级的联赛。 🤝 社区 团队与共同目标、好友、点赞、活动动态、分享卡片和邀请码。 🔔 触达玩家 应用内收件箱、邮件、iPhone、Android 和浏览器的推送、实时更新,以及按玩家语言进行的翻译。 🧩 集成 稳定的 /v1 API、TypeScript SDK、React 和 Web Components、签名 webhook、Slack、Teams 和 Discord,以及 Segment、RudderStack、Stripe 和 GitHub 的连接器。 🛡️ 管理 角色、审计日志、从预发布环境晋升到生产环境、按组织划分的功能控制、带作用域的 API key、备份、导出与导入,以及为隐私请求提供的数据擦除。 与替代方案相比的不足之处,请参见对比页面。 所有内容都在 gami.fied.cc/docs,支持搜索,也存在于 docs/ 文件夹中。 欢迎提交 bug 报告、想法和 pull request。CONTRIBUTING.md 涵盖了环境搭建、需要运行的检查以及贡献的许可方式。请遵守行为准则。 要在本地开发,你需要 Node.js 22、pnpm 11 和 Docker: pnpm install && cp .env.example .env pnpm infra:up && pnpm db:migrate:dev pnpm dev 项目结构 gami-fied/ ├── apps/ │ ├── api/ # 运行在 3001 端口的 Fastify API │ ├── worker/ # 用于规则和投递的后台 worker │ ├── dashboard/ # 运行在 3000 端口的 Next.js 仪表盘 │ └── website/ # gami.fied.cc:营销页面、文档和在线体验 ├── packages/ │ ├── sdk/ # TypeScript 客户端,在 npm 上为 @gami.fied/sdk(MIT) │ ├── react/ # React 组件,在 npm 上为 @gami.fied/react(MIT) │ ├── elements/ # 与上述相同的组件,以 HTML 元素形式提供,@gami.fied/elements(MIT) │ ├── database/ # PostgreSQL schema、Drizzle ORM、迁移和认证 │ ├── rules/ # 规则求值 │ ├── rewards/ # XP、徽章、钱包和奖品 │ ├── progression/ # 等级和连续打卡 │ ├── challenges/ # 挑战进度 │ ├── leaderboards/ # 排名、分群和联赛 │ ├── notifications/ # 应用内和邮件通知

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →