promotional bannermobile promotional banner

Better Compass Azimut

🧭 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 • E • S • W) along with the exact facing angle in degrees

File Details
DownloadInstall

bettercompass-1.1.0-forge-1.20.1

ByLuigipower5798
  • R
  • Jan 9, 2026
  • 26.82 KB
  • 59
  • 1.20.1
  • Forge

File Name

bettercompass-1.1.0.jar

Supported Versions

  • 1.20.1

Curse Maven Snippet

Forge

implementation fg.deobf("curse.maven:better-compass-azimut-1420378:7438666")
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

# Changelog - BetterCompass Mod

 

## [Version 1.1.0] - 2026-01-09
### 🐛 Bug Fixes

 

#### Fix Off-Hand Compass Detection
  • **Fixed** : Bug where HUD wouldn't display when compass was in off-hand (secondary hand)
  • **Impact** : HUD now works correctly regardless of whether compass is in main hand, off-hand, or inventory
  • **Code** : Improved check with `mainHand.is(Items.COMPASS) || offHand.is(Items.COMPASS)`
### 🚀 New Features
 
#### Coordinates System
  • **Added** : Display of player X, Y, Z coordinates
  • **Positions** : 4 configurable positions (top-left, top-right, bottom-left, bottom-right)
  • **Configuration** : `showCoordinates` to enable/disable
  • **Default position** : bottom-left
#### Controls and Interactions
  • **Configuration** : `requireCompass` to require a compass or always display
#### Commands
  • **Added** : `/bettercompass reload` - Reloads the mod configuration
  • **Permissions** : Accessible to administrators and in single-player
  • **Feedback** : Success/error messages with color codes
  • **Utility** : Allows reloading config without restarting the client
### 🌐 Server Compatibility

 

#### Server-Client Configuration System
  • **Added** : Complete client-server architecture with network synchronization
  • **Files** : `compass.toml` (client) and server configuration via commands
  • **Override** : Server parameters can override client configurations
#### Supported Server Parameters
`requireCompass` : Controls if a compass is required to display HUD
  - `"true"` - Forces compass requirement for all players
  - `"false"` - Displays HUD even without compass for all players
  - `"client"` - Lets client choose
`showCoordinates` : Controls coordinates display
  - `"true"` - Forces display for all players
  - `"false"` - Disables display for all players  
  - `"client"` - Lets client choose

 

#### Network Synchronization
  • **Added** : Custom network packet system to synchronize configurations
  • **Auto-sync** : Server configuration automatically sent to each player connection
  • **Real-time** : Configuration changes applied instantly
### 🔧 Technical Improvements

 

#### Automatic Configuration Generation
  • **Added** : Automatic creation of client and server configuration files
  • **Client** : `compass_config.toml` generated on first launch
  • **Server** : `server_config.toml` generated on server startup
#### Network Architecture
  • **Implemented** : `NetworkHandler` for server-client communication
  • **Packet** : `ServerConfigPacket` to transmit configurations
  • **Management** : `ServerSideHandler` for server-side logic
### 📋 Default Configuration

 

```toml
# Configuration Client (compass_config.toml)
# Better Compass Configuration

 

# Width of the compass display area in pixels
compassWidth = 400

 

# Height of the compass in pixels
compassHeight = 20

 

# Spacing between direction elements
spacing = 90

 

# Whether a compass is required in inventory to display HUD (true/false)
requireCompass = true

 

# Display player coordinates (true/false)
showCoordinates = true

 

# Coordinates position: top-left, top-right, bottom-left, bottom-right
coordinatesPosition = "bottom-left"

 

# Configuration Serveur (server_config.toml)
# Better Compass Server Configuration
# This file controls what client settings the server can override
# Only the following settings can be controlled by the server:
# Available values: 'true' (force enabled), 'false' (force disabled), 'client' (let client choose)

 

# Whether a compass is required in inventory to display HUD
requireCompass = "client"

 

# Display player coordinates
showCoordinates = "client"

 

```

 

### 🎯 Usage

 

1. **Client only** : The mod works with local configuration
2. **Server** : Administrators can control display for all players
3. **Override** : Server parameters take priority over client parameters
4. **Flexibility** : "client" option allows individual player choice
 
### Development Notes

 

  • **Forge Version** : 1.20.1
  • **Architecture** : Client-Server with network synchronization
  • **Compatibility** : Single-player and Multi-player
  • **Performance** : Optimized for minimal performance impact