🌿 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 ✨ (client-side Fabric mod) to create Geyser Custom Item API v2 mappings.

• ✨: 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