# \ud83c\udf3f Natural Compass \u2014 Plugin Recreation of Nature’s Compass (by Chaosyr)<\/p>\n
\n<\/p>\n
**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.<\/p>\n
Supports **vanilla, datapack, and modded biomes** (Terralith, Incendium), **all dimensions**, and **Bedrock players via Geyser**.<\/p>\n
<\/p>\n
## \ud83d\ude80 Quick Installation<\/p>\n
\n
\n
\n<\/p>\n
1. \ud83d\udce5 Download the `.jar`
\n2. \ud83d\udcc2 Place in `plugins\/`
\n3. \ud83d\udd01 Restart server
\n4. \ud83e\udded Craft\/give yourself a **Natural Compass** and explore!<\/p>\n
<\/p>\n
### \u26a0\ufe0f\u26a0\ufe0f\u26a0\ufe0f Server Admin Note \u2014 Bedrock Resource Pack \u26a0\ufe0f\u26a0\ufe0f\u26a0\ufe0f<\/p>\n
The Bedrock resource pack was generated using **Rainbow** (client-side Fabric mod) to create Geyser **Custom Item API v2** mappings.<\/p>\n
* **Rainbow:** GitHub \u2014 used to build the pack, **not a plugin dependency**
\n* **Requirement:** Your server must use a **Geyser fork with Custom API v2** for textures\/icons to display properly<\/p>\n
> Without this setup, Bedrock players can still use the compass \u2014 textures and visual features will not appear.<\/p>\n
<\/p>\n
### Java Edition
\n
\n\u2014 Animated compass needle, ready for Java Edition V1.1-SNAPSHOT.<\/p>\n
### Bedrock Edition
\n
\n\u2014 Requires **Geyser + Custom API v2** to work on Bedrock V1.0-SNAPSHOT.<\/p>\n
<\/p>\n
## \ud83e\udded Main Features<\/p>\n
### \ud83d\udd39 Biome Locator<\/p>\n
* Search **any biome**: vanilla, datapack, or modded
\n* Works in **Overworld, Nether, End**
\n* Fully compatible with **Java & Bedrock (Geyser)**<\/p>\n
<\/p>\n
### \ud83c\udfa8 Compass Texture<\/p>\n
* Original Nature’s Compass texture by Chaosyr
\n* Single texture for all compass tiers
\n* **Java resource pack** included (animated needle)
\n* **Bedrock pack** compatible via Geyser Custom API v2<\/p>\n
<\/p>\n
### \ud83d\udcc2 Customizable Compass Tiers<\/p>\n
| Tier | Default Range | Recipe |
\n| —- | ————- | —————————— |
\n| I | 1,000 blocks | Moss Block + Diamond + Compass |
\n| II | 2,500 blocks | Heart of the Sea + Tier I |
\n| III | 5,000 blocks | Amethyst Cluster + Tier II |
\n| IV | 10,000 blocks | Echo Shard + Tier III |
\n| V | 25,000 blocks | Nether Star + Tier IV |<\/p>\n
> Recipes fully configurable in `config.yml`.<\/p>\n
<\/p>\n
### \ud83d\udda5 In-Game Interface & Visuals<\/p>\n
* **Biome Selection GUI** by provider
\n* **Search messages**: “searching” & “biome found”
\n* **Visual Indicators**: Compass points, ActionBar\/BossBar, optional coordinates
\n* **Biome & Provider Icons**: Grass Block, Snow Block, custom heads<\/p>\n
<\/p>\n
### \ud83d\udd8c\ufe0f Customizing Biome & Provider Icons<\/p>\n
#### Biome Icons (`biomes.yml`)<\/p>\n
“`yaml
\nminecraft:sunflower_plains:
\n icon: SUNFLOWER
\n dimension: overworld
\n“`<\/p>\n
* Replace `icon` with any valid Minecraft item\/block ID
\n* Add new biomes by copying an entry and updating ID, name, icon, dimension<\/p>\n
#### Provider Icons (`providers.yml`)<\/p>\n
“`yaml
\nterralith:
\n icon: PLAYER_HEAD
\n texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZGVhNjExOGI4ZjVlMTI5MjE0Mzc5MTI4Yzc4MmNmYWE0ZDM0ZTVjZmE3YjkyZmIwM2JiNjk2ZjRmZGJhMDBlZSJ9fX0=
\n“`<\/p>\n
* Replace Base64 string to change icon
\n* Add new providers with `display_name` + `icon`
\n* Reload plugin: `\/naturalcompass reload`<\/p>\n
<\/p>\n
### \ud83d\udd10 Permissions<\/p>\n
| Permission | Description | Default |
\n| ———————– | ———————————– | ——- |
\n| `naturalcompass.use` | Use the compass | \u2705 true |
\n| `naturalcompass.craft` | Craft\/upgrade compasses | \u2705 true |
\n| `naturalcompass.admin` | Admin commands (reload, GUI access) | \u274c op |
\n| `naturalcompass.reload` | Reload config | \u274c op |<\/p>\n
<\/p>\n
### \ud83d\udccc Commands<\/p>\n
* `\/naturalcompass reload` \u2014 Reload configuration *(admin)*
\n* `\/naturalcompass admin` \u2014 Open admin GUI *(admin)*
\n* Aliases: `nc`<\/p>\n","protected":false},"excerpt":{"rendered":"
Natural Compass is a plugin adaptation of the popular Forge\/Fabric mod Nature\u2019s Compass by Chaosyr. It brings that mod\u2019s biome-searching functionality to Spigot\/Paper servers.<\/p>\n","protected":false},"featured_media":108843,"template":"","meta":{"_minecraft_slug":"natural-compass","_minecraft_project_id":"uTWZwCXZ","_minecraft_author":"ConstantMC","_minecraft_license":"MIT","_minecraft_downloads":708,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"natural-compass.zip","_minecraft_size_bytes":2615334,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T09:08:48.475470Z","_minecraft_date_created":"2025-11-06T09:18:47.791937Z","_minecraft_date_modified":"2025-12-25T16:37:51.651342Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/natural-compass","_minecraft_icon_attachment_id":108843,"_minecraft_imported_at":"2026-06-06T07:12:43+00:00","_minecraft_import_hash":"05cc473e3e7b5d7fdc582921636f958e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,88,89,1003,6,127,128,129,92,159],"mod_loader":[130,1004,9,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-108842","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-geyser","mod_category-minecraft","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_category-worldgen","mod_loader-bukkit","mod_loader-geyser","mod_loader-minecraft","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n