ServerPad

🇪🇸 ESPAÑOL

🖥️ ServerPad — Panel de Administración para Servidores Fabric

ServerPad es un mod cliente-servidor para Fabric 1.20.1 que añade un completo menú GUI accesible con una tecla, diseñado para mejorar la experiencia de juego en servidores de comunidad. Integra herramientas de utilidad, gestión de homes, warps, kits, sistema TPA y un panel de administración completo, todo controlado desde una interfaz visual personalizada.

---

✨ Características principales

🏠 Homes

• Establece, visita y elimina puntos de teletransporte personales (homes)
• Soporte para múltiples homes por jugador con límite configurable por rango
• Límite ilimitado (-1) o bloqueado (0) según el rango de LuckPerms

🗺️ Warps

• Crear, visitar y eliminar warps globales del servidor
• Permiso de creación y límite de warps configurable por rango

📦 Kits

• Sistema completo de kits con items personalizados (edición visual desde el inventario vanilla)
• Cooldown por kit configurable en segundos
• Opción one-time-only (un solo uso por jugador)
• Acceso limitado por rangos
• Preview de items del kit antes de reclamarlo directamente desde el menú

🔁 TPA

• Solicitudes de teletransporte entre jugadores (TPA y TPA Here)
• Notificaciones en GUI con botones de aceptar/rechazar
• Gestión de múltiples solicitudes simultáneas con expiración automática (60 segundos)
• Permisos independientes por rango para TPA y TPA Here

⚡ Utilidades en menú

• 🔧 Reparar todo — repara todo el inventario (cooldown configurable)
• 🍗 Alimentar — restaura hambre y saturación (cooldown configurable)
• ❤️ Curar — restaura vida completa (cooldown configurable)
• 🗑️ Basura — inventario temporal que elimina items al cerrarse
• ⚒️ Mesa de crafteo — acceso sin necesidad de colocar bloque
• 📦 Ender Chest — acceso directo desde el menú
• ⚖️ Yunque — acceso sin necesidad de colocar bloque
• 💀 Calavera — obtén la cabeza decorativa de cualquier jugador (cooldown configurable)
• 🎩 Sombrero — equipa cualquier bloque o item como casco seleccionándolo visualmente
• 🌍 Spawn — teletransporte al spawn del servidor
• ↩️ Back — vuelve a tu última posición antes de un teletransporte o muerte

🎖️ Sistema de rangos con LuckPerms

• Integración automática con LuckPerms para leer el rango del jugador
• Cada rango puede tener configuración independiente: límites de homes y warps, permisos de TPA, botones visibles y cooldowns individuales
• Overwrites por jugador: sobrescribe la configuración de rango para jugadores concretos (por UUID)

🔗 Botón URL personalizable

• Botón configurable que abre una URL externa (Discord, web, etc.)
• Nombre, URL y rangos con acceso configurables desde el panel admin

🏷️ Insignia HUD

• Muestra el rango del jugador en pantalla como insignia
• Posición arrastrable con una tecla configurable (<kbd>B</kbd> por defecto)

---

🛠️ Panel de Administración (OP nivel 4)

• Rangos: crear, editar y eliminar rangos con configuración completa
• Overwrites: asignar configuración personalizada a jugadores individuales
• Kits: crear kits, editar sus items visualmente, configurar cooldowns y rangos permitidos
• Inventario de jugadores: ver el inventario de cualquier jugador en línea y extraer items
• Configuración global: límite default de homes y cooldown de TP global
• Botón URL: configurar nombre, URL y rangos con acceso
• Recarga en caliente con /comandos reload sin reiniciar el servidor

---

🔒 Verificación de versión

Al conectarse, el mod verifica automáticamente que cliente y servidor tengan la misma versión. Si no coinciden, el servidor desconecta al jugador con un mensaje informativo.

---

🎨 Interfaz personalizada

• Todos los paneles tienen texturas propias con estética oscura estilo Minecraft
• Botones con colores semánticos: marrón (general), verde (confirmar/guardar), rojo (eliminar/rechazar), azul (volver/cancelar)
• Autocompletado de nombres de jugadores en la pantalla de TPA

