Description
## ๐งญ Just Coordinates - Simple XYZ Display
**A lightweight client-side mod that displays XYZ coordinates, inspired by Bedrock Edition**
No minimap, no extra info โ just your position on screen. Clean and simple.
---
## โจ Features
### ๐บ๏ธ Coordinates HUD
- **Bedrock-Style Display**: Shows coordinates with a gray background and white text
- **Simple Format**: `Position: X, Y, Z` โ exactly what you need, nothing more
- **Client-Side Only**: No server installation required
### ๐ฏ Configurable Position
- **6 Preset Positions**: Top-left (default), top-center, top-right, bottom-left, bottom-center, bottom-right
- **Easy to Open**: Assign a key to "Open Settings" in Controls, or use the **Config** button (Forge/NeoForge Mods screen, or Fabric with [ModMenu](https://modrinth.com/mod/modmenu) installed)
- **Remembers Your Choice**: Saved to `config/justcoordinates.json` when you close the settings screen
### ๐ฎ Smart Visibility
- **Toggle Keybind**: Press `J` to toggle the coordinates HUD on or off (rebindable in Controls settings)
- **Share to Chat**: Run `/justcoordinates share`, or assign a "Share Coordinates" key โ no server permission needed (on Forge 1.16.5 and 1.17.1, the keybind is the only option โ those versions have no client-command API)
- **F3 Compatibility**: Coordinates HUD is automatically hidden while the F3 debug screen is displayed
- **F1 Support**: Follows vanilla HUD behavior โ hidden when HUD is toggled off with F1
---
## ๐ How to Use
1. **Install the Mod**: Drop the jar file into your mods folder
2. **Launch the Game**: Coordinates appear automatically in the top-left corner โ no configuration needed
3. **Optional**: Open the settings screen anytime to move the HUD to one of 6 preset positions
---
## ๐ ๏ธ Technical Details
### Multi-Loader Support
This mod supports **multiple mod loaders** across many Minecraft versions!
| Minecraft | Fabric | Quilt | NeoForge | Forge |
|-----------|--------|-------|----------|-------|
| 26.2 | Yes | Yes | Yes | Yes |
| 26.1.2 | Yes | Yes | Yes | Yes |
| 26.1.1 | Yes | Yes | Yes | Yes |
| 26.1 | Yes | Yes | Yes | - |
| 1.21.11 | Yes | Yes | Yes | Yes |
| 1.21.10 | Yes | Yes | Yes | Yes |
| 1.21.9 | Yes | Yes | Yes | Yes |
| 1.21.8 | Yes | Yes | Yes | Yes |
| 1.21.7 | Yes | Yes | Yes | Yes |
| 1.21.6 | Yes | Yes | Yes | Yes |
| 1.21.5 | Yes | Yes | Yes | Yes |
| 1.21.4 | Yes | Yes | Yes | Yes |
| 1.21.3 | Yes | Yes | Yes | Yes |
| 1.21.1 | Yes | Yes | Yes | Yes |
| 1.20.1 | Yes | Yes | - | Yes |
| 1.19.2 | Yes | Yes | - | Yes |
| 1.18.2 | Yes | Yes | - | Yes |
| 1.17.1 | Yes | Yes | - | Yes |
| 1.16.5 | Yes | Yes | - | Yes |
Download the correct version for your Minecraft version and mod loader.
### Requirements
- **Fabric**: Fabric Loader + Fabric API
- **Quilt**: Quilt Loader + Fabric API (1.21.9 and earlier)
- **NeoForge**: NeoForge (1.21.1+)
- **Forge**: Forge
- **No additional dependencies** โ just the mod loader and its API
### Compatibility
- Works alongside other mods
- Compatible with performance mods (Sodium, Starlight, etc.)
- Client-side only โ safe for any server
---
## ๐ Bug Reports & Suggestions
Found a bug or have a suggestion? Report it on our [GitHub Issues](https://github.com/ksoichiro/JustCoordinates/issues) page!
---
## ๐ท Screenshots
Check out the **Gallery** above for screenshots of the coordinates HUD in action.
---
## ๐ License & Permissions
**License**: LGPL-3.0 - Copyright (C) 2025 Soichiro Kashima
**Source Code**: Available on [GitHub](https://github.com/ksoichiro/JustCoordinates)
**Freedom to Use**: โ
Free to use, modify, and redistribute under LGPL-3.0 terms
**Modpack Inclusion**: โ
Allowed - You may include this mod in modpacks
**Redistribution**: โ
Allowed - You may redistribute this mod (must remain LGPL-3.0)
---
## ๐ Links
- **GitHub Repository**: [https://github.com/ksoichiro/JustCoordinates](https://github.com/ksoichiro/JustCoordinates)
- **CurseForge**: [Link to CurseForge page]
---
**Simple coordinates, inspired by Bedrock Edition** ๐งญ