SkyBlock Companion

SkyBlock Companion is a client-side Fabric utility mod for Hypixel SkyBlock focused on progression, information, and quality-of-life features. It helps you plan upgrades, locate structures, analyze shard fusions, customize your HUD, and surface useful game information---all without automating gameplay.

Features

Attribute Progression Planner

Plan long-term attribute progression using your real inventory, Hunting Box, Bazaar prices, and live SkyHanni progression.

Features include:

• Multi-target planning for up to 16 attributes
• Shared inventory and fusion optimization
• Coin budget and acquisition planning
• Protected shards
• Manual inventory corrections
• Custom acquisition-rate overrides
• Persistent fusion execution queue
• Queue recovery after reconnects
• Automatic queue advancement from verified SkyHanni fusion events
• Manual recovery, confirmation, rewind, skip, and recalculation tools
• Planner status, prerequisites, missing materials, and progress tracking
• Planner and queue data exposed through custom HUD placeholders

The planner never performs gameplay actions. All purchases, inventory management, and fusions remain manual.

---

Shard Optimizer

Analyze your shard inventory and discover the most profitable fusion paths.

• Reads inventory and Hunting Box shards
• Uses live Bazaar prices
• Supports Instant Sell and Sell Offer pricing
• Multi-step profit optimization
• Compares fusion profit against selling shards directly
• Step-by-step fusion guidance
• Live Fusion Box validation
• Owned shard advisor
• Bazaar crafting flip analysis
• Persistent movable overlay panels

---

Dragon's Lair Finder

Locate the rare Crystal Hollows Dragon's Lair using positional dragon sounds.

• Records directional samples from dragon growls and wing flaps
• Requires movement between samples for better accuracy
• Triangulates the estimated location
• Displays direction, distance, confidence, and search progress
• Optional coordinate display
• Automatic sample expiration and world reset

Commands:

/dragonlair
/dragonlair status
/dragonlair reset
/dragonlair toggle

---

Soul Helper

Identify recently spawned souls and determine which mob created them.

• Matches souls with recently killed mobs
• Displays likely mob names and levels
• Intelligent matching using timing, distance, and entity information
• Readable labels for clustered souls
• Configurable label lifetime
• Reveal hidden labels while aiming at a soul

---

Crystal Nucleus Helper

Utilities for Crystal Nucleus exploration and waypoint management.

• Crystal Nucleus commands
• Waypoint parsing
• Navigation assistance

---

Custom HUD

Build completely customizable HUD layouts using live SkyBlock Companion data.

• Freely position HUD elements
• Expression-based templates
• Large placeholder library
• Live preview editor
• Progression, queue, shard, and attribute placeholders
• Persistent layouts

Example placeholders:

${progression.attributes.fishingSpeed.level}
${progression.attributes.fishingSpeed.remainingToNext}
${progression.plan.targetSummary}
${progression.queue.statusName}
${progression.queue.instruction}

Commands:

/placeholders

---

Custom Scoreboard

Replace or extend Minecraft's scoreboard with fully customizable templates.

• Custom formatting
• Dynamic placeholders
• Expression support
• Live preview editor

---

Entity Highlighter

Create configurable highlighting rules for entities to make important mobs easier to spot.

• Custom filters
• Configurable highlighting
• Per-rule customization

---

Performance

SkyBlock Companion is designed to stay responsive while performing complex calculations.

• Heavy planner calculations run off the render thread
• Fusion analysis is asynchronous
• Bazaar and progression data are cached
• Configuration writes are asynchronous
• Immutable snapshots prevent inconsistent UI state

---

No Gameplay Automation

SkyBlock Companion provides information and guidance only.

It does not:

• Click menus
• Move items
• Buy or sell items
• Perform fusions
• Send gameplay packets
• Simulate keyboard or mouse input
• Control player movement or combat

Every gameplay action is performed by the player.

---

Requirements

• Minecraft 26.1.2

• Fabric Loader

• Fabric API

• Skyblocker

• SkyHanni

• Dandelion (MoulConfig backend)

• YetAnotherConfigLib (optional alternate configuration backend)

• Mod Menu

• My testing environment is the Skyblock Enhanced modpack by Kd_Gaming1. Every time that pack gets an update I will update skyblocker and skyhanni API-S if something changes.

Tested Versions

• Skyblocker 6.7.0-beta.1+26.1.2
• SkyHanni 7.34.0

Other versions may work but are not officially supported.

---

Compatibility

SkyBlock Companion integrates with internal APIs from both Skyblocker and SkyHanni. Because these APIs are not public or stable, updates to either mod may break compatibility.

If a problem only occurs when SkyBlock Companion is installed, please report it here rather than to the Skyblocker or SkyHanni teams.

---

Disclaimer

SkyBlock Companion is an unofficial community project and is not affiliated with or endorsed by Hypixel, Skyblocker, or SkyHanni.