你好,我是 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 链接反馈。
Hi, I'm Js-Scrips, Im a FiveM developer and love using Fabric and i've noticed that Fabric doesnt have the same plugins as Forge, Bukkit ect.. So im here to change that! I'll be providing plugins for Fabric only that will try and give Fabric Servers more modern features and utilities that are either, never updated to the latest versions of Minecraft or features that are gate-kept for other Server Loaders.
ServerUtils — Essentials-style commands for Fabric
Lightweight, server-focused utilities that add essentials-style commands: homes, TPA, RTP, and back — with configurable warmups, cooldowns, safe teleports, and LuckPerms integration.
- Minecraft: 1.21.10 (Java Edition)
- Fabric Loader: 0.17.3+
- Requires: Fabric API (matching 1.21.10)
- Server-only mod (no client required)
Highlights
- Multiple homes per player with per-rank limits
- /home warmup (default 5s), per-second chime, cancel-on-movement, warp sound
- TPA requests with accept/deny
- RTP: border-aware, safe-location scan, optional chunk-loading, warmup + rank-based cooldown, optional hard max radius
- /back to previous location (cross-dimension)
- LuckPerms support for command access, home limits, and RTP cooldowns
- Simple JSON config at config/serverutils.json
Commands
- /sethome [name] — Set a home (default “home” if omitted)
- /home [name] — Teleport to a home; no argument lists your homes (warmup + chime + cancel-on-move)
- /homes — List your homes
- /delhome <name> — Delete a home
- /tpa <player> — Send a teleport request
- /tpaccept — Accept the latest TPA request
- /tpdeny — Deny the latest TPA request
- /rtp — Random safe teleport (border-aware, warmup + cooldown)
- /back — Return to your previous location
Notes
- Default warmups: /home 5s; /rtp 3s (both configurable)
- RTP can use a hard world radius cap (e.g., for a 50k×50k world, set 25,000)
LuckPerms Integration
- Use LuckPerms to grant command access, set per-rank home limits, adjust RTP cooldowns, or bypass cooldowns
Permission nodes (grant/deny per group/user)
- 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 seconds)
LuckPerms Meta keys (add in “Meta”, not “Permissions”)
- serverutils.homes.max = <integer>
- serverutils.rtp.cooldown = <integer seconds>
Examples (typical setup)
- Default group:
- Meta: serverutils.homes.max = 3
- Meta: serverutils.rtp.cooldown = 60
- VIP group:
- Meta: serverutils.homes.max = 10
- Meta: serverutils.rtp.cooldown = 15
- Staff:
- Permission: serverutils.homes.unlimited = true
- Permission: serverutils.rtp.bypasscooldown = true
Features and Behavior
Homes:
- Multiple homes per player, per-rank limits via nodes or LP meta
- Warmup (default 5s), per-second chime, cancel if the player moves, warp sound on arrival
TPA:
- /tpa, /tpaccept, /tpdeny with timeout (default 60s)
RTP:
- Safe search (no fluid, solid support, 2-block headroom, hazard checks)
- Respects world border and optional hard max radius
- Optional chunk-load so heightmap works off-road
- Warmup (default 3s) + cooldown via LP meta or nodes, warp sound on arrival
Back:
- Returns to previous location (cross-dimension).
Configuration (config/serverutils.json)
{
// Maximum number of homes a player can set by default (if not overridden by LuckPerms)
"defaultMaxHomes": 3,
// If true, LuckPerms meta key "serverutils.homes.max" overrides defaultMaxHomes per player/group
"useLuckPermsMetaForMaxHomes": true,
// Upper bound for scanning permission tiers "serverutils.homes.max.X" (X=1..permissionMaxHomesScanCeil)
"permissionMaxHomesScanCeil": 100,
// If true, players (or groups) with "serverutils.homes.unlimited" can set unlimited homes
"allowUnlimitedHomesPermission": true,
// Seconds before a /tpa request expires if not accepted/denied
"tpaTimeoutSeconds": 60,
// RTP: Minimum distance from center/border center for random teleport sampling (in blocks)
"rtpMinDistance": 100,
// RTP: Maximum distance for sampling (in blocks); may be further clamped by world border/hard max radius
"rtpMaxDistance": 5000,
// RTP: How many random attempts to find a safe spot before giving up
"rtpMaxAttempts": 12,
// If true, RTP sampling respects the world border and stays within it (minus margin)
"rtpRespectWorldBorder": true,
// Blocks to stay inside the world border when sampling RTP positions
"rtpWorldBorderMargin": 16,
// Dimensions where RTP is allowed; others are blocked
"rtpAllowedWorlds": [
"minecraft:overworld"
]
}
I will be updating this Plugin As i find issues and make it better for your server, so please feel free to report all issues to the github link.
评论 0
登录后参与评分
还没有评论,来抢沙发吧