Concierge

模组

· 作者 raymond570

你服务器的礼宾服务。提供家园、重生点、传送(TPA)、物品组等更多功能。

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.0ALPHA · 1.21.11 · Forge

一键开服(送7天)

Concierge

Concierge logo banner

一款优先为服务端设计的实用模组,单人游戏也能兼容大部分功能。提供:

  • 加入/离开追踪 — 将每次加入和离开的行为记录到控制台,检测首次加入情况, 并记录每位玩家上次在线时间和累计游玩时长(按玩家存储为 JSON 文件)。
  • 家园系统 — /sethome、/home、/delhome、/homes,支持配置每个玩家的 家园数量上限,由权限节点控制(因此 LuckPerms 组可以赋予不同的限制)。
  • 出生点 — /setspawn(管理员)、/spawn。
  • 返回 — /back,让你回到上一次传送或死亡前的位置。
  • 传送申请 (TPA) — /tpa、/tpahere、/tpaccept、/tpdeny、/tpcancel。
  • 实用工具 — /feed、/heal、/repair。
  • 快捷指令 — /gmc、/gms、/gmsp。
  • 虚拟合成/实用 GUI — /anvil、/craft、/stonecutter、/grindstone、 /smithing、/trash — 无需实体方块即可打开原版界面。
  • 管理员检查 — /invsee、/endersee 用于查看/编辑其他玩家的物品栏 或末影箱,若对方在线则实时查看,若离线则从磁盘读取。/ec 允许任何玩家打开自己的末影箱。
  • 套装 (Kits) — /kit <name> 领取套装,以及 /kit list、/kit create、/kit delete、 /kit give 用于管理套装。
  • 帮助 — /concierge help 打印当前调用者拥有权限的所有命令,并实时检查其实际权限。
  • 权限系统 — 每条命令都受权限节点控制,且每条冷却/引导时间 也 是权限节点(而不仅仅是配置文件中的固定值),这样 LuckPerms 可以给不同等级分配不同的冷却时间和引导时长。所有加载器的节点名称均相同。未安装权限模组时,各加载器会回退到合理的默认设置(所有玩家 / 仅 OP / 配置文件值,具体取决于节点)— 详见 Fabric 上的权限,了解需要额外模组才能完全控制的唯一加载器。
  • 可扩展性 — 小型公共 API (ConciergeAPI) 加上与加载器无关的加入/离开 回调 (ConciergeEvents) 让其他模组可以在此基础上构建,而无需修改此模组的代码,在所有加载器上使用相同的代码。

本模组不包含任何客户端内容(无 GUI、无快捷键绑定、无客户端渲染)— 它只需安装在服务端。

命令与权限

每条命令在运行前都会通过活动加载器提供的权限系统检查其权限节点(参见 多加载器架构)。 所有加载器的节点名称均相同。

家园

命令 用法 权限节点 默认访问权限
/sethome [name] 将当前位置保存为家园。省略 name 可保存为默认家园。 concierge.home.set 所有玩家
/home [name] 传送到已保存的家園。省略 name 可传送到默认家园。 concierge.home.tp 所有玩家
/delhome <name> 删除已保存的家園。 concierge.home.delete 所有玩家
/homes 列出所有已保存的家園名称。 concierge.home.list 所有玩家

出生点与返回

命令 用法 权限节点 默认访问权限
/spawn 传送到服务器出生点。如果有通过 /setspawn 设置的自定义点,则使用该点;否则回退到世界默认的出生点。 concierge.spawn.tp 所有玩家
/setspawn 将服务器出生点设置为你的当前位置。同时更新实际的原版世界出生点(即 /setworldspawn 设置的同一个点)。 concierge.spawn.set 仅 OP
/back 返回到最后一次传送或死亡前的位置。 concierge.back 所有玩家

传送申请 (TPA)

命令 用法 权限节点 默认访问权限
/tpa <player> 请求传送到另一位玩家处。 concierge.tpa.send 所有玩家
/tpahere <player> 请求另一位玩家传送到你这里。 concierge.tpa.send 所有玩家
/tpaccept 接受最近的一次传入传送请求。 concierge.tpa.accept 所有玩家
/tpdeny 拒绝最近的一次传入传送请求。 (无 — 始终允许) 所有玩家
/tpcancel 取消你发送的传送请求。 (无 — 始终允许) 所有玩家

