GeoCompass
Exploration Compass Plugin for Survival Servers
Exploration Compass Plugin for Survival Servers
Overview
GeoCompass adds a custom compass that turns mining into exploration gameplay.
- Right-click survey of nearby chunks
- Rare mineral directional tracking while holding the compass
- First-discovery server announcements with optional rewards
- Optimized with async scan + ChunkSnapshot + TTL cache
Compatibility
- Supported versions: 1.20.1 - 1.21.8
- Platform: Paper / Spigot-compatible servers
- API baseline: 1.20.1
Main Features
1.Survey Mode (Right Click)
- Scans configured chunk radius around player
- Counts configured whitelist blocks (`survey.probe-blocks`)
- Display modes: CHAT / ACTIONBAR / real BOSSBAR
- Per-area cache with configurable TTL (`survey.cache-ttl-ms`)
2. Rare Mineral Tracking
- Passive detection every configured interval
- Direction + distance hint output
- Real BossBar tracking mode supported
- Independent "recent tracking valid window" (`tracking.recent-valid-seconds`)
3. First Discovery Broadcast
- Announces when a player mines tracked ore under valid tracking context
- Discovery records stored in SQLite (async writer)
- Optional reward commands via console execution
4. Customization
- Item visuals: `item.name`, `item.lore`, `item.custom-model-data`
- Language: fully configurable in `lang.yml`
- World-specific minerals: `worlds.world-minerals`
- Dimension defaults: `tracking.dimension-defaults` (overworld/nether/end)
Spoiler: Image Preview
![[IMG]](//proxy.spigotmc.org/ccea2b2175610cb8f071b4c40702bec336d9f2db/68747470733a2f2f692e6962622e636f2f47763939396a6d7a2f323032362d30332d30382d31372d31392d30352e706e67)
![[IMG]](//proxy.spigotmc.org/57cce5a53b190b5d779bc91ff1538b848ab5f788/68747470733a2f2f692e6962622e636f2f3233425a316862312f323032362d30332d30382d31372d31392d35322e706e67)
![[IMG]](//proxy.spigotmc.org/38d8ea6392a7654464cfbd4c1fa87214be42c2d3/68747470733a2f2f692e6962622e636f2f527272474e705a2f515132303236303330382d3137323130362e706e67)
![[IMG]](//proxy.spigotmc.org/ad383c6c358f2268347d15a5276d445c91e787f2/68747470733a2f2f692e6962622e636f2f38345862303363792f62623331623361662d366232332d343762622d626266332d3436353333343434393331332e706e67)
What's New in v1.1
- Target Mode GUI
- Added `/gc gui`
- Sneak + right-click compass opens target selection GUI
- Players can switch between Auto mode and specific ore target - Energy / Balance System
- Compass now supports configurable energy
- Survey consumes energy (`item.energy.survey-cost`)
- Max energy configurable (`item.energy.max`) - Tracking Performance Upgrade
- ChunkSnapshot + sampled scan (instead of dense full-cube scan)
- Frame budget: `tracking.players-per-tick`
- Short-lived player grid cache: `tracking.scan-cache-ms`, `tracking.cache-grid-size` - Discovery Storage Upgrade
- Migrated to SQLite (`plugins/GeoCompass/discoveries.db`)
- Async write queue to reduce main-thread I/O pressure
- Indexed query fields for better scalability - Quality Improvements
- Survey radius supports wider configured range
- Faster target lookup using material sets
- Direction labels configurable (`tracking.direction-labels.*`)
Commands
Code (Text):
/geocompass
/gc give <player> [amount]
/gc reload
/gc stats [player]
/gc gui
/gc give <player> [amount]
/gc reload
/gc stats [player]
/gc gui
Permissions
| Permission | Default | Description |
| geocompass.use | true | Use GeoCompass features |
| geocompass.craft | true | Craft GeoCompass recipe |
| geocompass.bypass.cooldown | op | Bypass survey cooldown |
| geocompass.admin.reload | op | Reload config/language |
| geocompass.admin.give | op | Give GeoCompass item |
Installation
- Put the plugin jar in your server `plugins/` folder.
- Start the server once.
- Edit `plugins/GeoCompass/config.yml` and `plugins/GeoCompass/lang.yml`.
- Run `/gc reload` after edits.
Performance Notes
- Survey scanning is asynchronous
- Uses ChunkSnapshot to avoid heavy sync block reads during counting
- Result caching reduces repeated scans in the same area
Data Storage
Discovery data is stored in SQLite:
Code (Text):
plugins/GeoCompass/discoveries.db
Support
If you report an issue, please include:
If you report an issue, please include:
-
Server version and build
-
Plugin version
-
Relevant config sections
-
Console error logs (if any)
If this plugin helps your server, please leave a review.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
GeoCompss | Fun Mineral Exploration Compass is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.21. Downloaded 20 times (via Spigot). Download it and open it directly in the game.