Skip to content

Releases

UniversalShop 2.1.0 — Custom chest layouts

Choose a tag to compare

@hashk014 hashk014 released this 14 Oct 12:57

UniversalShop 2.1.0

Customize Java chest menus through the new menus.yml: choose 1–6 rows, ordered
content slots/page sizes, control positions, title overrides, backgrounds and
passive decorations. The feature covers all 13 shop, market, administration and
catalog editor menu types. Existing installations receive the default file
without overwriting their catalogs or other configuration.

Controls keep their actions when moved, including confirmation buttons. Content
pagination uses the configured capacity. Layout validation rejects collisions,
out-of-range slots, unknown settings and invalid materials. Invalid reloads retain
the previous active layout; successful reloads close open chest menus.

See menu configuration and examples. Native Bedrock forms retain their
own presentation. Automated runtime checks cover custom sizes, moved confirmation
with duplicate-click protection, passive decorations, compact category pagination,
editor content mapping and rejection of invalid layout reloads. The complete
Paper, Vault, Bedrock and legacy Unicode suites were rerun against this release.

Install UniversalShop-2.1.0.jar after stopping the server and backing up its data.
No balance migration is required when keeping the same economy. Menus are
configured in YAML; the catalog editor still edits products rather than layout
geometry.

Validation: 101 Java tests, 20 migration tests, 55/55 Paper versions, two Vault/EssentialsX versions, 28 Bedrock bridge checks and 26 legacy Unicode checks passed. Artifacts match the tested JAR.

Platform files are uploaded; first project moderation is pending. Modrinth submission requests unlisted visibility in accordance with its disclosed AI-content policy.

UniversalShop 2.0.0 - In-game editor and Vault marketplace

Choose a tag to compare

@hashk014 hashk014 released this 14 Oct 11:51

UniversalShop 2.0.0

Create catalog products directly in game, complete player purchases without losing browsing context, and run the marketplace with the internal economy or Vault. Existing wallets, escrow, settings and legacy pending journals are retained.

In-game catalog editor

/shop admin editor opens a guided editor. Create a product from the exact held item, adjust its name/category, prices, stock capacity/restocking, daily limits, worlds, permission, dynamic bounds/idle half-life, featured availability and console commands. Drafts stay private until reviewed and published; stale drafts cannot overwrite another administrator's edits. Template replacement, command edits and deletion require confirmation. Publication validates the complete catalog and preserves the previous file atomically.

Granular administrator permissions separate catalog, console commands, stock, balances, history, management, recovery, backup and reload. The existing universalshop.admin node remains compatible. English/French packs, personal language preferences and editable menu icons/background are included.

Player experience

Java search, custom quantities and listing creation use private, expiring chat inputs from menu actions. Bedrock players receive native text forms. Maximum quantities respect money, inventory space/matching metadata, stock, quotas, cooldowns, order bounds and daily budgets. Previews retain item metadata, remaining quotas are visible, and confirmations return to the previous category/page. Bulk sales have a review/confirmation menu. Inputs and confirmation callbacks are consumed once.

Marketplace browsing adds search, newest/price/name/seller ordering, personal listings and expired-item views. Expired offers are hidden publicly and do not consume the active seller quota. /shop market claim recovers whole expired listings that fit, keeping the remainder escrowed. Sale notices survive offline periods.

Vault buyers are debited through their provider. Net seller proceeds become durable liabilities until explicitly collected. Uncertain provider effects quarantine trading; interrupted deposits are never blindly repeated. Outstanding credits are bound to the original provider name.

Storage and operations

The durable commit point publishes sparse state changes and a checksummed audit record together. Checkpoints retain ordinary YAML with exact-byte integrity verification. Durable history survives beyond the legacy 200-entry cache. Legacy YAML/prepared journals migrate on startup. A process lease prevents two servers writing the same directory.

Legacy YAML writers previously turned supplementary Unicode text into binary and discarded custom item metadata on reload. The serializer now escapes only affected String scalars, retaining emoji names/lore, enchantments, damage and genuine binary data through journal/checkpoint reload. This is separately verified on actual Paper 1.7.10 and 1.8.8 with the production JAR.

/shop admin history filters UUID/product/UTC date/outcome/text and exports CSV. /shop admin backup captures configuration, catalog, checkpoint, audit and pending evidence in a plugin-data ZIP. /shop admin diagnose exposes recovery status and advisory duplicate/base-crafting price problems. Plugin backups require separate Minecraft playerdata and external economy backups.

The included offline migration tool checks the process lease, checksum and outstanding escrow/credits, creates a complete plugin backup and receipt, then changes only economy/provider bindings. Interrupted changes keep startup blocked. Provider balances must be transferred separately; the tool never moves money itself.

Dynamic prices optionally recover after inactivity: demand halves toward zero per complete configured idle interval. Active trades refresh the timer; rapid splitting cannot erase demand through rounding. Diagnostics remain advisory for farms, recipes and other plugins.

