/sbutils

A utility mod for Skyblock.net.

Primary LanguageJavaGNU General Public License v3.0GPL-3.0

sbutils

This is my personal utility mod for Skyblock.net. It contains all the features of the original Skyblock mod, with some tweaks, plus some features of my own creation.

While the feature set may be similar, this mod shares no code with the original Skyblock mod. Everything is written from scratch. This means that some things may behave differently than you are used to.

I am always looking for ways to improve the mod. If you have any feature requests or would like to report a bug, please make a GitHub issue.

Features

Feature Description Settings
Anti Place Prevents accidental placement of heads/grass. Prevent Head Placement - Prevents the placement of heads that have custom names.
Prevent Grass Placement - Prevents the placement of grass blocks.
Auto Advert Automatically sends messages from a specified file. Skyblock Advert File - The txt file containing your /skyblock advertisements.
Economy Advert File - The txt file containing your /economy advertisements.
Classic Advert File - The txt file containing your /classic advertisements.
Advert Delay - The delay between messages. (Seconds)
Advert Initial Delay - The delay between joining and sending an advert. (Seconds)
Use Advert Whitelist - Only sends adverts from the accounts specified in the whitelist.
Advert Whitelist - A list of accounts that may send adverts if 'Use Advert Whitelist' is enabled.
Auto Command Repeatedly executes a command with a set delay. Command Delay - The minimum delay between commands if there are multiple in the list.
Commands - The commands to execute.
Auto Crate Opens crate keys automatically.

To use:
1. Ensure your inventory contains the appropriate crate key
2. Enable Auto Crate when within range of the crate
Crate Mode - The type of crate to target (Voter, Common, Rare, Epic, or Legendary)
Crate Delay - After the current crate finishes, how long to wait before opening the next.
Crate Distance - The maximum distance from the crate.
Inventory Cleaner - Cleans your inventory if it becomes full.
Items to Clean - A list of items to clean from your inventory.
Auto Fix Automatically fixes the most damaged items in your inventory over time. Fix Mode - Which fix command to use (Hand or All)
Max Fix Percent - The maximum durability percentage an item can have and be fixed.
Fix Delay - The delay between fixes. (Seconds)
Fix Retry Delay - How long to wait for a response before sending the fix command again. (Seconds)
Max Fix Retries - The maximum amount of times to retry the fix command if the server isn't responding.
Auto Kit Claims your kits automatically. 24-hour kits are claimed every day at 12:00 AM UTC. Other kits are claimed based on their last claim time.

The first time it is enabled on your account, it will try claiming each kit you have added in the kit list. For ones that have already been claimed, it will predict the reset time and store the data to a file.
Kit Command Delay - If multiple kits are to be claimed at the same time, the delay between each command.
Kit Claim Delay - The amount of additional delay after the predicted kit reset time, to account for inaccuracies. Only applies to non 24-hour kits.
System Delay - Delay used to account for system time desync when claiming 24-hour kits. Changing this is not recommended.
Skyblock Kits - The kits to claim automatically while on /skyblock.
Economy Kits - The kits to claim automatically while on /economy.
Classic Kits - The kits to claim automatically while on /classic.
Auto Mine Automatically mines for you. Auto Switch - Automatically switches to a new pickaxe when the current durability gets too low.
Switch Durability - The durability to switch to a new pickaxe at.
Auto Private Automatically writes private signs. Auto Private Names - Up to two names to put on private signs. Yours is included automatically.
Auto Raffle Automatically buys raffle tickets when you log in and when the raffle ends. Skyblock Raffle Tickets - The amount of raffle tickets to purchase on /skyblock. (Max. 2)
Economy Raffle Tickets - The amount of raffle tickets to purchase on /economy. (Max. 5)
Auto Reply Automatically replies to private messages. Auto Response - The response to send to private messages.
Reply Delay - The delay between responses if multiple people message you at once. (Seconds)
Auto Silk Automatically enchants books and tools with Silk Touch.

