Homes
Homes 是一款快速、安全且轻量的 Minecraft 服务器家园管理插件[cite: 4]。它拥有简洁的指南针 GUI[cite: 5],支持多后端存储(SQLite、MySQL 和传统 YAML)[cite: 4],采用端到端 AES-256-GCM 坐标加密以保障玩家隐私[cite: 4],并内置 13 种语言的本地化支持[cite: 4]。
命令
玩家与管理员命令
| 命令 | 别名 | 描述 |
|---|---|---|
/sethome <name> |
/sethomes |
在当前位置设置一个家园[cite: 4, 5] |
/delhome <name> |
/rehome, /deletehome |
删除已有的家园[cite: 4, 5] |
/home <name> |
/h |
传送至指定的家园[cite: 4, 5] |
/homes |
/homelist |
打开家园 GUI(指南针,点击即可传送)[cite: 4, 5] |
/home reload |
— | 重载配置文件、语言文件,并热切换存储后端[cite: 4] |
仅限控制台命令
(严格限制在服务器控制台中使用——游戏内玩家,即使是 OP,也无法执行这些命令)[cite: 4]
| 命令 | 描述 |
|---|---|
/home clear <player|all> |
清除特定玩家或全服所有玩家的家园[cite: 4] |
/homes add <homes.yml|sqlite|legacy> to mysql <user:password> |
将 YAML 或 SQLite 中的所有家园数据迁移并加密至 MySQL,过程中零服务器卡顿[cite: 4] |
权限节点
| 节点 | 描述 | 默认值 |
|---|---|---|
homes.sethome |
允许设置家园[cite: 5] | 所有人 (true)[cite: 5] |
homes.delhome |
允许删除家园[cite: 5] | 所有人 (true)[cite: 5] |
homes.home |
允许传送到家园[cite: 5] | 所有人 (true)[cite: 5] |
homes.homes |
允许打开家园 GUI[cite: 5] | 所有人 (true)[cite: 5] |
homes.bypass |
绕过最大家园数量限制 (home-limit)[cite: 5] |
op[cite: 5] |
主要特性
存储后端与热切换
| 后端 | 描述 |
|---|---|
| SQLite (默认) | 本地 homes.db 运行于 WAL 模式(预写式日志),并使用隔离的连接池以防止文件锁定[cite: 4] |
| MySQL / MariaDB | 远程数据库支持,由集成、阴影处理并重定位的 HikariCP 连接池驱动[cite: 4] |
| Legacy YAML | 使用 homes.yml,通过 .tmp 文件原子保存(ATOMIC_MOVE)以防止崩溃时数据损坏[cite: 4] |
| 热切换支持 | 无需重启服务器,即可在 config.yml 中通过 /home reload 在 sqlite、mysql 和 legacy 之间即时切换[cite: 4] |
防管理员窥探隐私 (AES-256-GCM 加密)
- 端到端坐标加密: 所有坐标 ($X, Y, Z$)、世界以及视角角度 ($Yaw, Pitch$) 在写入 SQLite、MySQL 或
homes.yml之前均经过 AES-256-GCM 加密[cite: 4]。 - 管理员无法窥探: 服务器管理员即使通过 phpMyAdmin、DBeaver、HeidiSQL 或文本编辑器检查数据库,也无法查看玩家坐标(存储为加密的
ENC:v1:...字符串)[cite: 4]。 - 每玩家密钥: 唯一密钥通过
HMAC-SHA256(MasterKey, PlayerUUID)派生,每条记录具有唯一的 12 字节 IV[cite: 4]。如果留空,将自动生成一个 256 位密钥并保存在.encryption_key中[cite: 4]。
多语言支持 (13 种语言)
- 内置语言包: 包含
en、ru、zh、de、fr、es、pt、ja、uk、it、pl、tr和ko,位于languages/文件夹内[cite: 4]。 - 完整本地化: 游戏内消息、控制台日志、启动横幅和更新通知均遵循所选语言[cite: 4]。
- 自动同步: 现有语言文件在更新时会自动接收新键值,而不会覆盖自定义修改[cite: 4]。
配置 (config.yml)
# Language selection (en, ru, zh, de, fr, es, pt, ja, uk, it, pl, tr, ko)
language: "en"
storage:
type: "sqlite" # "sqlite", "mysql", or "legacy"
sqlite:
file: "homes.db"
mysql:
host: "localhost"
port: 3306
database: "homes"
username: "root"
password: ""
table-prefix: "homes_"
ssl: false
pool-size: 10
encryption:
enabled: true
secret-key: "" # Leave blank to auto-generate a 256-bit key in .encryption_key
check-updates: true
home-limit: 10
teleport-timeout: 5
Homes
Homes is a fast, secure, and lightweight home management plugin for Minecraft servers[cite: 4]. Featuring a clean compass GUI[cite: 5], multi-backend storage (SQLite, MySQL, and Legacy YAML)[cite: 4], end-to-end AES-256-GCM coordinate encryption for complete player privacy[cite: 4], and built-in localization in 13 languages[cite: 4].
Commands
Player & Admin Commands
| Command | Aliases | Description |
|---|---|---|
/sethome <name> |
/sethomes |
Sets a home at your current location[cite: 4, 5] |
/delhome <name> |
/rehome, /deletehome |
Deletes an existing home[cite: 4, 5] |
/home <name> |
/h |
Teleports you to the specified home[cite: 4, 5] |
/homes |
/homelist |
Opens the homes GUI (compasses, click to teleport)[cite: 4, 5] |
/home reload |
— | Reloads configuration, language files, and hot-swaps storage backends[cite: 4] |
Console-Only Commands
(Strictly restricted to the server console — in-game players, even OPs, cannot execute these)[cite: 4]
| Command | Description |
|---|---|
/home clear <player|all> |
Purges all homes of a specific player or all players across the server[cite: 4] |
/homes add <homes.yml|sqlite|legacy> to mysql <user:password> |
Migrates and encrypts all homes from YAML or SQLite directly into MySQL with zero server lag[cite: 4] |
Permissions
| Node | Description | Default |
|---|---|---|
homes.sethome |
Allows setting homes[cite: 5] | Everyone (true)[cite: 5] |
homes.delhome |
Allows deleting homes[cite: 5] | Everyone (true)[cite: 5] |
homes.home |
Allows teleporting to a home[cite: 5] | Everyone (true)[cite: 5] |
homes.homes |
Allows opening the homes GUI[cite: 5] | Everyone (true)[cite: 5] |
homes.bypass |
Bypasses the maximum home limit (home-limit)[cite: 5] |
op[cite: 5] |
Key Features
Storage Backends & Hot-Swapping
| Backend | Description |
|---|---|
| SQLite (Default) | Local homes.db running in WAL mode (Write-Ahead Logging) with an isolated connection pool to prevent file locking[cite: 4] |
| MySQL / MariaDB | Remote database support powered by an integrated, shaded, and relocated HikariCP connection pool[cite: 4] |
| Legacy YAML | Uses homes.yml with atomic file saving via .tmp files (ATOMIC_MOVE) to prevent corruption during crashes[cite: 4] |
| Hot-Swap Support | Switch between sqlite, mysql, and legacy in config.yml on the fly using /home reload without restarting the server[cite: 4] |
Admin-Proof Privacy (AES-256-GCM Encryption)
- End-to-End Coordinate Encryption: All coordinates ($X, Y, Z$), worlds, and viewing angles ($Yaw, Pitch$) are encrypted with AES-256-GCM before being written to SQLite, MySQL, or
homes.yml[cite: 4]. - Zero Admin Snooping: Server admins inspecting databases via phpMyAdmin, DBeaver, HeidiSQL, or text editors cannot view player coordinates (stored as encrypted
ENC:v1:...strings)[cite: 4]. - Per-Player Keys: Unique keys are derived via
HMAC-SHA256(MasterKey, PlayerUUID)with a unique 12-byte IV per record[cite: 4]. Automatically generates a 256-bit key in.encryption_keyif left blank[cite: 4].
Multi-Language Support (13 Languages)
- Built-in Locales: Includes
en,ru,zh,de,fr,es,pt,ja,uk,it,pl,tr, andkoinside thelanguages/folder[cite: 4]. - Full Localization: In-game messages, console logs, startup banners, and update notifications follow the selected language[cite: 4].
- Auto-Sync: Existing language files automatically receive new keys on update without overwriting custom edits[cite: 4].
Configuration (config.yml)
# Language selection (en, ru, zh, de, fr, es, pt, ja, uk, it, pl, tr, ko)
language: "en"
storage:
type: "sqlite" # "sqlite", "mysql", or "legacy"
sqlite:
file: "homes.db"
mysql:
host: "localhost"
port: 3306
database: "homes"
username: "root"
password: ""
table-prefix: "homes_"
ssl: false
pool-size: 10
encryption:
enabled: true
secret-key: "" # Leave blank to auto-generate a 256-bit key in .encryption_key
check-updates: true
home-limit: 10
teleport-timeout: 5
下载 Homes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Homes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Homes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Homes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Homes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Homes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Homes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Homes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Homes
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
功能:v2.4 - 模块化多平台适配器(Folia、Paper、Purpur、Spigot、Bukkit 1.13 - 26.3+)
- 实现模块化适配器系统:FoliaPlatformAdapter、PaperPlatformAdapter、SpigotPlatformAdapter
- 动态检测平台和服务器版本(1.13 - 26.3+)
- 更新 plugin.yml 中的 api-version 为 1.13,并设置 folia-supported: true
- 将构建输出工件重命名为 homes-${project.version}.jar(例如 homes-2.4.jar)
- 解耦 GUI 和传送引擎与平台特定的 API
- 更新文档并修复单元测试套件
⚠️ 测试与稳定性通知
请注意,此版本包含了新更新的跨版本适配器和 Folia 适配器,尚未在所有可能的服务器环境中进行广泛的实际生产测试。
如果您遇到任何错误、意外行为或控制台报错,请通过我们的支持邮箱 nothingflaresuport@gmail.com 向我们报告。您的反馈对我们非常重要!
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