WERM - Web Engine for Realm Monetization

WERM Logo

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?

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

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

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

Installation

Download the WERM plugin JAR file
Place it in your server's plugins folder
Start/restart your server
Generate a plugin token in your WERM Dashboard
Edit plugins/WERM/config.yml and add your plugin token
Run /werm reload or restart your server
✅ 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

Setup: Configure the plugin with your unique plugin token from the WERM dashboard
Heartbeat: The plugin sends periodic heartbeats to keep your server status updated
Purchases: When a customer makes a purchase on your WERM store, a delivery is queued
Delivery: The plugin polls for pending deliveries and executes the configured commands
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