# BetterPrisons: Quick Reference Guide<\/p>\n
BetterPrisons is a client-side enhancement mod for CosmicPrisons. No external dependencies required.<\/p>\n
—<\/p>\n
## HUDs (On-Screen Overlays)<\/p>\n
– **Cooldown HUD** \u2014 Timers for \/jet, \/feed, \/fix, \/home, \/tpa, \/tpahere, \/dangle, \/adangle, and combat. Super Breaker & Powerball tracked by Enchant HUD.
\n– **Satchel HUD** \u2014 Fill level and capacity for all satchels (works with renamed satchels). Combines same-type satchels. Threshold color alerts.
\n– **Stats HUD** \u2014 XP, XP\/hour, Cosmic Energy, session totals, time until next level. Shows visual indicator when paused.
\n– **Enchant HUD** \u2014 Countdown timers for Super Breaker and Powerball. Powerball Ready alert (title + sound) when cooldown ends.
\n– **Events HUD** \u2014 Coordinates, icon, and landing countdown for each meteor (natural 10 min \/ summoned 1 min). Bandit rushes in your badlands sub-world. Active Ore Merchants with per-tier toggles, distance, timeout.
\n– **Waypoints** \u2014 Screen-edge arrows and optional 3D beacon beams for every active meteor, merchant, and bandit rush. Renders at any distance.
\n– **Gang Pings** \u2014 Broadcast your position to gang (G) or truce (H) chat. Bind an extra key to ping the block you’re looking at. Received pings show as player head icons with beacon beams, info text (name, timer, coords, HP, facing), and sound alerts. 3-second cooldown. Dedicated config tab.
\n– **Super Breaker Aura** \u2014 Centered ring timer (WeakAura-style) for Super Breaker. Timer offset and enable\/disable toggle.<\/p>\n
—<\/p>\n
## EasyView (Inventory Overlays)<\/p>\n
Compact text labels on inventory items \u2014 no tooltip needed. Supports: Cosmic Energy, Money Notes, Gang Points, Black Scrolls, Charge Orbs, Dust, Pages (with optional tier coloring), Prestige Tokens, XP Bottles, Armor, Weapons, and Pickaxes. Each type is toggleable and color-configurable independently.<\/p>\n
—<\/p>\n
## Item Tooltips<\/p>\n
– **Enchant Book Costs** \u2014 Hover an enchant book to see per-level upgrade energy costs and running total to max level. Tier-aware formula.
\n– **Gang Point Expiry** \u2014 Hover a gang point note to see a live countdown and the expiry time in your local timezone (no more EDT math).
\n– All BP-added lines are prefixed with `[BP]` so they’re easy to distinguish.<\/p>\n
—<\/p>\n
## Peaceful Mining<\/p>\n
– Nearby players become translucent while holding a pickaxe or mace (opacity 0\u2013255, radius configurable). Pickaxe and mace each have their own toggle.
\n– Block-breaking progress remains visible through ghosted players.
\n– Disables accidental hits and right-clicks on players while mining.
\n– Auto-disable on combat: peaceful mining turns off when you enter combat and re-enables when combat ends (toggleable).<\/p>\n
—<\/p>\n
## Quality-of-Life<\/p>\n
– **Message Notifications** \u2014 Audio alert on private messages. 7 sounds to choose from, volume 0\u2013200%. —<\/p>\n ## Config Screen<\/p>\n Fully custom UI \u2014 no external mod required. Open with **I** or via Mod Menu.<\/p>\n – Tabs in a left sidebar (HUD Settings \/ Feature Settings \/ Configuration). —<\/p>\n ## Keyboard Shortcuts<\/p>\n – **I** \u2014 Open config screen —<\/p>\n **Support:** Contact nishu06 on Discord or open a ticket at https:\/\/discord.gg\/gW4sBdNmac.<\/p>\n","protected":false},"excerpt":{"rendered":" A client side mod for usage on CosmicPrisons intended to replace CosmicClient.<\/p>\n","protected":false},"featured_media":30273,"template":"","meta":{"_minecraft_slug":"betterprisons","_minecraft_project_id":"VTKts9H2","_minecraft_author":"nishu06","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":799,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"betterprisons.zip","_minecraft_size_bytes":15684931,"_minecraft_version_count":12,"_minecraft_updated_at":"2026-05-15T20:57:59.971835Z","_minecraft_date_created":"2026-01-31T04:09:20.398207Z","_minecraft_date_modified":"2026-05-15T17:05:33.494678Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/betterprisons","_minecraft_icon_attachment_id":30273,"_minecraft_imported_at":"2026-06-01T12:51:00+00:00","_minecraft_import_hash":"5f7f5170d590cae030c097c98e7d23d7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,844,88,97,89,866,92],"mod_loader":[99],"minecraft_version":[41,81],"class_list":["post-30272","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-economy","mod_category-equipment","mod_category-fabric","mod_category-game-mechanics","mod_category-minigame","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-11","minecraft_version-1-21-8"],"yoast_head":"\n
\n– **Powerball Ready Alert** \u2014 Title popup + configurable sound when Powerball cooldown ends.
\n– **Auto Trade** \u2014 Shift-right-click another player to send `\/trade
\n– **Held Item Scaling** \u2014 Resize held items per type (pickaxe, sword, axe, other) from 25\u2013150%.
\n– **Pickaxe Drop Protection** \u2014 Requires pressing drop twice within 3 seconds to drop a pickaxe. Options to block dropping entirely or block dragging out of inventory.<\/p>\n
\n– Collapsible sections and per-setting reset buttons (X icon).
\n– Hover tooltips on most settings.
\n– **Color picker** \u2014 HSV selector square, hue bar, live preview, and hex input.
\n– **HUD Editor** \u2014 Drag to reposition. Right-click a HUD for an inline scale slider (70\u2013150%). Color-coded: green = hovered, yellow = dragging, orange = scaling. Reset Positions button available.
\n– **Theme** \u2014 27 color settings (backgrounds, borders, text, accents, etc.) with real-time preview.<\/p>\n
\n– **R** \u2014 Reset Stats HUD (clears session totals)
\n– **B** \u2014 Pause \/ Resume Stats HUD tracking
\n– **G** \u2014 Send gang ping (your position)
\n– **H** \u2014 Send truce ping
\n– *(unbound)* \u2014 Send gang ping at the block you’re looking at \u2014 bind in Controls<\/p>\n