SquidUtils - Essential Server Utilities

SquidUtils is a mod that provides advanced tools and APIs for creating custom experiences in Minecraft.

---

✨ Main Features

🎯 Custom Titles

Display fully customizable titles and subtitles on players' screens with complete control over:

• Colors and scales
• Duration and fade effects
• Screen positioning
• Automatic timers

🌀 Blur Effects

Apply visual blur effects on screen borders with:

• Customizable colors
• Adjustable intensity and width
• Temporary or permanent activation
• Perfect for indicating states (poisoned, stunned, etc.)

🔢 Numbering System

Automatically assign numbers to players:

• Automatic numbering on join
• TAB display
• Ideal for tournaments and competitions
• Integration with death messages

💀 Custom Death Messages

Complete death handling system:

• Custom messages with player numbers
• "Floating soul" effect with inertia
• Screen darkening
• Programmable post-death commands

⚙️ Scheduled Commands on Death

Execute command sequences automatically when a player dies:

• Precise delays in seconds (even decimals)
• Player-specific commands
• Fully configurable via JSON
• Perfect for custom respawn systems

🚪 Waiting Room System

Professional lobby with:

• Customizable HUD
• Real-time player counter
• Automatic phase system
• Complete visual configuration

---

📦 Installation

For Players

1. Download the mod from Modrinth
2. Place it in your Fabric client's mods/ folder
3. Done! The mod will work automatically on servers that have it installed

For Administrators

1. Download the mod from Modrinth
2. Place it in your Fabric server's mods/ folder
3. Start the server to generate configurations
4. Customize the files in config/squidutils/

---

🔧 Configuration

The mod automatically generates configuration files in config/squidutils/:

dead.json

Configure commands that execute when a player dies:

{
  "commands": [
    {
      "delaySeconds": 0,
      "command": "say {player} has been eliminated!"
    },
    {
      "delaySeconds": 3,
      "command": "title {player} title {\"text\":\"ELIMINATED\",\"color\":\"red\"}"
    }
  ]
}

waitinghud.json

Customize colors, sizes, and positions of the waiting room HUD.

---

🎯 Commands

/squidutils

• /squidutils numberplayer start - Start player numbering
• /squidutils numberplayer stop - Stop numbering
• /squidutils numberplayer stats - Show statistics
• /squidutils deathmessage start - Enable custom death messages
• /squidutils deathmessage stop - Disable death messages

/waitingroom

• /waitingroom start <maxPlayers> - Start waiting room
• /waitingroom stop - Stop waiting room
• /waitingroom status - Show current status

All commands require operator permissions (level 2)

---

💻 API for Developers

SquidUtils provides complete APIs for developers:

PlayerTitleAPI

PlayerTitleAPI.showTitle(player, "VICTORY!", "You won", PlayerTitleAPI.COLOR_GOLD);

BlurEffectAPI

BlurEffectAPI.enableBlurTemporary(player, 5000, BlurEffectAPI.COLOR_POISON);

See full documentation on GitHub

Installation as Dependency

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    modImplementation "com.github.ELBGG:SquidUtils:${squid_version}"
    include "com.github.ELBGG:SquidUtils:${squid_version}"
}

---

📋 Requirements

• Minecraft: 1.21.1
• Fabric Loader: 0.15.0+
• Fabric API: Required
• Satin API: 2.0.0+

---

🤝 Compatibility

• ✅ Client and Server: Works on both
• ✅ Multiplayer: Optimized for servers
• ✅ Singleplayer: Compatible
• ✅ Other mods: High compatibility

---

🐛 Report Issues

Found a bug? Have a suggestion?

• GitHub Issues: Report here
• Provide complete logs
• Describe steps to reproduce
• Indicate mod and Minecraft version

---

📜 License

All rights reserved by ELBGG. Redistribution without authorization is prohibited.

---

SquidUtils - Utilidades Esenciales para Servidores

SquidUtils es un mod que proporciona herramientas avanzadas y APIs para crear experiencias personalizadas en Minecraft.

---

✨ Características Principales

🎯 Títulos Personalizados

Muestra títulos y subtítulos completamente personalizables en la pantalla de los jugadores con control total sobre:

• Colores y escalas
• Duración y efectos de fade
• Posicionamiento en pantalla
• Temporizadores automáticos