实用工具

命令 用法 权限节点 默认访问权限
/feed 将饥饿值和饱和度恢复至满。 concierge.feed 所有玩家
/heal 将生命值恢复至满,补充饥饿值,扑灭身上的火焰。 concierge.heal 所有玩家
/repair 完全修复主手手中的物品。 concierge.repair 所有玩家
/ec 打开你自己的末影箱。 concierge.enderchest 所有玩家

快捷指令

等同于 /gamemode <mode>,但输入更短,每个指令都有独立的权限节点, 因此可以给某个等级授予创造模式权限,而不必同时授予旁观者模式等权限。

命令 用法 权限节点 默认访问权限
/gmc 将自己切换为创造模式。 concierge.gamemode.creative 仅 OP
/gms 将自己切换为生存模式。 concierge.gamemode.survival 仅 OP
/gmsp 将自己切换为旁观者模式。 concierge.gamemode.spectator 仅 OP

虚拟合成/实用 GUI

这些命令会在没有对应实体方块的情况下打开原版界面。

命令 用法 权限节点 默认访问权限
/anvil 打开虚拟铁砧。 concierge.anvil 所有玩家
/craft 打开虚拟工作台。 concierge.craft 所有玩家
/stonecutter 打开虚拟切石机。 concierge.stonecutter 所有玩家
/grindstone 打开虚拟砂轮。 concierge.grindstone 所有玩家
/smithing 打开虚拟锻造台。 concierge.smithing 所有玩家
/trash 打开垃圾桶——关闭时留在里面的物品将被丢弃。 concierge.trash 所有玩家

管理员检查

命令 用法 权限节点 默认访问权限
/invsee <player> 查看/编辑玩家的快捷栏 + 主背包(36个槽位;不包含护甲和副手)。也适用于离线玩家。 concierge.invsee 仅限 OP
/endersee <player> 查看/编辑玩家的末影箱。也适用于离线玩家。 concierge.endersee 仅限 OP

两者都接受服务器曾经见过的任何玩家名称,而不仅仅是当前在线的玩家 (匹配方式与 /ban 或 /whitelist 匹配名称的方式相同)。如果目标玩家在线,视图是实时的,编辑会立即生效。如果他们离线,Concierge 会直接读取其保存的 playerdata/<uuid>.dat 文件,允许你编辑该文件的快照,并在你关闭屏幕时将更改写回该文件——即使文件中已存在的护甲和副手物品未显示,也会保持不变。如果该名称从未加入过服务器(不存在保存的数据),命令会告知你,而不是打开一个空屏幕。

套装

命令 用法 权限节点 默认访问权限
/kit <name> 领取套装(受该套装自身冷却时间限制)。 concierge.kit.use 所有玩家
/kit list 列出可用的套装名称。 (无 — 始终允许) 所有玩家
/kit create <name> 将你的当前库存(主背包36个槽位)保存为新套装/替换套装。 concierge.kit.admin 仅限 OP
/kit delete <name> 删除套装。 concierge.kit.admin 仅限 OP
/kit give <player> <name> 向玩家发放套装,绕过其冷却时间。 concierge.kit.admin 仅限 OP
/kit cooldown <name> <seconds> 设置玩家在领取该特定套装之间必须等待的时间长度。 concierge.kit.admin 仅限 OP

每个套装都有自己的冷却时间(新创建的套装默认为0 = 无冷却时间), 按玩家和套装分别追踪——领取 daily 不会让 starter 进入冷却状态。 在创建套装后的任何时候都可以使用 /kit cooldown <name> <seconds> 进行设置。 concierge.admin.bypass.cooldown 仍然完全绕过任何套装的冷却时间。 当领取套装时,任何无法放入玩家背包的物品都会掉落在他们脚下,而不是丢失。

帮助

命令 用法 权限节点 默认访问权限
/concierge 或 /concierge help 列出你当前拥有使用权限的所有 Concierge 命令。 (无 — 始终允许;过滤列表本身) 所有玩家

冷却时间与预热(由 LuckPerms 控制)

