Skip to content

Repository files navigation

SR-Addons

Unified client-side Fabric mod for Hypixel SkyBlock — combines PartyCommands, StarredMobHighlighter, CarryModule, visual tweaks, and in-game alerts into a single addon.

Minecraft Java Kotlin Gradle Fabric Loom License Version


Installation

  1. Install Java 25 (LTS).
  2. Install Fabric Loader >= 0.19.0 for Minecraft 26.2
  3. Install Fabric API
  4. Install Fabric Language Kotlin >= 1.14.0
  5. Install YACL >= 3.9.0
  6. (Optional) Install ModMenu to open config directly from the Mods screen
  7. Download SR-Addons-1.7.5.jar and place it in .minecraft/mods/

Features

Modules

StarredMobHighlighter

  • Wireframe / fill highlight for mobs with ✯ star symbol in name
  • Configurable color (RGBA), render mode, line width, max distance

PartyCommands

  • Type commands in chat with ! prefix — no /pc needed
  • 40+ individually toggleable commands
  • Ping, TPS, FPS, time, location, coords, holding, status info
  • Full party management (warp, allinvite, transfer, promote, demote, kick, kickoffline, kickall, disband, invite, leave)
  • Dungeon & Kuudra queue (!f1–!f7, !m1–!m7, !t1–!t5) with optional countdown
  • Fun commands (coinflip, 8ball, dice, boop, random)
  • Countdown timer with sound, note message, auto !mod reply
  • Configurable response routing (party chat / local), separator line removal
  • Configurable Send Interval — commands and their party-chat replies are queued so they never reach Hypixel in the same tick (which used to make one of them silently fail)
  • Party-chat replies are sent as clean text: §/& color codes and hex codes are stripped
  • Auto party list updater with member online/offline tracking

CarryModule

  • Full carry order management via /cm commands
  • Carry types with configurable unit & bulk pricing
  • Client tracking with completed / remaining counts
  • Client Highlight — green bounding box around client players
  • Boss Highlight — red bounding box around bosses spawned by clients (detects "Spawned by:" name tags)
  • Miniboss Highlight — orange bounding box for configurable Slayer miniboss names near clients (19 defaults, add/remove via commands)
  • Boss Spawn Notification — subtitle alert when a client's boss spawns (toggleable, custom text)
  • Earnings history, refund calculator, undo support
  • Auto price calculation (no player name needed when only 1 client)

Visual Tweaks

  • Hide Armor Bar — hide vanilla armor bar above the hotbar
  • Hide Hunger Bar — hide vanilla food/hunger bar above the hotbar
  • Hide Entity Fire — hide fire animation on burning entities
  • Fullbright — maximum global brightness, ignoring ambient light
  • Better FOV — disable Speed/Aiming/Submerged FOV changes, keeping sprint FOV untouched
  • Pin Tooltip — pin item tooltips on screen for comparison (left-drag to move, right-click to close, scroll to navigate, Ctrl+scroll to resize)

Text & Tools

  • Replace Texts — replace text patterns in all rendered text, with Developer's Name highlight
  • Calculator — /calc <expression> or /sra calc <expression> with K/M/B suffix support and TAB completion

Alerts & Notifications

  • Ragnarock Notifier — subtitle alerts when casting Ragnarock or when cancelled
  • Ping Alert — subtitle warning when ping stays above threshold
  • TPS Alert — subtitle warning when TPS drops below threshold
  • Chat Keywords Alert — subtitle notification when configurable keywords appear in chat, with per-keyword cooldown and prefix/suffix ignore flags

All modules support i18n (English / 简体中文).


Commands

/sra — ModManagement
Command Description
/sra Show help
/sra reload Reload configuration
/sra config / /sra gui Open config GUI
/sra version Show version info
/sra update Check for updates
/sra calc <expr> Evaluate a math expression (alias: /calc)
/sra replaceTexts add "<word>" "<replacement>" Add a text replacement
/sra replaceTexts remove "<word>" Remove a text replacement
/sra replaceTexts list List custom replacements
/sra alert add "<keyword>" "<subtitle>" [cooldown] Add a chat keyword alert
/sra alert remove "<keyword>" Remove a chat keyword alert
/sra alert list List all chat keyword alerts
/sra alert clear Remove all chat keyword alerts
/cm — CarryModule

