IQ Addons

## 🎯 What is IQ? **IQ** is a lightweight Fabric mod designed to enhance your Kuudra experience on Hypixel SkyBlock. While it includes some general features, the core focus is on providing **useful, non-intrusive QoL improvements** for every phase of Kuudra runs. From the very beginning, our goal has been to keep IQ **clean and minimal** — offering only useful features with no unnecessary clutter. --- ## ✨ Features ### Phase 1 — Supplies

🎯 Pearl Waypoints

Shows precise waypoints for pearl throws based on your position. Includes stand block indicators and timing labels. - Automatically detects your current area - Shows optimal pearl landing spots - Displays recommended throw timing - Fully customizable via JSON config

📦 Supply Waypoints

Draws beacon beams at supply crate locations carried by giants. - Real-time tracking of supply carriers - Customizable waypoint colors - Automatic updates as giants move

🏔️ Pile Waypoints

Displays beacons at all crate pile locations. - Highlights remaining piles - Different color for "no pre" piles - Automatically hides completed piles

⏱️ Supply Timers

Tracks and displays supply pickup times for all players. - Shows player name and pickup time - Color-coded based on speed - Clean HUD overlay

🔔 Supply Alerts

Multiple alert systems to keep you informed: - **No Pre Alert** — Automatically announces missing pre supplies to party chat - **Already Picking Alert** — Shows title when someone else is picking your supply - **Second Supply Alert** — Announces second supply position (Shop/X Cannon/Square) - **Supply Recover Message** — Sends your custom chat message when you recover a supply - **Supply Giant Hitbox Alert** — Highlights and alerts when you recover inside giant hitbox

📈 Supply Progress Widget

Replaces the default supply title with a clean, movable widget. - Live 0/6 progress updates - Better visibility than vanilla title spam - Fully HUD-editable position

--- ### Phase 2 — Build

🏗️ Build Progress Overlay

Displays a comprehensive build progress HUD. - Current build percentage - Fresh count tracker - ETA estimation - Color-coded progress bar

🔥 Fresh Alerts & Timers

Complete fresh tracking system: - **Fresh Message** — Sends party message when you fresh (with build %) - **Fresh Timers** — Renders countdown above fresher's heads - **Fresh Countdown** — Personal HUD countdown for your fresh - **Fresh Highlight** — Glowing effect on players who are fresh

👷 Build Helper Waypoints

Shows beacon beams at build piles with progress-based colors. - Red → Orange → Yellow → Green color progression - Displays pile progress percentage - Helps prioritize which piles need attention

👤 Elle Highlight

Draws a visible hitbox around Elle during the build phase for easy tracking.

🔊 Ballista Build Sound Replace

Replaces the default Ballista build sound during Phase 2 with IQ custom audio.

--- ### Phase 3 — Stun

💚 Kuudra HP Bossbar

Custom health display for Kuudra. - Shows current HP and percentage - Color-coded health bar - Damage calculator during boss phase

📍 Stun Waypoints

Displays waypoints at optimal stun positions.

🎯 Kuudra Hitbox

Renders Kuudra's hitbox with a glowing outline for easier targeting. - Customizable color - Works through walls

🚫 Block Useless Perks

Prevents accidentally purchasing useless perks from the perk menu. - Blocks: Steady Hands, Bomberman, Auto Revive, Human Cannonball, Elle's Lava Rod, Elle's Pickaxe

--- ### Phase 4 — Boss Fight

🧭 Kuudra Direction Alert

Shows which direction Kuudra will spawn from. - Color-coded direction indicator - Large on-screen title alert

⚔️ Rend Damage Tracker

Tracks when teammates deal Rend damage to Kuudra. - Shows damage amount - Displays timing since boss start - Color-coded damage tiers

⚠️ Danger Zone Alert

Alerts when you're standing on tentacle danger zones. - **JUMP!** alert on yellow/orange/red terracotta - Audio notification

🦴 Backbone Alert

Tracks Bonemerang backbone timing with on-screen progress and Rend sync alert.

🙈 Hide Kuudra Damage Title

Hides the vanilla Kuudra damage title (e.g. ☠ 240M/240M❤) for a cleaner boss screen.

--- ### General Features

📊 Custom Splits

Comprehensive run timing display. - Individual phase times with color grading - Overall run time - Pace estimation - Customizable thresholds

👥 Team Highlight

Highlights your teammates with a glowing effect during runs. - Distinguishes real players from NPCs - Customizable highlight color

💜 Mana Drain Notify

Announces Extreme Focus mana usage to party chat with affected player count.

🔔 Party Join Sound

Plays a notification sound when someone joins your party.

🔇 Hide Mob Nametags

Prevents Kuudra mob nametags from rendering, reducing visual clutter.

🏆 Personal Best Tracker

Tracks your best Kuudra run time and notifies you when you beat your PB.

💰 Kuudra Profit Tracker

Calculates profit/loss per run with configurable pricing logic. - Bazaar and Auction-aware pricing - Includes keys, essence, books, armor and pet bonus adjustments - Hourly rate and session tracking

🧰 Chest Utilities

Utility set for chest-focused runs. - **Chest Value Display** — Shows chest value when opening reward chests - **Chest Counter Tracker** — Tracks progress toward the 60 chest cap - **Chest Counter Party Reminders** — Optional milestone/cap announcements in party chat - **Croesus Helper** — Highlights already opened chests in Croesus/Vesuvius menus

🔁 Auto Requeue

Automatically queues the next Kuudra run after boss completion with configurable delay.

📣 Kuudra Notifications

Centralized event notifications for key run moments. - Build started / build done - Supplies done - Ichor used - Cannonball purchased - No pre reminder - SOS (pre-stun) reminder - Phase change alerts - Optional notification sound

🪄 Ability Announce

Announces selected ability casts in party chat. - Spirit Spark - Hollowed Rush - Raging Wind - Ichor Pool - Mana Drain

🎮 Party Commands

Supports chat-based party commands triggered by `!` messages. - Warp / transfer / promote / kick shortcuts - Quick joininstance commands (`!t1` to `!t5`) - Ping and TPS replies - Share runs, chest progress, and profit stats in party chat

👔 Wardrobe Keybinds

Lets you swap Wardrobe sets instantly using configurable keybinds with optional sound feedback.

🚨 Limbo Alert

Detects SkyBlock limbo kicks and alerts your party automatically.

🧹 Extra Visual Cleanup

Additional clutter-reduction options for cleaner gameplay. - Hide Kuudra vanilla boss bar - Hide selected useless armor stands

--- ## Pearl Waypoints Customization Advanced users can edit `pearl_waypoints.json` to customize pearl throw locations. The mod will automatically reload changes. --- ## 💬 Support Need help or have suggestions? - 🐛 **Bug Reports:** Open an [issue on GitHub](https://github.com/pehenrii/IQ/issues) - 💡 **Feature Requests:** Join our [Discord](https://discord.gg/HdhXhCWcW9) - 💬 **General Help:** Ask in our Discord server --- ## 👥 Credits

PeHenrii Lead Developer

DarkJota Mind behind the features

---