? 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)。
- ⚔️ 战斗日志集成:
- ? 动态 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"
? 安装与设置
- 停止 Minecraft 服务器。
- 将
ApxHome-1.0.0.jar 放入服务器的 plugins/ 目录中。
- 必需 / 推荐插件:
- 启动 服务器。
- 自定义
plugins/ApxHome/config.yml 中的设置,并运行 /apxhome reload!
? 要求与兼容性
- Minecraft 版本: 1.20 - 1.21.x+
- 服务器软件: Paper, Purpur (推荐用于对话框), 或 Spigot。
- Java 版本: Java 21+
? 支持与社区
需要帮助、发现了 Bug 或想建议新功能?加入我们的官方社区:
由 APX Plugins 用心打造 ❤️
? ApxHome v1.0.0 — The Modern Paper Dialogs Update!
ApxHome is a modern, high-performance, and feature-rich Minecraft home management plugin built for Survival, SMP, and Network servers (1.20+ - 1.21+).
This update brings native Paper Dialog API (Minecraft 1.21+) support, giving players clean client-side popup screens while maintaining 100% backward compatibility with classic Chest & Hopper GUIs!
? Version Changelog (v1.0.0)
- ✨ Modern Paper Dialogs UI (Minecraft 1.21+):
- Replaced clunky inventory chests with clean, native client popup dialogs.
- Compact View: Fast 3-home pagination for quick teleportation.
- Expanded View: Click "Show More" to open a massive 90-slot home browser.
- Interactive action buttons for Teleport, Rename, Icon Selection, and Safe Deletion.
- Added high-definition Minecraft item sprites and custom font rendering (
item_sprites.properties).
- ?️ Smart Hybrid Fallback:
- Added automatic runtime detection via
DialogSupport.
- Older versions (1.20+) and servers without Dialog API automatically switch to the classic Chest GUI without any errors or crashes.
- ⚙️ New Config Options:
- Added
GUI.USE-DIALOGS: true/false to easily toggle between Dialogs and Inventory GUIs.
- Added
GUI.dialog-expanded-slots: 90 to customize expanded screen capacity.
- ? Improvements & Fixes:
- Optimized database query speed during bulk home loading.
- Fixed cooldown desync during rapid menu navigation.
Video
✨ Full Feature Overview
- ? Dual UI Engine (Dialogs & Chest GUIs):
- Modern native Dialog popups on Paper 1.21+.
- Classic paginated Inventory GUI on 1.20+ or Spigot.
- ⚙️ Complete In-Game Home Management:
- ⚡ Teleport: Instant warmup countdown with real-time ActionBar timer.
- ? Relocate: Update home location to your current position with a confirmation screen.
- ✏️ Rename: Rename homes in-game with regex validation.
- ? Change Icon: Select custom icons from a menu or set to your currently held item.
- ?️ Safe Deletion: Two-step confirmation screen prevents accidental home deletion.
- ⏳ Smart Teleport Mechanics:
- Real-time ActionBar timer (
Teleporting in 3s...).
- Cancels on player movement (
movement-threshold: 0.2) or damage taken.
- Built-in safe location checker (prevents teleporting into lava or suffocating in walls).
- Immersive sound effects (
NOTE_BLOCK, ENDERMAN_TELEPORT) and particle effects (PORTAL, REVERSE_PORTAL).
- ⚔️ Combat Log Integration:
- Blocks players from teleporting while tagged in active PvP combat.
- ? Dynamic LuckPerms Limits:
- Native hook into LuckPerms API 5.4.
- Home limits adjust automatically in real-time when player ranks change.
- ? Dual Async Storage Engine:
- SQLite: Instant plug-and-play, zero external setup (
plugins/ApxHome/homes.db).
- MySQL / MariaDB: Multi-threaded HikariCP connection pooling for server networks.
- 100% Asynchronous — zero server lag or TPS drops.
- ? PlaceholderAPI Support:
- Full integration with scoreboards, tablists, actionbars, and chat formatters.
? Home Limit System (LuckPerms Setup)
ApxHome calculates home limits using permission nodes. It automatically detects the highest permission assigned to the player and updates their GUI slots immediately.
Permission Nodes:
apxhome.limit.<number> — Sets maximum allowed homes (e.g., apxhome.limit.3)
apxhome.limit.unlimited — Gives infinite homes
apxhome.bypass.limit — Bypasses all home limits
Example Rank Structure:
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 Setup Commands:
/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
? Commands & Permissions
Player Commands
| Command |
Description |
Permission |
Default |
/home or /homes |
Open the Home GUI / Dialog screen |
apxhome.use |
Everyone |
/home <name> |
Teleport directly to a saved home |
apxhome.home |
Everyone |
/home rename <old> <new> |
Rename a home via command |
apxhome.rename |
Everyone |
/sethome <name> |
Set a home at your current location |
apxhome.sethome |
Everyone |
/delhome <name> |
Delete a saved home |
apxhome.delete |
Everyone |
Administrator Commands
| Command |
Description |
Permission |
/apxhome reload |
Reload configuration, messages, and menus |
apxhome.admin |
/apxhome info <player> |
Inspect a player's home limit and stats |
apxhome.admin |
/apxhome list <player> |
List all homes owned by target player |
apxhome.admin |
/apxhome delete <player> <home> |
Force delete a specific player's home |
apxhome.admin |
/apxhome teleport <player> <home> |
Teleport to any player's home |
apxhome.admin |
/apxhome version |
Check plugin version and status |
apxhome.admin |
Bypass Permissions
| Permission |
Description |
apxhome.bypass.warmup |
Teleport instantly with zero warmup delay |
apxhome.bypass.cooldown |
Bypass cooldown delay between teleports |
apxhome.bypass.limit |
Bypass all home quantity limits |
apxhome.admin |
Access to all administrative commands and bypasses |
? PlaceholderAPI Placeholders
| Placeholder |
Description |
Example Output |
%apxhome_home_count% |
Number of homes set by player |
3 |
%apxhome_home_limit% |
Maximum home limit of player |
5 |
%apxhome_available_slots% |
Remaining available home slots |
2 |
%apxhome_next_home_slot% |
The slot number of the next home |
4 |
%apxhome_has_home_<name>% |
Check if player has a specific home |
true / false |
⚙️ Configuration (config.yml)
# ==============================================================================
# ApxHome Main Configuration
# ==============================================================================
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 & Dialog Configurations
# ==============================================================================
GUI:
# true = Modern Paper Dialogs (Minecraft 1.21+ Paper)
# false = Classic Inventory Chest GUI
USE-DIALOGS: true
# Total slots shown in expanded dialog view (Show More)
dialog-expanded-slots: 90
# ==============================================================================
# Database Configuration
# ==============================================================================
database:
type: "SQLITE" # Options: SQLITE or MYSQL
sqlite:
file: "homes.db"
? Installation & Setup
- Stop your Minecraft server.
- Put
ApxHome-1.0.0.jar into your server's plugins/ directory.
- Required / Recommended Plugins:
- Install PlaceholderAPI into
plugins/ (Recommended for placeholders).
- Install LuckPerms into
plugins/ (Recommended for rank-based limits).
- Start your server.
- Customize settings inside
plugins/ApxHome/config.yml and run /apxhome reload!
? Requirements & Compatibility
- Minecraft Version: 1.20 - 1.21.x+
- Server Software: Paper, Purpur (Recommended for Dialogs), or Spigot.
- Java Version: Java 21+
? Support & Community
Need help, found a bug, or want to suggest a new feature? Join our official community:
Crafted with ❤️ by APX Plugins.
评论 0
登录后参与评分
还没有评论,来抢沙发吧