JVIPS Changelog

---

[2.2.0] — Native Menu, HUD Configurator & Inventory Vouchers

New Features

Unified /vips menu with configurable UI backend

The /vips menu command now dispatches to one of two UI implementations, controlled by a single field in config.json:

"customui": {
  "menuvip": "native"
}

Value	Behavior
"native"	Opens the native CustomUIPage menu (VipTestMenuPage)
"hyui"	Opens the HyUI-based menu (JvipsHyUiMenu) HyUI Dependancy

Permission requirement jvips.use is now enforced on /vips menu regardless of the chosen backend.

---

Voucher activation mode: "tab" or "inventory"

A new vouchers.activationMode option in config.json controls how vouchers are activated from the Vouchers tab:

"vouchers": {
  "activationMode": "tab"
}

Value	Behavior
"tab"	Two-click confirmation activates the VIP directly (default)
"inventory"	First click moves the voucher to the player's physical hotbar as an item; the player activates it from there

The "inventory" mode enables the full physical voucher flow: receive voucher → hold in hand → /vips sellvoucher or activate by interacting.

---

/vips sellvoucher <currency> <price> — Sell a held voucher

Players can list a physical VIP voucher directly from their hand onto the VIP Shop:

• The voucher must be in the active hotbar slot — any other slot is rejected
• HMAC signature and ownership are validated before listing
• The item is removed from the hotbar and placed as an active shop listing
• Currency and price follow the same rules as admin shop listings

Command	Permission
/vips sellvoucher <currency> <price>	jvips.use

New message keys: player.sellvoucher.noVoucherInHand, player.sellvoucher.ok

---

Voucher chest guard — block vouchers from external containers

Voucher items can no longer be placed in any chest other than the player's own VIP Chest:

• Attempting to move a voucher to an external container reverts the move and shows a message
• Moving to the VIP Chest (/vips chest) is always allowed
• The guard is registered per-player on join and whenever the VIP Chest is opened

New message key: error.cantMoveVoucherToChest

---

VIP HUD position configurator (/vips hudcfg)

Players can now reposition the VIP HUD overlay to any screen coordinate:

• Opens a full-screen configuration page with the HUD preview rendered at the current position
• Fine controls — move ±1 px per click (8 directions)
• Coarse controls — move ±10 px per click (8 directions)
• Position is saved automatically on every click — no explicit save action needed
• Closing the page applies the new position to the live HUD on the next tick
• Per-player positions stored in data/hud-prefs/<uuid>.json

Command	Permission
/vips hudcfg	jvips.use

All UI texts are configurable via the message JSONs:

Key	Default (pt_BR)
hudcfg.title	Posicionar HUD
hudcfg.label.fine	Fino (+/- 1)
hudcfg.label.coarse	Grosso (+/- 10)
hudcfg.btn.close	Fechar (salvo)
hudcfg.preview.label	VIP — Preview

New data file: data/hud-prefs/<uuid>.json

---

VIP HUD positioning via appendInline (technical)

The VIP HUD now supports per-player dynamic positioning without client crashes:

• VipHud.ui is a fill-screen wrapper (#VipHudWrapper) with no content
• The actual HUD element is injected via UICommandBuilder.appendInline() with the position baked into the markup string — avoids setting Left/Top via cmd.set(), which causes a client crash ("doesn't match a markup property")
• Position changes destroy the current HUD; the next tick recreates it with the saved position from HudPrefsStore

---

Changes

/vips givekey now always delivers to TAB

/vips givekeytab has been merged into /vips givekey. The command now always delivers vouchers directly to the player's Vouchers tab. The givekeytab subcommand has been removed.

HyUI upgraded to 0.9.4

libs/HyUI-0.9.2-all.jar replaced with HyUI-0.9.4-all.jar.

Native menu (VipMenuPage) — full i18n

All static texts in the native menu (tabs, buttons, labels, hints, shop panel, history columns) are now configurable via the message JSONs. Approximately 50 new/updated keys across pt_BR, en_US, and es_ES.

---

New Commands

Command	Description	Permission
/vips sellvoucher <currency> <price>	Lists the voucher held in the active hotbar slot on the VIP Shop	jvips.use
/vips hudcfg	Opens the HUD position configurator	jvips.use

Removed Commands

Command	Reason
/vips givekeytab	Merged into /vips givekey

---

New Data Files

File	Description
data/hud-prefs/<uuid>.json	Per-player HUD X/Y position (default: 810 × 880)

---