To use:
1. Ensure your inventory contains the configured tool, books, and at least 3 lapis
2. Enable Auto Silk
3. Open an enchanting table
Target Tool - The tool that Auto Silk will target.
Book Priority - Prioritizes books when enchanting.
Books Only - Only uses books for enchanting.
Book Cleaner - Cleans books without Silk Touch from your inventory when it becomes full.
Auto Silk Delay - The delay between each enchanting action.
Show Button - Adds a button to the enchantment screen for toggling Auto Silk.
Button Position - The position of the Auto Silk button.
Centered Command Tells you if the current island is suitable for map art creation, the expansion required, and how many extra blocks you will have in each direction. N/A
Chat Append Adds a prefix and/or suffix to the messages you send. Add Prefix - Adds the specified prefix to all the messages you send.
Chat Prefix - The prefix to add to your messages.
Add Suffix - Adds the specified suffix to all the messages you send.
Chat Suffix - The suffix to add to your messages.
Chat Filters Filters certain messages from chat. Filter Tips - Whether tip messages should be filtered from chat.
Filter Advancements - Whether advancement messages should be filtered from chat.
Filter Welcome Messages - Whether player welcome messages should be filtered from chat.
Filter Friend Joins - Whether friend join messages should be filtered from chat.
Filter Island MOTDs - Whether island MOTD messages should be filtered from chat.
Filter Votes - Whether player vote messages should be filtered from chat.
Filter Vote Rewards - Whether player vote reward messages should be filtered from chat.
Filter Raffle Messages - Whether raffle messages should be filtered from chat.
Filter Crate Messages - Whether crate opening messages should be filtered from chat.
Filter ClearLag Messages - Whether ClearLag messages should be filtered from chat.
Filter Perished In Void Messages - Whether 'perished in void' messages should be filtered from chat.
Filter SkyChats - Whether SkyChat messages should be filtered from chat."

Custom Filters - A list of custom regex filters to apply to chat.
Chat Logger Logs transactions, private messages, and visits to .minecraft/sbutils/chatlogger. Log Incoming Transactions - Whether to log transaction messages from your shops.
Log Outgoing Transactions - Whether to log transaction messages from other players' shops.
Log Incoming Messages - Whether to log incoming private messages.
Log Outgoing Messages - Whether to log outgoing private messages.
Log Visits - Whether to log players visiting your island.
Log Drop Party Messages - Whether to log messages from drop party events.
Convert Command Converts a quantity into double chests, stacks, and remainder. Supports units like 's' for stacks, 'sc' for single chests, and 'dc' for double chests. Also supports almost all mathematical operations. N/A
Death Coords Command Tells you the dimension and coordinates of your last death. N/A
Enchant All Enchants either your held item, or all items in your inventory. Can also be used to unenchant. Enchant Mode - Whether to use the built in /enchantall command, or send enchants individually.
TPS Sync - Attempts to sync delays to server TPS to avoid spam kicks during lag spikes.
Enchant Delay - The delay between sending enchant commands. (Seconds)
Cooldown Frequency - The number of commands to be executed before a cooldown is initiated. (To avoid spam kick)
Cooldown Time - The length of the cooldown. (Seconds)
Exclude Frost - Excludes Frost Walker from /enchantall.
Inv Cleaner Automatically moves configured items into /disposal when triggered. Click Delay - The delay between clicks when moving items into the disposal. (Seconds)
Items to Clean - A list of items to clean from your inventory.
Join Commands Automatically sends commands when you join the server. Initial Delay - The delay between joining the server and sending the commands. (Seconds)
Delay - The delay between each command. (Seconds)
Join Command List - A list of commands to execute upon joining. The accounts field allows you to specify a comma-separated list of accounts that should execute the command. If it's left blank, the command will be executed by all accounts.
Map Saver Saves maps to a png file located in ./minecraft/sbutils/mapsaver. To use, hold a map or look at one in a frame, and execute /savemap.
Mentions Notifies you with a sound when something is mentioned in chat. Play Mention Sound - Notifies you with a sound when something is mentioned in chat.
Mention Sound - The sound played when something is mentioned in chat.
Mention Highlighting - Whether to change the color of mentions in chat.
Highlight Color - The color to highlight mentions with.
Exclude Server Messages - Doesn't notify you about server messages.
Exclude Self Messages - Doesn't notify you about your own messages.
Exclude Sender - Ignores the sender (the prefix/name of the player) when checking for mentions.
Current Account Mentions - Notifies you when your username is mentioned in chat.
Aliases - A list of strings you would like to be notified for.
No GMT Replaces GMT date/time in /mail and /email with a preferred timezone. Time Zone - Set a preferred time zone, or leave blank to use system time.
Show Time Zone - Displays the new time zone in parenthesis next to the date/time.
Notifier Notifies you of various things. Show VP Llama Title - Shows a title when a vote party llama appears at spawn.
Play VP Llama Sound - Plays a sound when a vote party llama appears at spawn.
VP Llama Sound - The sound played when a vote party llama appears at spawn.
Show Trader Title - Shows a title when a wandering trader appears at spawn.
Show Trader Items - Displays the items offered by the wandering trader when it appears.
Show Items on Click - Shows wandering trader items when the alert message is clicked.
Play Trader Sound - Plays a sound when a wandering trader appears at spawn.
Trader Sound - The sound played when a wandering trader appears at spawn.
Play Shop Sound - Plays a sound when one of your shops has a transaction in chat.
Shop Sound - The sound played when one of your shops has a transaction in chat.
Play Visit Sound - Plays a sound when players visit your island.
Visit Sound - The sound played when players visit your island.
Staff Detector Detects when staff join/leave. Detect Staff Join - Whether you should receive notifications when staff members join.
Detect Staff Leave - Whether you should receive notifications when staff members leave.
Play Staff Sound - Whether to play sounds when staff members join/leave.
Staff Sound - The sound played when staff join/leave.
Tool Saver Prevents usage of tools after a certain durability. Tool Durability - The durability to stop at.