---

📋 Comandos

• /back — vuelve a tu posición anterior
• /serverstatus — comprueba si el servidor responde
• /comandos reload — recarga la configuración (OP nivel 4)

---

📦 Requisitos

• Minecraft 1.20.1
• Fabric Loader ≥ 0.15.11
• Fabric API
• LuckPerms (recomendado)
• Instalado en cliente y servidor con la misma versión

🇬🇧 ENGLISH

🖥️ ServerPad — Server Administration Panel for Fabric

ServerPad is a client-server mod for Fabric 1.20.1 that adds a full-featured GUI menu accessible with a single key press, designed to enhance the gameplay experience on community servers. It integrates utility tools, homes, warps, kits, a TPA system and a complete admin panel — all controlled from a custom visual interface.

---

✨ Main Features

🏠 Homes

• Set, visit and delete personal teleport points (homes)
• Multiple homes per player with a per-rank configurable limit
• Unlimited (-1) or fully blocked (0) based on LuckPerms rank

🗺️ Warps

• Create, visit and delete global server warps
• Creation permission and warp limit configurable per rank

📦 Kits

• Full kit system with custom items edited visually through the vanilla inventory GUI
• Per-kit cooldown configurable in seconds
• One-time-only option (single use per player)
• Rank-restricted access
• Item preview before claiming directly from the menu

🔁 TPA

• Player-to-player teleport requests (TPA and TPA Here)
• In-GUI notifications with accept/deny buttons
• Multiple simultaneous requests with automatic expiry (60 seconds)
• Independent per-rank permissions for TPA and TPA Here

⚡ Menu Utilities

• 🔧 Repair All — repairs every item in your inventory (configurable cooldown)
• 🍗 Feed — restores hunger and saturation (configurable cooldown)
• ❤️ Heal — restores full health (configurable cooldown)
• 🗑️ Trash — temporary inventory that destroys all items on close
• ⚒️ Crafting Table — access without placing a block
• 📦 Ender Chest — direct access from the menu
• ⚖️ Anvil — access without placing a block
• 💀 Player Skull — obtain any player's decorative head (configurable cooldown)
• 🎩 Hat — equip any block or item as a helmet using a visual picker
• 🌍 Spawn — teleport to the server spawn
• ↩️ Back — return to your last position before a teleport or death

🎖️ LuckPerms Rank System

• Automatic integration with LuckPerms to read each player's rank
• Every rank can have its own configuration: home and warp limits, TPA permissions, visible buttons and individual cooldowns
• Per-player overwrites: override rank settings for specific players by UUID

🔗 Customizable URL Button

• Configurable button in the menu that opens an external URL (Discord, website, etc.)
• Name, URL and allowed ranks fully configurable from the admin panel

🏷️ HUD Badge

• Displays the player's rank as a badge on the HUD
• Draggable position with a configurable key (<kbd>B</kbd> by default)

---

🛠️ Admin Panel (OP level 4)

• Ranks: create, edit and delete ranks with full configuration
• Overwrites: assign custom configuration to individual players
• Kits: create kits, edit their items visually, configure cooldowns and allowed ranks
• Player Inventory Viewer: view any online player's inventory in real time and extract items
• Global Config: default home limit and global TP cooldown
• URL Button: configure name, URL and allowed ranks
• Hot reload via /comandos reload without restarting the server

---

🔒 Version Check

When connecting to a server, the mod automatically verifies that the client and server are running the same version. If they don't match, the server disconnects the player with an informative message showing both versions.

---

🎨 Custom Interface

• All panels feature custom textures with a dark Minecraft-style aesthetic
• Semantic button colors: brown (general), green (confirm/save), red (delete/reject), blue (back/cancel)
• Player name autocomplete in the TPA screen

---

📋 Commands

• /back — return to your previous position
• /serverstatus — check if the server is responding
• /comandos reload — reload configuration (OP level 4)

---

📦 Requirements

• Minecraft 1.20.1
• Fabric Loader ≥ 0.15.11
• Fabric API
• LuckPerms (recommended)
• Must be installed on both client and server with matching versions