菲乌·跃迁

Fiw Warp

为 Fabric 和 NeoForge 打造的轻量级、纯服务端传送模组。

Fiw Warp 为你的玩家提供家园功能，并为服务器管理员提供传送点功能。它内置了合理的可配置预热机制，使传送无法成为瞬间逃脱的按钮——同时还有可选的冷却时间以防止滥用。该模组仅限服务端运行，不注册任何网络通信，也不包含客户端代码，因此它不会干扰你的游戏体验，并保持服务器轻量化。

同一个模组即支持 Minecraft 1.21.11 版本的 Fabric 和 NeoForge。

✨ 功能特性

• 🏠 每个玩家多个命名的家园（可配置数量上限）
• 🌐 传送点 — 默认仅管理员可用，或可配置允许玩家创建自己的传送点（并设置每人上限）
• ✅ 传送确认 — 执行 /warp 传送前显示可点击的接受/拒绝提示（可选）
• ⏳ 预热传送 — 需保持站定数秒（默认5秒）；移动、受到攻击、攻击他人或破坏方块将取消传送（所有触发条件均可开关）
• ❄️ 独立冷却时间 — 针对 /home、/warp 和 /back 分别设置（默认关闭）
• ⚡ 管理员瞬间传送 — 通过权限等级实现
• 🎆 传送粒子效果 + 音效 — 带额外消散效果，瞬间传送时附带短暂的失明视觉特效——或完全关闭这些效果
• 💬 所有消息均可自定义 — 模组输出的任何文字都能在配置文件中修改
• 🪶 极小的文件体积，使用纯 JSON 存储，无 Architectury 依赖

🎮 命令

• /home [名称]、/sethome [名称]、/delhome [名称]、/edithome <名称> <新名称>、/homes
• /warp [名称]、/warp accept、/warp deny、/warps
• /back
• 传送点管理： /setwarp <名称>、/delwarp <名称>、/editwarp <名称> <新名称> — 默认仅管理员可用，或可配置为所有玩家开放（仅限管理自己的传送点）
• 管理员命令： /fiwwarp reload

⚙️ 配置

所有内容均可通过 config/fiwwarp/config.json 文件配置——包括预热时间、各命令冷却时间、传送取消条件、家园/传送点上限、跨维度传送开关、粒子/失明特效、传送确认、管理员权限等级，以及模组输出的所有消息文本。编辑配置文件后执行 /fiwwarp reload 即可生效。

自由组合各系统。 家园、传送点和返回系统均支持独立开关——例如，将 enable_warps 和 enable_back 设为 false，即可打造一个仅限家园功能的生存服务器。被禁用的系统将完全隐藏其对应命令。

📦 运行环境要求

• Fabric： Fabric API + Fabric Language Kotlin
• NeoForge： Kotlin for Forge

🧩 兼容性

仅限服务端运行。客户端无需安装本模组即可加入运行此模组的服务器。