Aquatic Developments - Premium Minecraft Plugins

A comprehensive guide for setting up and using AquaticMiniShop on your Minecraft server.

1. Requirements

Server: Paper / Spigot 1.20.1 – 1.21.10
Java: Minimum Java 17
Recommended Plugins:
- Vault + an economy plugin (e.g., EssentialsX, CMI) – If no Vault is found, the plugin uses its own SQLite economy.
- PlaceholderAPI – Required for custom placeholders in scoreboards, TAB, etc.

2. Installation

Copy the minishop.jar file into your server's plugins folder.
Restart your server.
On the first run, the following files will be generated:
- config.yml – Prices, economy, storage settings, debug, language.
- messages.yml – Messages in multiple languages (en, hu, de, fr, es).
- data.db (or MySQL/JSON storage based on config) – Player data + MiniChest contents + economy.

3. Main Features

MiniShop Barrel

A special BARREL item. Right-clicking opens the MiniShop GUI for buying blocks/items.

Mini Ender Chest

A special ENDER_CHEST item. Right-clicking opens your personal MiniChest GUI.

MiniChest

3–6 rows, per-player chest storage.
Saved via SQLite / MySQL / JSON.
Expandable via the Perk Shop GUI (requires levels + economy).

Fixed Inventory Slots

If both perks are active: Slot 7 (Barrel), Slot 8 (Ender Chest).
If only one is active: It goes to Slot 8.
The plugin protects these items (cannot be moved, crafted, dropped, or stored elsewhere).

Settings & Admin GUI

Settings (/minishopsettings): Toggle Barrel/Ender Chest visibility, toggle glow effects. Checks for inventory space before enabling.
Admin (/minishopadmin [player]): Edit owned/enabled flags, modify MiniChest rows (1-6), set daily limits, adjust perk prices, reload config.

4. Commands

Command	Description	Permission
/minishop	Opens the Perk Shop GUI (Barrel, Ender Chest, Upgrades).	aquaminishop.shop
/minishopsettings	Opens your personal Settings GUI.	aquaminishop.shop
/minishopadmin [player]	Opens the Admin GUI for yourself or a target player.	aquaminishop.admin
/minishopgive <player> [type]	Gives perk items. Types: `barrel`, `ender`, `mind`.	aquaminishop.give

5. Permissions

aquaminishop.shop – Use Perk Shop / Settings GUI (Default: true)
aquaminishop.barrel – Use MiniShop Barrel (Default: true)
aquaminishop.miniender – Use Mini Ender Chest (Default: true)
aquaminishop.give – Admin give command (Default: op)
aquaminishop.admin – Admin GUI (Default: op)
aquaminishop.vip – VIP daily limit (Overrides default limit)

6. Configuration

Important sections of the config.yml file:

# Economy Settings
starting-balance: 1000  # Used if no Vault is present

# Daily Limits
daily-limit:
  default: 0            # 0 = Infinite
  vip: 50               # Requires 'aquaminishop.vip' permission

# Debug Mode
debug: false            # Enable for detailed logs

# Storage Configuration
storage:
  type: sqlite          # Options: sqlite, mysql, json
  sqlite:
    file: "data.db"
  mysql:
    host: "localhost"
    port: 3306
    # ... other MySQL settings
  json:
    folder: "playerdata"

7. PlaceholderAPI

The plugin registers the aquaminishop expansion. Usage: %aquaminishop_<placeholder>%

Placeholder	Description
%aquaminishop_balance%	Player's current balance
%aquaminishop_daily_limit%	Max daily purchases
%aquaminishop_daily_left%	Remaining purchases today
%aquaminishop_purchases_today%	Purchases made today
%aquaminishop_minichest_rows%	MiniChest rows (1-6)
%aquaminishop_minishop_owned%	Is MiniShop owned? (true/false)
%aquaminishop_minishop_enabled%	Is MiniShop enabled? (true/false)
%aquaminishop_miniender_owned%	Is MiniEnder owned? (true/false)
%aquaminishop_miniender_enabled%	Is MiniEnder enabled? (true/false)

8. Troubleshooting

Database/File Issues

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

Economy Issues

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

Placeholders Not Working

Verify PlaceholderAPI is installed and check logs for "AquaticMiniShop placeholders registered".

AquaticMiniShop Documentation