AfkShop

A customizable GUI coin shop plugin for Paper servers.

AfkShop allows players to purchase items using your server's coin currency through a simple and easy-to-use GUI shop.

Server administrators can create categories, add items, set prices, and configure their own economy system directly in-game.

Features

• Custom GUI Shop – Create and manage your shop with categories and items.
• Easy Item Setup – Add items directly from your main hand using commands.
• Custom Economy Support – Works with different coin and points plugins through configurable commands.
• Vault Support – Supports Vault as an optional economy provider.
• Custom Item Support – Supports items from plugins such as ItemsAdder, Nexo, and Amethyst Tools.
• Automatic Refunds – Refunds players when an item cannot be delivered after payment.
• Purchase Confirmation – Players can confirm or cancel their purchases.
• Customizable GUI – Configure menu titles, sizes, buttons, sounds, and messages.
• Configurable Categories – Create your own shop categories and organize items.
• Permission Support – Control who can use and manage the shop.

How It Works

AfkShop is designed for servers that use coins or custom currencies.

Players open the shop, select an item, and confirm their purchase. The plugin checks their balance, processes the payment, and delivers the item.

Administrators can create their own shop without manually editing item configurations.

Shop Management

Create and manage your shop directly in-game.

Hold the item you want to sell in your main hand and use the following commands:

/afkshop addcategory <id> [title]
/afkshop additem <category> <slot|auto> <price>
/afkshop setprice <category> <id> <price>
/afkshop setgive <category> <id> <command>
/afkshop removeitem <category> <id>
/afkshop list [category]
/afkshop reload

AfkShop automatically generates item IDs based on the item material. You can also use automatic slot placement to organize your shop.

Custom Item Support

AfkShop supports custom items from other plugins.

Supported examples:

• ItemsAdder
• Nexo
• Amethyst Tools
• Other plugins that use custom item data

The plugin saves a complete copy of the item, including its name, lore, enchantments, and custom data.

This allows players to receive the original custom item when purchasing it.

You can also configure another plugin's give command to deliver items.

Economy Support

AfkShop supports different economy systems.

You can configure your economy using console commands in config.yml.

Example:

economy:
  method: command
  check-command: "coins balance %player%"
  take-command: "coins take %player% %amount%"
  refund-command: "coins give %player% %amount%"

Available methods:

• command – Use your configured economy commands.
• vault – Use the registered Vault economy provider.
• auto – Use configured commands first and Vault as a fallback.

Note: Command-based balance checking requires your economy plugin to display the balance in the server console.

Configuration

AfkShop provides configuration options for customizing the shop.

You can configure:

• Main menu title and size
• Category menu size and icons
• Item prices and slots
• Back and confirmation buttons
• GUI filler items
• Purchase sounds
• Chat and actionbar messages
• Economy commands
• Purchase cooldowns and timeouts

Shop categories and items are stored in categories.yml.

Purchase Protection

AfkShop includes several features to help protect purchases:

• Prevents repeated confirmation clicks.
• Allows only one active purchase per player.
• Checks payments before delivering items.
• Verifies payments when configured.
• Automatically attempts refunds when delivery fails.
• Prevents item movement and inventory duplication through shop GUIs.
• Handles player disconnections during purchases.
• Logs payment and delivery errors for administrators.

Commands & Permissions

Command	Permission	Description
/afkshop	afkshop.use	Open the shop
/afkshop list	afkshop.admin	View shop items
/afkshop addcategory	afkshop.admin	Create a category
/afkshop additem	afkshop.admin	Add an item
/afkshop removeitem	afkshop.admin	Remove an item
/afkshop setprice	afkshop.admin	Change an item price
/afkshop setgive	afkshop.admin	Set a give command
/afkshop reload	afkshop.reload	Reload configuration
/afkshop selftest	OP / Console	Test economy integration

Default Permissions

• afkshop.use – Default: Everyone
• afkshop.admin – Default: Operators
• afkshop.reload – Default: Operators

Installation

1. Download the AfkShop plugin.
2. Place the JAR file inside your server's plugins folder.
3. Start your server.
4. Open plugins/AfkShop/config.yml.
5. Configure your economy commands.
6. Create categories and add items using the in-game commands.

Your shop is now ready to use!

Requirements

• Paper 26.3 or newer
• Java 25 or newer
• Vault (Optional)

Troubleshooting

Balance cannot be read

Check your economy commands and make sure the balance response appears in the server console. You can use /afkshop selftest <player> to test it.

Items are not being delivered

Check your configured give command and make sure it works from the server console.

Custom items lose their properties

Remove the item and add it again while holding the original custom item.

Shop categories or items are missing

Check the server console for configuration errors or invalid item slots.

---

Developed by Ngotra

If you enjoy using AfkShop, consider leaving a review or sharing your feedback. Your support helps improve the plugin.