Homes - 现代化家园管理

💡简介

Homes 是一款为 Minecraft 服务器设计的插件，它允许玩家创建和管理自己的家。通过直观的图形界面（GUI），玩家可以轻松设置、传送、重命名家园，并享受粒子导航等视觉效果。

🎮功能特性

• 创建家园：玩家可以设置多个家园。
• 管理家园：支持删除和重命名已创建的家园。
• 传送功能：快速传送到指定的家园。
• 粒子导航：使用酷炫的粒子效果引导玩家前往家园。
• 跨维度支持：可以在不同的世界或维度中设置家园。
• 图形界面：所有核心功能都可通过 GUI 操作。
• 高度可配置：支持通过配置文件调整家园数量上限、粒子效果等。

🔧权限列表

以下是插件使用的权限节点

• homes.create：允许创建家园。
• homes.use：允许使用 GUI 功能。
• homes.teleport：允许使用传送功能。
• homes.navigate：允许使用导航功能。
• homes.admin：授予管理权限（如查看版本信息等）。

🔧命令列表

• /addhome [Name]：添加一个指定名称的家园。
• /homes：打开包含所有功能的主 GUI。
• /rename [Name]：重命名一个已存在的家园。
• /addperm [Permission] [Amount]：为拥有特定权限的用户设置家园数量上限。
• /reloadmessages：重新加载 messages.yml 中的消息配置。
• /reloadperms：重新加载 permissions.yml 中的权限配置。

⭐数据与数据库配置

家园数据可以通过配置文件或 SQL 数据库保存。

配置文件示例

在 homes.yml 中，数据存储格式如下：

homes:
  Example1:
    X: '174.78694353928665'
    Y: '65.0'
    Z: '-150.7085900761925'
    world: 'world'

> 注意：虽然支持直接编辑配置文件来添加家园，但此操作可能导致错误，建议通过游戏内命令操作。

数据库配置

要启用数据库存储，请在 database.yml 中设置你的数据库连接信息，并将 enabled 设为 "true"。

database:
  enabled: 'true'
  host: localhost
  database: yourDatabase
  user: yourUser
  password: 'yourPassword'

⭐消息配置

所有提示消息都可在 messages.yml 文件中自定义。

• 支持 Kyori Adventure Mini-Message 格式（在消息前使用 <mm> 标签）。
• 请务必保留消息中的占位符。
• 修改后，可使用 /reloadmessages 命令重载消息配置。

配置示例

messages:
  # MiniMessage 示例
  prefix: <mm><gradient:#41D1FF:#55FDB2>Homes</gradient> <gray> | <reset>
  # 普通消息示例
  home_no_space: §cYou don't have enough space to add more homes

⭐选项配置

你可以在 options.yml 中调整插件的各项参数，例如家园上限、粒子效果等。

配置示例与说明

options:
  info: 'All Available Particles: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html'
  particle:
    enabled: 'true'
    particle: FLAME
    spawnDelay: '10'
  navigation:
    spacing: '0.5'
    length: '5'
    particle: SOUL_FIRE_FLAME
  homes:
    maxhomes: '99'
    block: CYAN_BED

重要说明

• 修改生效：更改 options.yml 后，需要重启服务器（未来会添加重载命令）。
• 家园上限：maxhomes 选项仅在 permissions.yml 中的自定义权限数量功能被禁用时生效。
• 材质支持：block 项可更改为任何存在于 Minecraft 1.21.1 版本的方块。

⭐权限配置

权限节点可以在 permissions.yml 中自定义。

配置示例

homes:
  create: homes.create
  use: homes.use
  teleport: homes.teleport
  navigate: homes.navigate
  admin: homes.admin
permissions:
  enabled: 'TRUE'
  default: '40'

配置说明

• 禁用权限：将权限节点后的值留空，即可使该权限失效。
• 启用/禁用自定义数量：当 permissions.enabled 设为 "FALSE" 时，系统将使用 options.yml 中的 maxhomes 值作为所有玩家的家园上限。
• 添加新权限：你可以在游戏内使用 /addperm 命令来添加新的权限组和对应的家园数量。

❓支持与反馈

如果你有功能建议或发现了漏洞，请在 GitHub 仓库的 Issues 页面提交报告。

如果你喜欢这个插件，别忘了给它评分！