Logo
Natural Compass
PluginMIT

Natural Compass

Natural Compass is a plugin adaptation of the popular Forge/Fabric mod Nature’s Compass by Chaosyr. It brings that mod’s biome-searching functionality to Spigot/Paper servers.

304
Downloads
3
Followers
3 months ago
Updated
📦
3
Versions
adventureequipmentworldgenbukkitgeyserminecraftpaperpurpurspigot
Download Latestv1.2-SNAPSHOTView on Modrinth

📖About Natural Compass

🌿 Natural Compass — Plugin Recreation of Nature's Compass (by Chaosyr)

GitHub
Sponsor

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.

image

🚀 Quick Installation

Paper
Purpur
Bukkit
Spigot

  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.

Without this setup, Bedrock players can still use the compass — textures and visual features will not appear.


Java Edition

Java Resource Pack
— Animated compass needle, ready for Java Edition V1.1-SNAPSHOT.

Bedrock Edition

Bedrock Resource Pack
— 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