Skip to content

iqaddons/IQ

Repository files navigation

IQ Logo
IQ Addons

A Hypixel SkyBlock mod made especially for Kuudra
Clean, minimal, and focused on what matters

Discord GitHub Downloads Made with Java Fabric License


🎯 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

🤝 Contributing

Contributions are welcome! If you'd like to contribute:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feat/amazing-feature)
  3. Commit your changes (git commit -m 'feat(amazing) add amazing feature')
  4. Push to the branch (git push origin feat/amazing-feature)
  5. Open a Pull Request

📜 License

This project is licensed under the MIT License — see the LICENSE file for details.


👥 Credits

PeHenrii
Lead Developer
DarkJota
Mind behind the features

Made with ❤️ for the Kuudra community
⭐ Star us on GitHub if you find this useful!

About

IQ is a Hypixel SkyBlock mod made especially for Kuudra.

Resources

License

Stars

Watchers

Forks

Contributors

Languages