HispanoUtils

HispanoUtils is a client-side Fabric mod built for Paper servers: it receives data from the server and renders fullscreen transitions, animations (including GIFs), and an optional team HUD. The server pushes events via plugin channels; heavy visuals run on the client without adding gameplay load on the vanilla server world logic.

---

✨ What you can do

• Fullscreen transitions: cubes, fades, slides, zoom, diagonal sweep, and more — with customizable colors and timings.
• Server-driven animations: the companion plugin can trigger animations for one player or everyone at once.
• Team HUD (/hteams): shows team information on the client when the server requests it (PvP events, minigames, etc.).
• Maps and events: great for intros, zone changes, win/lose moments, or guided visuals on themed servers.

(The Paper plugin also adds chest refill commands and loot table management — that is pure server-side logic and does not require this mod on the client.)

---

🔄 How it works

The HispanoUtils Paper plugin sends custom payloads to clients (plugin messaging). The Fabric mod parses them and draws the UI: screen-covering transitions, animations, and team HUD updates. World gameplay (inventory, blocks, entities) stays vanilla on the server; what you see as “cinematic” is a visual layer on the client.

---

⚙️ Requirements

• Minecraft: 1.21.11 (adjust the badge if you ship another version line).
• Fabric Loader and Fabric API matching your game version.
• Client mod: HispanoUtils (this project).
• Recommended for the full experience: the HispanoUtils Paper plugin on your server — commands /transition, /animation, /hteams, etc.

Without the plugin, the mod has nothing to consume for typical map/event setups — install both if you control the server.

---

🔧 For developers (Paper)

Other plugins can integrate through the public server API:

import com.dysthy.hispanoutils.plugin.api.HispanoUtilsAPI;

HispanoUtilsAPI api = HispanoUtilsAPI.getInstance();
if (api != null && api.isAvailable()) {
    api.sendTransition(player, "cube", "in=40 hold=10 out=30 color=#FF0000");
}

Server commands: /transition, /transitionall, /animation, /animationall, /hteams.

---

MIT License