家园

一款面向 Paper 服务器的现代化、功能丰富的家园传送插件。以优雅的方式设置、管理和传送至家园,支持 MiniMessage 格式、粒子信标、可配置 GUI、全语言支持以及多种存储后端。

核心功能
- 每位玩家可设置无限数量的家园(可配置)
- 支持带预热时间和冷却时间的传送
- 显示家园信息(坐标、设置日期、所有者)
- 在 GUI 菜单中为每个家园设置自定义图标
- 与其他玩家共享家园
- 经典命令别名:
/sethome、/delhome、/listhomes、/home <name>(可配置)
视觉效果与特效
- 动画粒子信标(13 种可定制颜色),仅对家园所有者可见
- 传送音效(可配置)
- 预热期间实时动作栏倒计时
- 到达时的尘埃粒子效果
UI 与配置
- 交互式 GUI 完全通过 YAML 文件配置(
menus/*.yml)
- 直接从 GUI 创建、重命名和管理家园
- 全程支持 MiniMessage 颜色代码(不再需要
§ 符号)
- 家园名称、颜色和子命令的 Tab 补全
多语言与本地化
- 内置语言:英语、意大利语、西班牙语、法语、德语、俄语、乌克兰语
- 完全可扩展的语言系统,只需放入任何新的
.yml 文件即可
- 插件更新时自动合并新的配置/语言键值(无需手动合并)
- 所有消息均可通过语言文件自定义
存储
- 多种存储后端:YAML(平面文件)、SQLite(嵌入式)、MySQL/MariaDB(连接池)
- 切换后端时自动迁移数据
- SQL 后端使用 HikariCP 连接池
- 原子写入和安全并发数据访问
权限与经济系统
- 为每项功能提供细粒度的权限节点
- Vault 经济系统集成(可配置传送费用)
- 管理员工具(删除任意玩家的家园、强制传送玩家)
- 安全的费用检查和错误处理
安全性与健壮性
- 对所有玩家输入进行验证
- 登出/断开连接时正确清理数据
- 向后兼容:自动检测并迁移旧插件数据文件
- 更新时自动合并新键值,且不会破坏现有配置

- 从 Modrinth 下载
Homes-1.2.0.jar
- 将其放入服务器的
plugins/ 文件夹
- 重启服务器
- 在
plugins/Homes/config.yml 中配置存储后端和设置
- 在
plugins/Homes/menus/*.yml 中自定义 GUI
- 在
plugins/Homes/lang/*.yml 中自定义消息

/home 查看你的家园列表(打开 GUI)
/home set <name> 在当前地点设置一个家园
/home <name> 传送至某个家园
/home info <name> 查看家园信息
/home remove <name> 删除一个家园
/home beacon <name> [color|off] 切换信标或设置颜色(13 种颜色)
/home share <name> <player> 将家园分享给另一位玩家
/home unshare <name> <player> 移除家园的共享状态
/home admin delete <player> <name> 删除任意玩家的家园(仅限管理员)
/home admin tp <player> <home> 强制将玩家传送至其家园(仅限管理员)
/home reload 重新加载配置文件和语言文件(控制台及管理员可用)
# 经典别名(可在 config.yml 中配置)
/sethome [name]
/delhome <name>
/listhomes

homes.use 插件的基础权限
homes.set 设置家园
homes.teleport 传送至家园
homes.remove 删除自己的家园
homes.beacon 使用信标系统
homes.share 与他人共享家园
homes.unshare 取消共享家园
homes.admin.delete 删除任意玩家的家园
homes.admin.teleport 强制传送玩家
homes.admin.reload 重新加载配置(玩家和控制台均可用)
homes.bypass.cost 绕过传送费用(Vault)
homes.bypass.cooldown 绕过传送冷却时间

主配置文件 (config.yml)
# 存储后端
storage:
type: yaml # 选项:yaml | sqlite | mysql
auto-migrate: true # 切换后端时自动迁移数据
# SQLite(当 type: sqlite 时使用)
sqlite:
file: homes.db
# MySQL/MariaDB(当 type: mysql 时使用)
mysql:
host: localhost
port: 3306
database: homes
username: root
password: ""
pool-size: 5
# 家园设置
max-homes: 10 # 每位玩家的最大家园数量(-1 表示无限)
max-name-length: 32 # 家园名称字符限制
# 经典命令别名
classic-commands:
enabled: true
sethome: true
delhome: true
listhomes: true
传送系统
teleport:
warmup-seconds: 3
cooldown-seconds: 30
cancel-on-damage: true
cancel-on-move: true
信标
beacons:
enabled: true
beam-height: 256
particle-size: 1.0
refresh-ticks: 4
经济(Vault)
economy:
enabled: false
cost-per-teleport: 10.0
音效
sounds:
enabled: true
teleport-start: ENTITY_ENDERMAN_TELEPORT
teleport-end: ENTITY_GENERIC_EXPLODE
beacon-color-change: ENTITY_EXPERIENCE_ORB_PICKUP
### GUI 配置 (`menus/homes.yml`)
完全可自定义的 GUI,通过简单的 YAML 定义:
```yaml
homes-gui:
title: "<gold>✦ 你的家园 ✦</gold>"
rows: 5
items:
info-slot:
slot: 0
material: PAPER
display-name: "<yellow>家园信息</yellow>"

- 服务器: Paper 1.21.11-R0.1 或兼容版本
- Java: 21 或更高版本
- 可选: Vault(用于支持经济功能)
- 可选: MySQL/MariaDB 服务器(如果使用
storage.type: mysql)
从旧版本升级
Homes 会自动检测旧的插件数据并在首次启动时进行迁移。配置文件和语言文件采用智能合并方式,更新中添加的新键会自动插入,而不会覆盖你现有的自定义设置。无需手动迁移配置。
Homes

A modern, feature-rich home teleportation plugin for Paper servers. Set, manage, and teleport to homes with style, features MiniMessage support, particle beacons, configurable GUIs, full multi-language support, and multiple storage backends.

Core
- Set unlimited homes per player (configurable)
- Teleport with warmup and cooldown timers
- Home info display (coordinates, set date, owner)
- Per-home custom icons in GUI menus
- Home sharing with other players
- Classic command aliases:
/sethome, /delhome, /listhomes, /home <name> (configurable)
Visuals & Effects
- Animated particle beacons (13 customizable colors) visible only to the home owner
- Sound effects for teleportation (configurable)
- Real-time action bar countdown during warmup
- Dust particle effects at arrival
UI & Configuration
- Interactive GUIs entirely configured via YAML (
menus/*.yml)
- Create, rename, and manage homes directly from the GUI
- MiniMessage color support throughout (no more
§ codes)
- Tab completion for homes, colors, and subcommands
Multi-Language & Localization
- Built-in languages: English, Italian, Spanish, French, German, Russian, Ukrainian
- Fully extensible lang system, drop in any new
.yml file
- Auto-merge of new config/lang keys on plugin update (no more manual merging)
- All messages customizable via language files
Storage
- Multiple storage backends: YAML (flat-file), SQLite (embedded), MySQL/MariaDB (pooled)
- Automatic migration when switching between backends
- HikariCP connection pooling for SQL backends
- Atomic writes and safe concurrent data access
Permissions & Economy
- Granular permission nodes for every feature
- Vault economy integration (configurable teleport costs)
- Admin tools (delete any home, force-teleport players)
- Safe cost checks and error handling
Safety & Robustness
- Input validation on all player inputs
- Proper cleanup on logout/disconnect
- Retro-compatibility: old plugin data files are automatically detected and migrated
- Auto-merge of new keys when updating without breaking existing configs

- Download
Homes-1.2.0.jar from Modrinth
- Place it in your server's
plugins/ folder
- Restart your server
- Configure storage backend and settings in
plugins/Homes/config.yml
- Customize GUIs in
plugins/Homes/menus/*.yml
- Customize messages in
plugins/Homes/lang/*.yml

/home View your homes (opens GUI)
/home set <name> Set a home at your current location
/home <name> Teleport to a home
/home info <name> View home information
/home remove <name> Delete a home
/home beacon <name> [color|off] Toggle beacon or set color (13 colors)
/home share <name> <player> Share a home with another player
/home unshare <name> <player> Remove sharing from a home
/home admin delete <player> <name> Delete any player's home (admin only)
/home admin tp <player> <home> Force teleport a player to their home (admin only)
/home reload Reload config and language files (console & admin)
# Classic aliases (configurable in config.yml)
/sethome [name]
/delhome <name>
/listhomes

homes.use Base permission for the plugin
homes.set Set homes
homes.teleport Teleport to homes
homes.remove Delete own homes
homes.beacon Use beacon system
homes.share Share homes with others
homes.unshare Unshare homes
homes.admin.delete Delete any player's home
homes.admin.teleport Force-teleport players
homes.admin.reload Reload configs (players and console)
homes.bypass.cost Bypass teleport costs (Vault)
homes.bypass.cooldown Bypass teleport cooldown

Main Config (config.yml)
# Storage Backend
storage:
type: yaml # Options: yaml | sqlite | mysql
auto-migrate: true # Automatically migrate data when switching backends
# SQLite (used when type: sqlite)
sqlite:
file: homes.db
# MySQL/MariaDB (used when type: mysql)
mysql:
host: localhost
port: 3306
database: homes
username: root
password: ""
pool-size: 5
# Homes
max-homes: 10 # Maximum homes per player (-1 for unlimited)
max-name-length: 32 # Home name character limit
# Classic aliases
classic-commands:
enabled: true
sethome: true
delhome: true
listhomes: true
# Teleport System
teleport:
warmup-seconds: 3
cooldown-seconds: 30
cancel-on-damage: true
cancel-on-move: true
# Beacons
beacons:
enabled: true
beam-height: 256
particle-size: 1.0
refresh-ticks: 4
# Economy (Vault)
economy:
enabled: false
cost-per-teleport: 10.0
# Sounds
sounds:
enabled: true
teleport-start: ENTITY_ENDERMAN_TELEPORT
teleport-end: ENTITY_GENERIC_EXPLODE
beacon-color-change: ENTITY_EXPERIENCE_ORB_PICKUP
GUI Configuration (menus/homes.yml)
Fully customizable GUIs defined in simple YAML:
homes-gui:
title: "<gold>✦ Your Homes ✦</gold>"
rows: 5
items:
info-slot:
slot: 0
material: PAPER
display-name: "<yellow>Home Info</yellow>"

- Server: Paper 1.21.11-R0.1 or compatible
- Java: 21 or higher
- Optional: Vault (for economy support)
- Optional: MySQL/MariaDB server (if using
storage.type: mysql)
Upgrading from an older version
Homes automatically detects old plugin data and migrates it on first boot. Config and lang files are smart-merged, new keys added in updates are inserted automatically without overwriting your existing customizations. No manual config migration needed.
评论 0
登录后参与评分
还没有评论,来抢沙发吧