Bienvenid@ a QuickHud

Welcome to QuickHud

QuickHud es un mod + plugin para Minecraft que permite a los administradores de servidor mostrar información personalizada en la pantalla de los jugadores, como contadores de jugadores vivos, kills, timers, coordenadas y equipos.

QuickHud is a mod + plugin for Minecraft that allows server administrators to display custom information on players' screens, such as alive player counters, kills, timers, coordinates and teams.

Mod + Plugin Fabric · Forge Bukkit · Spigot Minecraft 1.20.1

❓ ¿Qué es QuickHud?What is QuickHud?

QuickHud es un mod + plugin para Minecraft que permite a los administradores de servidor mostrar información personalizada en la pantalla HUD de los jugadores, como contadores de jugadores vivos, kills, temporizadores con cuenta regresiva, coordenadas y listas de equipo con skin.

QuickHud is a mod + plugin for Minecraft that allows server administrators to display custom information on the players' HUD screen, such as alive player counters, kills, countdown timers, coordinates, and team lists with skins.

🔌

Cómo funciona How it works El plugin (Bukkit/Spigot) corre en el servidor y controla qué se muestra. El mod (Fabric/Forge) debe estar instalado en el cliente de cada jugador para poder renderizar el HUD. The plugin (Bukkit/Spigot) runs on the server and controls what is shown. The mod (Fabric/Forge) must be installed on each player's client to render the HUD.

📦 DescargasDownloads

El mod y el plugin están disponibles en las mismas plataformas:

The mod and plugin are available on the same platforms:

🟩

Modrinth

Mod & Plugin · Todas las versiones

Mod & Plugin · All versions

Ir a Modrinth ↗Go to Modrinth ↗

🔥

CurseForge

Mod & Plugin · Todas las versiones

Mod & Plugin · All versions

Ir a CurseForge ↗Go to CurseForge ↗

🧩 CompatibilidadCompatibility

Componente	Component	Loader / Plataforma	Loader / Platform
Mod (Cliente)	Mod (Client)	Fabric	1.20.1
Mod (Cliente)	Mod (Client)	Forge	1.20.1
Plugin (Servidor)	Plugin (Server)	Bukkit / Spigot	1.20.1

ℹ️

QuickHud no requiere dependencias adicionales. QuickHud does not require additional dependencies.

⚙️ InstalaciónInstallation

📌

Instalación en dos partes Two-part installation QuickHud requiere el mod en el cliente (para renderizar el HUD) y el plugin en el servidor (para controlar qué se muestra). Sin ambas partes, el HUD no funcionará. QuickHud requires the mod on the client (to render the HUD) and the plugin on the server (to control what is shown). Without both parts, the HUD won't work.

Instalación del Mod (Cliente)

Mod Installation (Client)

Instala Fabric o Forge para 1.20.1

Install Fabric or Forge for 1.20.1

Descarga e instala el loader correspondiente desde su web oficial.

Download and install the corresponding loader from its official website.

Descarga el mod QuickHud

Download the QuickHud mod

Descarga la versión correcta para tu loader desde Modrinth o CurseForge.

Download the correct version for your loader from Modrinth or CurseForge.

Coloca el .jar en la carpeta mods/

Place the .jar in the mods/ folder

.minecraft/mods/quickhud-x.x-fabric-1.20.1.jar

Instalación del Plugin (Servidor)

Plugin Installation (Server)

Descarga el .jar del plugin

Download the plugin .jar

El archivo de plugin está en los mismos enlaces de Modrinth/CurseForge.

The plugin file is in the same Modrinth/CurseForge links.

Coloca el .jar en plugins/

Place the .jar in plugins/

Copia el archivo en la carpeta plugins/ de tu servidor Bukkit/Spigot.

Copy the file to the plugins/ folder of your Bukkit/Spigot server.

Reinicia el servidor

Restart the server

El plugin generará automáticamente su carpeta de configuración en plugins/QuickHudPL/. El estado se persiste en state.json.

The plugin will automatically generate its config folder at plugins/QuickHudPL/. State is persisted in state.json.

plugins/ └── QuickHudPL/ └── state.json ← Estado global del HUD (auto-generado)

🎯 Elementos del HUDHUD Elements

QuickHud puede mostrar los siguientes elementos, cada uno con posición y escala configurables:

QuickHud can display the following elements, each with configurable position and scale:

👤

Jugadores

Players

Contador de jugadores vivos (modo supervivencia/aventura)

Alive player counter (survival/adventure mode)

💀

Kills

Contador de bajas. Se incrementa automáticamente cuando un jugador mata a otro.

Kill counter. Auto-increments when a player kills another.

⏱️

Temporizador

Timer

Cuenta regresiva con etiqueta personalizable. Soporta %timer% como placeholder.

Countdown timer with customizable label. Supports %timer% as placeholder.

🗺️

Coordenadas

Coordinates