Keybinds

Keybind Description Default
Open Config GUI Opens the config GUI. Backslash
/is Executes /is. Unbound
/ehome Executes /ehome. Unbound
/jump Executes /jump. Unbound
/back Executes /back. Unbound
/wb Executes /wb. Unbound
/ec Executes /ec. Unbound
/trash Executes /trash. Unbound

Commands

Command Aliases Usage
/antiplace /noplace /noplace <grass/heads> - Tells you if the specified Anti Place mode is enabled.
/noplace <grass/heads> <true/false> - Enables or disables an Anti Place mode.
/autoadvert /advert /advert - Toggles Auto Advert.
/advert info - If Auto Advert is enabled, tells you how long until the next ad is sent, and the ad index.
/advert <sbFile/ecoFile/classicFile> - Tells you the current advert file for the specified server.
/advert <sbFile/ecoFile/classicFile> set <filename> - Sets the advert file for the specified server.
/advert ads - Lists the ads in the current advert file, with their indexes.
/advert ads add <advert> - Adds the specified advert to the current advert file.
/advert ads del <index> - Removes the advert at the specified index from the current advert file.
/advert ads insert <index> <advert> - Inserts the advert at the specified index in the advert file.
/advert ads toggle <index> - Enables or disables the advert at the specified index.
/advert delay - Tells you what the current advert delay is.
/advert delay <seconds> - Sets the advert delay.
/advert initialDelay - Tells you what the current initial delay is.
/advert initialDelay <seconds> - Sets the initial delay.
/advert whitelist - Shows the current advert whitelist.
/advert whitelist enabled - Tells you if the advert whitelist is enabled.
/advert whitelist enabled <true/false> - Enables or disables advert whitelist.
/advert whitelist <add> <name> - Adds an account to the advert whitelist.
/advert whitelist <del> <index> - Removes an account from the advert whitelist.
/advert whitelist insert <index> <name> - Inserts an account into the advert whitelist.
/advert reset - Resets remaining delay to 0 and returns to the first ad index.
/autocmd /acmd /acmd - Toggles Auto Command.
/acmd minDelay - Tells you the current minimum command delay.
/acmd minDelay <seconds> - Sets the minimum command delay.
/acmd commands - Tells you the current Auto Command commands, and their remaining delays if applicable.
/acmd commands add <command> - Adds a command to the Auto Command list with a default delay of 1 second (disabled by default).
/acmd commands del <index> - Removes a command from the Auto Command list.
/acmd commands insert <index> <command> - Inserts a command into the Auto Command list (disabled by default).
/acmd commands toggle <index> - Enables or disables a command in the Auto Command list.
/acmd commands set <index> <command/delay> <command/seconds> - Sets the command or delay of an entry in the Auto Command list.
/autocrate /ac /ac - Toggles Auto Crate.
/ac mode - Tells you the current Auto Crate mode.
/ac mode <Voter/Common/Rare/Epic/Legendary> - Sets the Auto Crate mode setting.
/ac delay - Tells you the current Auto Crate delay.
/ac delay <seconds> - Sets the Auto Crate delay setting.
/ac range - Tells you the current Auto Crate range.
/ac range <range> - Sets the Auto Crate range setting.
/ac cleaner - Tells you if inventory cleaner is enabled.
/ac cleaner <true/false> - Enables or disables inventory cleaner.
/ac cleaner items - Tells you the items in the inventory cleaner list.
/ac cleaner items add <item> - Adds an item to the inventory cleaner list.
/ac cleaner items del <item> - Removes an item from the inventory cleaner list.
/autofix /af /af - Toggles Auto Fix.
/af info - If Auto Fix is enabled, tells you how long until the next fix.
/af reset - Resets Auto Fix.
/af mode - Tells you the current fix mode.
/af mode <hand/all> - Sets the fix mode.
/af percent - Tells you the current max fix percent.
/af percent <percent> - Sets the max fix percent.
/af delay - Tells you the current delay setting.
/af delay <seconds> - Sets the delay setting.
/af retryDelay - Tells you the current retry delay setting.
/af retryDelay <seconds> - Sets the retry delay setting.
/autokit /ak /ak - Toggles Auto Kit.
/ak info - Displays the current kit queue, and the time left for each kit.
/ak commandDelay - Tells you the current kit command delay.
/ak commandDelay <seconds> - Sets the kit command delay.
/ak claimDelay - Tells you the current kit claim delay.
/ak claimDelay <seconds> - Sets the kit claim delay.
/ak systemDelay - Tells you the current system delay setting.
/ak systemDelay <seconds> - Sets the system delay setting.
/ak sbKits - Displays the current skyblock kit list.
/ak sbKits add <kit> - Adds a kit to the skyblock kit list.
/ak sbKits del <kit> - Removes a kit from the skyblock kit list.
/ak ecoKits - Displays the current economy kit list.
/ak ecoKits add <kit> - Adds a kit to the economy kit list.
/ak ecoKits del <kit> - Removes a kit from the economy kit list.
/ak classicKits - Displays the current classic kit list.
/ak classicKits add <kit> - Adds a kit to the classic kit list.
/ak classicKits del <kit> - Removes a kit from the classic kit list.
/automine /mine /mine - Toggles Auto Mine.
/mine timer <duration> - Enables Auto Mine for a specified amount of time.
/mine timer - Tells you the time remaining in the timer.
/mine switch - Tells you if auto switch is enabled.
/mine switch <true/false> - Enables or disables auto switch.
/mine durability - Tells you the current switch durability.
/mine durability <durability> - Sets the switch durability.
/autoprivate /ap /ap - Toggles Auto Private.
/ap names - Lists the current Auto Private names.
/ap names add <name> - Adds an Auto Private name.
/ap names del <name> - Removes an Auto Private name.
/autoraffle /autoraf /autoraf - Toggles Auto Raffle.
/autoraf sbTickets - Tells you the current skyblock tickets setting.
/autoraf sbTickets <amount> - Sets the skyblock tickets setting.
/autoraf ecoTickets - Tells you the current economy tickets setting.
/autoraf ecoTickets <amount> - Sets the economy tickets setting.
/autoreply /areply /areply - Toggles Auto Reply.
/areply response - Tells you the current auto response.
/areply response set <response> - Sets your auto reponse.
/areply delay - Tells you the current reply delay.
/areply delay <seconds> - Sets the reply delay.
/autosilk /silk /silk - Toggles Auto Silk.
/silk target - Tells you the current target tool setting.
/silk target <tool> - Sets the target tool setting.
/silk cleaner - Tells you if Book Cleaner is enabled.
/silk cleaner <true/false> - Enables or disables Book Cleaner.
/silk delay - Tells you the current enchanting delay.
/silk delay <seconds> - Sets the enchanting delay.
/silk showButton - Tells you if the button is shown or not.
/silk showButton <true/false> - Shows/hides the button on the enchantment screen.
/silk buttonPos - Tells you the current button position.
/silk buttonPos <buttonPos> - Sets the Auto Silk button's position.
/centered /ctr /ctr - Tells you if the current island is suitable for map art creation, the expansion required, and how many extra blocks you will have in each direction.
/chatappend /append /append <prefix/suffix> - Tells you your chat prefix or suffix.
/append <prefix/suffix> enabled - Tells you if your chat prefix or suffix is enabled.
/append <prefix/suffix> enabled <true/false> - Enables or disables your chat prefix or suffix.
/append <prefix/suffix> set <string> - Sets your chat prefix or suffix.
/chatfilter /filter /filter - Lists all enabled and disabled filters.
/filter <filter> - Tells you if the specified filter is enabled.
/filter <filter> <true/false> - Enables or disables a filter.
/filter custom - Lists your custom regex filters.
/filter custom add <regex> - Adds a custom regex filter (disabled by default).
/filter custom del <index> - Removes a custom regex filter.
/filter custom insert <index> <regex> - Inserts a custom regex filter.
/filter custom toggle <index> - Toggles a custom regex filter.
/filter custom setRegex <index> <regex> - Updates the regex pattern of a custom filter.
/chatlogger /logger /logger - Lists all enabled and disabled loggers.
/logger <logger> - Tells you if the specified logger is enabled.
/logger <logger> <true/false> - Enables or disables a logger.
/convert /cv /cv <value> - Converts a quantity into double chests, stacks, and remainder.

