Direction HUD

Overview

The Direction HUD mod displays useful player information such as facing direction, world time, coordinates, and more directly on the screen. All HUD elements are configurable and can be toggled on or off using commands. The state is saved between game sessions.

Features

Direction Display Shows cardinal (N, S, E, W) and intercardinal directions (NE, NW, SE, SW) in the top left corner.
Minecraft Days Displays the number of days passed in the current world (top left).
Time Display Shows both:
- Real-world time (24-hour format)
- In-game time (12-hour format with AM/PM and sun/moon icons) in the top right corner
Coordinate Display Shows current X, Y, Z coordinates above the hotbar.
Biome Display Shows the current biome next to the coordinates.
Coordinate Saving Save your current location with a custom name and retrieve it later.
Toggleable Features Each HUD element can be enabled or disabled independently using commands.
Persistent Config All preferences and saved coordinates are stored in: config/direction-hud.json
Minimalist UI Clean, readable overlays with subtle backgrounds for visibility.

How It Works

1. Initialization

The mod loads configuration from config/direction-hud.json
Commands are registered using the /dh namespace to avoid conflicts with other mods

2. Direction Calculation

The player’s yaw angle is used to determine direction
The 360° circle is divided into 8 segments (45° each):
- N, NE, E, SE, S, SW, W, NW

3. Rendering

Enabled HUD elements are rendered in their respective screen positions:
- Top Left: Direction + Minecraft days
- Top Right: Time (real + in-game)
- Above Hotbar: Coordinates + biome
Each element includes a semi-transparent background for readability

4. Command Handling

All features are controlled via /dh commands
Changes are saved instantly to the config file

Commands

Direction

/dh direction <on|off> Toggle direction display

Days

/dh days <on|off> Toggle Minecraft days display

Time

/dh time <on|off> Toggle real-world and in-game time display

Coordinates

/dh coords <on|off> Toggle coordinate display

/dh coords save <name> Save current coordinates with a custom name

/dh coords list List all saved coordinates

Biome

/dh biome <on|off> Toggle biome display

Configuration

The mod uses a JSON-based configuration file:

config/direction-hud.json

This file stores:

Enabled/disabled state for each HUD element
Saved coordinates with custom names

Changelog

[3.2.1] - 29-04-2026

Features

Added Minecraft day counter
Added real-world and in-game time display
Added coordinate and biome display
Added coordinate saving and listing system
Introduced per-feature toggles via commands
Migrated config from .properties to .json
Updated command namespace to /dh to avoid mod conflicts

Notes

All settings persist between game sessions
Designed to be lightweight and non-intrusive
Compatible with most Fabric-based modpacks