
玩家群体
为你的服务器提供私有留存仪表板:日活跃用户、新用户与回访用户、D1/D7留存率、峰值在线人数、会话时长。无需数据库,无需云服务,一个jar文件即可。
玩家是在回归,还是只是路过?在线人数统计告诉你的是今晚的情况。玩家基数则告诉你上周的新人是否回来了——这个数字才决定服务器是否在增长。
把一个 jar 放进 mods/,启动服务器,打开它打印的链接。你会得到:
- 今日玩家,分为新玩家和回归玩家,并与昨日对比
- D1 和 D7 留存率:在首次访问发生在一天前 / 一周前的玩家中,有多少人回来了
- 首周回归:面向较小服务器的宽松版留存率
- 每日及历史最高在线人数,以及按小时统计的加入人数,让你知道何时安排活动
- 平均会话时长、聊天量,以及玩家使用的语言
- 最近玩家表格,包含会话数、游戏时间、首次和最后出现时间
- 游戏内
/playerbase命令,用于查看核心数字和仪表盘链接(管理员,或单人游戏中的任何人) - 一个 JSON API(
/api/summary、/api/players),供你自己的 Discord 机器人或电子表格使用
默认私密。所有内容都会写入 config/playerbase/ 下的纯文本文件,并通过随机 token 从服务器本机的 127.0.0.1 提供访问。任何数据都不会离开你的机器。没有账户,没有遥测,jar 中也没有第三方库。
对服务器负担很轻。三个事件监听器和一个仅追加日志。统计在启动时从日志重建,因此崩溃永远不会损坏数据库。
安装
- 将 jar 和 Fabric API 放入服务器的 mods/ 文件夹并启动服务器。
- 从服务器日志中读取仪表盘 URL(Playerbase dashboard: http://127.0.0.1:8765/?token=...),或在控制台运行
/playerbase。token 在首次启动时生成,并存储在config/playerbase/playerbase.properties中。 - 要从另一台机器访问仪表盘,请在
playerbase.properties中设置http.bind=0.0.0.0,并将其置于 HTTPS 或 SSH 隧道之后。请对 token 保密。
设置(config/playerbase/playerbase.properties)
http.enabled=true | http.bind=127.0.0.1 | http.port=8765 | http.token=(generated) | http.publicUrl= | data.retentionDays=90
FAQ
会拖慢服务器吗?没有可测量的开销:它只在有人加入、离开或聊天时记录一行文本。
数据在哪里?config/playerbase/ 中的 events.jsonl 和 playerbase.properties。
它与 LuckPerms、Essential Commands、Styled Chat 兼容吗?它不会触碰它们;它只监听加入、断开和聊天事件。
我的玩家数据会在任何地方共享吗?不会。没有任何内容被发送到服务器之外。
兼容性:Minecraft 26.3,搭配 Fabric Loader 0.20.1 和 Fabric API。Java 25。服务端:可在专用服务器和单人游戏的内置服务器上运行;其他玩家无需安装任何东西。许可证:MIT。
发现 bug 或想要新功能?在这里评论,我会回复。可按需提供服务器定制插件开发服务。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。