
树状简历
一个服务端 Minecraft Fabric 模组,实现了基于树状结构的白名单系统,通过邀请链管理玩家访问权限。
Treevite
一个服务端 Minecraft Fabric 模组,实现基于树的邀请制白名单系统,通过邀请链管理玩家访问权限。
概述
Treevite 允许你通过层级邀请系统控制谁可以加入你的服务器。从仅控制台作为根管理员开始,白名单玩家可以邀请其他人,形成一棵"授权玩家树"。这提供了一种灵活、有机的方式来管理服务器访问权限,无需手动将每个玩家添加到白名单。
主要功能:
- 基于树的白名单系统,以控制台为根节点
- 通过
/invite命令实现的玩家间邀请系统 - 邀请撤销并自动调整权限
- 每位玩家的每日邀请次数限制(可配置)
- 支持 Java 版和基岩版玩家
- 邀请历史记录追踪
- 基于权限的命令(通过 Fabric Permissions API)
要求
- Minecraft 服务器 26.1.2(或兼容版本)
- Fabric Loader 0.19.2 或更高版本
- Java 25 或更高版本
- Fabric API
安装
- 下载
tree-invite.jar模组文件 - 将其放入服务器的
mods文件夹 - 启动服务器
- (可选)安装 Fabric Permissions API 以启用基于权限的命令访问
命令
玩家命令
/invite <player> [java|bedrock]
- 邀请玩家加入服务器
- 如果未指定平台,默认使用 Java 版
- 用户名通过 Mojang API 查询(Java)或转换为 XUID 格式(基岩版)
- 受每日次数限制(默认:每天 4 次邀请,服务器时间凌晨 02:00 重置)
/revokeinvite <player> [java|bedrock]
- 撤销你发送给某位玩家的邀请
- 只有原始邀请者可以撤销
- 平台可选;如果未指定,则同时检查两个平台
- 如果玩家没有其他回到控制台的路径,将失去访问权限
- 邀请数据会保留,以便重新邀请时自动恢复
/inviteinfo [player]
- 查看邀请信息
- 列出谁邀请了该玩家以及该玩家邀请了谁
- 如果未指定玩家,默认为命令执行者
管理员命令
/setmaxinvites <player> <count>
- 为某位玩家设置自定义的每日邀请上限
- 覆盖全局默认次数限制
- 设置为 0 可禁止该玩家邀请
/setglobalmaxinvites <count>
- 为所有玩家设置默认的每日邀请上限
- 仅控制台或高权限管理员可访问
工作原理
- 初始化: 初始时仅控制台在白名单中
- 邀请: 任何白名单玩家都可以使用
/invite邀请其他人 - 访问控制: 只要玩家通过邀请链拥有至少一条有效的回到控制台的路径,就可以加入
- 撤销: 当邀请被撤销时,受影响的玩家将失去访问权限,除非他们拥有另一条通往控制台的路径
- 恢复: 如果被撤销的玩家再次被邀请(直接或间接),他们将自动重新获得访问权限
示例场景
控制台(根)
├── Alice(由控制台邀请)
│ ├── Bob(由 Alice 邀请)
│ └── Carol(由 Alice 邀请)
└── Dave(由控制台邀请)
└── Eve(由 Dave 邀请)
- 所有玩家都可以加入
- 如果控制台撤销 Dave 的邀请,Eve 将失去访问权限(没有其他路径)
- 如果控制台撤销 Alice 的邀请,Bob 和 Carol 将失去访问权限
- 如果控制台重新邀请 Dave,Eve 将自动重新获得访问权限
配置
配置存储在 config/tree-invite-messages.json 中,并在重启后保留。模组会自动管理白名单数据——你无需修改原版白名单。
权限
当 Fabric Permissions API 可用时,将识别以下权限:
tree-invite.invite- 允许使用/invite命令tree-invite.revoke- 允许使用/revokeinvite命令tree-invite.info- 允许使用/inviteinfo命令tree-invite.admin.setmaxinvites- 允许使用/setmaxinvites命令tree-invite.admin.setglobalmaxinvites- 允许使用/setglobalmaxinvites命令
数据库
Treevite 默认使用 SQLite 进行持久化存储,但也支持 PostgreSQL。所有邀请关系和次数限制数据都会自动存储。
支持
- 问题反馈: 在 GitHub 仓库报告 bug
- 疑问: 查阅文档或在仓库讨论区提问
- 作者: AwesomestOwl
许可证
GNU General Public License v3.0 - 详情请参阅 LICENSE 文件
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。