Example usage:
/cv 1.7dc or /cv 54s or /cv 1728 or /cv 1.7dc + (54s - 1728) or /cv 5 * (256 / 2) or /cv sqrt(256)

For a full list of supported functions, see here.
/deathcoords /dcoords /dcoords - Tells you the dimension and coordinates of your last death.
/enchall /eall /eall - Enchants your held item with all possible enchants.
/eall inv - Enchants all items in your inventory with all possible enchants.
/eall mode - Tells you the current enchant mode.
/eall mode <mode> - Sets the enchant mode.
/eall tpsSync - Tells you if TPS Sync is enabled.
/eall tpsSync <true/false> - Enables or disables TPS Sync.
/eall delay - Tells you the current delay between enchantments.
/eall delay <seconds> - Sets the delay between enchantments.
/eall cooldownFrequency - Tells you the current cooldown frequency.
/eall cooldownFrequency <frequency> - Sets the cooldown frequency.
/eall cooldownTime - Tells you the current cooldown time.
/eall cooldownTime <seconds> - Sets the cooldown time.
/eall excludeFrost - Tells you whether exlude frost walker is enabled.
/eall excludeFrost <true/false> - Enables or disables exclude frost walker.
/invclean /ic /ic - Cleans your inventory.
/ic clickDelay - Tells you the current clickDelay setting.
/ic clickDelay <seconds> - Sets the clickDelay.
/ic items - Lists your configured items to clean.
/ic items add <item> - Adds an item to your cleaning list.
/ic items del <item> - Removes an item from your cleaning list.
/joincmds /jc /jc - Toggles Join Commands.
/jc commands - Lists your join commands.
/jc commands add <command> - Adds the specified command to your join commands.
/jc commands del <index> - Removes the command at the specified index in your join commands.
/jc commands insert <index> <command> - Inserts the command at the specified index in your join commands.
/jc commands set <index> <command/accounts> <command/accounts> - Changes the command or accounts at the specified index in your join commands.
/jc delay - Tells you the current command delay.
/jc delay <seconds> - Sets join command delay.
/jc initialDelay - Tells you the current initial delay.
/jc initialDelay <seconds> - Sets initial delay.
/savemap /smap /smap - Saves either the held map, or the one you are looking at in a frame to a png file located in .minecraft/sbutils/mapsaver.
/mentions /ment /ment - Toggles Mentions.
/ment excludeServer - Tells you if server messages are being ignored by Mentions.
/ment excludeServer <true/false> - Enables or disables server message exclusion.
/ment excludeSelf - Tells you if your own messages are being ignored by Mentions.
/ment excludeSelf <true/false> - Enables or disables self message exclusion.
/ment currentAccount - Tells you if current account mentions are enabled.
/ment currentAccount <true/false> - Enables or disables current account mentions.
/ment aliases - Lists the current mention aliases.
/ment aliases add <alias> - Adds a mention alias.
/ment aliases del <index> - Removes a mention alias.
/ment aliases insert <index> <alias> - Inserts a mention alias.
/ment sound - Tells you what the current notification sound is.
/ment playSound <sound> - Enables or disables mention sounds.
/ment sound <sound> - Sets the notification sound.
/ment highlight - Tells you if mention highlighting is enabled.
/ment highlight <true/false> - Enables or disables mention highlighting.
/ment highlight color - Tells you the current highlight color.
/ment highlight color <color> - Sets the highlight color.
/nogmt /ng /ng - Toggles No GMT.
/ng timeZone set <zone> - Sets your preferred time zone.
/ng showTimeZone <true/false> - Shows or hides the time zone name next to the time.
/notifier /notif /notif vpLlama title - Tells you if the VP llama title notification is enabled.
/notif vpLlama title <true/false> - Enables or disables the VP llama title notification.
/notif vpLlama playSound - Tells you if the VP llama sound notification is enabled.
/notif vpLlama playSound <true/false> - Enables or disables the VP llama sound notification.
/notif vpLlama sound - Tells you the current VP llama notification sound.
/notif vpLlama sound <sound> - Sets the VP llama notification sound.
/notif trader title - Tells you if the wandering trader title notification is enabled.
/notif trader title <true/false> - Enables or disables the wandering trader title notification.
/notif trader items - Tells you if displaying trader items is enabled.
/notif trader items <true/false> - Enables or disables displaying trader items.
/notif trader items onClick - Tells you if showing trades on click is enabled.
/notif trader items onClick <true/false> - Enables or disables showing trades on click.
/notif trader checkItems - Shows current wandering trader items.
/notif trader playSound - Tells you if the wandering trader sound notification is enabled.
/notif trader playSound <true/false> - Enables or disables the wandering trader sound notification.
/notif trader sound - Tells you the current wandering trader notification sound.
/notif trader sound <sound> - Sets the wandering trader notification sound.
/notif shop - Tells you if shop notifications are enabled.
/notif shop <true/false> - Enables or disables shop notifications.
/notif shop sound - Tells you the current shop sound.
/notif shop sound <sound> - Sets the shop sound.
/notif visits - Tells you if visit notifications are enabled.
/notif visits <true/false> - Enables or disables visit notifications.
/notif visits sound - Tells you the current visit sound.
/notif visits sound <sound> - Sets the visit sound.
/staffdetect /sd /sd detectJoin - Tells you whether detect join is enabled.
/sd detectJoin <true/false> - Enables or disables detect join.
/sd detectLeave - Tells you whether detect leave is enabled.
/sd detectLeave <true/false> - Enables or disables detect leave.
/sd playSound - Tells you if the notification sound is enabled.
/sd playSound <true/false> - Enables or disables the notification sound.
/sd sound - Tells you what the current notification sound is.
/sd sound <sound> - Sets the notification sound.
/toolsaver /saver /saver - Toggles Tool Saver.
/saver durability - Tells you the current durability setting.
/saver durability <durability> - Sets the durability setting.
/unenchall /ueall /ueall - Unenchants your held item.
/ueall inv - Unenchants all items in your inventory.
/ueall tpsSync - Tells you if TPS Sync is enabled.
/ueall tpsSync <true/false> - Enables or disables TPS Sync.
/ueall delay - Tells you the current delay between enchantments.
/ueall delay <seconds> - Sets the delay between enchantments.
/ueall cooldownFrequency - Tells you the current cooldown frequency.
/ueall cooldownFrequency <frequency> - Sets the cooldown frequency.
/ueall cooldownTime - Tells you the current cooldown time.
/ueall cooldownTime <seconds> - Sets the cooldown time.