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.

708

Quick challenge

How far can you run before the mobs catch you?

Natural Compass

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

GitHub

Sponsor

biome-searching functionality is a Spigot/Paper plugin that brings biome-searching functionality to Minecraft servers, recreating the popular Forge/Fabric mod biome-searching functionality by Chaosyr.

Supports Bedrock players via Geyser (Terralith, Incendium), Bedrock players via Geyser, 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 Custom Item API v2 (client-side Fabric mod) to create Geyser Custom Item API v2 mappings.

* Requirement: Requirement: — used to build the pack, Requirement: * Requirement: Your server must use a %%MD1%% 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

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 Java & Bedrock (Geyser): vanilla, datapack, or modded * Works in Java & Bedrock (Geyser) * Fully compatible with Java & Bedrock (Geyser)

🎨 Compass Texture

* Original Nature's Compass texture by Chaosyr * Single texture for all compass tiers * Bedrock 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 & Provider Icons by provider * Biome & Provider Icons: "searching" & "biome found" * Biome & Provider Icons: Compass points, ActionBar/BossBar, optional coordinates * Biome & Provider Icons: Grass Block, Snow Block, custom heads

🖌️ Customizing Biome & Provider Icons

Biome Icons (`biomes.yml`)

```yaml 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`)

```yaml 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 |