
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 服务器多年来一直拥有的传送点和住所系统。如果你运行的是插件服务器,请使用原版:
请不要向 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 维护或支持。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。