EpicHomes - 家园传送插件丨支持 1.26.1.x / Folia

EpicHomes 是一款高度优化、资源占用极低的 Minecraft 家插件，它集成了完整的 GUI 系统、异步传送功能，并原生支持 Folia 和 PlaceholderAPI，同时提供从其他主流家插件导入数据的能力，旨在为你提供终极的家管理体验。

💡核心特性

• 完整 GUI 系统：通过直观的图形界面进行家的传送和管理。
• 异步传送：完全优化的异步传送，最大限度减少对服务器性能的影响。
• 原生 Folia 支持：完全兼容 PaperMC 的 Folia 项目，为未来的多线程服务器架构做好准备。
• PlaceholderAPI 支持：轻松访问插件内部数据，用于在 HolographicDisplays 等插件中显示。
• 数据导入功能：支持从其他家插件（如 StormerHomes、EssentialsX）异步导入家数据，不影响服务器性能。
• 高度可配置：提供详细的配置文件，可自定义家的数量限制、传送延迟、GUI 外观等。

🎮命令与权限

玩家命令

• /home - 打开家列表 GUI 或传送至指定家。
• /home set <名称> - 在当前位置设置一个家。
• /home delete <名称> - 删除指定的家。
• /home list - 列出你所有的家。
• /sethome <名称> - 在当前位置设置一个家。
• /delhome <名称> - 删除指定的家。

管理员命令

• /homeadmin delete <玩家> <家名称> - 删除指定玩家的家。
• /homeadmin visit <玩家> <家名称> - 传送到指定玩家的家。
• /homeadmin list <玩家> - 列出指定玩家的所有家。
• /homeadmin reload - 重载插件配置和消息文件。
• /importhomes - 执行从其他插件导入家数据的操作（需要配置启用）。

关键权限

• epichomes.maxhomes.* - 绕过所有家的数量限制（OP 玩家默认拥有）。
• epichomes.maxhomes.groupX - 用于层级权限系统的家数量组权限（X 为 1-6）。
• epichomes.command.import - 允许使用 /importhomes 命令。
• epichomes.update - 接收游戏内的插件更新通知。

🔧配置概述

主要配置文件为 config.yml 和 messages.yml，修改后可能需要重启服务器才能生效。

家设置 (`config.yml`)

• homes.default-max-homes： 玩家默认可拥有的最大家数量（默认：3）。
• homes.permission-based-homes-max-amount.enabled： 是否启用基于层级权限的家数量系统（默认：false）。
• homes.disallowed-home-names： 禁止使用的家名称列表（区分大小写和语法）。

传送设置

• teleportation.delay-before-teleport.enabled： 传送前是否有延迟（默认：true）。
• teleportation.delay-before-teleport.time： 传送延迟时间（秒，默认：5）。
• teleportation.cancel-teleport-on-move： 玩家移动时是否取消传送（启用可能会增加服务器负载，默认：true）。

GUI 系统

• gui-system.use-global-gui.enabled： 是否启用 GUI 系统（默认：true）。
• 可自定义家列表、删除确认等 GUI 的标题、图标材质和描述文字。

数据导入

• general.home-data-importer.enabled： 是否启用数据导入功能（默认：false）。
• general.home-data-importer.import-from： 指定从哪个插件导入数据（如 EssentialsX）。

✨安装与依赖

要求

• 必需： Spigot、Paper 或兼容的服务器核心（支持 Folia）。
• 软依赖： PlaceholderAPI（用于变量支持）。
• 导入数据时： 需要同时启用 EpicHomes 和旧的家插件。

安装步骤

• 将 EpicHomes.jar 放入服务器的 plugins 文件夹。
• 启动服务器以生成配置文件和文件夹。
• 根据需求编辑 config.yml 和 messages.yml。
• 重载或重启服务器使配置生效。

数据导入步骤

• 在 config.yml 中，将 general.home-data-importer.enabled 设为 true，并设置 import-from 为源插件（如 EssentialsX）。
• 确保 EpicHomes 和旧家插件都已启用。
• 在游戏内或控制台执行命令 /importhomes（需要权限）。
• 导入成功后，即可安全移除旧的家插件。

