ApxHome

插件

· 作者 AkashPlayz

一款简单且功能强大的 Minecraft 家园管理插件,提供图形界面和基于权限的家园数量限制。

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

最新 1.0.0 · 26.2 · Folia / Paper

一键开服(送7天)

? ApxHome v1.0.0 — 现代 Paper 对话框更新!

ApxHome 是一款现代化、高性能且功能丰富的 Minecraft 家园管理插件,专为生存服、 SMP 服和网络服务器(1.20+ - 1.21+)打造。

此次更新原生支持 Paper Dialog API(Minecraft 1.21+),为玩家提供清爽的客户端弹窗界面,同时保持与经典箱子 & 漏斗 GUI 的 100% 向后兼容!


? 版本更新日志 (v1.0.0)

  • ✨ 现代 Paper 对话框 UI(Minecraft 1.21+):
    • 用简洁的原生客户端弹窗对话框取代了笨拙的物品栏箱子。
    • 紧凑视图: 快速展示 3 个家园的分页,实现快速传送。
    • 扩展视图: 点击“显示更多”以打开拥有 90 个槽位的大型家园浏览器。
    • 交互按钮用于传送、重命名、图标选择和安全删除。
    • 添加了高清 Minecraft 物品精灵图和自定义字体渲染 (item_sprites.properties)。
  • ?️ 智能混合回退机制:
    • 通过 DialogSupport 添加了自动运行时检测。
    • 旧版本(1.20+)和没有 Dialog API 的服务器会自动切换回经典的箱子 GUI,不会报错或崩溃。
  • ⚙️ 新配置选项:
    • 新增 GUI.USE-DIALOGS: true/false,可轻松在对话框和物品栏 GUI 之间切换。
    • 新增 GUI.dialog-expanded-slots: 90 以自定义扩展屏幕容量。
  • ? 改进与修复:
    • 优化了批量加载家园时的数据库查询速度。
    • 修复了在快速菜单导航期间的冷却时间不同步问题。

视频


✨ 完整功能概览

  • ? 双 UI 引擎(对话框 & 箱子 GUI):
    • 在 Paper 1.21+ 上使用现代原生对话框弹窗。
    • 在 1.20+ 或 Spigot 上使用经典的分页物品栏 GUI。
  • ⚙️ 完整的游戏内家园管理:
    • ⚡ 传送: 即时启动预热倒计时,并带有实时 ActionBar 计时器。
    • ? 重新定位: 通过确认屏幕将家园位置更新为当前位置。
    • ✏️ 重命名: 在游戏内使用正则验证重命名家园。
    • ? 更改图标: 从菜单中选择自定义图标,或设置为当前手持物品。
    • ?️ 安全删除: 两步确认屏幕防止意外删除家园。
  • ⏳ 智能传送机制:
    • 实时 ActionBar 计时器(Teleporting in 3s...)。
    • 玩家移动(movement-threshold: 0.2)或受到伤害时取消传送。
    • 内置安全地点检查器(防止传送到岩浆中或在墙壁里窒息)。
    • 沉浸式音效(NOTE_BLOCK, ENDERMAN_TELEPORT)和粒子效果(PORTAL, REVERSE_PORTAL)。
  • ⚔️ 战斗日志集成:
    • 阻止玩家在处于活跃 PvP 战斗标记时进行传送。
  • ? 动态 LuckPerms 限制:
    • 原生接入 LuckPerms API 5.4。
    • 当玩家等级变更时,家园上限会实时自动调整。
  • ? 双异步存储引擎:
    • SQLite: 即插即用,无需外部设置(plugins/ApxHome/homes.db)。
    • MySQL / MariaDB: 多线程 HikariCP 连接池,适用于服务器网络。
    • 100% 异步运行 —— 零服务器延迟或 TPS 下降。
  • ? PlaceholderAPI 支持:
    • 完全集成记分板、标签列表、动作条和聊天格式化器。

? 家园限制系统(LuckPerms 设置)

ApxHome 使用权限节点计算家园限制。它会自动检测分配给玩家的最高权限,并立即更新其 GUI 槽位。

权限节点:

  • apxhome.limit.<number> — 设置允许的最大家园数量(例如 apxhome.limit.3)
  • apxhome.limit.unlimited — 给予无限家园
  • apxhome.bypass.limit — 绕过所有家园数量限制

示例等级结构:

