WERM - Web Engine for Realm Monetization

The official Minecraft plugin for WERM - the future of game monetization. Global wallets, instant delivery, and powerful analytics—all with the lowest fees in the industry.

Website • Dashboard • Discord

---

🆕 What's New in v1.0.4

⚡ Performance & Reliability Release

This release adds batch delivery confirmation and async file I/O to improve performance and reliability during high-load scenarios.

| Feature | Description |
|---------|-------------|
| 📦 Batch Delivery Confirmation | Up to 10 confirmations per API call for 90% reduction in network overhead |
| 🔄 Async File I/O | Non-blocking queue persistence with debounced writes prevents main thread blocking |
| 🛑 Graceful Shutdown | Proper executor termination ensures no data loss during server stops |
| ⚡ Faster Bulk Deliveries | Improved performance when multiple items need to be delivered at once |

Technical Details:

• Batch size: 10 confirmations per API call
• I/O thread: Daemon thread named WERM-ConfirmationQueue-IO
• Shutdown timeout: 5 seconds for graceful termination
• Debounced writes: 2-second delay to coalesce multiple queue changes

Previous Releases:

v1.0.3 - Performance Optimization

| Feature | Description |
|---------|-------------|
| 🔗 HTTP Connection Pooling | New OkHttp-based connection manager with 5-connection pool and 5-minute keep-alive |
| 📉 Smart Polling | Dynamic polling with exponential backoff—reduces API calls by up to 75% during idle periods |
| ⚡ Faster Response Times | Keep-alive connections eliminate connection setup overhead |
| 🛠️ Improved Resource Usage | Connection reuse reduces memory footprint and CPU usage |

Technical Details:

• Connection pool: 5 max idle connections, 5-minute keep-alive
• Timeouts: 10s connect, 30s read, 10s write
• Backoff: Up to 4x base interval after consecutive empty responses
• Instant reset when player joins or delivery found

v1.0.2 - bStats Update

• 🔧 bStats Update - Updated bStats plugin ID for proper metrics tracking
• All security hardening from v1.0.1 remains in place

v1.0.1 - Security Features

| Feature | Description |
|---------|-------------|
| 🛡️ Command Validation | Blocks dangerous commands (op, deop, ban, stop) from being executed via deliveries |
| 🔐 TLS 1.2+ Enforcement | All API connections now require modern TLS protocols |
| 📝 Debug Redaction | Sensitive data (tokens, UUIDs) automatically redacted in debug logs |
| 💾 Confirmation Queue | Pending delivery confirmations survive server restarts |
| ✅ Input Sanitization | Player names and UUIDs sanitized before command execution |
| 🌐 Endpoint Validation | HTTPS and domain whitelist enforcement for API endpoints |
| ⏱️ Rate Limiting | Verification attempts limited to prevent brute-force abuse |
| 🔄 Auto-Discovery | Project ID now auto-discovered from API (no hardcoding) |

---

🌐 What is WERM?

WERM is a modern, all-in-one monetization platform built specifically for Minecraft servers. Think of it as a Tebex alternative—but with better features, lower fees, and a focus on the modern server owner experience.

Platform Features

| Feature | Description |
|---------|-------------|
| 🔍 Server Discovery | Get your server listed on our public directory where players can find, vote for, and join servers |
| 💰 Global Wallet System | Players have one wallet across all WERM-powered servers (1 credit = 1 USD cent) |
| 🛒 Built-in Storefront | Beautiful, customizable store pages with categories, sales, gifting, and wishlists |
| ⚡ Instant Delivery | Hybrid delivery system using webhooks + polling ensures items are delivered fast |
| 🗳️ Voting System | Integrated voting with Votifier/NuVotifier support to boost your server's ranking |
| 💬 Discord Integration | Display your Discord member count on your server listing |
| 🌍 Multi-Currency Support | Accept payments globally with automatic currency conversion |
| 💸 Lowest Fees | Starting at just 3% platform fee (vs 5%+ competitors) |

Why Choose WERM?

