Описание
# 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:
```json
{
"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 ` - 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
```java
PlayerTitleAPI.showTitle(player, "VICTORY!", "You won", PlayerTitleAPI.COLOR_GOLD);
```
### BlurEffectAPI
```java
BlurEffectAPI.enableBlurTemporary(player, 5000, BlurEffectAPI.COLOR_POISON);
```
**[See full documentation on GitHub](https://github.com/ELBGG/SquidUtils)**
### Installation as Dependency
```gradle
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](https://github.com/ELBGG/SquidUtils/issues)
- 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:
```json
{
"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 ` - 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
```java
PlayerTitleAPI.showTitle(player, "¡VICTORIA!", "Has ganado", PlayerTitleAPI.COLOR_GOLD);
```
### BlurEffectAPI
```java
BlurEffectAPI.enableBlurTemporary(player, 5000, BlurEffectAPI.COLOR_POISON);
```
**[Ver documentación completa en GitHub](https://github.com/ELBGG/SquidUtils)**
### Instalación como Dependencia
```gradle
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í](https://github.com/ELBGG/SquidUtils/issues)
- 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.
---