Simple Scroll

📜 SimpleScroll (Scroll Utility)

SimpleScroll is a lightweight, client-side optimization mod that solves the age-old problem of overflowing item tooltips in heavily modded Minecraft.

If you play with massive tech mods, complex questing packs, or custom item configurations, you’ve likely seen tooltips that stretch far beyond the boundaries of your screen. This mod introduces a clean, performance-friendly scrolling system that keeps your tooltips neat, readable, and fully customizable.

🎥 Video Review:

https://imgur.com/a/t1qhgvU

✨ Features

• Universal Scrolling: Automatically caps any long tooltip in the game (vanilla or modded) to a customizable limit (default is 15 lines) and enables smooth vertical scrolling.
• Simple Controls: Just hold the Alt key and use your Mouse Scroll Wheel while hovering over any item to scroll through its description.
• Smart Memory: Automatically resets the scroll position back to the top when you move your cursor to a different item, ensuring a seamless inventory experience.
• Extremely Optimized: Designed with performance in mind. All formatting, colors, and styles are cached on configuration load, resulting in zero rendering lag.
• 100% Client-Side: Safe to use on any multiplayer server. You do not need to install it on the server.

⚙️ Fully Customizable Config

The mod features an extensive configuration file (simplescroll-common.toml) allowing you to personalize every single visual aspect of the scroll indicators to match your favorite UI theme:

• linesToEnableScroll: Customize the threshold at which tooltips begin scrolling (default: 10 lines).
• Indicator Customization: Independently change both the Color (Black, Gold, Aqua, Red, etc.) and the Style (Bold, Italic, Obfuscated, Underline, Strikethrough, or none) for:
  • The top scroll arrows (▲ … ▲)
  • The bottom scroll arrows (▼ … ▼)
  • The active lines counter label ([Line X-Y of Z])
  • The “Hold Alt” helpful reminder label

📔 Config (simple_scroll-common.toml) :

#Specifies the minimum number of lines required to enable scrolling.
# Default: 10
# Range: > 0
linesToEnableScroll = 10
#[▲ ... ▲] color.
#Colors list: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE
#Write ChatFormatting.SELECTED_COLOR
#Allowed Values: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE, OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, RESET
arrowsBottomColor = "YELLOW"
#[▲ ... ▲] style.
#Style list: OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, NULL
#Write Styles.SELECTED_STYLE
#Allowed Values: OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, NULL
arrowsBottomStyle = "NULL"
#[10 Lines - 8 from 25] color.
#Colors list: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE
#Write ChatFormatting.SELECTED_COLOR
#Allowed Values: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE, OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, RESET
lines_counter_color = "DARK_GRAY"
#[10 Lines - 8 from 25] style.
#Style list: OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, NULL
#Write Styles.SELECTED_STYLE
#Allowed Values: OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, NULL
lines_counter_style = "NULL"
#[Use Mouse Wheel to Scroll] color.
#Colors list: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE
#Write ChatFormatting.SELECTED_COLOR
#Allowed Values: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE, OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, RESET
useWheelColor = "AQUA"
#[Use Mouse Wheel to Scroll] style.
#Style list: OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, NULL
#Write Styles.SELECTED_STYLE
#Allowed Values: OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, NULL
useWheelStyle = "NULL"
#[▼ ... ▼] color.
#Colors list: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE
#Write ChatFormatting.SELECTED_COLOR
#Allowed Values: BLACK, DARK_BLUE, DARK_GREEN, DARK_AQUA, DARK_RED, DARK_PURPLE, GOLD, GRAY, DARK_GRAY, BLUE, GREEN, AQUA, RED, LIGHT_PURPLE, YELLOW, WHITE, OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, RESET
arrowsTopColor = "YELLOW"
#[▼ ... ▼] style.
#Style list: OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, NULL
#Write Styles.SELECTED_STYLE
#Allowed Values: OBFUSCATED, BOLD, STRIKETHROUGH, UNDERLINE, ITALIC, NULL
arrowsTopStyle = "NULL"

🛠️ Modpack Creators & Compatibility

• Compatibility: Works out-of-the-box with all mods, including JEI, EMI, REI, and major tech or magic mods that add extensive descriptions.
• Aesthetic Control: Perfect for modpack creators who want to unify the look of tooltips across different mods using the TOML configuration.

📒 Log

1.0:

• Mod’s uploading

2.0:

• holdAltColor and holdAltStyle deprecated, sience 2.0 and higher
• sience 2.0 scroll works in jei and other gui

2.1:

• Fixed : in other interfaces – such as Xaero’s Minimap or Waystones – scrolling might not work, even if the mouse wasn’t hovering over an item.