AWarp

AWarp

适用于NeForge和Fabric 26.3的服务端传送点、家园和传送基础功能,移植自Gecolay的GWarp。玩家传送点带有排行榜、密码、锁和到达效果,私有家园、/back、/tpa和/spawn,以及管理员工具。无需客户端安装。

AWarp

由 Gecolay 开发的 GWarp 的 NeoForge 与 Fabric 移植版:玩家传送点、管理员传送工具、私人住所,以及 /back、/tpa 和 /spawn。它仅运行在服务端。

玩家无需安装任何东西。将对应加载器的 jar 放入服务器的 mods 文件夹即可。

加载器 需下载的文件 还需要
NeoForge awarp-neoforge-1.3.0.jar 无
Fabric awarp-fabric-1.3.0.jar Fabric API

两个版本拥有相同的命令、权限和功能,并以相同格式保存数据。

❤️ 鸣谢

本模组基于 Gecolay 开发的 GWarp,并经 Gecolay 许可发布。原始设计、功能集和命令布局的所有功劳均归其所有。

我针对 NeoForge 和 Fabric 从零重写了它,因此不包含 GWarp 的任何代码,模组服务器现在也能使用 Spigot 和 Paper 服务器多年来一直拥有的传送点和住所系统。如果你运行的是插件服务器,请使用原版:

👉 SpigotMC 上的 GWarp

请不要向 Gecolay 报告本移植版的 bug。请在本项目的 问题追踪器 或评论中反馈。

🔀 AWarp 与 GWarp 的区别

  • 平台: 运行于 NeoForge 和 Fabric 服务器及单人游戏,而非 Spigot/Paper,且仅限服务端。
  • 额外命令: /back(包括返回死亡地点)、/tpa、/tpahere、/tpaccept、/tpdeny、/spawn 和 /setspawn。
  • 与其他模组友好共存: 每项功能均可在配置中关闭,因此可与 FTB Essentials 或类似模组同时运行而不发生命令冲突。
  • 权限: 在 NeoForge 上使用 NeoForge 的 Permission API,在 Fabric 上使用 fabric-permissions-api,因此两个平台上均可与 LuckPerms 配合使用。节点名称与 GWarp 不同。
  • 更公平的排行榜: 访客按每位玩家只计一次,因此一个人无法通过反复传送来将自己的传送点推上 /warp top。
  • 消息: 仅提供英文,但每条消息均可在 messages.json 中编辑。
  • 无追踪: 无 bStats,也无更新检查器。
  • 数据: 现有的 GWarp 传送点和住所不会被导入。

✨ 功能

传送点

  • 玩家拥有的传送点,服务器上任何人都可以访问
  • 每位玩家的传送点数量上限,可通过权限按玩家或按组覆盖
  • 访客计数器,以及显示访问量最高传送点的 /warp top 排行榜
  • 分页传送点列表,显示每个传送点的拥有者和访客数
  • 玩家到达时显示的欢迎消息
  • 锁定传送点以对访客关闭
  • 为传送点设置密码保护(/warp <name> <password>)
  • 到达粒子和音效,可从游戏内任意粒子或音效中选择,支持 Tab 补全
  • 传送冷却,附带绕过权限
  • 安全传送检查,不会将玩家丢入岩浆、固体方块内部或虚空之上(可选)
  • 仅限同维度模式(可选)
  • 私人传送点:只有拥有者和受邀玩家可以看见或使用
  • /warps 打开一个包含所有传送点的箱子菜单,带分页,玩家点击即可传送(兼容原版客户端)
  • 可点击聊天:点击 /warp list 或 /warp top 中的任意传送点即可前往
  • 快捷命令:/setwarp、/delwarp、/updatewarp

住所

  • 私人住所,默认每位玩家 10 个(可配置)
  • 设置、移动、删除和列出你的住所,显示坐标和维度。点击列表中的住所即可前往
  • 与朋友共享住所,朋友随后可通过 /home visit 访问
  • 兼容 Essentials 习惯的快捷命令:/homes、/sethome、/delhome
  • /home back 将你带回上次传送前的位置