这些不与特定命令绑定——它们是整数权限节点,用于调整上述命令的行为方式,因此不同的 LuckPerms 等级可以拥有不同的 冷却时间/预热时间(例如 VIP 获得瞬间传送,默认玩家等待5秒)。 如果没有权限覆盖,每个节点都会回退到配置文件中的匹配值(Forge/NeoForge 上的 server.toml, Fabric 上的 server.json)。

节点 类型 默认值(无 LuckPerms) 效果
concierge.home.warmup 整数(秒) 配置 home.warmupSeconds (3) 在你被 /home 传送之前的延迟。
concierge.spawn.warmup 整数(秒) 配置 spawn.warmupSeconds (3) 在你被 /spawn 传送之前的延迟。
concierge.back.warmup 整数(秒) 配置 back.warmupSeconds (3) 在你被 /back 传送之前的延迟。
concierge.tpa.warmup 整数(秒) 配置 tpa.warmupSeconds (3) 在接受 /tpa//tpahere 后你被传送之前的延迟。
concierge.tpa.cooldown 整数(秒) 配置 tpa.cooldownSeconds (10) 发送 /tpa//tpahere 请求之间的冷却时间。
concierge.home.limit 整数 1(玩家),999(OP) 玩家通过 /sethome 拥有的最大家园数量。
concierge.admin.bypass.cooldown 布尔值 仅限 OP 完全跳过 /tpa//tpahere//kit 的冷却时间。
concierge.admin.bypass.warmup 布尔值 仅限 OP 完全跳过所有“不要移动!”的传送延迟。

关于套装的说明: 套装冷却时间是通过 /kit cooldown <name> <seconds> (见上面的 Kits)按套装设置的,而不是通过权限节点——加载器的权限系统 要求在启动时预先注册节点,因此像 concierge.kit.<name>.cooldown 这样的动态节点对于运行时创建的套装来说并不实用。 concierge.admin.bypass.cooldown 仍然会绕过套装的任何冷却时间。

如果玩家移动,所有预热都会被取消(可通过配置文件中的 general.cancelWarmupOnMove 配置)。

LuckPerms 使用示例:

/lp group default permission set concierge.home.limit 3
/lp group vip permission set concierge.home.limit 10
/lp group vip permission settemp concierge.tpa.warmup 0
/lp group vip permission settemp concierge.tpa.cooldown 0
/lp group default permission set concierge.spawn.set false

数据存储

数据根据其所关联的内容分布在三个位置:

世界范围(坐标仅在他们被记录的世界中具有意义, 因此这些数据位于世界存档内部,并随备份/副本一起移动):

数据 位置 格式
家园 <world>/concierge/homes/<player-uuid>.json — 每位玩家一个文件 JSON
出生点 <world>/concierge/spawn.json — 单个共享文件 JSON

服务器作用域,配置文件目录(管理员可能会手动编辑的设置,与主配置文件一起,在世界重置后保留):

数据 位置 格式
主配置文件(冷却时间、热身时间等) config/concierge/server.toml (Forge/NeoForge)
config/concierge/server.json (Fabric)
TOML / JSON
套装 (Kits) config/concierge/kits/<kit-name>.nbt — 每个套装一个文件,包含该套装自身的冷却时间 NBT (原版物品列表格式)

服务器作用域,专用文件夹(不断变化的运行时数据而非设置,因此不放在 config/ 中,而是位于其自己的顶级文件夹中,与 world/、config/、mods/ 并列;同样在世界重置后保留):

数据 位置 格式
加入记录(首次加入、最后上线、总游戏时长) concierge/players/<player-uuid>.json JSON

对于使用默认世界名称运行的服务器,世界作用域的数据位于 world/concierge/... 下。/back 位置和待处理的 /tpa 请求不会被持久化存储——它们仅保存在内存中,并在服务器重启时重置,这与常见的 Essentials 风格行为一致。

配置

服务器配置文件在首次运行时生成——Forge/NeoForge 上为 config/concierge/server.toml(利用其内置的 TOML 配置系统),Fabric 上为 config/concierge/server.json(由于 Fabric 没有内置配置系统,Concierge 自行管理 JSON 文件)——其中包含冷却时间、热身持续时间和 tpa 请求超时设置。这些是备用值,仅在玩家没有匹配的 LuckPerms 权限覆盖时使用——参见上方的 冷却时间与热身。

扩展

其他模组可以依赖 Concierge 并复用其管理器,而不是重新实现家园/出生点/传送/套装功能。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源