Muestra las coordenadas X Y Z del jugador en tiempo real.

Shows the player's X Y Z coordinates in real time.

🤝

Equipo

Team

Lista de miembros del equipo del jugador con sus skins renderizadas.

Player's team member list with their rendered skins.

✏️

Texto libre

Free text

Texto personalizado en cualquier posición. Soporta códigos de color Minecraft.

Custom text at any position. Supports Minecraft color codes.

⌨️ Comandos del PluginPlugin Commands

Todos los comandos son ejecutados en el servidor por un operador (isOp). El estado se sincroniza automáticamente a todos los jugadores conectados.

All commands are executed on the server by an operator (isOp). State is automatically synced to all connected players.

Show / Hide

Mostrar todos los elementosShow all elements

/hud show all [pos] [escala]

Mostrar elemento específicoShow specific element

/hud show players|kills|coords|team <pos> [escala]

Iniciar temporizadorStart timer

/hud show timer <pos> <segundos> [escala] [texto con %timer%]

Mostrar texto libreShow free text

/hud show text <pos> <texto...>

Ocultar elementosHide elements

Kills & Timer

Gestionar killsManage kills

/hud kills set <n> [jugador|@a]
/hud kills reset [jugador|@a]

Controlar temporizadorControl timer

/hud timer pause|resume|reset

Otros

Other

Cambiar idioma / Resetear todoChange language / Reset all

/hud lang es|en
/hud reset                  ← restaura valores por defecto

Referencia de argumentos

Argument reference

Argumento	Argument	Descripción
<pos>	Posición en pantalla (ver sección Posiciones)	Screen position (see Positions section)
[escala]	Número decimal. 1.0 = tamaño normal. Rango: 0.1 – 5.0	Decimal number. 1.0 = normal size. Range: 0.1 – 5.0
<segundos>	Duración del temporizador en segundos (entero positivo)	Timer duration in seconds (positive integer)
%timer%	Placeholder que se reemplaza con el tiempo formateado (MM:SS)	Placeholder replaced with formatted time (MM:SS)

📐 PosicionesPositions

Cada elemento del HUD puede colocarse en una de las 9 posiciones predefinidas:

Each HUD element can be placed at one of the 9 predefined positions:

top_left

top_center

top_right

mid_left

mid_center

mid_right

bottom_left

bottom_center

bottom_right

💡

Cuando varios elementos comparten la misma posición, se apilan automáticamente verticalmente sin superponerse. When multiple elements share the same position, they automatically stack vertically without overlapping.

🔒 PermisosPermissions

QuickHud usa el sistema de permisos de Bukkit. Actualmente los comandos requieren que el jugador sea op:

QuickHud uses Bukkit's permission system. Currently commands require the player to be op:

🛡️

isOp (Operador)

⚙️ Default: op

⚠️

Los comandos de cliente (/mediac) no existen en QuickHud. Todo se controla desde el servidor con /hud. Los jugadores no ejecutan ningún comando. Client commands (/mediac) do not exist in QuickHud. Everything is controlled from the server with /hud. Players don't execute any commands.

❓ Preguntas FrecuentesFrequently Asked Questions

¿El HUD se muestra igual para todos los jugadores?

Is the HUD shown the same for all players?

Sí. QuickHud usa un estado global único. Cualquier cambio realizado por un admin se aplica instantáneamente a todos los jugadores conectados.

Yes. QuickHud uses a single global state. Any change made by an admin is instantly applied to all connected players.

¿El estado del HUD se guarda al reiniciar el servidor?

Is the HUD state saved on server restart?

Sí. El plugin guarda el estado en plugins/QuickHudPL/state.json automáticamente y lo restaura al iniciar.

Yes. The plugin automatically saves state to plugins/QuickHudPL/state.json and restores it on startup.

¿Los jugadores necesitan instalar algo?

Do players need to install anything?

Sí. Cada jugador debe tener el mod QuickHud instalado en su cliente (Fabric o Forge). Sin él, el HUD no se renderizará aunque el plugin esté activo en el servidor.

Yes. Each player must have the QuickHud mod installed on their client (Fabric or Forge). Without it, the HUD won't render even if the plugin is active on the server.

¿El temporizador se pausa al reiniciar?

Does the timer pause on restart?

Sí. Al recargar, el temporizador se restaura en estado pausado con los segundos restantes. Usa /hud timer resume para retomarlo.

Yes. On reload, the timer is restored in paused state with remaining seconds. Use /hud timer resume to continue it.

⭐ CréditosCredits

✨ Creador & Desarrollador

✨ Creator & Developer

Sunny @SunnyAim_

Creador de QuickHud. Diseño, desarrollo, mantenimiento y todo lo demás.

Creator of QuickHud. Design, development, maintenance and everything else.

𝕏 @SunnyAim_

📄

Esta es la wiki oficial de QuickHud v1.0. This is the official wiki for QuickHud v1.0.