传送基础功能

  • /back 将你带回上次传送前的位置,或死亡地点
  • /tpa 和 /tpahere 传送请求,带有可点击的 [接受] 和 [拒绝] 按钮,60 秒后过期(可配置)
  • /tpacancel 撤回请求,/tptoggle 阻止其他玩家向你发送请求
  • /spawn,以及用于选择其目的地的 /setspawn

面向服主

  • 仅限服务端,因此原版客户端可以加入
  • /awarp 下的完整管理工具集,用于管理任意传送点、更改拥有者、重置访客数以及将玩家发送到传送点
  • 每条命令都有权限节点,在两个加载器上均可与 LuckPerms 及其他权限模组配合使用(在 Fabric 上,权限库已内置,无需额外安装)
  • 可选的传送预热(“3 秒后传送,请勿移动!”),若玩家移动或受到伤害则取消,因此没人能在战斗中传送逃离。默认关闭
  • 每项功能均可单独开启或关闭
  • 每条消息均可在 messages.json 中使用 & 颜色代码编辑
  • /warpreload 无需重启即可重新加载消息(在 Fabric 上还包括设置)
  • 数据按世界以纯 JSON 保存,便于备份或编辑,且世界可在 NeoForge 和 Fabric 版本之间迁移

📜 命令

传送点:/warp

命令 描述
/warp <name> [password] 前往传送点
/warp top 访问量最高的传送点
/warp list [page] 所有传送点
/warp set <name> 在你站立的位置创建传送点
/warp delete <name> 删除你的传送点
/warp update <name> 将你的传送点移动到你所站立的位置
/warp welcome <name> <text>|clear 设置或清除欢迎消息
/warp warps [player] 列出某位玩家的传送点
/warp lock <name> 锁定或解锁你的传送点
/warp owner <name> 查看传送点的拥有者
/warp password <name> [password|clear] 显示、设置或清除密码
/warp effect [name] [effect|clear] 到达粒子
/warp sound [name] [sound|clear] 到达音效
/warp private <name> 将你的传送点设为私人或重新公开
/warp invite <name> <player> 允许某位玩家使用你的私人传送点
/warp uninvite <name> <player> 撤回该许可
/warps 在箱子菜单中浏览传送点

快捷命令:/setwarp、/delwarp(或 /deletewarp)、/updatewarp

住所:/home

命令 描述
/home <name> 前往住所
/home set <name> 在你站立的位置设置住所
/home delete <name> 删除住所
/home update <name> 将住所移动到你所站立的位置
/homes 或 /home homes 列出你的住所
/home back 返回上次传送前的位置
/home invite <player> <home> 与某位玩家共享住所
/home uninvite <player> <home> 停止共享
/home visit <player> <home> 前往别人与你共享的住所
/home shared 列出与你共享的住所

快捷命令:/sethome [name](仅 /sethome 会创建一个名为 "home" 的住所)、/delhome <name>、/homes

传送基础功能

命令 描述
/back 返回上次传送前的位置,或死亡地点
/tpa <player> 请求传送到某位玩家处
/tpahere <player> 请求某位玩家传送到你处
/tpaccept [player] 接受最新的请求,或来自该玩家的请求
/tpdeny [player] 拒绝最新的请求,或来自该玩家的请求
/tpacancel [player] 取消你发送的请求(不带名字则取消全部)
/tptoggle 停止或开始接收传送请求
/spawn 前往出生点
/setspawn 设置 /spawn 的目的地(不会更改原版世界出生点)

管理:/awarp

命令 描述
/awarp warp <player> <warp> 将玩家发送到传送点
/awarp set <name> <player> 创建属于某位玩家的传送点
/awarp delete <name> 删除任意传送点
/awarp update <name> 移动任意传送点
/awarp welcome <name> <text>|clear 编辑任意欢迎消息
/awarp lock <name> 锁定或解锁任意传送点
/awarp setowner <name> <player> 更改传送点的拥有者
/awarp reset <name>|all 重置访客数
/awarp password <name> [password|clear] 管理任意传送点的密码
/awarp effect [name] [effect|clear] 管理任意传送点的粒子
/awarp sound [name] [sound|clear] 管理任意传送点的音效
/awarp count <name> 开启或关闭访客计数
/awarp private <name> 将任意传送点设为私人或公开
/awarp version 显示模组版本
/warpreload 重新加载消息

