Concierge

一款优先为服务端设计的实用模组,单人游戏也能兼容大部分功能。提供:
- 加入/离开追踪 — 将每次加入和离开的行为记录到控制台,检测首次加入情况,
并记录每位玩家上次在线时间和累计游玩时长(按玩家存储为 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 并复用其管理器,而不是重新实现家园/出生点/传送/套装功能。
Concierge

A utility mod, built server-first and most things will work for singleplayer too. Provides:
- Join/leave tracking — logs every join/leave to console, detects first-time joins,
tracks last-seen time and cumulative playtime per player (stored as JSON per player).
- Homes —
/sethome, /home, /delhome, /homes, with a configurable per-player
home limit driven by a permission node (so LuckPerms groups can grant different limits).
- Spawn —
/setspawn (admin), /spawn.
- Back —
/back, returns you to your previous location (before a teleport or death).
- TPA —
/tpa, /tpahere, /tpaccept, /tpdeny, /tpcancel.
- Utility —
/feed, /heal, /repair.
- Gamemode shortcuts —
/gmc, /gms, /gmsp.
- Virtual crafting/utility GUIs —
/anvil, /craft, /stonecutter, /grindstone,
/smithing, /trash — open the vanilla screen without needing the physical block.
- Admin inspection —
/invsee, /endersee to view/edit another player's inventory
or ender chest, live if they're online or saved-to-disk if they're offline. /ec lets
any player open their own ender chest.
- Kits —
/kit <name> to claim, plus /kit list, /kit create, /kit delete,
/kit give to manage them.
- Help —
/concierge help prints every command the invoking player currently has
permission to use, checked live against their actual permissions.
- Permissions — every command is gated by a permission node, and every
cooldown/warmup is also a permission node (not just a flat config value), so
LuckPerms can give different ranks different cooldowns and
warmup lengths. Node names are identical on all three loaders. Without a permissions
mod installed, each loader falls back to sensible defaults (all players / OP-only /
a config-file value, per node) — see Permissions on Fabric
for the one loader that needs an extra mod for full control.
- Extendable — a small public API (
ConciergeAPI) plus loader-agnostic join/leave
callbacks (ConciergeEvents) let other mods build on top without touching this mod's
code, using the same code on every loader.
This mod has no client-side content (no GUI, no key-binds, no client rendering) — it
only needs to be installed on the server.
Commands & permissions
Every command checks its permission node before running, through whatever permission system
the active loader provides (see Multi-loader architecture).
Node names are identical on all three loaders.
Homes
| Command |
Usage |
Permission node |
Default access |
/sethome [name] |
Save your current location as a home. Omit name for your default home. |
concierge.home.set |
all players |
/home [name] |
Teleport to a saved home. Omit name for your default home. |
concierge.home.tp |
all players |
/delhome <name> |
Delete a saved home. |
concierge.home.delete |
all players |
/homes |
List all your saved home names. |
concierge.home.list |
all players |
Spawn & back
| Command |
Usage |
Permission node |
Default access |
/spawn |
Teleport to the server spawn point. Uses the custom point set via /setspawn if there is one, otherwise falls back to the world's own spawn point. |
concierge.spawn.tp |
all players |
/setspawn |
Set the server spawn point to your current location. Also updates the actual vanilla world spawn point (the same one /setworldspawn sets). |
concierge.spawn.set |
ops only |
/back |
Return to your location before your last teleport or death. |
concierge.back |
all players |
TPA
| Command |
Usage |
Permission node |
Default access |
/tpa <player> |
Request to teleport to another player. |
concierge.tpa.send |
all players |
/tpahere <player> |
Request that another player teleport to you. |
concierge.tpa.send |
all players |
/tpaccept |
Accept your most recent incoming teleport request. |
concierge.tpa.accept |
all players |
/tpdeny |
Deny your most recent incoming teleport request. |
(none — always allowed) |
all players |
/tpcancel |
Cancel a teleport request you sent. |
(none — always allowed) |
all players |
Utility
| Command |
Usage |
Permission node |
Default access |
/feed |
Restore your hunger and saturation to full. |
concierge.feed |
all players |
/heal |
Restore your health to full, refill hunger, put out fire. |
concierge.heal |
all players |
/repair |
Fully repair the item in your main hand. |
concierge.repair |
all players |
/ec |
Open your own ender chest. |
concierge.enderchest |
all players |
Gamemode shortcuts
Equivalent to /gamemode <mode> but shorter to type, each with its own permission node
so a rank can be granted creative without also getting spectator, etc.
| Command |
Usage |
Permission node |
Default access |
/gmc |
Switch yourself to creative mode. |
concierge.gamemode.creative |
ops only |
/gms |
Switch yourself to survival mode. |
concierge.gamemode.survival |
ops only |
/gmsp |
Switch yourself to spectator mode. |
concierge.gamemode.spectator |
ops only |
Virtual crafting/utility GUIs
These open the vanilla screen without the physical block being present.
| Command |
Usage |
Permission node |
Default access |
/anvil |
Open a virtual anvil. |
concierge.anvil |
all players |
/craft |
Open a virtual crafting table. |
concierge.craft |
all players |
/stonecutter |
Open a virtual stonecutter. |
concierge.stonecutter |
all players |
/grindstone |
Open a virtual grindstone. |
concierge.grindstone |
all players |
/smithing |
Open a virtual smithing table. |
concierge.smithing |
all players |
/trash |
Open a trash can — anything left inside when closed is discarded. |
concierge.trash |
all players |
Admin inspection
| Command |
Usage |
Permission node |
Default access |
/invsee <player> |
View/edit a player's hotbar + main inventory (36 slots; armor/offhand not included). Works for offline players too. |
concierge.invsee |
ops only |
/endersee <player> |
View/edit a player's ender chest. Works for offline players too. |
concierge.endersee |
ops only |
Both accept any player name the server has ever seen, not just currently-online ones
(matched the same way /ban or /whitelist match names). If the target is online, the
view is live and edits apply immediately. If they're offline, Concierge reads their
saved playerdata/<uuid>.dat file directly, lets you edit a snapshot of it, and writes
your changes back to that file the moment you close the screen — armor and offhand
items already in the file are preserved untouched even though they aren't shown. If the
name has never joined the server (no saved data exists), the command tells you so
instead of opening an empty screen.
Kits
| Command |
Usage |
Permission node |
Default access |
/kit <name> |
Claim a kit (subject to that kit's own cooldown). |
concierge.kit.use |
all players |
/kit list |
List available kit names. |
(none — always allowed) |
all players |
/kit create <name> |
Save your current inventory (main 36 slots) as a new/replacement kit. |
concierge.kit.admin |
ops only |
/kit delete <name> |
Delete a kit. |
concierge.kit.admin |
ops only |
/kit give <player> <name> |
Give a kit to a player, bypassing their cooldown. |
concierge.kit.admin |
ops only |
/kit cooldown <name> <seconds> |
Set how long a player must wait between claims of that specific kit. |
concierge.kit.admin |
ops only |
Each kit has its own cooldown (default 0 = no cooldown for newly created kits),
tracked per player per kit — claiming daily doesn't put starter on cooldown too.
Set it with /kit cooldown <name> <seconds> any time after creating the kit.
concierge.admin.bypass.cooldown still bypasses any kit's cooldown entirely.
Any items that don't fit in the player's inventory when a kit is claimed are dropped
on the ground at their feet rather than lost.
Help
| Command |
Usage |
Permission node |
Default access |
/concierge or /concierge help |
Lists every Concierge command you currently have permission to use. |
(none — always allowed; filters the list itself) |
all players |
Cooldowns & warmups (LuckPerms-controllable)
These aren't tied to a specific command — they're integer permission nodes that tune
how the commands above behave, so different LuckPerms ranks can have different
cooldowns/warmups (e.g. VIPs get instant teleports, default players wait 5 seconds).
Each falls back to the matching value in the config file (server.toml on Forge/NeoForge,
server.json on Fabric) when no permission override applies.
| Node |
Type |
Default (no LuckPerms) |
Effect |
concierge.home.warmup |
integer (seconds) |
config home.warmupSeconds (3) |
Delay before /home teleports you. |
concierge.spawn.warmup |
integer (seconds) |
config spawn.warmupSeconds (3) |
Delay before /spawn teleports you. |
concierge.back.warmup |
integer (seconds) |
config back.warmupSeconds (3) |
Delay before /back teleports you. |
concierge.tpa.warmup |
integer (seconds) |
config tpa.warmupSeconds (3) |
Delay before an accepted /tpa//tpahere teleports you. |
concierge.tpa.cooldown |
integer (seconds) |
config tpa.cooldownSeconds (10) |
Cooldown between sending /tpa//tpahere requests. |
concierge.home.limit |
integer |
1 (players), 999 (ops) |
Max homes a player may have via /sethome. |
concierge.admin.bypass.cooldown |
boolean |
ops only |
Skips the /tpa//tpahere//kit cooldowns entirely. |
concierge.admin.bypass.warmup |
boolean |
ops only |
Skips all "don't move!" teleport delays entirely. |
Note on kits: kit cooldowns are set per-kit via /kit cooldown <name> <seconds>
(see Kits above), not through a permission node — the loaders' permission systems
requires nodes to be registered up front at startup, so a dynamic node like
concierge.kit.<name>.cooldown isn't practical for kits created later at runtime.
concierge.admin.bypass.cooldown still bypasses whatever cooldown a kit has.
All warmups are cancelled if the player moves (configurable via
general.cancelWarmupOnMove in the config file).
Example LuckPerms usage:
/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
Data storage
Data is split across three locations depending on what it's tied to:
World-scoped (coordinates only mean something in the world they were recorded in,
so this lives inside the world save and travels with backups/copies of it):
| Data |
Location |
Format |
| Homes |
<world>/concierge/homes/<player-uuid>.json — one file per player |
JSON |
| Spawn point |
<world>/concierge/spawn.json — single shared file |
JSON |
Server-scoped, config directory (settings an admin might hand-edit, alongside the
main config file, survives a world reset):
| Data |
Location |
Format |
| Main config (cooldowns, warmups, etc) |
config/concierge/server.toml (Forge/NeoForge)
config/concierge/server.json (Fabric) |
TOML / JSON |
| Kits |
config/concierge/kits/<kit-name>.nbt — one file per kit, includes that kit's own cooldown |
NBT (vanilla item-list format) |
Server-scoped, dedicated folder (constantly-changing runtime data rather than
settings, so it's kept out of config/, in its own top-level folder next to world/,
config/, mods/; also survives a world reset):
| Data |
Location |
Format |
| Join tracking (first join, last seen, total playtime) |
concierge/players/<player-uuid>.json |
JSON |
For a server running with the default level name, world-scoped data lands under
world/concierge/.... /back locations and pending /tpa requests are not
persisted at all — they're kept in memory only and reset on server restart, matching
common Essentials-style behaviour.
Config
A server config file is generated on first run — config/concierge/server.toml on
Forge/NeoForge (their built-in TOML config systems), or config/concierge/server.json on
Fabric (which has no built-in config system, so Concierge manages a JSON file itself) —
with cooldowns, warmup durations and the tpa request timeout. These are the fallback
values used only when a player has no matching LuckPerms permission override — see
Cooldowns & warmups above.
Extending
Other mods can depend on Concierge and reuse its managers instead of reimplementing
homes/spawn/tpa/kits.
评论 0
登录后参与评分
还没有评论,来抢沙发吧