Squid Utils API

# 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); ```

(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: (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 co