Validation and limits

See COMPATIBILITY.md and machine-readable Paper/Vault/Bedrock reports for the exact JAR hash and final counts. Unit coverage includes corruption, crash/restart boundaries, legacy migration, backups, filters, permissions, input validation, money and policies. Connected-player integration drives editor draft/input/review/publish/cancel/stale flows, confirmation duplication, metadata previews, market accounting and full restarts.

The storage benchmark compares old full snapshots with the new journal on a synthetic 20,000-wallet/500-product ledger. It measures storage costs, not Minecraft TPS or multiplayer stress. Writes, copy/diff work, reports, backups and checkpoints remain synchronous. Physical power loss, rendered desktop/mobile/console UI, Microsoft authentication, other Vault providers and network-wide consistency are not certified.

Install or upgrade

Stop the server and preserve a full backup, replace the binary with UniversalShop-2.0.0.jar, then restart. Run /shop admin editor, /shop admin diagnose and optionally /shop language fr. Existing modules retain their settings; missing keys use defaults without replacing customized catalogs.

  • UniversalShop-2.0.0.jar: install in plugins/.
  • UniversalShop-2.0.0-Install.zip: JAR, example language/configuration files and documentation.
  • UniversalShop-2.0.0-sources.jar: Java source archive.
  • UniversalShop-2.0.0-Evidence.zip: integration and unit evidence.
  • SHA256SUMS.txt and manifest.json: exact release metadata.

UniversalShop 1.2.0 - Optional management modules

Choose a tag to compare

@hashk014 hashk014 released this 13 Oct 19:39

UniversalShop 1.2.0

Manage a small shop with a few switches, or enable advanced survival-economy controls as needed. This release adds nine independent management modules, all OFF by default, with a Java inventory dashboard and native Bedrock administrator forms. All plugin content remains in English.

Optional modules

  • Access: maintenance, opening days/hours, named timezones, overnight windows and a custom closure message.
  • Product rules: pause products/categories, switch buying/selling separately, set order bounds, per-player product cooldowns and server-wide daily quotas.
  • Budgets: daily player spending and sale-earnings caps, including atomic bulk-sale enforcement.
  • Campaigns: multiple timed, targeted promotions with optional permissions.
  • Loyalty: configurable discount tiers based on completed purchase spending.
  • Sale protection: named, lore-bearing, enchanted, damaged or selected material templates.
  • Analytics: product/player totals, top products by revenue and CSV exports.
  • Personal tools: persistent favorites, recent trades and catalog/name/base-price sorting.
  • Stock alerts: configurable low-stock console warnings with throttling.

Additional admin tools duplicate, rename and recategorize products, restore stock and reset supply/demand offsets. New rules run through the existing transaction journal and respect command switches, permissions and the resale price floor. They cover the server shop; player-market escrow and payments remain independently configurable.

Quick start

/shop admin panel
/shop admin manage enable personal
/shop admin manage enable analytics
/shop admin manage stats

Open the panel in Survival mode with universalshop.admin. Enable only the modules you need. The management guide contains all commands, examples, defaults and exact rule semantics.

Validation

  • 43 JUnit tests passed, including schedules, quotas, cooldowns, budgets, campaigns, loyalty, analytics and upgrade defaults.
  • 55 Paper versions from 1.7.10 through 26.3 passed with two connected Java protocol clients and a full restart. Each case includes optional-module scenarios and a server-driven dashboard click, plus statistics/favorites persistence.
  • Vault 1.7.3 with EssentialsX 2.22.0 passed on Paper 1.21.11 and 26.3, including budget rejection before debit and managed-transaction accounting.
  • A real offline Bedrock protocol client on Paper 26.2 with Geyser/Floodgate received 12 native forms and passed 23 checks, including favorites and an administrator module toggle.
  • Every integration report records the exact release JAR SHA-256. Full logs and unit reports are included in the evidence ZIP.

No rendered Minecraft/mobile/console UI, Microsoft authentication or high-concurrency load test is claimed. The Java matrix is not a Geyser backend compatibility matrix. This remains a Java backend plugin, not a native Bedrock Dedicated Server or land-claim plugin. See compatibility and operations documentation for platform boundaries.

Upgrade and assets

Stop the server, back up its plugin data, replace the previous UniversalShop JAR with 1.2.0 and restart. Configuration, catalog and ledger are preserved. Missing management settings use defaults without overwriting user settings. No new module changes trading or collects activity until enabled.

  • UniversalShop-1.2.0.jar: install in plugins/.
  • UniversalShop-1.2.0-Install.zip: JAR, example configuration and documentation.
  • UniversalShop-1.2.0-sources.jar: source archive.
  • UniversalShop-1.2.0-Evidence.zip: integration logs and unit reports.
  • SHA256SUMS.txt and manifest.json: checksums and release metadata.