🔑 权限

所有节点均以 awarp. 开头。管理员(OP)拥有全部权限。服主可通过 LuckPerms 或其他权限模组更改其中任意一项。

所有玩家默认拥有: warp.use、warp.top、warp.list、warp.set、warp.delete、warp.update、warp.welcome、warp.warps、warp.warps_other、warp.lock、warp.owner、warp.password、warp.effect、warp.sound、warp.private(同时涵盖 invite 和 uninvite)、warp.menu、home.use、home.set、home.delete、home.update、home.list、home.back、home.share、home.visit(同时涵盖 /home shared)、back、tpa(同时涵盖 /tpaccept、/tpdeny 和 /tpacancel)、tpahere、tpa.toggle、spawn

默认仅管理员(OP)拥有: warp.cooldown_bypass、warp.lock_bypass、warp.password_bypass、warp.unsafe_bypass、warp.private_bypass、home.cooldown_bypass、tpa.cooldown_bypass、spawn.cooldown_bypass、warmup_bypass、setspawn、reload,以及所有 admin.* 节点

上限(整数节点,-1 = 无限制):awarp.warp.limit、awarp.home.limit。在 LuckPerms 中将其设为 meta,例如 /lp group vip meta set awarp.warp.limit 5

⚙️ 配置

设置文件在首次启动时创建:NeoForge 上为 config/awarp-local.toml,Fabric 上为 config/awarp.json。两者使用相同的选项名称。主要选项及其默认值:

选项 默认值 备注
use_warp / use_admin_warp / use_shortcuts / use_home true 开启或关闭命令组(需要重启)
use_back / use_tpa / use_spawn true 开启或关闭基础功能(需要重启)
use_home_shortcuts / use_warp_menu true 开启或关闭 /homes、/sethome、/delhome 和 /warps 菜单(需要重启)
warmup_seconds 0 传送预热秒数。0 = 关闭
cancel_on_move / cancel_on_damage true 什么会取消预热
default_warp_amount 1 每位玩家的传送点数
default_home_amount 10 每位玩家的住所数
warp_cooldown_seconds 10
home_cooldown_seconds 0
spawn_cooldown_seconds 0
back_on_death true /back 将玩家带回死亡地点
tpa_timeout_seconds 60 传送请求的持续时间
tpa_cooldown_seconds 5 发送请求之间的等待时间
use_safe_warp false 阻止不安全的目的地
same_dimension_only false
owner_counts_as_visitor false
broadcast_visitor_reset true 向所有人公告 /awarp reset all
list_page_size / top_amount 10
top_min_visitors 1 出现在 /warp top 中所需的访客数
min_name_length / max_name_length 1 / 20
min_password_length / max_password_length 1 / 15
粒子数量 / 偏移 / 速度,音效音量 / 音调 50 / 1.0 / 0.5,1.0 / 1.0 到达效果调节

消息存储在 config/awarp/messages.json。传送点、住所、共享住所和出生点按世界保存在 <world>/awarp/ 中。

📦 需求

  • Minecraft 26.3
  • NeoForge: NeoForge 26.3.0.95 或更新版本
  • Fabric: Fabric Loader 0.20.1 或更新版本,以及 Fabric API
  • 仅限服务端。客户端无需安装该模组即可加入。

💬 支持

发现 bug 或有想法?请在评论中或 问题追踪器 上发布。这是一个非官方移植版,请不要向原作者发送支持请求。

GWarp © Gecolay。AWarp 是一个独立的 NeoForge 和 Fabric 移植版,经 Gecolay 许可发布;它不由 Gecolay 维护或支持。