Default  ──► 3 Homes   (Permission: apxhome.limit.3)
VIP      ──► 5 Homes   (Permission: apxhome.limit.5)
MVP      ──► 10 Homes  (Permission: apxhome.limit.10)
Elite    ──► 15 Homes  (Permission: apxhome.limit.15)
Owner    ──► Unlimited (Permission: apxhome.limit.unlimited)

LuckPerms 设置命令:

/lp group default permission set apxhome.limit.3
/lp group vip permission set apxhome.limit.5
/lp group mvp permission set apxhome.limit.10
/lp group elite permission set apxhome.limit.15
/lp group owner permission set apxhome.limit.unlimited

? 命令与权限

玩家命令

命令 描述 权限 默认
/home 或 /homes 打开家园 GUI / 对话框屏幕 apxhome.use 所有人
/home <name> 直接传送到已保存的家园 apxhome.home 所有人
/home rename <old> <new> 通过命令重命名家园 apxhome.rename 所有人
/sethome <name> 在当前地点设置一个家园 apxhome.sethome 所有人
/delhome <name> 删除已保存的家园 apxhome.delete 所有人

管理员命令

命令 描述 权限
/apxhome reload 重新加载配置、消息和菜单 apxhome.admin
/apxhome info <player> 检查玩家的家园限制和统计信息 apxhome.admin
/apxhome list <player> 列出目标玩家拥有的所有家园 apxhome.admin
/apxhome delete <player> <home> 强制删除特定玩家的家园 apxhome.admin
/apxhome teleport <player> <home> 传送到任何玩家的家园 apxhome.admin
/apxhome version 检查插件版本和状态 apxhome.admin

绕过权限

权限 描述
apxhome.bypass.warmup 即时传送,无预热延迟
apxhome.bypass.cooldown 绕过传送之间的冷却延迟
apxhome.bypass.limit 绕过所有家园数量限制
apxhome.admin 访问所有管理员命令和绕过权限

? PlaceholderAPI 占位符

占位符 描述 示例输出
%apxhome_home_count% 玩家已设置的家数量 3
%apxhome_home_limit% 玩家的最大家数量上限 5
%apxhome_available_slots% 剩余可用的家槽位 2
%apxhome_next_home_slot% 下一个家的槽位编号 4
%apxhome_has_home_<name>% 检查玩家是否拥有特定名称的家 true / false

⚙️ 配置文件 (config.yml)

# ==============================================================================
# ApxHome 主配置文件
# ==============================================================================

general:
  default-home-limit: 3
  max-name-length: 16
  name-regex: "^[a-zA-Z0-9_ -]+$"
  date-format: "dd/MM/yyyy HH:mm"
  default-sort: "NAME"

teleport:
  warmup: 3
  cooldown: 5
  cancel-on-movement: true
  movement-threshold: 0.2
  cancel-on-damage: true
  safe-teleport: true
  combat:
    enabled: true
    duration: 10
  actionbar:
    enabled: true

# ==============================================================================
# GUI & 对话框配置
# ==============================================================================
GUI:
  # true = 现代 Paper 对话框 (Minecraft 1.21+ Paper)
  # false = 经典库存箱子 GUI
  USE-DIALOGS: true

  # 展开对话框视图(显示更多)中显示的总槽位数
  dialog-expanded-slots: 90

# ==============================================================================
# 数据库配置
# ==============================================================================
database:
  type: "SQLITE" # 选项:SQLITE 或 MYSQL
  sqlite:
    file: "homes.db"

? 安装与设置

  1. 停止 Minecraft 服务器。
  2. 将 ApxHome-1.0.0.jar 放入服务器的 plugins/ 目录中。
  3. 必需 / 推荐插件:
    • 安装 PlaceholderAPI 到 plugins/ (推荐用于占位符)。
    • 安装 LuckPerms 到 plugins/ (推荐用于基于排名的限制)。
  4. 启动 服务器。
  5. 自定义 plugins/ApxHome/config.yml 中的设置,并运行 /apxhome reload!

? 要求与兼容性

  • Minecraft 版本: 1.20 - 1.21.x+
  • 服务器软件: Paper, Purpur (推荐用于对话框), 或 Spigot。
  • Java 版本: Java 21+

? 支持与社区

需要帮助、发现了 Bug 或想建议新功能?加入我们的官方社区:

  • ? Discord 支持:

由 APX Plugins 用心打造 ❤️

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源