Homes!

插件

· 作者 Hydr46605

Just Homes!

0 本站下载 0 关注 更新于 8 个月前

最新 v1.2.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

家园

Banner

Paper Spigot Bukkit


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


Features

核心功能

  • 每位玩家可设置无限数量的家园(可配置)
  • 支持带预热时间和冷却时间的传送
  • 显示家园信息(坐标、设置日期、所有者)
  • 在 GUI 菜单中为每个家园设置自定义图标
  • 与其他玩家共享家园
  • 经典命令别名:/sethome、/delhome、/listhomes、/home <name>(可配置)

视觉效果与特效

  • 动画粒子信标(13 种可定制颜色),仅对家园所有者可见
  • 传送音效(可配置)
  • 预热期间实时动作栏倒计时
  • 到达时的尘埃粒子效果

UI 与配置

  • 交互式 GUI 完全通过 YAML 文件配置(menus/*.yml)
  • 直接从 GUI 创建、重命名和管理家园
  • 全程支持 MiniMessage 颜色代码(不再需要 § 符号)
  • 家园名称、颜色和子命令的 Tab 补全

多语言与本地化

  • 内置语言:英语、意大利语、西班牙语、法语、德语、俄语、乌克兰语
  • 完全可扩展的语言系统,只需放入任何新的 .yml 文件即可
  • 插件更新时自动合并新的配置/语言键值(无需手动合并)
  • 所有消息均可通过语言文件自定义

存储

  • 多种存储后端:YAML(平面文件)、SQLite(嵌入式)、MySQL/MariaDB(连接池)
  • 切换后端时自动迁移数据
  • SQL 后端使用 HikariCP 连接池
  • 原子写入和安全并发数据访问

权限与经济系统

  • 为每项功能提供细粒度的权限节点
  • Vault 经济系统集成(可配置传送费用)
  • 管理员工具(删除任意玩家的家园、强制传送玩家)
  • 安全的费用检查和错误处理

安全性与健壮性

  • 对所有玩家输入进行验证
  • 登出/断开连接时正确清理数据
  • 向后兼容:自动检测并迁移旧插件数据文件
  • 更新时自动合并新键值,且不会破坏现有配置

Installation

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

Commands

/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

Permissions

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               绕过传送冷却时间

Configuration

主配置文件 (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>"

Reqs

  • 服务器: Paper 1.21.11-R0.1 或兼容版本
  • Java: 21 或更高版本
  • 可选: Vault(用于支持经济功能)
  • 可选: MySQL/MariaDB 服务器(如果使用 storage.type: mysql)

从旧版本升级

Homes 会自动检测旧的插件数据并在首次启动时进行迁移。配置文件和语言文件采用智能合并方式,更新中添加的新键会自动插入,而不会覆盖你现有的自定义设置。无需手动迁移配置。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源