SkyBlock Companion

A modular, client-side toolkit for Hypixel SkyBlock. Plan complex Bazaar flips, work toward attribute goals, optimize shard fusions, track Crystal Nucleus runs, and build your own HUD and scoreboard—without handing control of your character to a mod.

Features

Bazaar Trade Planner

Find profitable routes through crafting, combining, and Forge recipes, not just one-step flips.

• Compare multiple acquisition routes, including buying intermediate materials.
• Inspect item-by-item crafting trees, required coins, estimated taxes, ROI, and break-even prices.
• Set a budget, batch size, maximum operation count, and allowed methods, for example, crafting and combining only, at most 23 operations.
• Use available Bazaar order summaries to estimate instant-trade slippage; see warnings when depth or liquidity data is incomplete.
• Pin a specific route, or keep a legacy pin following the lowest-cost route.
• Configure book-combining chains manually; supported rules can also come from a release-generated catalog or external transformation data.

Trading estimates are not guarantees. Order books move, limit orders may not fill, Forge availability varies, and some costs or requirements cannot be verified automatically.

Shards & Attribute Goals

Turn shard progress into a plan you can actually follow.

• Browse shard relationships and inspect possible fusion trees.
• Evaluate shard fusion opportunities against current market prices.
• Plan up to 16 Attribute Goals together, accounting for owned shards, reserved copies, Bazaar purchases, gameplay acquisition, and fusion steps.
• Optimize for coins, time, number of fusions, or a configurable balance.
• Track a chosen plan and advance fusion progress from verified integration events after you perform the actions.

Custom HUD & Scoreboard

Build interfaces for the information you care about.

• Compose HUD panels with text, items, images, progress bars, rectangles, dividers, layout containers, conditions, and repeats.
• Use a sandboxed expression language with arithmetic, logic, formatting functions, conditional text, and live values from supported game/mod integrations.
• Create persistent custom values through /placeholder commands.
• Design a context-aware custom scoreboard using the same expression system.
• Arrange movable overlays in one HUD layout editor.

Crystal Nucleus Assistant

Track crystals, run progress, locations, and historical runs in the Crystal Hollows. Includes a Metal Detector helper, King's Scent and Temple state tools, route guidance, and optional economic advice based on available data.

Waypoints, Soul Helper & Entity Highlighter

• Waypoints: Create and manage world-space navigation markers with area/server/session scopes, names, distance labels, and styling.
• Soul Helper: Highlight and label suspected souls using nearby entity and death observations, with configurable confidence and visibility behavior.
• Entity Highlighter: Filter entity highlights by name or type, with distance and visibility controls.

Getting started

1. Install the matching Minecraft 26.2 Fabric version and the required dependencies below.
2. Install SkyBlock Companion in your client's mods folder.
3. Open Mod Menu → SkyBlock Companion to enable features and configure their settings.
4. Try /bazaarflipper, /shardtools trees, /progression plan, /nucleus status, or /sbc wp.
5. For advanced HUD customization, open the Custom HUD builder from the mod configuration.

Requirements: Java 25+, Fabric Loader, Fabric API, Hypixel Mod API, Skyblocker, SkyHanni, Dandelion, and YetAnotherConfigLib (YACL). Mod Menu is supported and recommended for access to the configuration UI. Check the release's dependency list for compatible builds.

Integration baselines used by this project include Skyblocker 6.10.4+26.2 and SkyHanni 7.57.0-mc26.2. Different releases may not be compatible.

Important notes

No gameplay automation. SkyBlock Companion does not click inventories, buy or sell items, perform fusions, move the player, or send gameplay-action inputs. Planners and trackers only provide guidance and observe completed actions.

Compatibility warning. Some Skyblocker and SkyHanni integrations use internal APIs. Updating those mods can break SkyBlock Companion even when their public APIs remain compatible. Please report integration-related problems to SkyBlock Companion, not those upstream projects, unless the issue reproduces without this mod.

Privacy and networking. Market-data features can request public Hypixel Bazaar data; the optional developer enchantment-catalog generator is not run by the client. This mod should not be treated as a source of guaranteed financial or gameplay outcomes.

Documentation & support

• Full documentation: Not yet published, working on it :< — installation, feature guides, HUD scripting, function and variable references, examples, and troubleshooting.
• License: CC BY 4.0

Unofficial community project. Not affiliated with or endorsed by Hypixel, Skyblocker, or SkyHanni.