
要求: TNE/VaultUnlocked 和 GriefPrevention
HoloShops
玩家拥有的箱子商店,配有悬浮的 3D 全息显示面板——基于显示实体、Vault 经济系统和 GriefPrevention 领地保护构建。无需 GUI,无需告示牌,无杂乱元素。
功能
3D 全息显示
每个商店都会在箱子上方生成一个悬浮的物品、标题、价格面板以及可点击的交互区域,全部使用显示实体实现。
多槽位商店
单个箱子可以出售多种物品类型。玩家可以直接在全息图上通过 PREV / NEXT 按钮切换槽位。
领地感知创建
商店创建仅限于 GriefPrevention 领地的所有者。在任何商店命令执行前,都会验证容器的信任关系。
双 Vault 支持
接入 VaultUnlocked(Vault2 API),并自动回退到旧版 Vault。兼容任何兼容的经济插件。
重启后持久化
商店数据保存至 YAML 文件。显示实体使用记分板标签,确保在重新加载时清理过期实体。
买与卖同店进行
每个物品槽都有独立的买入价(顾客 → 商店)和卖出价(商店 → 顾客)。两者均可单独禁用。
工作原理
1
装满你的箱子,至少放入一种物品,然后面朝它站立。
2
运行 /shop create —— 插件会读取你的箱子内容,并为每种独特的物品类型创建一个槽位。
3
在全息图上右键点击 [SET BUY] 或 [SET SELL],然后在聊天栏输入价格。使用 -1 可禁用该方向。
4
顾客走近并右键点击显示上的 BUY 或 SELL —— 他们无需使用任何命令。
命令
| 命令 | 描述 |
/shop create |
在你注视的箱子上创建商店。你必须在自己的 GriefPrevention 领地内,且箱子中必须至少包含一件物品。 |
/shop remove |
移除你注视的箱子上的商店,并消失其全息图。需要所有权或管理员权限。 |
/shop refresh |
手动重新生成你注视的商店的全息显示。如果显示不同步,此命令非常有用。 |
所有命令都要求玩家直接注视 5 格内的箱子或桶。
权限
| 节点 | 描述 | 默认值 |
| holo.shop.admin |
允许无视所有权移除任何商店,并可设置其他玩家拥有的商店的价格。 |
op |
| holo.shop.use |
允许使用 HoloShops 的玩家命令。 |
true |
所有其他商店交互不需要特殊权限节点 —— 任何玩家均可使用。
依赖要求
Paper
1.21.4 或更高版本。不支持 Spigot —— 显示实体和异步聊天事件需要 Paper API。
必须安装
VaultUnlocked 或 Vault
经济抽象层。优先使用 VaultUnlocked(Vault2 API),若不可用则回退至旧版 Vault。
必须安装
经济类插件
任何向 Vault 注册经济的插件,例如 EssentialsX Economy、CMI 等。
必须安装
GriefPrevention
领地保护集成。商店创建仅限领地所有者;所有命令均强制执行容器信任机制。
必须安装

Requirements: TNE/VaultUnlocked & GriefPrevention
HoloShops
Player-owned chest shops with floating 3D holographic displays — built on display entities, Vault economy, and GriefPrevention claim protection. No GUIs, no signs, no clutter.
Features
3D holographic display
Each shop spawns a floating item, title, price panel, and clickable interaction zones above the chest using display entities.
Multi-slot shops
A single chest can sell multiple item types. Players cycle through slots with the PREV / NEXT buttons directly on the hologram.
Claim-aware creation
Shop creation is restricted to GriefPrevention claim owners. Container trust is verified before any shop command runs.
Dual Vault support
Hooks into VaultUnlocked (Vault2 API) with automatic fallback to legacy Vault. Works with any compatible economy plugin.
Persistent across restarts
Shop data is saved to YAML. Display entities use scoreboard tags so stale entities are always cleaned up on reload.
Buy & sell in one shop
Each item slot has an independent buy price (customer → shop) and sell price (shop → customer). Either can be disabled.
How it works
1
Fill your chest with at least one item type and stand facing it.
2
Run /shop create — the plugin reads your chest contents and creates a slot for each unique item type.
3
Right-click [SET BUY] or [SET SELL] on the hologram and type a price into chat. Use -1 to disable that direction.
4
Customers walk up and right-click BUY or SELL on the display — no commands needed on their end.
Commands
| Command | Description |
/shop create |
Creates a shop on the chest you are looking at. You must be in your own GriefPrevention claim and the chest must contain at least one item. |
/shop remove |
Removes the shop on the chest you are looking at and despawns its hologram. Requires ownership or the admin permission. |
/shop refresh |
Manually respawns the hologram display for the shop you are looking at. Useful if the display becomes desynced. |
All commands require the player to be looking directly at a chest or barrel within 5 blocks.
Permissions
| Node | Description | Default |
| holo.shop.admin |
Allows removing any shop regardless of ownership, and setting prices on shops owned by other players. |
op |
| holo.shop.use |
Allows using of the holoshop player commands. |
true |
All other shop interactions require no special permission node — any player may use them.
Requirements
Paper
1.21.4 or later. Spigot is not supported — display entities and async chat events require Paper APIs.
Required
VaultUnlocked or Vault
Economy abstraction layer. Automatically prefers VaultUnlocked (Vault2 API) and falls back to legacy Vault.
Required
Economy plugin
Any plugin that registers an economy with Vault — EssentialsX Economy, CMI, etc.
Required
GriefPrevention
Claim protection integration. Shop creation is locked to claim owners; container trust is enforced on all commands.
Required
评论 0
登录后参与评分
还没有评论,来抢沙发吧