Natural Compass

🌿 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

1. 📥 Download the .jar
2. 📂 Place in plugins/
3. 🔁 Restart server
4. 🧭 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 icon with 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