JS Server Utilities

模组

· 作者 JS-Scripts

Fabric 实用插件,为你的服务器提供简单命令

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.10 · Fabric

一键开服(送7天)

你好,我是 Js-Scrips,一名 FiveM 开发者,也是 Fabric 的忠实用户。我注意到 Fabric 并没有像 Forge、Bukkit 等其他平台那样拥有同样丰富的插件生态。因此,我来填补这一空白!我将专门为 Fabric 提供插件,旨在为 Fabric 服务器带来更现代化的功能与实用工具,这些功能要么从未更新到 Minecraft 最新版本,要么被其他服务器加载器所独占。


ServerUtils — 适用于 Fabric 的 Essentials 风格命令

轻量级、面向服务器的实用工具,添加了类似 Essentials 的命令:包括家园(homes)、传送申请(TPA)、随机传送(RTP)和返回(back),支持可配置的等待时间、冷却时间、安全传送以及 LuckPerms 权限集成。

  • Minecraft:1.21.10(Java版)
  • Fabric Loader:0.17.3+
  • 依赖:Fabric API(匹配 1.21.10 版本)
  • 仅限服务端模组(无需客户端安装)

亮点

  • 每个玩家可设置多个家园,并支持按权限组限制数量
  • /home 命令支持等待时间(默认5秒),每秒提示音,移动即取消,传送音效
  • TPA 请求支持接受/拒绝
  • RTP:边界感知、安全位置扫描、可选区块加载、等待时间 + 基于权限组的冷却时间、可选最大半径限制
  • /back 返回上一位置(支持跨维度)
  • 支持 LuckPerms 用于命令访问、家园数量限制及 RTP 冷却时间控制
  • 简单的 JSON 配置文件位于 config/serverutils.json

命令

  • /sethome [name] — 设置一个家园(如果省略名称,默认为“home”)
  • /home [name] — 传送至指定家园;不带参数列出你的所有家园(含等待时间 + 提示音 + 移动取消机制)
  • /homes — 列出你的所有家园
  • /delhome <name> — 删除指定家园
  • /tpa <player> — 向玩家发送传送请求
  • /tpaccept — 接受最新的 TPA 请求
  • /tpdeny — 拒绝最新的 TPA 请求
  • /rtp — 随机安全传送(边界感知,含等待时间与冷却时间)
  • /back — 返回上一位置

备注

  • 默认等待时间:/home 5秒;/rtp 3秒(均可配置)
  • RTP 可使用硬世界半径上限(例如,对于 50k×50k 的世界,设置为 25,000)

LuckPerms 集成

  • 使用 LuckPerms 授予命令访问权限、设置各权限组的家园上限、调整 RTP 冷却时间或绕过冷却时间

权限节点(可按组/用户授予或拒绝)

  • serverutils.command.home
  • serverutils.command.sethome
  • serverutils.command.delhome
  • serverutils.command.homes
  • serverutils.command.back
  • serverutils.command.tpa
  • serverutils.command.tpaccept
  • serverutils.command.tpdeny
  • serverutils.command.rtp
  • serverutils.homes.unlimited
  • serverutils.homes.max.X (X = 1..100)
  • serverutils.rtp.bypasscooldown
  • serverutils.rtp.cooldown.N (N = 0..3600 秒)

LuckPerms 元数据键(在“Meta”中添加,而非“Permissions”)

  • serverutils.homes.max = <整数>
  • serverutils.rtp.cooldown = <整数秒>

示例(典型配置)

  • 默认组:
    • Meta: serverutils.homes.max = 3
    • Meta: serverutils.rtp.cooldown = 60
  • VIP 组:
    • Meta: serverutils.homes.max = 10
    • Meta: serverutils.rtp.cooldown = 15
  • 员工组:
    • Permission: serverutils.homes.unlimited = true
    • Permission: serverutils.rtp.bypasscooldown = true

特性与行为

家园:

  • 每位玩家可设置多个家园,通过节点或 LP(LuckPerms)元数据实现按权限组限制数量
  • 传送前等待时间(默认 5 秒),每秒提示音,若玩家移动则取消传送,到达时播放传送音效

传送申请(TPA):

  • 支持 /tpa、/tpaccept、/tpdeny 命令,并设有超时机制(默认 60 秒)

随机传送(RTP):

  • 安全搜索:避免液体方块、确保地面坚实、保留至少 2 格头部空间、进行危险检查
  • 尊重世界边界,并支持可选的最大半径限制
  • 可选区块加载功能,使高度图在野外也能正常工作
  • 传送前等待时间(默认 3 秒)+ 冷却时间通过 LP 元数据或节点控制,到达时播放传送音效

返回:

  • 返回到上一个位置(跨维度)。

配置 (config/serverutils.json)

{
  // 玩家默认可设置的最大家园数量(如果未被 LuckPerms 覆盖)
  "defaultMaxHomes": 3,

  // 如果为 true,LuckPerms 元数据键 "serverutils.homes.max" 将按玩家/组覆盖 defaultMaxHomes
  "useLuckPermsMetaForMaxHomes": true,

  // 扫描权限层级 "serverutils.homes.max.X" 的上限 (X=1..permissionMaxHomesScanCeil)
  "permissionMaxHomesScanCeil": 100,

  // 如果为 true,拥有 "serverutils.homes.unlimited" 权限的玩家(或组)可以设置无限个家园
  "allowUnlimitedHomesPermission": true,

  // /tpa 请求在被接受或拒绝前过期的秒数
  "tpaTimeoutSeconds": 60,

  // RTP:随机传送采样时距离中心/边界中心的最小距离(以方块为单位)
  "rtpMinDistance": 100,

  // RTP:采样的最大距离(以方块为单位);可能会进一步受世界边界/硬最大半径的限制
  "rtpMaxDistance": 5000,

  // RTP:在放弃之前寻找安全位置的最大随机尝试次数
  "rtpMaxAttempts": 12,

  // 如果为 true,RTP 采样会尊重世界边界并保持在边界内(减去边距)
  "rtpRespectWorldBorder": true,

  // 在采样 RTP 位置时,与世界边界保持的内部距离(方块数)
  "rtpWorldBorderMargin": 16,
}
// 允许使用 RTP 的维度;其他维度将被阻止
"rtpAllowedWorlds": [
  "minecraft:overworld"
]
}

我将根据发现的问题持续更新此插件,以更好地适配您的服务器。如有任何问题,请随时通过 GitHub 链接反馈。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源