树状简历

树状简历

一个服务端 Minecraft Fabric 模组,实现了基于树状结构的白名单系统,通过邀请链管理玩家访问权限。

管理

Treevite

一个服务端 Minecraft Fabric 模组,实现基于树的邀请制白名单系统,通过邀请链管理玩家访问权限。

概述

Treevite 允许你通过层级邀请系统控制谁可以加入你的服务器。从仅控制台作为根管理员开始,白名单玩家可以邀请其他人,形成一棵"授权玩家树"。这提供了一种灵活、有机的方式来管理服务器访问权限,无需手动将每个玩家添加到白名单。

主要功能:

  • 基于树的白名单系统,以控制台为根节点
  • 通过 /invite 命令实现的玩家间邀请系统
  • 邀请撤销并自动调整权限
  • 每位玩家的每日邀请次数限制(可配置)
  • 支持 Java 版和基岩版玩家
  • 邀请历史记录追踪
  • 基于权限的命令(通过 Fabric Permissions API)

要求

  • Minecraft 服务器 26.1.2(或兼容版本)
  • Fabric Loader 0.19.2 或更高版本
  • Java 25 或更高版本
  • Fabric API

安装

  1. 下载 tree-invite.jar 模组文件
  2. 将其放入服务器的 mods 文件夹
  3. 启动服务器
  4. (可选)安装 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>

  • 为所有玩家设置默认的每日邀请上限
  • 仅控制台或高权限管理员可访问

工作原理

  1. 初始化: 初始时仅控制台在白名单中
  2. 邀请: 任何白名单玩家都可以使用 /invite 邀请其他人
  3. 访问控制: 只要玩家通过邀请链拥有至少一条有效的回到控制台的路径,就可以加入
  4. 撤销: 当邀请被撤销时,受影响的玩家将失去访问权限,除非他们拥有另一条通往控制台的路径
  5. 恢复: 如果被撤销的玩家再次被邀请(直接或间接),他们将自动重新获得访问权限

示例场景

控制台(根)
├── 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 文件