Setup

Command Description
/cm add-type <type> Add a carry type
/cm add-client <player> <type> <n> Add a client with carry count
/cm set-price <type> <price> Set unit price (e.g. 1.8M, 500K)
/cm set-bulk-price <type> <price> <n> Set bulk price for n+ carries

Management

Command Description
/cm add-amount <player> <n> Increase carry count
/cm set-amount <player> <n> [true|false] Set carry count & bulk toggle
/cm remove-amount <player> <n> Decrease carry count
/cm remove-client <player> Remove a client
/cm remove-type <type> Remove a carry type

Info

Command Description
/cm calc-price [player] Calculate total price (auto if 1 client)
/cm list-client Show all clients
/cm list-type Show all carry types
/cm status Show total earnings

Complete

Command Description
/cm done [player] [n] Record completed carries (defaults to 1)
/cm refund <player> Calculate refund
/cm undo Undo last change

Utility

Command Description
/cm clear-client Remove all clients
/cm clear-history Reset earnings history
/cm add-miniboss "<name>" Add a miniboss name for highlighting
/cm remove-miniboss "<name>" Remove a miniboss name (TAB autocomplete)
!command — PartyCommands

Info

Command Description
!help Show available commands
!ping Show latency
!tps Show server TPS
!fps Show FPS
!time Show current time
!location / !loc Show location
!coords / !co Show coordinates
!holding / !hold Show held item
!status Show party member list
Party Management (leader only)
Command Description
!warp / !w Warp members to your hub
!allinvite / !allinv Enable all invite
!transfer <player> / !pt Transfer party leader
!promote <player> Promote member
!demote <player> Demote member
!kick <player> [reason] / !k Kick a member
!kickoffline Kick all offline members
!kickall [players...] Kick all except specified
!disband Disband the party
!invite <player> / !inv Invite player to party
!leave Leave the party

Dungeon Queue

Command Description
!f1–!f7 Queue Catacombs floor
!m1–!m7 Queue Master Mode floor
!t1–!t5 Queue Kuudra tier

Add a countdown: !f7 30 — enters in 30 seconds.

Fun

Command Description
!fun cf Coin flip (heads/tails)
!fun 8ball Magic 8-ball
!fun dice Roll a dice
!fun boop <player> Boop a player
!fun random [min] [max] Random number

Utility

Command Description
!forward Toggle party chat forwarding
!reload Reload configuration
!cd <time> Start countdown (60, 5m, 1h, 5m30s, max 12h)
!clear Clear current countdown
!note [message] Save/send note to party
Key Bindings
Key Action
` (Grave) Open chat with ! prefix
Unbound Open config GUI
Unbound Toggle PartyCommands on/off
Unbound Pin Tooltip

Configuration

Configurations

All settings managed through the YACL config GUI (/sra gui or via ModMenu) with 5 tabs:

Tab Settings
General Display (own nametag, separator, update check), Visual Tweaks (armor, hunger, entity fire, fullbright, better FOV), Text (replace texts, dev name highlight), Quick Tools (/calc command, pin tooltip)
PartyCommands Prefix, 40+ individual command toggles, response routing, send interval, auto !mod reply, note, countdown sound
StarredMob Enabled, highlight color (RGBA), render mode, line width, max distance
Carry Master toggle, highlight profiles (client/boss/miniboss colors), boss notification, render settings
Alerts Ragnarock Notifier, Ping Alert, TPS Alert, Chat Keywords Alert

Config file: .minecraft/config/sraddons.json

Old configs from EntityFire, PartyCommands, and StarredMobHighlighter are auto-migrated on first launch.


Building from Source

./gradlew clean build

The build also runs ktlint and the unit tests, and the Kotlin compiler is configured with allWarningsAsErrors, so a warning fails the build. Use ./gradlew ktlintFormat to fix style issues.

Requirements: JDK 25
Output: build/libs/SR-Addons-1.7.5.jar


License

This project is licensed under MIT License.

About

Unified mod for Minecraft 26.2

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages