🌿 Natural Compass — Plugin Recreation of Nature's Compass (by Chaosyr)
Natural Compass is a Spigot/Paper plugin that brings biome-searching functionality to Minecraft servers, recreating the popular Forge/Fabric mod Nature's Compass by Chaosyr.
Supports vanilla, datapack, and modded biomes (Terralith, Incendium), all dimensions, and Bedrock players via Geyser.
🚀 Quick Installation
- 📥 Download the
.jar - 📂 Place in
plugins/ - 🔁 Restart server
- 🧭 Craft/give yourself a Natural Compass and explore!
⚠️⚠️⚠️ Server Admin Note — Bedrock Resource Pack ⚠️⚠️⚠️
The Bedrock resource pack was generated using Rainbow (client-side Fabric mod) to create Geyser Custom Item API v2 mappings.
- Rainbow: GitHub — used to build the pack, not a plugin dependency
- Requirement: Your server must use a Geyser fork with Custom API v2 for textures/icons to display properly
Without this setup, Bedrock players can still use the compass — textures and visual features will not appear.
Java Edition
— Animated compass needle, ready for Java Edition V1.1-SNAPSHOT.
Bedrock Edition
— Requires Geyser + Custom API v2 to work on Bedrock V1.0-SNAPSHOT.
🧭 Main Features
🔹 Biome Locator
- Search any biome: vanilla, datapack, or modded
- Works in Overworld, Nether, End
- Fully compatible with Java & Bedrock (Geyser)
🎨 Compass Texture
- Original Nature's Compass texture by Chaosyr
- Single texture for all compass tiers
- Java resource pack included (animated needle)
- Bedrock pack compatible via Geyser Custom API v2
📂 Customizable Compass Tiers
| Tier | Default Range | Recipe |
|---|---|---|
| I | 1,000 blocks | Moss Block + Diamond + Compass |
| II | 2,500 blocks | Heart of the Sea + Tier I |
| III | 5,000 blocks | Amethyst Cluster + Tier II |
| IV | 10,000 blocks | Echo Shard + Tier III |
| V | 25,000 blocks | Nether Star + Tier IV |
Recipes fully configurable in
config.yml.
🖥 In-Game Interface & Visuals
- Biome Selection GUI by provider
- Search messages: "searching" & "biome found"
- Visual Indicators: Compass points, ActionBar/BossBar, optional coordinates
- Biome & Provider Icons: Grass Block, Snow Block, custom heads
🖌️ Customizing Biome & Provider Icons
Biome Icons (biomes.yml)
minecraft:sunflower_plains:
icon: SUNFLOWER
dimension: overworld
- Replace
iconwith any valid Minecraft item/block ID - Add new biomes by copying an entry and updating ID, name, icon, dimension
Provider Icons (providers.yml)
terralith:
icon: PLAYER_HEAD
texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZGVhNjExOGI4ZjVlMTI5MjE0Mzc5MTI4Yzc4MmNmYWE0ZDM0ZTVjZmE3YjkyZmIwM2JiNjk2ZjRmZGJhMDBlZSJ9fX0=
- Replace Base64 string to change icon
- Add new providers with
display_name+icon - Reload plugin:
/naturalcompass reload
🔐 Permissions
| Permission | Description | Default |
|---|---|---|
naturalcompass.use |
Use the compass | ✅ true |
naturalcompass.craft |
Craft/upgrade compasses | ✅ true |
naturalcompass.admin |
Admin commands (reload, GUI access) | ❌ op |
naturalcompass.reload |
Reload config | ❌ op |
📌 Commands
/naturalcompass reload— Reload configuration (admin)/naturalcompass admin— Open admin GUI (admin)- Aliases:
nc