🌀 Efectos de Blur

Aplica efectos visuales de desenfoque en los bordes de la pantalla con:

• Colores personalizables
• Intensidad y ancho ajustables
• Activación temporal o permanente
• Perfectos para indicar estados (envenenado, aturdido, etc.)

🔢 Sistema de Numeración

Asigna automáticamente números a los jugadores:

• Numeración automática al unirse
• Visualización en el TAB
• Ideal para torneos y competencias
• Integración con mensajes de muerte

💀 Mensajes de Muerte Personalizados

Sistema completo de manejo de muertes:

• Mensajes personalizados con números de jugador
• Efecto de "alma flotante" con inercia
• Oscurecimiento de pantalla
• Comandos programables post-muerte

⚙️ Comandos Programados al Morir

Ejecuta secuencias de comandos automáticamente cuando un jugador muere:

• Delays precisos en segundos (incluso decimales)
• Comandos específicos por jugador
• Totalmente configurable vía JSON
• Perfecto para sistemas de respawn personalizados

🚪 Sistema de Sala de Espera

Lobby profesional con:

• HUD personalizable
• Contador de jugadores en tiempo real
• Sistema de fases automático
• Configuración visual completa

---

📦 Instalación

Para Jugadores

1. Descarga el mod desde Modrinth
2. Colócalo en la carpeta mods/ de tu cliente Fabric
3. ¡Listo! El mod funcionará automáticamente en servidores que lo tengan instalado

Para Administradores

1. Descarga el mod desde Modrinth
2. Colócalo en la carpeta mods/ de tu servidor Fabric
3. Inicia el servidor para generar las configuraciones
4. Personaliza los archivos en config/squidutils/

---

🔧 Configuración

El mod genera automáticamente archivos de configuración en config/squidutils/:

dead.json

Configura comandos que se ejecutan cuando un jugador muere:

{
  "commands": [
    {
      "delaySeconds": 0,
      "command": "say {player} ha sido eliminado!"
    },
    {
      "delaySeconds": 3,
      "command": "title {player} title {\"text\":\"ELIMINADO\",\"color\":\"red\"}"
    }
  ]
}

waitinghud.json

Personaliza los colores, tamaños y posiciones del HUD de la sala de espera.

---

🎯 Comandos

/squidutils

• /squidutils numberplayer start - Inicia numeración de jugadores
• /squidutils numberplayer stop - Detiene numeración
• /squidutils numberplayer stats - Muestra estadísticas
• /squidutils deathmessage start - Activa mensajes de muerte personalizados
• /squidutils deathmessage stop - Desactiva mensajes de muerte

/waitingroom

• /waitingroom start <maxPlayers> - Inicia sala de espera
• /waitingroom stop - Detiene sala de espera
• /waitingroom status - Muestra estado actual

Todos los comandos requieren permisos de operador (nivel 2)

---

💻 API para Desarrolladores

SquidUtils proporciona APIs completas para desarrolladores:

PlayerTitleAPI

PlayerTitleAPI.showTitle(player, "¡VICTORIA!", "Has ganado", PlayerTitleAPI.COLOR_GOLD);

BlurEffectAPI

BlurEffectAPI.enableBlurTemporary(player, 5000, BlurEffectAPI.COLOR_POISON);

Ver documentación completa en GitHub

Instalación como Dependencia

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    modImplementation "com.github.ELBGG:SquidUtils:${squid_version}"
    include "com.github.ELBGG:SquidUtils:${squid_version}"
}

---

📋 Requisitos

• Minecraft: 1.21.1
• Fabric Loader: 0.15.0+
• Fabric API: Requerida
• Satin API: 2.0.0+

---

🤝 Compatibilidad

• ✅ Cliente y Servidor: Funciona en ambos
• ✅ Multiplayer: Optimizado para servidores
• ✅ Singleplayer: Compatible
• ✅ Otros mods: Alta compatibilidad

---

🐛 Reportar Problemas

¿Encontraste un bug? ¿Tienes una sugerencia?

• GitHub Issues: Reportar aquí
• Proporciona logs completos
• Describe los pasos para reproducir
• Indica versión del mod y Minecraft

---

📜 Licencia

Todos los derechos reservados por ELBGG. Prohibida la redistribución sin autorización.

---