UniversalShop 1.1.0 - Command controls and Bedrock forms

Choose a tag to compare

@hashk014 hashk014 released this 13 Oct 19:19

UniversalShop 1.1.0

Administrators can now disable individual UniversalShop commands or entire groups. Bedrock players connecting through Geyser/Floodgate receive native forms with separate Buy/Sell buttons and confirmation screens. All plugin messages and documentation remain in English.

New features

  • disabled-commands configuration with parent/child rules such as pay, buy, market.list or admin.add.
  • /shop admin command disable <path> and /shop admin command enable <path> persist changes immediately. The console remains able to restore access, even when shop or admin is disabled.
  • Shared enforcement across aliases, namespaced commands, signs, Java menus and Bedrock transactions; disabled options are filtered from help/completion and relevant buttons.
  • Optional Geyser/Floodgate integration without mandatory runtime dependencies. Bedrock forms support product/category/deal browsing, quantities, buy/sell confirmation, bulk sales and player-market purchase/reclaim confirmation.
  • One-use form tokens, expired quote rejection and invalidation on reload, disconnect or policy change. Missing form APIs fall back to the inventory interface.

Validation

  • 26 JUnit tests passed.
  • 55 Paper versions from 1.7.10 through 26.3 passed with two connected Java protocol clients and a full server restart.
  • Vault 1.7.3 with EssentialsX 2.22.0 passed on Paper 1.21.11 and 26.3.
  • A Bedrock 26.51 protocol client connected through real Geyser/Floodgate on Paper 26.2: 6 native forms received, 15 checks passed, including purchase/sale accounting, duplicate responses, disabled purchase rejection and hidden Buy button.
  • All reports identify the exact release JAR SHA-256. Logs and unit reports are bundled in the evidence ZIP.

The Bedrock fixture uses an offline loopback identity. Microsoft/Xbox authentication, account linking, proxy forwarding and rendered mobile/console UI were not tested. The Java compatibility matrix does not imply Geyser supports every listed backend. UniversalShop runs on the Java backend; native Bedrock Dedicated Server, Folia, Fabric and Forge are unsupported. Spigot/CraftBukkit/Purpur are intended API targets but were not directly boot-tested.

Upgrade and download

Stop the server, back up the UniversalShop folder, replace the previous JAR with UniversalShop-1.1.0.jar, and restart. Existing configuration/catalog/ledger files are retained. New switches default to no disabled commands and Bedrock forms enabled. See setup and command examples.

  • UniversalShop-1.1.0.jar: plugin to install in plugins/.
  • UniversalShop-1.1.0-Install.zip: JAR, example configuration and English documentation.
  • UniversalShop-1.1.0-sources.jar: source archive.
  • UniversalShop-1.1.0-Evidence.zip: integration logs and test reports.
  • SHA256SUMS.txt and manifest.json: artifact checksums and release metadata.

UniversalShop 1.0.0

Choose a tag to compare

@hashk014 hashk014 released this 13 Oct 18:58

UniversalShop 1.0.0

An English survival shop for Minecraft Java with a single legacy/modern plugin JAR.

Features include GUI purchases and sales with confirmation, exact custom-item templates, bulk selling, command services, an internal economy, optional Vault, dynamic prices, finite stock and timed restocking, daily limits, weekly/daily featured items, timed promotions, permission discounts, taxes, a player marketplace with escrow, shop signs, catalog editing, backups, history and transaction recovery.

Validation

  • 18 unit tests passed.
  • 55 Paper versions from 1.7.10 through 26.3 passed the internal-economy integration suite with two connected protocol clients, server-side GUI checks and a full restart.
  • Vault 1.7.3 with EssentialsX 2.22.0 passed real debit/deposit and restart checks on Paper 1.21.11 and 26.3.
  • The compatibility JSON records the exact tested JAR hash, server builds, channels and check counts. Full logs are provided in the evidence archive.

Spigot/CraftBukkit/Purpur are intended API targets but were not directly boot-tested. Folia, Forge, Fabric, Bedrock and proxy servers are not plugin targets. No rendered-client visual or high-concurrency load test is claimed. Review the compatibility and operations documents for precise limits, including ambiguous third-party delivery recovery.

Downloads

  • UniversalShop-1.0.0.jar: install in your server's plugins/ folder.
  • UniversalShop-1.0.0-Install.zip: JAR, example configuration and English documentation.
  • UniversalShop-1.0.0-sources.jar: plugin source archive.
  • UniversalShop-1.0.0-Evidence.zip: full per-version integration logs and test reports.
  • SHA256SUMS.txt and manifest.json: artifact checksums and release metadata.

Start the server and run /shop. Internal mode requires no dependencies. The player marketplace and /shop pay use internal wallets; Vault mode delegates balances to the installed provider.