❓常见问题与支持

• 问题反馈：请勿在评论区发布错误报告。请加入我们的 Discord 服务器并创建支持工单，或在插件讨论帖中留言。
• 开发版本：可以尝试最新的开发构建版，但请自行承担风险，并务必遵循每个版本附带的说明。
• 视频教程：用户 GreenArrow99 制作了视频文档，可在其 YouTube 频道查看。
• API 与开发：EpicHomes 提供了功能完整的 API，开发者可通过 Wiki 了解如何使用。

⭐服务条款摘要

使用 EpicHomes 即表示您同意 CraptiCraft 开发许可协议。主要条款包括：

• 插件仅供个人非商业使用。
• 禁止修改、反编译、分发或出售插件。
• 插件按“原样”提供，不提供任何担保。
• 开发者对因使用插件造成的任何损失不承担责任。
• 协议受英国 GDPR 法律管辖。
• 最后更新日期：2025年12月20日。

请务必在使用前阅读完整的服务条款。

EpicHomes 是一款功能强大的 Minecraft 家插件，它提供了直观的 GUI 界面、便捷的家管理命令以及完善的权限系统，让玩家和服务器管理员都能轻松设置和传送至家园。

💡命令

玩家命令

• /home - 打开玩家的家园列表 GUI。
• 别名：/h, /eh, /homes, /epichomes
• /home <home-name> - 将玩家传送至指定的家。
• /home list - 在聊天栏中显示玩家的所有家。
• /home set <home-name> - 在玩家当前位置设置一个家。
• /home delete <home-name> - 打开确认删除家的 GUI。
• /sethome <home-name> - 在玩家当前位置设置一个家。
• /delhome <home-name> - 打开确认删除家的 GUI。
• /importhomes - 从 StormerHomes 或 EssentialsX 导入所有可用的家。
• 别名：/ih, /epicimport, /ei, /importhome, /homeimport

管理员命令

• /homeadmin delete <player> <home-name> - 允许管理员删除其他玩家的家。
• /homeadmin visit <player> <home-name> - 将管理员传送至其他玩家的家。
• /homeadmin list <player> - 允许管理员查看指定玩家的所有家。
• /homeadmin reload - 允许管理员重载插件。
• 别名：/ha

🎮权限

权限节点如下

• epichomes.maxhomes.group1 - 默认授予所有玩家。
• epichomes.* - 默认授予 OP，包含所有子权限。
• epichomes.admin - 管理员基础权限。

- `epichomes.update` - 检查更新。

- `epichomes.maxhomes.*` - 无限制的家数量。

- `epichomes.command.*` - 所有命令权限。

- `epichomes.command.deleteothers` - 删除他人的家。

- `epichomes.command.visitothers` - 访问他人的家。

- `epichomes.command.listothers` - 查看他人的家列表。

- `epichomes.command.reload` - 重载插件。

- `epichomes.command.import` - 导入家园。

- `epichomes.bypass.*` - 绕过所有限制。

- `epichomes.bypass.cooldown` - 绕过传送冷却。

- `epichomes.bypass.movement` - 绕过移动限制。

🔧PlaceholderAPI

要使用以下占位符，必须安装最新版本的 PlaceholderAPI。

目前可用的 11 个占位符

• %epicHomes_pluginPrefix%
• %epicHomes_pluginVersion%
• %epicHomes_pluginAuthor%
• %epicHomes_baseServerVersion%
• %epicHomes_serverPackage%
• %epicHomes_pluginEnabled%
• %epicHomes_totalPlayerJoined%
• %epicHomes_userLastKnownName%
• %epicHomes_userUUID%
• %epicHomes_userHomeListSize%
• %epicHomes_userHomeList%

未来计划添加更多占位符，以显示关于玩家单个家的更多信息。

注意：无需从 PAPI eCloud 下载扩展，所有占位符均由 EpicHomes 内部提供。

✨API 集成

EpicHomes 拥有功能完整的 API，允许开发者访问插件内部功能，并添加更多自定义特性。

如需了解如何使用，请查阅 EpicHomes 的 Wiki 页面。