
zHomes 是一款现代、快速且完全可配置的 Spigot/Paper/Purpur/PufferFish 服务器家园插件。它专注于简洁性、速度和自定义功能,让服务器管理员能够为玩家提供熟悉但强大的传送体验。
部分功能:
- 创建、删除和列出家园
- 用于管理和转换家园的管理员工具
- 支持 PlaceholderAPI 消息占位符
- 支持 MiniPlaceholders 迷你消息占位符
- 支持 Vault 经济与命令消耗
- 集成 GriefPrevention 和 WorldGuard 进行区域检查
- 传送预热与安全传送检查
- 可配置命令、消息和权限
- 100% 可配置的菜单
- 使用 SQL(H2/SQLite/MariaDB/MySQL)进行存储(无需本地 data/ 目录)
由 yL3oft 维护。本项目免费且开源。

要求
- Java 17+(请查阅发行说明以获取确切的 JDK 要求)
- Paper、Spigot 或兼容分支
安装
- 从 Releases / Modrinth / Hangar / Spigot 下载最新的 JAR 文件。
- 将 JAR 文件放入服务器的
plugins/文件夹中。 - 启动服务器一次以生成配置文件(src/main/resources/config.yml 默认值)。
- 完成!
快速测试
- 作为玩家:输入
/sethome home1然后/home home1 - 作为管理员:输入
/zhomes reload

管理员
/zhomes info— 显示插件信息和统计信息。/zhomes reload— 重新加载插件配置和消息。/zhomes version <update>— 检查插件版本并在指定<update>时进行更新。/zhomes nearhomes [radius] <-u <user> -h <home>>— 检查某位置附近的家园(默认为您的位置)。管理员可以指定用户和家园以在该家园附近进行检查。/zhomes parse <player> <string>- 为特定玩家解析包含插件占位符和 PlaceholderAPI 占位符的字符串。/zhomes export— 将所有家园导出到插件文件夹中的 .json.gz 文件。/zhomes import <file>— 从/zhomes export导出的 .json.gz 文件中导入家园。/zhomes converter <type>— 内联转换工具,用于从其他插件导入家园(示例:/zhomes converter ultimatehomes)。查看详细的转换文档:
玩家 / 家园命令
/sethome [name]— 创建一个家园(如果省略则使用默认名称)。/delhome [name]— 删除一个家园。管理员可以使用/delhome <player:home>。/home [name]— 传送到一个家园。管理员可以使用/home <player:home>。/homes [player]— 列出家园。管理员可以使用/homes <player>。/home rename [oldName] [newName]— 重命名一个家园
注意
- 命令消耗和 Vault 集成需要安装 Vault。
- 某些命令具有仅限管理员的变体(请参阅下方的权限)。
完整命令列表及用法:

以下是权限节点及其在插件配置(zHomes/config.yml)中定义的默认意图。请使用您的权限插件来授予或拒绝这些权限。
命令权限
- zhomes.command.main — 主命令(默认为 True)
- zhomes.command.main.help — 帮助子命令(默认为仅限 OP)
- zhomes.command.main.version — 版本子命令(默认为 True)
- zhomes.command.main.info — 信息子命令(默认为仅限 OP)
- zhomes.command.main.reload — 重载子命令(默认为仅限 OP)
- zhomes.command.main.nearhomes - 附近家园子命令(默认为仅限 OP)
- zhomes.command.main.parse — 解析子命令(默认为仅限 OP)
- zhomes.command.main.converter — 转换器子命令(默认为仅限 OP)
- zhomes.command.main.importexport — 导入与导出子命令(默认为仅限 OP)
- zhomes.command.sethome —
/sethome(默认为 True) - zhomes.command.delhome —
/delhome(默认为 True)- zhomes.command.delhome.others —
/delhome <player:home>(默认为仅限 OP)
- zhomes.command.delhome.others —
- zhomes.command.homes —
/homes(默认为 True)- zhomes.command.homes.others —
/homes <player>(默认为仅限 OP)
- zhomes.command.homes.others —
- zhomes.command.home —
/home(默认为 True)- zhomes.command.home.others —
/home <player:home>(默认为仅限 OP) - zhomes.command.home.rename —
/home rename(默认为 True)
- zhomes.command.home.others —
绕过 / 杂项权限(在 config.yml 中定义)
- zhomes.bypass.limit — 绕过家园数量限制(默认仅 OP 可用)
- zhomes.bypass.dimensionalteleportation — 绕过维度限制(默认仅 OP 可用)
- zhomes.bypass.safeteleport — 绕过安全传送检查(默认关闭)
- zhomes.bypass.warmup — 绕过传送准备时间(默认仅 OP 可用)
- %command_permission%.bypass.command-cost — 绕过指令消耗(默认仅 OP 可用)。特定指令的绕过权限由指令权限字符串生成(详见 config.yml)
- %command_permission%.bypass.command-cooldown — 绕过指令冷却时间(默认仅 OP 可用)。特定指令的绕过权限由指令权限字符串生成(详见 config.yml)
如需查看权威默认值并进行修改,请打开仓库中的 src/main/resources/config.yml 或查阅实时文档:

zHomes 内置了转换器,可从知名插件导入家园数据。该转换器在聊天窗口中运行(非 GUI)。完整转换器详情见此处:

支持的集成:
- PlaceholderAPI — 支持消息占位符 & zHomes 提供的自定义 占位符。
- MiniPlaceholders - 支持 MiniMessage 占位符用于高级消息格式化 & zHomes 提供的自定义 占位符。
- Vault — 用于基于经济的指令消耗。
- GriefPrevention — 区域检查集成。
- WorldGuard — 区域和标志检查。
- MiniMessage — 高级消息格式化。
- bStats — 匿名指标统计(可配置)。
请在配置文件中启用或禁用集成,并确保在期望集成行为时已安装第三方插件。

