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}