• Free Tier Available - Start monetizing with no monthly fees (up to $500/month revenue)
• Modern Dashboard - Clean, intuitive interface for managing your server and products
• Real-time Analytics - Track sales, player engagement, and revenue trends
• Cross-Server Economy - Players can use their wallet credits on any WERM server
• Open & Transparent - No hidden fees, no surprise charges

---

✨ Plugin Features

🔗 Account Verification

Players can securely link their Minecraft account to WERM using a simple 6-character verification code. Generate a code on the website, enter it in-game, and you're connected!

📦 Automatic Delivery System

Automatically delivers purchased products to players using configurable console commands. Supports both immediate delivery and requiring players to be online.

💓 Server Heartbeat

Keeps your server status updated on the WERM dashboard with real-time player counts and server version information.

🎮 Player Join Detection

Automatically checks for and delivers pending purchases when players join the server.

⚡ Async Processing

All API calls are processed asynchronously to ensure zero impact on your server's performance.

🛡️ Secure Authentication

Uses secure plugin token authentication to ensure only your server can manage deliveries.

📝 Fully Customizable

All messages are fully configurable with Minecraft color code support (& codes).

---

📜 Commands

| Command | Description | Permission |
|---------|-------------|------------|
| /werm verify <code> | Link your Minecraft account with WERM | werm.verify (default: true) |
| /werm help | Display help information | None |
| /werm status | View plugin connection status | werm.admin (default: op) |
| /werm reload | Reload plugin configuration | werm.admin (default: op) |

Aliases: /w

---

🎯 Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| werm.verify | Allows players to verify their Minecraft account | true |
| werm.admin | Admin commands (reload, status) | op |

---

⚙️ Configuration

# WERM Plugin Configuration

# Generate your plugin token at https://wermpay.com/dashboard/servers
plugin-token: "werm_XXXXXXXX_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

# Enable debug logging for troubleshooting
debug: false

# Heartbeat Settings
heartbeat:
  interval: 60              # Send status every X seconds
  send-player-count: true   # Include player count in heartbeat

# Delivery Settings  
delivery:
  interval: 15              # Check for deliveries every X seconds

# Customizable messages (supports & color codes)
messages:
  prefix: "&8[&6WERM&8] &r"
  verify-success: "&aYour Minecraft account has been linked successfully!"
  verify-failed: "&cVerification failed: &7%reason%"
  delivery-received: "&aYou received: &e{product} &ax{quantity}"
  # ... and more customizable messages

---

📦 Delivery Placeholders

When configuring your product commands in the WERM dashboard, you can use these placeholders:

| Placeholder | Description |
|-------------|-------------|
| {player} or {player_name} | Player's username |
| {uuid} or {player_uuid} | Player's UUID |
| {quantity} | Quantity purchased |
| {product_id} | Product ID |
| {product_name} | Product name |
| {order_id} | Order ID |
| {delivery_id} | Delivery ID |

Example Commands:

give {player} diamond 64
lp user {player} parent add vip
eco give {player} 1000

---

🚀 Installation

1. Download the WERM plugin JAR file
2. Place it in your server's plugins folder
3. Start/restart your server
4. Generate a plugin token in your WERM Dashboard
5. Edit plugins/WERM/config.yml and add your plugin token
6. Run /werm reload or restart your server
7. ✅ Your server will now appear as online in the WERM dashboard!

---

📋 Requirements

• Server Software: Spigot, Paper, Purpur, or any Spigot-based fork
• Minecraft Version: 1.13+
• Java Version: 8+
• WERM Account: Create one here

---

🔧 How It Works

1. Setup: Configure the plugin with your unique plugin token from the WERM dashboard
2. Heartbeat: The plugin sends periodic heartbeats to keep your server status updated
3. Purchases: When a customer makes a purchase on your WERM store, a delivery is queued
4. Delivery: The plugin polls for pending deliveries and executes the configured commands
5. Confirmation: Successful deliveries are confirmed and marked as completed

---

💬 Support

Need help? Join our Discord Server for support and community discussions.

---

📄 License

This plugin is provided by WERM for use with the WERM monetization platform.

---

WERM - The Future of Game Monetization
_{© 2026 WERM | Made with ❤️ for the Minecraft community}