如果您觉得 zHomes 有用或需要帮助:
- Discord:
- Issues:
- Docs:
通过给仓库加星并加入 Discord 来支持该项目!

zHomes is a modern, fast and fully-configurable homes plugin for Spigot/Paper/Purpur/PufferFish servers. It focuses on simplicity, speed and customization so server owners can give players a familiar — but powerful — teleportation experience.
Some features:
- Create, delete and list homes
- Admin tools for managing and converting homes
- PlaceholderAPI support for message placeholders
- MiniPlaceholders support for minimessage placeholders
- Vault support for economy/command-costs
- GriefPrevention and WorldGuard integration for region checks
- Teleport warmup and safe-teleport checks
- Configurable commands, messages and permissions
- 100% configurable menus
- Uses SQL (H2/SQLite/MariaDB/MySQL) for storage (no local data/ directory)
Maintained by yL3oft. This project is free and open-source.

Requirements
- Java 17+ (check release notes for exact JDK requirement)
- Paper, Spigot or a compatible fork
Installation
- Download the latest JAR from Releases / Modrinth / Hangar / Spigot.
- Place the JAR in your server's
plugins/folder. - Start the server once to generate config files (src/main/resources/config.yml defaults).
- You're done!
Quick test
- As a player:
/sethome home1then/home home1 - As an admin:
/zhomes reload

Admin
/zhomes info— Shows plugin info and stats./zhomes reload— Reloads plugin configuration and messages./zhomes version <update>— Checks the plugin version and updates if<update>is specified./zhomes nearhomes [radius] <-u <user> -h <home>>— Check for homes near a location (your location by default). Admins can specify a user and home to check near that home./zhomes parse <player> <string>- Parse a string with Plugin Placeholders & PlaceholderAPI placeholders for a specific player./zhomes export— Export all homes to a .json.gz file in the plugin folder./zhomes import <file>— Import homes from a .json.gz file exported by/zhomes export./zhomes converter <type>— Inline converter tool to import homes from other plugins (example:/zhomes converter ultimatehomes). See detailed converter docs:
Player / Home commands
/sethome [name]— Create a home (default name if omitted)./delhome [name]— Delete a home. Admins can use/delhome <player:home>./home [name]— Teleport to a home. Admins can use/home <player:home>./homes [player]— List homes. Admins can use/homes <player>./home rename [oldName] [newName]— Rename a home
Notes
- Command costs and vault integration require Vault to be installed.
- Some commands have admin-only variants (see Permissions below).
Full command list and usage:

Below are the permission nodes and their default intent as defined in the plugin configuration (zHomes/config.yml). Use your permissions plugin to grant or deny these.
Command permissions
- zhomes.command.main — Main command (True by default)
- zhomes.command.main.help — Help SubCommand (Only OP by default)
- zhomes.command.main.version — Version SubCommand (True by default)
- zhomes.command.main.info — Info SubCommand (Only OP by default)
- zhomes.command.main.reload — Reload SubCommand (Only OP by default)
- zhomes.command.main.nearhomes - Nearhomes SubCommand (Only OP by default)
- zhomes.command.main.parse — Parse SubCommand (Only OP by default)
- zhomes.command.main.converter — Converter SubCommand (Only OP by default)
- zhomes.command.main.importexport — Import & Export SubCommand (Only OP by default)
- zhomes.command.sethome —
/sethome(True by default) - zhomes.command.delhome —
/delhome(True by default)- zhomes.command.delhome.others —
/delhome <player:home>(Only OP by default)
- zhomes.command.delhome.others —
- zhomes.command.homes —
/homes(True by default)- zhomes.command.homes.others —
/homes <player>(Only OP by default)
- zhomes.command.homes.others —
- zhomes.command.home —
/home(True by default)- zhomes.command.home.others —
/home <player:home>(Only OP by default) - zhomes.command.home.rename —
/home rename(True by default)
- zhomes.command.home.others —
Bypass / misc permissions (as defined in config.yml)
- zhomes.bypass.limit — Bypass home limits (Only OP by default)
- zhomes.bypass.dimensionalteleportation — Bypass dimension restriction (Only OP by default)
- zhomes.bypass.safeteleport — Bypass safe-teleport checking (False by default)
- zhomes.bypass.warmup — Bypass teleport warmup (Only OP by default)
- %command_permission%.bypass.command-cost — Bypass command-cost (Only OP by default). Command-specific bypass permission is generated from the command permission string (see config.yml)
- %command_permission%.bypass.command-cooldown — Bypass commands cooldown (Only OP by default). Command-specific bypass permission is generated from the command permission string (see config.yml)
If you want to see the authoritative defaults and change them, open src/main/resources/config.yml in the repo or check the live docs:

zHomes contains an inline converter to import homes from well-known plugins. The converter runs in-chat (not a GUI). See full converter details here:

Supported integrations:
- PlaceholderAPI — Message placeholders supported & custom placeholders provided by zHomes.
- MiniPlaceholders - MiniMessage placeholders supported for advanced message formatting & custom placeholders provided by zHomes.
- Vault — for economy-based command-costs.
- GriefPrevention — region checks integration.
- WorldGuard — region and flag checks.
- MiniMessage — advanced message formatting.
- bStats — anonymous metrics (configurable).
Enable or disable integrations from config and ensure the third-party plugins are installed on the server when you expect integration behavior.

If you find zHomes helpful or need assistance:
- Discord:
- Issues:
- Docs:
Support the project by starring the repo and joining the Discord!
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 zHomes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
一般更改
- 修复了启动时旧的数据库迁移问题
完整更新日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