🧭 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