HomeLink

🏠 HomeLink——优雅传送！

HomeLink 是一款轻量级、完全运行于服务端的模组，适用于 Fabric 和 NeoForge，让玩家轻松创建、管理自定义家园地点并传送过去。
非常适合生存服务器、SMP 和冒险类社区。

✨ 功能

• 📌 设置和删除命名家园
• 🧭 使用 /home <name>
• 传送到你的家园↩️ 返回上次传送前所在的位置，使用 /tpback
• 👥 向其他玩家发送传送请求，或接受他们发来的请求
• ⛔ 受到伤害或移动时，待处理的传送会被取消 （可配置）
• 🛡 抵达后获得短暂的伤害保护 （可配置）
• 📁 每位玩家的家园都会保存为易读的 JSON 文件
• 🌍 支持多世界，也适用于下界
• 💬 提供直观的反馈消息和日志
• 🛡 完全运行于服务端——无需安装客户端模组！

🔧 命令

• /sethome <name> ——在当前位置设置家园
• /delhome <name> ——删除指定家园
• /home [name] ——传送到某个家园（未指定名称时，传送到名为“home”的家园；如果只有一个家园，则传送到该家园）
• /tpback ——返回上次传送前所在的位置
• /tpto <player> ——请求传送到另一位玩家身边
• /tphere <player> ——请求另一位玩家传送到你身边
• /tpaccept <player> ——接受待处理的请求
• /tpdeny <player> ——拒绝待处理的请求
• /tpcancel ——取消你的待处理传送

⚙️ 配置

编辑位于以下位置的配置文件：
/config/HomeLink/HomeLink.json

可配置项目：

• 家园数量上限
• 家园传送延迟（/home）
• 返回传送延迟（/tpback）
• 传送延迟（/tpto、/tphere）
• 是否在移动时取消传送
• 传送请求的接受超时时间
• 抵达后的伤害保护时长

🧩 前置要求

Fabric

• Fabric Loader
• Fabric API

NeoForge

• NeoForge（无需其他依赖）

🛠️ 构建

本项目使用同一套共享代码库构建两种加载器版本：

• common/ ——模组本体（家园、传送、命令、配置、存储），使用纯 Minecraft 代码
• fabric/ ——Fabric 入口点以及 fabric.mod.json
• neoforge/ ——NeoForge 入口点和 neoforge.mods.toml

使用 gradlew build 运行（Java 25）。生成的 JAR 文件位于：

• fabric/build/libs/homelink-fabric-<version>.jar
• neoforge/build/libs/homelink-neoforge-<version>.jar

Minecraft、Fabric 和 NeoForge 的版本均在 gradle.properties 中设置。

🌟 为什么选择 HomeLink？

简单易用、适合服务器，并且提供丰富的生活品质功能。
无论你是休闲玩家，还是大型服务器的运营者，HomeLink 都能让传送体验流畅、公平且可配置。

📜 许可协议

本模组采用 GNU AGPLv3 许可协议。

💬 反馈

发现错误或有功能建议？
欢迎在 GitHub 上提交 issue 或 PR！