Minecraft plugin QuickShop-Hikari

🔌 About QuickShop-Hikari

QuickShop-Hikari is a Minecraft plugin that implements chest-based buy/sell shops (ChestShops). Players create and use shops by interacting with chests; most gameplay does not require any commands. The project is maintained by the QuickShop-Community and focuses on modern compatibility, data safety, and extensible integrations.

🎯 Purpose

Provide an in-game, item-based economy where players can list items for sale or create buy-shops using chests. The plugin is aimed at server administrators who want a physical, chest-driven economy and per-shop control without forcing players to learn commands.

⚙️ Features

• Create buy and sell shops using chests and signs (chest-based shops).
• Support for NBT data, enchantments, item damage, potion data, and mob eggs.
• Toggleable virtual display item above shops (ProtocolLib or PacketEvents supported).
• Unlimited chest support and double-chest mixed buy/sell behavior.
• Blacklist support with bypass permission options.
• Per-shop permission management and shop benefits between owners and other players.
• i18n support for item and enchantment names and MiniMessage syntax for messages.
• H2 (local) and MySQL (remote) datasource support.
• Integration hooks for common protection and utility plugins (compatibility modules available).
• Developer API (Maven/Gradle coordinates provided) for querying shops and integrating features.
• bStats telemetry with opt-out via configuration.

🧩 Who It Is For

Server owners and administrators running Survival/SMP or economy-focused servers who want a physical, chest-based marketplace. It fits small to large servers that use Vault-compatible economy plugins and want per-shop control and database-backed storage.

🏗️ Example Use Cases

• Players place items in a chest and label it to sell stacks automatically to other players.
• An admin enables per-shop permissions so moderators can manage shops in specific worlds or regions.
• A network uses MySQL storage to keep shops persistent across server instances.

⌨️ Commands

Note: the project documentation states that normal player gameplay does not require commands; commands are primarily administrative.

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official QuickShop-Hikari jar from the project's distribution (Modrinth/Spigot/GitHub releases).
• Place the jar file into your server plugins/ folder.
• Start the server and verify the plugin loaded (the docs show running the qs command in the console to display the help/test output).

📦 Dependencies

Confirmed required/optional integrations listed by the project:

• Vault (required for economy bridging)
• A Vault-compatible economy plugin (examples given by the project)
• ProtocolLib or PacketEvents (required for virtual display items / per-player localization)
• LuckPerms (recommended for permission management)

🧾 Configuration

• The plugin creates and uses a config.yml (the docs reference config.yml keys for display protocol and privacy settings).
• Data storage supports local H2 or remote MySQL; configuration options are available in the plugin configuration files.

🧠 Technical Notes

• Official documentation recommends running on a Paper-based server and documents a requirement of Java 21.
• The project provides a developer API and Maven/Gradle coordinates for compile-time usage.
• QuickShop-Hikari ships compatibility modules for third-party plugins (e.g., WorldGuard, WorldEdit, OpenInv) as optional downloads.
• Telemetry: uses bStats; opt-out via config settings.

🤝 When This Plugin Is Useful

If you want a chest-driven, player-facing marketplace with persistent storage and per-shop controls (rather than GUI-only or command-driven shops), QuickShop-Hikari provides a modern, database-backed implementation with hooks for common economy and protection plugins.