General
Core behaviour, notifications, updates.
On this page
14 features in 5 groups, with 103 options between them. Generated from the mod's own catalogue as of 2.0.1; the same list, without the options, is on the features page.
Setup and presets
First-run wizard, preset library, undo
First-run welcome
Remembers whether you have been shown the Vantage setup, and lets you run it again.
On by default Menu Works outside SkyBlock first_run_welcome
Welcome
| Option | What it does | Type | Default |
|---|---|---|---|
| Run the setup again | Opens the six-step setup: what you play, how the screen looks, how loud alerts are. Same as typing /vantage setup. | Button: | — |
Setup & Presets
The first-run setup and the ready-made preset library: pick a look, pick a playstyle, undo either.
On by default Menu Works outside SkyBlock setup
Setup
| Option | What it does | Type | Default |
|---|---|---|---|
| Run the setup again | Walks through the six-step setup: what you play, how the screen looks, how loud alerts are. Nothing is reset first, so it picks up from where you are now. | Button: | — |
Presets
| Option | What it does | Type | Default |
|---|---|---|---|
| Presets | Ready-made setups: HUD layouts to pick a look, and playstyles that switch on what a dungeon runner, a miner or a farmer wants. Also copies your own settings to the clipboard. | Button: | — |
| Undo the last preset | Puts everything back the way it was before the last preset was applied. Available until you close the game. | Button: | — |
| Reload the preset files | Reads the preset files again. Useful when a resource pack adds or edits one. | Button: | — |
Alerts
Toast and title style, profile switches, 11:11
11:11
Tells you to make a wish at 11:11, and to keep it to yourself.
On by default Warning Sound Works outside SkyBlock eleven_eleven
11:11
| Option | What it does | Type | Default |
|---|---|---|---|
| Watch | Whose 11:11 to watch. With both, you also get the alert when it turns 11:11 in the other place. | Dropdown: California and Minnesota · California only · Minnesota only | California and Minnesota |
| When | Whether 11:11 in the morning counts too. | Dropdown: Morning and night · Night only · Morning only | Morning and night |
| Message | The big line. | Text | Make a wish |
| Say where | Name the place under the message, so you know whose 11:11 it is. | Toggle | On |
| Play a sound | Toggle | On | |
| Test | Show the alert now. | Button | — |
Notifications
Global style for every Vantage alert: toast and title duration, alert volume, severity filtering and do-not-disturb.
On by default Warning Sound Works outside SkyBlock notifications
Toasts
| Option | What it does | Type | Default |
|---|---|---|---|
| Show toasts | Corner cards used for most alerts. Turning this off leaves titles, sounds and chat untouched. | Toggle | On |
| Toast duration | How long a toast stays on screen before it slides away. Depends on Show toasts. | Slider, 1–20s, steps of 0.5 | 4s |
| Maximum toasts | Oldest toasts are dismissed once this many are stacked. Depends on Show toasts. | Slider, 1–10 | 5 |
Titles
| Option | What it does | Type | Default |
|---|---|---|---|
| Show titles | Big centred text used for alerts that must not be missed (boss phases, rare drops). | Toggle | On |
| Title duration | How long a Vantage title stays on screen. Depends on Show titles. | Slider, 0.5–10s, steps of 0.5 | 2s |
Sounds
| Option | What it does | Type | Default |
|---|---|---|---|
| Play sounds | Alert sounds played by Vantage features. Independent of Minecraft's own sound sliders. | Toggle | On |
| Alert volume | Master volume applied to every Vantage alert sound. Depends on Play sounds. | Slider, 0–100%, steps of 5 | 100% |
Do not disturb
| Option | What it does | Type | Default |
|---|---|---|---|
| Do not disturb | Silences every Vantage title, toast and alert sound until you turn it back off. Chat messages still come through. | Toggle | Off |
| Quiet in dungeons | Suppress titles, toasts and sounds for the whole dungeon run. | Toggle | Off |
| Quiet in boss fights | Suppress titles, toasts and sounds once the dungeon boss fight starts, so nothing covers the screen at the worst moment. | Toggle | Off |
Severity
| Option | What it does | Type | Default |
|---|---|---|---|
| Info | Neutral notifications: trackers, timers, informational updates. | Toggle | On |
| Success | Green notifications: something completed or a goal was reached. | Toggle | On |
| Warning | Amber notifications: something needs attention soon. | Toggle | On |
| Error | Red notifications: a feature could not do its job. Leave this on unless you know what you are hiding. | Toggle | On |
| Preview | Sends one notification of every severity plus a title, so you can see the current style. | Button: | — |
Profile switch notice
Tells you which SkyBlock profile you are on whenever it changes.
On by default Warning profile_switch_notice
Profile switch
| Option | What it does | Type | Default |
|---|---|---|---|
| Style | How the new profile name is shown. Turn the feature off entirely to silence it. | Dropdown: Toast · Chat · Toast and chat · Title | Toast |
| Announce on join | Also announce the profile the first time it is detected after joining a server, not only when you switch. | Toggle | Off |
| Include game mode | Append Ironman / Stranded / Bingo to the profile name when the profile is not a normal one. | Toggle | On |
Profile and playtime
Profile viewer, playtime per session and island, and opt-in statistics
Playtime tracker
Tracks how long you play SkyBlock per session and per island, persisted between launches.
On by default HUD Tracker 1 HUD element playtime_tracker
Tracking
| Option | What it does | Type | Default |
|---|---|---|---|
| Only while the window is focused | Stop counting while Minecraft is in the background, so alt-tabbing does not inflate your playtime. | Toggle | On |
| Idle timeout | Stop counting after this long without moving or looking around. Set to 0 to count all the time. | Slider, 0–30min | 10min |
HUD
| Option | What it does | Type | Default |
|---|---|---|---|
| Show session | Time spent in SkyBlock since the game started. | Toggle | On |
| Show current island | Total time on the island you are on right now. | Toggle | On |
| Show total | All-time SkyBlock playtime recorded by Vantage. | Toggle | Off |
Actions
| Option | What it does | Type | Default |
|---|---|---|---|
| Print playtime | Prints the same breakdown as /vantage playtime. | Button: | — |
| Reset recorded playtime | Clears the stored totals and per-island breakdown. The current session keeps counting. | Button: | — |
Profile viewer
A full SkyBlock profile viewer: skills, slayers, dungeons, inventories, collections and a networth estimate, for any player, in the Vantage look. Open it with /vt pv <name>.
On by default Menu Keybind Prices Works outside SkyBlock profile_viewer
| Option | What it does | Type | Default |
|---|---|---|---|
| Start on | Which page the viewer opens on. | Dropdown: Summary · Skills · Slayers · Dungeons · Inventory · Collections | Summary |
| Estimate networth | Price every item on the profile to estimate its networth. Runs on a background thread; turn it off if you only care about levels. | Toggle | On |
| Open my profile | Key that opens the viewer on your own account. Works outside menus. | Keybind | None |
| Look up your own profile | Opens the viewer on the account you are logged in as. | Button: | — |
| Forget cached profiles | Profiles are kept in memory for two minutes so switching pages never refetches. This drops them, plus every networth estimate, so the next lookup hits the API. | Button: | — |
Vantage Stats
Records what you do in SkyBlock and mirrors your profile to a web page only you can share. Off until you turn it on, category by category.
Off by default Tracker Automation Works outside SkyBlock vantage_stats
Sync
| Option | What it does | Type | Default |
|---|---|---|---|
| Sync while you play | Upload every five minutes instead of only when you leave a world. | Toggle | On |
| Notify when a sync fails | A single toast the first time a sync fails, and nothing after that until it works again. | Toggle | On |
Mirror
| Option | What it does | Type | Default |
|---|---|---|---|
| Mirror your profile | Read your own menus as you open them so the page can show your skills, pets and gear. Nothing is opened for you. | Toggle | On |
| Timeline notes in chat | Say in chat when something goes on your timeline - a personal best, a rare drop, a first. | Toggle | Off |
Status
| Option | What it does | Type | Default |
|---|---|---|---|
| Vantage Stats | Opens the status screen. | Button: | — |
| Consent and categories | Choose what Vantage Stats records, category by category. | Button: | — |
Grind ledger
Net coins per hour across every grind, its costs, and the switch coach
Grind coach
Watches your live rate against your own median for the grind you are on and says so when it falls away, with the observable cause when there is one. Needs the grind ledger's measurements, so leaving this on keeps measuring even with the ledger's own chip and table switched off.
On by default Tracker Profit Warning HUD 1 HUD element grind_coach
Decay
| Option | What it does | Type | Default |
|---|---|---|---|
| Rate decay alerts | Speak up when the last fifteen minutes fall below your own band for this grind. Off means the coach never opens its mouth about the grind you are on. | Toggle | On |
| How far under before it counts | How far under your median the rolling fifteen-minute rate has to sit before it counts as a decay at all. It must also be under the tenth percentile of the band, so a quiet run inside your normal spread never fires. Depends on Rate decay alerts. | Slider, 10–60%, steps of 5 | 25% |
| How long it must stay there | How long the rate has to stay under before you hear about it. One unlucky drought is not a decayed grind. Depends on Rate decay alerts. | Slider, 2–15 min | 5 min |
| Quietest gap between alerts | The shortest gap between two coach toasts of any kind. A coach that repeats itself is a coach you learn to ignore. | Slider, 5–120 min, steps of 5 | 20 min |
| Name the cause | Append the most likely observable cause to the alert when there is one — an empty key slot, sack messages that stopped arriving, runs a death voided. | Toggle | On |
Switching
| Option | What it does | Type | Default |
|---|---|---|---|
| Better grind alerts | Point out your best measured grind when the one you are on is running well under it. Off by default: it is a suggestion about the next three hours, not about the next three minutes. | Toggle | Off |
| How far ahead the other grind must be | How far your best measured grind has to beat what you are making right now before the coach mentions it. This is its own number, not the decay threshold: 'how far under my median I am' and 'how far ahead something else is' are different questions with different right answers. Depends on Better grind alerts. | Slider, 10–100%, steps of 5 | 25% |
| How long it must stay ahead | How long the gap has to hold before you hear about it. A single dry quarter of an hour is not a reason to walk away from a grind. Depends on Better grind alerts. | Slider, 2–15 min | 5 min |
| Finish this first | Hold back the switch suggestion and say 'finish this first' while a slayer boss is nearly up, an RNG meter is nearly full, or you are inside a Kuudra or dungeon run. Walking out of something you already paid for is the one switch that always loses coins. Depends on Better grind alerts. | Toggle | On |
HUD
| Option | What it does | Type | Default |
|---|---|---|---|
| Live bar | A HUD bar of what you are making right now against your own median for this grind, with the band drawn the same way the ledger table draws it. | Toggle | On |
Grind ledger
Measures every grind on one clock and ranks them by net coins per hour after the keys, fuel and deaths they actually cost, re-priced at today's market. Open the table with /vantage ledger.
On by default Tracker Profit Prices HUD Menu 1 HUD element grind_ledger
Prices
| Option | What it does | Type | Default |
|---|---|---|---|
| Price items at | Which price every stored item count is valued at when the ledger is read. Nothing was ever stored as coins, so changing this re-prices your whole history straight away. | Dropdown: Best available · Bazaar sell · Lowest BIN · 3-day average BIN | Best available |
Measuring
| Option | What it does | Type | Default |
|---|---|---|---|
| Shortest session to rank | Sessions with less active time than this are still stored, but never ranked or averaged. Two minutes of Kuudra is not a measurement of Kuudra. | Slider, 30–600s, steps of 10 | 90s |
| Sessions before a rank | How many closed sessions a grind needs before it gets a rank instead of a 'needs more data' row. A confident wrong answer here costs more than no answer. | Slider, 1–20 | 3 |
| Sessions kept per grind | How many sessions each grind keeps in full before the oldest are folded into a summary bucket. Nothing is deleted: lifetime totals survive the cap. | Slider, 20–1,000, steps of 20 | 200 |
Costs
| Option | What it does | Type | Default |
|---|---|---|---|
| Record what the grind costs | Record the cost side at all. Off makes the ledger a pure gross comparison, like every other profit tracker. | Toggle | On |
| Count shop purchases | Attribute a purse drop to a purchase when you clicked an item in a recognised shop menu in the two seconds before it. Auction house buys are never counted. Depends on Record what the grind costs. | Toggle | On |
| Count consumables burnt | Count whitelisted items leaving your inventory outside a menu as spend — keys, drill fuel, arrows. The list lives in config/vantage/ledger/consumables.json and is yours to edit. Depends on Record what the grind costs. | Toggle | On |
| Count purse income | Count small purse gains — under a million per event, with no menu open — as grind income. Anything larger is a sale or a withdrawal and is listed as unexplained instead. | Toggle | On |
| Show unexplained purse movement | List the purse movements the ledger could not explain on the expanded row. They are never counted as cost either way; this only decides whether you see them. | Toggle | On |
HUD
| Option | What it does | Type | Default |
|---|---|---|---|
| Live chip | A HUD chip reading the grind you are on, its net coins per hour and its rank, while an activity is detected. | Toggle | On |
| Show the rank on the chip | Append '#1 of 9' to the chip, so you can see whether what you are doing is your best grind. Depends on Live chip. | Toggle | On |
| Card when a session ends | Post a card when a grind session closes, comparing the run you just did against your own median for that grind. | Toggle | On |
Actions
| Option | What it does | Type | Default |
|---|---|---|---|
| Export the ledger | Writes every stored session to config/vantage/ledger/export-<date>.csv. It is written to your own config folder and nothing leaves this machine. | Button: | — |
| Grind to reset | Which grind the button below clears. 'Nothing' means none is chosen, and the button does nothing. | Dropdown: Nothing · Kuudra · Catacombs · Slayer · Ender Dragon · Garden farming and 7 moreFishing · Crystal Hollows · Mineshaft · Dwarven Mines · Torrhus Canyon · Crimson Isle · The Rift | Nothing |
| Reset one grind | Clears every stored session for the grind chosen above. Every other grind is untouched. | Button: | — |
| Reset the whole ledger | Clears every stored session for this profile. There is no second copy anywhere, so this cannot be undone. | Button: | — |
API and updates
Where profiles come from, prices, updates, status HUD
Announcements
Announcements from the Vantage maintainers - releases, heads-ups and warnings - as a card at the top of the screen once each, and /vt news for the record.
On by default Warning Works outside SkyBlock announcements
Show
| Option | What it does | Type | Default |
|---|---|---|---|
| Releases | Announce releases: an update prompt when you are behind, the notes for your build when you are on it. | Toggle | On |
| Notes for the build you run | Show a release announcement even when you already run that version, as its notes. Off means only updates you do not have yet. Depends on Releases. | Toggle | On |
| News and warnings | Everything that is not a release: heads-ups, known issues, maintenance notices. | Toggle | On |
| Style | A card drops in from the top of the screen with the whole announcement; a toast is the ordinary notification. | Dropdown: Card · Toast | Card |
| Card stays for | Slider, 5–40s | 14s | |
| Chime | A soft chime as the card arrives, pitched by what it is. | Toggle | On |
| Chime volume | Depends on Chime. | Slider, 10–100%, steps of 5 | 60% |
| Also in chat | Put a chat line with a clickable link under the card, so the announcement and its link outlive it. | Toggle | On |
| Re-check every | How often a running client looks for new announcements after the first check at boot. | Slider, 10–180min, steps of 5 | 30min |
Actions
| Option | What it does | Type | Default |
|---|---|---|---|
| Open the announcements | Every announcement that applies to you, newest first. Also /vt news. | Button: | — |
| Check now | Fetch the announcements file immediately; anything new is dealt as a card once you are in a world. | Button: | — |
| Show the latest again | Repeat the most recent announcement that applies to you, even if you have already seen it. | Button: | — |
| Preview the card | Show a sample announcement the way a real one would arrive. Close the menu to watch it. | Button: | — |
API & Data Sources
Where profile data comes from, NotEnoughUpdates item repository and price refresh settings, with manual update and refresh actions.
On by default Prices Works outside SkyBlock api_settings
Profile data
| Option | What it does | Type | Default |
|---|---|---|---|
| Where profiles come from | Vantage reads SkyBlock profiles through its own service, which holds one registered Hypixel application key. There is nothing to configure and nothing to paste. Vantage will never ask you for a Hypixel API key: Hypixel's developer policy forbids putting one in a mod. | Button: | — |
Item repository
| Option | What it does | Type | Default |
|---|---|---|---|
| Auto-update item repo | Check the NotEnoughUpdates repository for a newer commit on every launch. Turn this off to always use the copy already on disk. | Toggle | On |
| Update repo now | Pull the newest item data now. Item names, recipes and constants refresh without a restart. | Button: | — |
| Reinstall repo | Delete the local repository and download a fresh copy. Use this when items look wrong. | Button: | — |
Prices
| Option | What it does | Type | Default |
|---|---|---|---|
| Price refresh interval | How often Bazaar prices are fetched. Auction data (lowest and average BIN) is fetched at twice this interval because it moves far more slowly. Lower values cost more requests; the default is already well inside Hypixel's limits. | Slider, 30–900s, steps of 15 | 120s |
| Refresh prices now | Fetch Bazaar, lowest BIN and average BIN data immediately. | Button: | — |
Status
| Option | What it does | Type | Default |
|---|---|---|---|
| Report to chat | Print what happened in chat when an update or refresh finishes. The two buttons that exist to answer a question always reply. | Toggle | On |
| Data source status | Print the state of every data source: item repo, Bazaar, auctions, Hypixel, the profile service and the HTTP cache. | Button: | — |
Update checker
Checks once per session for a newer Vantage release on your channel (stable, beta or alpha) and shows a single toast when one is available.
On by default Warning Works outside SkyBlock update_checker
Update checker
| Option | What it does | Type | Default |
|---|---|---|---|
| Channel | Which releases to be told about. Stable is what everyone gets; beta and alpha builds ship earlier and may break. A channel also sees everything more stable than itself. | Dropdown: Stable · Beta · Alpha | Versions.Channel.of(Vantage.version()) |
| Only compatible builds | Ignore releases that have no jar for this Minecraft version. Turn off to be told about builds for other versions too. | Toggle | On |
| Announce in chat | Add a chat line with a clickable link to the release next to the toast. | Toggle | On |
| Check now | Run the check immediately and report the result, even if this session already checked. | Button: | — |
Vantage status HUD
Debugging panel showing the mod version, API and item repository readiness, price cache age and detected location.
Off by default HUD 1 HUD element Works outside SkyBlock vantage_status
Lines
| Option | What it does | Type | Default |
|---|---|---|---|
| Item repository | Repository load state and item count. | Toggle | On |
| Prices | How long ago the Bazaar and auction caches were refreshed. | Toggle | On |
| Profile service | Which service profile lookups go through. There is no API key to show: Vantage does not hold one. | Toggle | Off |
| Location | Island, area and server id as detected by the state layer. | Toggle | Off |
Style
| Option | What it does | Type | Default |
|---|---|---|---|
| Compact | Drop the labels and show only the values. | Toggle | Off |