\ud83e\udded Better Compass<\/p>\n
Better Compass is a lightweight and fully configurable Minecraft mod that adds a modern compass HUD with directional indicators, coordinates display, biome info, and dimension tracking. It features a complete theming system with multiple pre-designed themes and full server-client configuration management.<\/p>\n
\u26a0\ufe0f By default, a compass must be present in the player’s inventory for the HUD to work (configurable via server or client settings).<\/p>\n
\u2728 Features<\/p>\n
\ud83d\udccd **Directional Indicators** – Shows 8 cardinal directions (N, NE, E, SE, S, SW, W, NW)
\n\ud83c\udfaf **Facing Angle** – Displays exact facing direction in degrees with smooth animation
\n\ud83d\udcd0 **Coordinates Display** – Real-time X, Y, Z coordinates with customizable position and scale
\n\ud83c\udf0d **Dimension Info** – Shows current dimension (Overworld\/Nether\/End)
\n\ud83d\uddfa\ufe0f **Biome Display** – Displays current biome name
\n\ud83c\udfa8 **Theme System** – 4 pre-built themes (default, compact, colorful, immersive) with full customization
\n\u2699\ufe0f **Custom Themes** – Create unlimited custom themes with 50+ configurable parameters
\n\ud83d\udd27 **Hot-Reload** – Reload themes without restarting with `\/bettercompass theme reload`
\n\ud83c\udf10 **Full Customization** – Configure colors, positions, sizes, and animations via TOML files
\n\ud83d\udce1 **Server Override** – Servers can force themes and settings on all connected clients
\n\ud83e\udded **Compass Requirement** – Toggle compass requirement at server or client level
\n\ud83d\ude80 **Lightweight** – Optimized for minimal performance impact
\n\ud83d\udcbb **Multi-Platform** – Available for both Forge and Fabric<\/p>\n
\u2699\ufe0f Configuration<\/p>\n
The mod uses TOML configuration files for complete customization:<\/p>\n
**Client Configuration** (`config\/bettercompass\/compass.toml`):<\/p>\n
“`
\nrequireCompass = false
\ncurrentTheme = “default”
\n“`<\/p>\n
* `requireCompass`: If true, HUD only appears with a compass in inventory
\n* `currentTheme`: Selected theme (default, compact, colorful, immersive, or custom)<\/p>\n
**Server Configuration** (`server_config.toml`):<\/p>\n
“`
\nserverForceTheme = false
\nserverTheme = “default”
\nrequireCompass = “client”
\n“`<\/p>\n
* `serverForceTheme`: If true, forces all clients to use the specified theme
\n* `serverTheme`: Theme to enforce on all players (ignored if serverForceTheme = false)
\n* `requireCompass`: “client” (player chooses), “true” (required), “false” (optional)<\/p>\n
\ud83c\udfa8 Theme System<\/p>\n
Themes are stored in `config\/bettercompass\/themes\/` as TOML files. Each theme contains:<\/p>\n
* **Colors**: Primary, secondary, background, text, border (ARGB format)
\n* **Dimensions**: Compass size, text scale, padding, border width
\n* **Positions**: X, Y coordinates for each HUD element
\n* **Coordinates Display**: Position, scale, and visibility
\n* **Dimension Display**: Position, scale, and visibility
\n* **Biome Display**: Position, scale, and visibility
\n* **Animation**: Smooth rotation speed and other effects
\n* **Metadata**: Theme name, author, and description<\/p>\n
**Supported Color Formats:**<\/p>\n
* ARGB: `0xAARRGGBB` (e.g., `0xFF00FF00` for opaque green)
\n* Hex: `#RRGGBB` (e.g., `#00FF00`)
\n* RGB: `rgb(255, 0, 0)`
\n* RGBA: `rgba(255, 0, 0, 128)`<\/p>\n
**Example Theme** (`config\/bettercompass\/themes\/custom.toml`):<\/p>\n
“`
\n# Better Compass Theme: default
\n# Classic Better Compass theme<\/p>\n
[metadata]
\nname = “default”
\ndescription = “Classic Better Compass theme”
\nauthor = “Better Compass”
\nversion = “1.0”<\/p>\n
[position]
\nhudPosition = “top-center”
\nhudOffsetX = 0
\nhudOffsetY = 0<\/p>\n
[compass]
\nwidth = 400
\nheight = 20
\nspacing = 90
\nscale = 1.0<\/p>\n
[colors]
\nbackground = 0x80000000
\nborder = 0xFFFFFFFF
\ntext = 0xFFFFFFFF
\ndirection = 0xFFAAAAAA
\nnorth = 0xFFFF0000
\neast = 0xFFFFFFFF
\nsouth = 0xFFFFFFFF
\nwest = 0xFFFFFFFF
\nplayerDirection = 0xFFFFFFFF
\ncoordinates = 0xFFFFFFFF
\ndimension = 0xFFFFFFFF
\nbiome = 0xFFFFFFFF<\/p>\n
[playerDirection]
\nposition = “center”
\noffsetX = 0
\noffsetY = 0<\/p>\n
[coordinates]
\nshow = true
\nposition = “bottom-center”
\noffsetX = 0
\noffsetY = -15
\nformat = “X: %d Y: %d Z: %d”<\/p>\n
[dimension]
\nshow = false
\nposition = “below-coordinates”
\noffsetX = 0
\noffsetY = 12<\/p>\n
[biome]
\nshow = false
\nposition = “below-dimension”
\noffsetX = 0
\noffsetY = 12<\/p>\n
[appearance]
\nshowBorder = false
\nborderWidth = 1
\nborderRadius = 3
\nshowBackground = false
\nbackgroundPadding = 4
\ntextScale = 1.0
\ntextShadow = false<\/p>\n
[animation]
\nsmoothRotation = false
\nrotationSpeed = 0.3
\n“`<\/p>\n
Simply create a new TOML file in `config\/bettercompass\/themes\/` with your own theme configuration. The theme will be automatically loaded and available through commands.<\/p>\n
All commands support Tab-completion for theme names.<\/p>\n
* `\/bettercompass theme list` – Display all available themes with the current one marked \ud83c\udf10 Server Compatibility<\/p>\n Better Compass features complete server-client integration:<\/p>\n * **Client-only mode**: Works seamlessly in single-player \ud83c\udfaf Default Themes<\/p>\n 1. **default** – Balanced, clean design suitable for most playstyles \ud83d\udca1 Creating Custom Themes<\/p>\n Simply create a new TOML file in `config\/bettercompass\/themes\/` with any name. Themes are automatically loaded and available through commands. The theme system provides 50+ customizable parameters to match any player preference or server aesthetic.<\/p>\n \ud83c\udfaf Mod Goal<\/p>\n Better Compass enhances navigation with a modern, highly customizable interface while maintaining vanilla-friendly balance. Whether you prefer a subtle compass or a feature-rich HUD, the extensive theme system accommodates every playstyle in both single-player and multiplayer environments.<\/p>\n","protected":false},"excerpt":{"rendered":" \ud83e\udded Better Compass Better Compass is a lightweight and fully configurable Minecraft mod that adds a modern compass HUD at the top of the screen. It displays the cardinal directions (N \u2022 E \u2022 S \u2022 W) along with the exact facing angle in degrees<\/p>\n","protected":false},"featured_media":28080,"template":"","meta":{"_minecraft_slug":"better-compass-azimut","_minecraft_project_id":"mUH0QgBW","_minecraft_author":"luigipower5798","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":311,"_minecraft_follows":4,"_minecraft_client_side":"required","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"better-compass-azimut.zip","_minecraft_size_bytes":176051,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T17:39:34.649788Z","_minecraft_date_created":"2026-01-14T22:59:17.816043Z","_minecraft_date_modified":"2026-01-14T23:16:38.217078Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/better-compass-azimut","_minecraft_icon_attachment_id":28080,"_minecraft_imported_at":"2026-06-01T10:58:47+00:00","_minecraft_import_hash":"7db5557c7a7e9a9a8188b53b8a51144b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,88,97,104,89,92],"mod_loader":[99,106],"minecraft_version":[59,36,60,93,94,101,102],"class_list":["post-28079","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-equipment","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-utility","mod_loader-fabric","mod_loader-forge","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6"],"yoast_head":"\n
\n* `\/bettercompass theme set
\n* `\/bettercompass theme current` – Show the currently active theme and its properties
\n* `\/bettercompass theme reload` – Hot-reload all themes from disk (useful for developers)<\/p>\n
\n* **Server mode**: Administrators can enforce themes and settings across all players
\n* **Real-time sync**: Configuration changes sync immediately when players join
\n* **Override system**: Server theme forcing takes priority over client preferences
\n* **Flexibility**: Individual settings can be left to client choice or forced server-wide<\/p>\n
\n2. **compact** – Optimized for smaller screens and minimal HUD footprint
\n3. **colorful** – Vibrant colors for better visibility and visual appeal
\n4. **immersive** – Subtle and elegant design for atmosphere preservation<\/p>\n