Kits

礼包

基于权限的玩家礼包，适用于 Fabric 服务器。

[][modrinth:files]

[][modrinth:files]

Kits 是一个适用于 [Fabric][fabric] 服务器的 Minecraft 模组，它添加了可配置的、基于权限的玩家礼包。这允许服务器所有者轻松设置物品批次，供玩家根据其等级领取。此外，礼包可以设置预定义的冷却时间，以防止玩家无限使用。

兼容 LuckPerms

使用方法

添加礼包

命令：/kit add [时间单位]\

所需权限：kits.manage

要添加一个礼包，只需将您希望包含在此礼包中的物品放在您的物品栏中，然后运行命令 /kit add。

> 注意：

> [时间单位] 可以是 d（天）、h（小时）、m（分钟）、s（秒）、y（年）之一。如果未指定时间单位，冷却时间 将被解释为毫秒。

领取礼包

命令：/kit claim \

所需权限：kits.claim.

对于玩家来说，领取礼包很简单。他们只需输入 /kit claim 。如果他们拥有使用指定礼包的权限，并且该礼包对他们没有处于冷却状态，他们将在物品栏中收到礼包（如果物品栏已满，则掉落在地上）。

Brigadier 建议已启用，并且只会建议玩家拥有权限的礼包。

移除礼包

命令：/kit remove \

所需权限：kits.manage

要移除一个礼包，只需输入 /kit remove 。这将不可逆转且完全地 删除 服务器上所有用户的指定礼包。

重置玩家礼包冷却时间

如果作为管理员，您希望重置玩家的礼包冷却时间，允许他们重新领取已领取的礼包，可以使用以下命令：

重置单个礼包

命令：/kit resetPlayerKit \

所需权限：kits.manage

重置所有礼包

命令：/kit resetPlayer \

所需权限：kits.manage

礼包环

Kits 支持 礼包环 —— 共享共同冷却时间的礼包集合。当玩家领取环中的任何礼包时，环中的所有礼包将一起进入冷却状态。

有关礼包环的详细信息，请参阅 RINGS.md。

高级功能

Kits 将其大部分数据存储在 nbt 文件中，使用 Minecraft 的 NBT 格式。您可以使用 [NBTExplorer][nbtexp] 等工具修改和创建此类文件。

礼包配置文件

如果出于某种原因，您希望手动配置礼包，而不是使用内置命令，可以通过直接修改礼包文件来实现。

礼包文件存储在 config/kits 目录中，采用 Minecraft 的 NBT 格式。

这允许您在创建后修改礼包内容或冷却时间，甚至添加全新的礼包。

玩家礼包使用记录文件

每当玩家成功领取一个礼包时，领取时间会被记录在一个用户特定的文件中，文件名为 .nbt，位于 world/kitsuserdata 目录中。

如果您希望重置或修改用户下次可以使用已领取礼包的时间，可以编辑此文件中指定的时间（存储为 自 Epoch 以来的毫秒数）。要重置给定用户的所有礼包冷却时间，只需删除与其对应的 nbt 文件。

贡献

感谢您考虑为 Kits 做出贡献！请参阅 [贡献指南][contributing]。

许可证

Kits 是根据 [MIT 许可证][licence] 授权的开源软件。

Discord

有问题吗？在 [我的 Discord 服务器][discord] 中联系我。

[nbtexp]: https://github.com/jaquadro/NBTExplorer

[contributing]: .github/CONTRIBUTING.md

[curseforge]: https://curseforge.com/minecraft/mc-mods/kits

[curseforge:files]: https://www.curseforge.com/minecraft/mc-mods/kits/files

[modrinth:files]: https://modrinth.com/mod/kits/versions

[fabric]: https://fabricmc.net/

[licence]: LICENCE

[minecraft]: https://minecraft.net/

[releases]: https://github.com/John-Paul-R/kits/releases

[security]: .github/SECURITY.md

[discord]: https://discord.jpcode.dev/