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
• 💡 Feature Requests: Join our Discord
• 💬 General Help: Ask in our Discord server

---

👥 Credits

PeHenrii Lead Developer

DarkJota Mind behind the features

---