Getting Started

Overview

mineWallet is a feature-rich economy plugin for Paper 1.19.4+ servers. It provides a complete wallet system with an in-game shop, daily bonuses, automatic promotions, and full multi-server synchronization via Redis.

Features

• Wallet System — deposit, withdraw, set balance, and track payment history
• In-Game Shop — fully configurable GUI-based store with categories and quantity selection
• Promotions — automatic rotating discounts on products
• Daily Bonus — configurable random bonus with cooldown timer
• Multi-Server Sync — Redis pub/sub keeps wallets and caches in sync across servers
• Multiple Databases — H2, MySQL, or MongoDB backends
• PlaceholderAPI — display wallet balance anywhere
• Developer API — public interfaces for external plugin integration

Requirements

• Java 17+
• Paper 1.19.4+

Optional

• PlaceholderAPI 2.11.6+
• Redis (for multi-server synchronization)
• MySQL or MongoDB (alternative database backends)

Installation

1. Download the latest mineWallet-*-spigot.jar file
2. Place it in your server’s plugins/ folder
3. Start or restart the server
4. Edit the generated configuration files in plugins/mineWallet/
5. Run /wa reload to apply changes

Configuration Files

After first startup, the following files are generated in plugins/mineWallet/:

File	Description
config.yml	Main plugin configuration (database, Redis, bonus, promotions)
messages.yml	All plugin messages with MiniMessage formatting
store-ui.yml	Shop GUI layout and elements
pay-confirm-ui.yml	Purchase confirmation dialog layout
quantity-select-ui.yml	Quantity selection dialog layout

Quick Setup

Single Server (H2)

No additional configuration is required. The plugin uses an embedded H2 database by default.

Multi-Server (MySQL + Redis)

database:
  databaseType: MYSQL
  hostname: "localhost"
  base: "minewallet"
  port: 3306
  username: "root"
  password: "securepass"

redis:
  enabled: true
  hostname: "localhost:6379"
  username: null
  password: "securepass"