GlymeraSecurity v2.0

GlymeraSecurity - All-in-One Server Protection

Complete security suite: IP+UUID bans, VPN/Proxy blocking, chat muting, block logging with inspect/rollback/restore, and area-wide grief detection. One plugin, full control.

Most actual version only working for Hytale stable 5 !

What is GlymeraSecurity?

GlymeraSecurity combines all essential server security tools into a single plugin. It protects your server from griefers, VPN abusers, and unwanted players with a powerful ban system that tracks all known IPs per player. It also provides a full block logging database (powered by RocksDB) that lets admins inspect block history, look up player activity, search areas for changes, and roll back or restore griefed areas.

All commands are OP-only.

Features

Ban System (UUID + IP)

• Banning a player automatically bans their UUID and all known IPs in one command
• IP tracking builds up over time — every login records the player's IP
• Works on offline players (as long as they joined at least once)
• Separate IP-only bans for manual use
• Timed bans supported (e.g. 30m, 2h, 7d)

VPN / Proxy / Tor Blocking

• Automatically downloads and updates VPN, datacenter, and Tor exit node lists
• Live IP checks via ip-api.com (free, no key needed)
• Optional: proxycheck.io and vpnapi.io support with API keys
• 6-hour result cache to minimize API calls
• IP whitelist for trusted connections
• Players are checked on connect and blocked before joining

Chat Mute System

• Mute players from chatting while still allowing commands
• Timed or permanent mutes
• Muted players see a notification when they try to chat

Block Logging (RocksDB)

• Every block break and place is logged with player, position, world, block type, and timestamp
• Async batched writes — zero impact on server performance
• Dual-indexed: lookup by position or by player
• Automatic cleanup of old entries (configurable retention, default 30 days)
• Inspect mode: hit any block to see its full history
• Area search: find all changes by all players in a radius
• Player lookup: find all changes by a specific player nearby

Rollback & Restore

• Roll back a specific player's changes or an entire area
• Configurable radius and time window
• Restore undoes a rollback

Commands — Ban & Kick

/gban <player> — Ban player (UUID + all known IPs, permanent)
/gban ip <ip> — Ban a specific IP address
/gban list — Show all active bans (UUID + IP)
/gunban <player> — Unban player (removes UUID + all IP bans)
/gunban <ip> — Unban a specific IP
/gkick <player> — Kick a player (they can rejoin)

Commands — Mute

/gmute <player> — Mute a player (blocks chat, allows commands)
/gunmute <player> — Unmute a player

Commands — Block Logging

/gl inspect — Toggle inspect mode — hit blocks to see history
/gl lookup <player> — Show player's changes nearby (default: 20 blocks, 24h)
/gl lookup <player> <radius> — Show changes with custom radius
/gl lookup <player> <radius> <hours> — Show changes with radius and time
/gl area <radius> <hours> — Show ALL players' changes in radius
/gl rollback <player> — Rollback player's changes (default: 20 blocks, 1h)
/gl rollback <player> <radius> <hours> — Rollback with custom radius and time
/gl rollback area — Rollback ALL changes in area (default: 20 blocks, 1h)
/gl rollback area <radius> <hours> — Rollback area with custom radius and time
/gl restore <player> — Undo a rollback for a player (default: 20 blocks, 1h)

Commands — Admin

/gsec status — Show plugin status (bans, lists, cache, DB, config)
/gsec reload — Reload config, bans, mutes, and VPN lists
/gsec vpncheck <ip> — Check if an IP is flagged as VPN/Tor/Datacenter

Time & Radius Parameters

• Radius is in blocks around your current position (max configurable, default max 100)
• Hours supports decimals: 0.25 = 15 min, 0.5 = 30 min, 1 = 1 hour, 24 = 1 day
• Lookup defaults: 20 blocks radius, 24 hours
• Rollback defaults: 20 blocks radius, 1 hour

Configuration

All settings in plugins/GlymeraSecurity/config.json:

• blockVPN (default: true) — Block known VPN IPs
• blockTor (default: true) — Block Tor exit nodes
• blockDatacenter (default: true) — Block datacenter IPs
• useIpApi (default: true) — Use ip-api.com for live checks
• blockLoggingEnabled (default: true) — Enable block change logging
• vpnCacheHours (default: 6) — Hours to cache VPN check results
• defaultRollbackRadius (default: 20) — Default radius for lookup/rollback
• maxRollbackRadius (default: 100) — Maximum allowed radius
• logRetentionDays (default: 30) — Auto-delete logs older than this
• logBatchSize (default: 50) — Async write batch size
• logFlushIntervalMs (default: 500) — Async write interval
• defaultBanMessage — Message shown to banned players
• vpnBlockMessage — Message shown to VPN-blocked players
• whitelistedIPs — IPs that bypass VPN checks
• proxycheckApiKey — Optional proxycheck.io API key
• vpnapiKey — Optional vpnapi.io API key

How IP Tracking Works

Every time a player connects, their IP is stored alongside their UUID. Over time, this builds a complete picture of all IPs a player has used. When you ban a player with /gban, all their known IPs are banned simultaneously — no matter how many times they switched connections.

Installation

1. Place GlymeraSecurity.jar in your server's mods/ folder
2. Start (or restart) the server
3. Done!

No asset pack required.

Made with care by Glymera for the Hytale community