🛡️ WardenxCheck 🛡️

API REST + Sistema Anti-Duelo para Papel/Espiga

Monitor your server remotely • Protect against rogue staff • Zero external dependencies

📋 Overview

WardenxCheck is a dual-purpose plugin that combines a powerful REST API for remote server monitoring with an intelligent anti-grief system designed to catch rogue staff members — while leaving normal players completely unrestricted.

• 👮 For Admins: Monitor TPS, players, memory, entities, and more via simple HTTP requests.
• 🛡️ For Security: Automatically detect and freeze staff using dangerous commands.
• 🔗 For Integration: Send webhooks to Discord, Telegram, or any HTTP endpoint.

🌐 REST API Endpoints

Access real-time server data via HTTP (default port 8080). All endpoints return clean JSON — perfect for dashboards, Discord bots, or monitoring systems.

🔒 API Security

• API Key Authentication: Require X-API-Key header or ?key= parameter.
• IP Whitelist: Allow only specific IPs/CIDR ranges.
• Auto-Block: Automatically block IPs after failed auth attempts.
• Rate Limiting: Configurable requests per minute per IP.
• Access Logging: Full request logs with timestamps and response times.

⚔️ Anti-Grief System

Smart Targeted Monitoring

Unlike other anti-grief plugins, WardenxCheck only monitors players with specific permissions (staff, admins, etc.). Normal players can use TNT, End Crystals, and PvP freely without restrictions.

🚫 Detects Dangerous Actions

• /fill with dangerous blocks or excessive volume.
• /summon of dangerous entities (Warden, Wither, TNT, etc.).
• /setblock and /clone abuse.
• /execute with nested dangerous commands.
• /kill @e mass entity killing.
• /give massive quantities of dangerous items.
• WorldEdit //set and //replace abuse.
• Manual placement of TNT, End Crystals, Respawn Anchors.
• Spawn eggs of dangerous mobs.

⚡ Automatic Response

1. Instant Freeze: Player cannot move, interact, or use commands.
2. Auto Rollback: Removes placed blocks/entities from the last 5 minutes.
3. Alert Admins: Notification in-game with suggested commands.
4. Webhook Alert: Send details to Discord/external systems.
5. Full Logging: Complete incident log with timestamps and context.

❄️ Freeze System Features

• Frozen players cannot move, break blocks, use commands, or interact.
• Freeze status persists across restarts and rejoins.
• Optional jail teleport for frozen players.
• OP status temporarily removed until unfrozen.

Webhook Integration Example

Envíe alertas instantáneas cuando los jugadores estén congelados usando la carga útil JSON:

{
  "event": "player_frozen",
  "timestamp": "2025-01-15T14:30:22",
  "player": {
    "name": "RogueAdmin",
    "uuid": "abc-123...",
    "ip": "192.168.1.50",
    "location": "world (100, 64, -200)"
  },
  "details": {
    "reason": "Fill with dangerous block: tnt",
    "command": "/fill ~ ~ ~ ~50 ~50 ~50 tnt"
  }
}

💻 Comandos y permisos

Alias: /wxc, /warden

⚙️ Configuración

# WardenxCheck Configuration
api:
  port: 8080
  enabled: true

security:
  monitor_staff: true
  freeze_on_detect: true

# Add your full config here...

🚀 Casos de uso

• Paneles del servidor: Integre las estadísticas del servidor en su panel de alojamiento.
• Bots de Discord: Muestra TPS en vivo, recuento de jugadores e información del servidor.
• Monitoreo: Alerta cuando el TPS cae o la memoria está alta.
• Protecția personalului: Atrape cuentas comprometidas o administradores deshonestos al instante.

📦 Requisitos e instalación

• Java: 21+
• Servidor: Papel/Espiga 1.21+
• Dependencias: Ninguno (¡todos incluidos!)

Instalare:

1. Descargar el .jar.
2. Lugar en /plugins carpeta.
3. Reiniciar servidor.
4. Editar config.yml a tus necesidades.
5. Uso /wardenxcheck genkey para generar claves API.

¿Preguntas? ¿Problemas? ¿Sugerencias?
Deja un comentario o abre un problema — ¡todos los comentarios son bienvenidos!

Gratis | Hecho para la comunidad de Minecraft por Adfay