AquaticMiniShop

A feature-rich, portable shop and storage solution for Minecraft servers. Allows players to carry a MiniShop Barrel and a Mini Ender Chest. Includes Perk Shop, Vault support, and database integration.

Requirements

Server: Paper / Spigot 1.20.1 – 1.21.10
Java: Minimum Java 17
Recommended Plugins:
- Vault + economy plugin (EssentialsX, CMI) – Internal SQLite economy used if missing.
- PlaceholderAPI – Optional, for placeholders.

Installation

Download
Get the AquaticMiniShop-1.0.0.jar file.
Install
Drag and drop it into your server's plugins folder.
Restart
Restart your server to generate configuration files.
Configure
Edit config.yml and lang/*.yml as needed.

Core Features

Portable MiniShop

Open a shop GUI anywhere using the MiniShop Barrel item.

Mini Ender Chest

Access a private, upgradable storage anywhere.

Perk Shop

Buy items and upgrade MiniChest rows (3 to 6 rows).

Upgradable Storage

Start with 3 rows, upgrade to 6 rows using money and XP.

Economy Support

Full Vault support. Falls back to internal SQLite economy.

Settings GUI

Toggle item visibility and glow effects via /minishopsettings.

Admin GUI

Manage player perks, rows, limits, and toggle features live.

Daily Limits

Limit daily purchases (VIP support available).

Multi-language

English, Hungarian, German, French, Spanish support.

Database Support

SQLite (default) and MySQL support.

Commands

Command	Description	Permission
/minishop	Opens the Perk Shop GUI.	aquaminishop.shop
/minishopsettings	Opens the Settings GUI.	aquaminishop.shop
/minishopgive <p> [t]	Gives special items (barrel, ender).	aquaminishop.give
/minishopadmin [p]	Opens the Admin GUI.	aquaminishop.admin
/minishopreload	Reloads configuration files.	aquaminishop.admin

Permissions

Node	Default	Description
aquaminishop.shop	true	Access to /minishop & settings
aquaminishop.give	op	Access to /minishopgive
aquaminishop.admin	op	Access to /minishopadmin & reload
aquaminishop.barrel	true	Use MiniShop Barrel item
aquaminishop.miniender	true	Use Mini Ender Chest item
aquaminishop.vip	false	Bypass default daily limits

Configuration

config.yml

# https://aquaticdev.eu/docs - DOCUMENTATION

# Debug mode – if true, more verbose error logging + stacktraces in console
debug: false

# Default language (en, hu, de, fr, es)
language: en
available-languages:
  - en
  - hu
  - de
  - fr
  - es

# Starting balance when Vault is NOT present
starting-balance: 0.0

# Daily purchase limits
daily-limit:
  default: 0   # 0 = unlimited
  vip: 0       # if >0 and the player has aquaminishop.vip

# Permissions
permissions:
  shop: aquaminishop.shop
  settings: aquaminishop.shop
  admin: aquaminishop.admin
  give: aquaminishop.give
  barrel-use: aquaminishop.barrel
  miniender-use: aquaminishop.miniender
  vip: aquaminishop.vip
  open: minishop.open

# Storage mode: sqlite | mysql | json
storage:
  type: sqlite
  sqlite:
    file: data.db
  mysql:
    host: localhost
    port: 3306
    database: minishop
    user: root
    password: password
    useSSL: false

# Perk prices and MiniChest upgrades
perk-shop:
  gui-title: "&3Perk Shop"
  require-xp-for-upgrades: true
  prices:
    mini-ender: 8000.0
    minishop-barrel: 10000.0
  minichest-upgrades:
    - to-rows: 4
      price: 20000
      required-level: 0
    - to-rows: 5
      price: 40000
      required-level: 30
    - to-rows: 6
      price: 80000
      required-level: 40

Placeholders

⚠️ Requires PlaceholderAPI installed on your server.

Placeholder	Description
%aquaminishop_balance%		Player's balance.
%aquaminishop_daily_limit%		Player's max daily limit.
%aquaminishop_daily_left%		Purchases left for today.
%aquaminishop_purchases_today%		Number of purchases made today.
%aquaminishop_minichest_rows%		Current rows of the MiniChest.
%aquaminishop_minishop_owned%		True/false if player owns the Barrel.
%aquaminishop_glow_enabled%		True/false if glow is enabled.

Troubleshooting

Database/File Issues

If data.db is not created, check folder permissions. Ensure storage.type is set correctly in config.

Economy Issues

If no Vault is found, the plugin falls back to its internal economy. %aquaminishop_balance% works in both cases.