Better Compass Mod

🧭 Overview
Better Compass enhances your Minecraft navigation experience by displaying real-time distance and direction to key locations right on your screen. No more guessing how far you are from spawn or your bed!

✨ Features
📍 Real-Time Distance Tracking
World Spawn – Always know how far you are from the world spawn point

Bed Location – Track distance to your respawn point (automatically detected)

Clear Display – Clean, non-intrusive overlay in the corner of your screen

🧭 Smart Direction Indicators
Cardinal Directions – North, South, East, West

Intercardinal Directions – NE, NW, SE, SW

Exact Distance – In blocks, updated in real-time

⚙️ Customization
Toggle On/Off – Show/hide with a simple keybind

Position Control – Move the display anywhere on screen

Color Customization – Choose your preferred colors

Auto-Hide – Automatically hides when close to targets

🎮 How It Works
Default Display
text
Spawn: 256 blocks (North-West)
Bed: 64 blocks (South)
Setup
Install the mod

Join any world

Set your bed by sleeping

The mod automatically detects both locations

Key Features in Action
Night Exploration – Never get lost in the dark

Building Projects – Perfect for large-scale constructions

Adventure Maps – Essential for custom maps and challenges

Hardcore Mode – Critical for survival planning

🔧 Technical Details
Requirements
Minecraft: 1.16.5

Forge: 36.2.34 or newer

Client-side Only – Safe for any server

Performance
Minimal Impact – Less than 1% FPS loss

Efficient Updates – Only updates when you move

Memory Efficient – No unnecessary calculations

🛠️ Installation
Simple Installation
Download bettercompass-1.16.5-1.0.0.jar

Place in .minecraft/mods/ folder

Launch Minecraft with Forge

For Developers
bash
git clone [repository]
./gradlew build

Output: build/libs/bettercompass-1.0.0.jar

🎯 Use Cases
For Survival Players
Never lose your base – Always find your way back

Plan expeditions – Know exactly how far you’ve traveled

Respawn strategy – Optimize bed placement

For Builders
Large projects – Maintain orientation in massive builds

Symmetric designs – Perfect alignment from spawn

Territory marking – Define build boundaries

For Adventure Maps
Custom objectives – “Find the temple 500 blocks East”

Navigation puzzles – Use distance clues

Race maps – Checkpoint distance tracking

⚡ Performance Optimized
Smart Rendering
Only renders when needed

Minimal texture bindings

Efficient text rendering

Configurable Settings
toml

Toggle features

show_spawn = true
show_bed = true

Display settings

x_position = 5
y_position = 5
scale = 1.0

Auto-hide when close

auto_hide = true
hide_distance = 10
🔄 Compatibility
Works With
✅ OptiFine

✅ JourneyMap

✅ Xaero’s Minimap

✅ Most popular mods

Server Safe
No server installation required

Doesn’t affect gameplay

Pure visual enhancement

📈 Why Better Compass?
Over Standard Compass
Feature Vanilla Compass Better Compass
Distance Display ❌ No ✅ Yes
Bed Tracking ❌ No ✅ Yes
Direction Precision ❌ Basic ✅ Detailed
On-Screen Display ❌ No ✅ Always visible
Over Other Mods
Lightweight – No heavy dependencies

Simple – Just works, no complex setup

Accurate – Uses Minecraft’s own coordinates

🎨 Customization Options
Display Modes
Simple – Just distance

Standard – Distance + direction

Detailed – Distance + direction + coordinates

Color Themes
Default – Blue for spawn, Orange for bed

Custom – Any hex color you prefer

Themed – Match your resource pack

🚀 Quick Start Guide
Install the mod

Join any world

Sleep in a bed to set it

Travel away from spawn/bed

Watch the distances update in real-time!

🔍 Technical Implementation
How It Calculates
Distance – Pythagorean theorem in 3D space

Direction – Trigonometric angle calculation

Updates – Only on player movement or config change

Code Architecture
java
// Simple and efficient

1. Subscribe to render events
2. Get player and target positions
3. Calculate distance and direction
4. Render text on screen

🤝 Community Features
For Modpack Makers
Easy to include in any pack

Configurable defaults

No conflicts with other mods

Translations
Built-in support for multiple languages

Easy to add new translations

Community contributions welcome

📊 Real-World Examples
Scenario 1: Lost in a Cave
text
Before: “Where am I? Which way is out?”
After: “Spawn: 128 blocks (North-East) – Got it!”
Scenario 2: Base Building
text
Before: “How far is my farm from spawn?”
After: “Farm: 64 blocks (West) – Perfect distance!”
Scenario 3: Nether Portal Linking
text
Before: “Will this portal link correctly?”
After: “Overworld spawn: 256 blocks – Math checks out!”
🛡️ Safety & Privacy
No Data Collection
✅ No analytics

✅ No telemetry

✅ No internet connection required

✅ 100% offline functionality

No Game Modification
Doesn’t change game mechanics

Doesn’t affect mob spawning

Doesn’t modify world generation

Pure visual enhancement only

🔮 Future Updates Planned
✅ Current: Spawn and bed tracking

🔄 In Development: Lodestone compass support

📋 Planned: Waypoint system

💡 Ideas: Coordinate sharing between players

❓ FAQ
Q: Does this work in multiplayer?
A: Yes! Works on any server without server-side installation.

Q: Will this affect my FPS?
A: Minimal impact (1-2 FPS at most).

Q: Can I move the display?
A: Yes, fully configurable position.

Q: Does it work with shaders?
A: Yes, compatible with all shader packs.

Q: How accurate is it?
A: 100% accurate – uses Minecraft’s coordinate system.

📜 License
MIT License – Free to use, modify, and distribute.

Links
Discord: https://discord.gg/rneQAppRMc