{"url":"https://levimc.org/mods/github.com/MiracleForest/NaturesLodestone/","tooth":"github.com/MiracleForest/NaturesLodestone","name":"NaturesLodestone","description":"Nature's Compass for Minecraft Bedrock Edition: pick a biome and a compass leads you to it","owner":"MiracleForest","icon":"https://avatars.githubusercontent.com/MiracleForest?s=144","repository":"https://github.com/MiracleForest/NaturesLodestone","issues":"https://github.com/MiracleForest/NaturesLodestone/issues","releases":"https://github.com/MiracleForest/NaturesLodestone/releases","stars":0,"updated":"2026-11-01T15:24:11Z","published":"2026-10-29T06:48:44Z","created":"2026-10-27T23:49:42Z","license":"LGPL-3.0","categories":["utility","adventure"],"platforms":["levilamina"],"env":["server","client"],"gameVersions":["1.26.51"],"tags":["platform:levilamina","type:mod","server","client","category:utility","category:adventure","biome","compass"],"latest":{"variant":"","version":"0.1.1","install":"lip install github.com/MiracleForest/NaturesLodestone@0.1.1"},"readmes":[{"file":"README.md","lang":"en","text":"# NaturesLodestone\n\n[![Build](https://github.com/MiracleForest/NaturesLodestone/actions/workflows/build.yml/badge.svg)](https://github.com/MiracleForest/NaturesLodestone/actions/workflows/build.yml)\n[![License](https://img.shields.io/github/license/MiracleForest/NaturesLodestone)](COPYING.LESSER)\n\nFind any biome with a compass. NaturesLodestone brings Chaosyr's Java mod [Nature's Compass](https://modrinth.com/mod/natures-compass) to Bedrock, for dedicated servers and single-player worlds.\n\n<img src=\"docs/showcase/search.webp\" alt=\"Select Biome in Nature's Compass' layout, a desert search and the HUD showing where it was found\" width=\"960\">\n\nMore pictures and clips are in [docs/showcase](docs/showcase).\n\n## Using the compass\n\n**Craft it** on a crafting table: a compass in the middle, logs on the four sides and four saplings of one kind in the corners.\n\n| What you do | What happens |\n| --- | --- |\n| Right-click (in the air or on a block) | Opens **Select Biome**. |\n| Sneak + right-click | Stops the search and resets the compass. Works on a broken compass too. |\n| Hold it | The HUD in the top-left corner shows the compass's status, and the needle points to the biome it found. Before a search, the needle points to the world spawn. |\n\n**Select Biome** lists every biome the world can generate. Each row shows the biome's dimension, tags, source and XP cost.\n\n- **Search box.** Filters by name. `$forest` filters by tag, `@minecraft` by source.\n- **Sort By** cycles through Name, Source, Tags, Dimension, Levels, Rainfall and Temperature.\n- **Choose a biome.** Click it, then **Search**, or click it again. A search costs the biome's XP levels (nothing in creative). Biomes you can't afford are greyed out.\n- **Search for Next** finds another patch of the biome you found, one that isn't connected to any earlier find. Turn it off with `maxNextSearches: 0`.\n- **Teleport** takes you to the biome you found, at a safe height. Only operators, or players in a world with cheats on, can use it, and only while `allowTeleport` is on. If the chunks there aren't loaded yet, you wait above them until they are (at most 20 s).\n- **Cancel** closes the screen.\n\nThe search runs on the server, a little every tick, spiralling out from where you stand. While it runs, the HUD shows **Searching** and the radius. When it ends, the HUD shows **Found** with the coordinates and your distance (with `displayCoordinates`), or **Not Found** with the radius and the number of samples.\n\nWith `compassDurability` set, every successful search (outside creative) wears the compass down, and the durability bar shows how much is left. A broken compass can't search. Repair it on a crafting table: Nature's Compass + compass gives you a fresh one.\n\n### Servers, clients and vanilla players\n\n| Where | Select Biome | HUD | Needle |\n| --- | --- | --- | --- |\n| Single-player (client mod) | yes | drawn by the mod | animated |\n| Dedicated server, player with the client mod | yes | drawn by their mod | animated |\n| Dedicated server, vanilla player | yes | drawn by the server's resource pack | static icon |\n\n## Install\n\nYou need Minecraft Bedrock Edition **1.26.51** for Windows (x64) with LeviLamina **26.51.x** (on a client, installed through [LeviLauncher](https://github.com/LiteLDev/LeviLauncher)).\n\nWith [lip](https://github.com/LiteLDev/lip) 0.35.0 or later:\n\n```sh\nlip install github.com/MiracleForest/NaturesLodestone           # dedicated server\nlip install github.com/MiracleForest/NaturesLodestone#client    # client\n```\n\nOr download the zip from the [latest release](https://github.com/MiracleForest/NaturesLodestone/releases/latest) and extract it next to `LeviLamina/`:\n\n| Where | Zip | Folder |\n| --- | --- | --- |\n| Dedicated server | `natureslodestone-server-windows-x64.zip` | `plugins/NaturesLodestone/` |\n| Client (LeviLauncher) | `natureslodestone-client-windows-x64.zip` | `mods/NaturesLodestone/` |\n\n## Commands\n\n| Command | Who | What it does |\n| --- | --- | --- |\n| `/naturescompass reload` | Operators, console | Reloads the configuration and translations. |\n| `/naturescompass selftest [\"glob\"]` | Operators, console | Runs the in-game selftests. |\n\n`/natureslodestone` is an alias of `/naturescompass`. Nature's Compass has no commands. The other sub-commands (`damage`, `gui`, `hud`, `needle`) are debug tools for the tests. They are listed in [docs/SPEC.md](docs/SPEC.md#6-commands).\n\n## Configuration\n\nSettings live in `config/*.json` inside the mod folder (`plugins/NaturesLodestone/` or `mods/NaturesLodestone/`). Each file is created with defaults on first start.\n\n| File | Setting | Default | Meaning |\n| --- | --- | --- | --- |\n| `mod.json` | `language` | `en_US` | Language of server messages when a player's own language has no translation. |\n| | `usePlayerLocale` | `true` | Use each player's game language when a translation exists. |\n| | `requireResourcePack` | `true` | Dedicated server: players must accept the resource pack to join. |\n| `naturescompass.json` | `allowTeleport` | `true` | Operators and players in worlds with cheats can teleport to a located biome. |\n| | `maxNextSearches` | `25` | 0 to 10000. 0 hides \"Search for Next\", so the compass always locates the nearest biome. |\n| | `displayCoordinates` | `true` | Show the coordinates and distance of a located biome on the HUD. |\n| | `radiusModifier` | `2500` | 0 to 1000000. The maximum search radius is 4 × this, in blocks. |\n| | `sampleSpaceModifier` | `16` | 0 to 1000000. The distance between two samples is 4 × this, in blocks. Lower is more accurate and slower. |\n| | `biomeBlacklist` | `[]` | Biome ids that can't be searched for. `*` matches any characters, `?` one character, e.g. `\"minecraft:*ocean*\"`. |\n| | `defaultXpLevels` | `0` | 0 to 3. XP levels a search costs. |\n| | `perBiomeXpLevels` | `[]` | `\"biome_id,levels\"` entries that override `defaultXpLevels` (wildcards allowed, at most 3 levels), e.g. `\"minecraft:deep_dark,3\"`. |\n| | `maxSamples` | `50000` | 0 to 1000000. Maximum samples one search takes. |\n| | `compassDurability` | `0` | 0 to 10000. Successful searches before the compass breaks and must be repaired. 0 disables durability. |\n| `naturescompass_client.json` | `displayWithChatOpen` | `true` | Show the HUD lines while the chat is open. |\n| | `fixBiomeNames` | `true` | Add missing spaces to biome names in the list (\"ForestHills\" becomes \"Forest Hills\"). |\n| | `overlayLineOffset` | `1` | 0 to 50. Line offset of the HUD lines. |\n| | `overlaySide` | `LEFT` | `LEFT` or `RIGHT`: the side of the screen for the HUD lines. |\n\n`naturescompass.json` is the Nature's Compass \"General\" section. `naturescompass_client.json` is its \"Client\" section. In single-player, the client mod reads both. On a dedicated server, the server's `naturescompass_client.json` controls the HUD it sends to vanilla players (and the biome name fixing in Select Biome). Players with the client mod use their own copy for their HUD. `/naturescompass reload` applies changes.\n\n## Differences from Nature's Compass\n\nNaturesLodestone matches Nature's Compass 3.3.1 everywhere except where Bedrock forces a difference. The full list is in [docs/SPEC.md](docs/SPEC.md) (sections 1.3 and 8).\n\n- **Select Biome is a form.** The server sends it, so vanilla players can use it too. With the resource pack (single-player, and servers with `requireResourcePack`) it is drawn in NC's layout. The search box opens a small input and filters when you confirm it, not on every key. Players without the pack get a plain form with the same contents.\n- **Vanilla players on a server.** The HUD is sent as a title that the resource pack draws in the same place. It can't hide itself while the chat is open, and it can replace a normal title that is on screen when the HUD changes. The needle is a static icon.\n- **One search per compass.** In NC, one player's search cancels another's.\n- **Saplings.** All four saplings in the recipe must be of the same kind.\n- **Teleporting into unloaded chunks** waits until they have loaded.\n- **Durability** shows as Bedrock's durability bar.\n- **Biome ids** are Bedrock's (for example `minecraft:roofed_forest` is Dark Forest). Names and tags follow Java.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). [AGENTS.md](AGENTS.md) is the developer guide.\n\n## Credits\n\nNaturesLodestone reproduces the behaviour of [Nature's Compass](https://github.com/MattCzyr/NaturesCompass) by Chaosyr. It copies no code or assets from it.\n\n## License\n\n[LGPL-3.0-or-later](COPYING.LESSER)\n"}],"gallery":[{"kind":"video","src":"/mods/showcase/MiracleForest/NaturesLodestone/search.mp4","poster":"/mods/showcase/MiracleForest/NaturesLodestone/search-poster.webp","width":1280,"height":720,"title":{"en":"Pick a biome, the compass finds it","zh-CN":"选一个生物群系，罗盘替你找到"},"caption":{"en":"Right-click the compass, filter Select Biome for \"desert\", pick it and press Search. The HUD shows the desert's coordinates and how far away it is.","zh-CN":"右键罗盘，在“选择生物群系”里筛选 desert，选中后点击搜索。HUD 随即显示沙漠的坐标和距离。"}},{"kind":"video","src":"/mods/showcase/MiracleForest/NaturesLodestone/needle.mp4","poster":"/mods/showcase/MiracleForest/NaturesLodestone/needle-poster.webp","width":1280,"height":720,"title":{"en":"The needle points the way","zh-CN":"指针指明方向"},"caption":{"en":"Turn around and the needle keeps pointing at the biome it found, like a vanilla compass points at the spawn.","zh-CN":"原地转一圈，指针始终指向找到的生物群系，就像原版指南针指向出生点。"}},{"kind":"video","src":"/mods/showcase/MiracleForest/NaturesLodestone/teleport.mp4","poster":"/mods/showcase/MiracleForest/NaturesLodestone/teleport-poster.webp","width":1280,"height":720,"title":{"en":"Teleport there","zh-CN":"一键传送"},"caption":{"en":"Operators and players in worlds with cheats can teleport to the biome. They land at a safe height, even if its chunks were not loaded yet.","zh-CN":"管理员或开启作弊的世界中的玩家可以直接传送过去，落在安全的高度，目标区块尚未加载也没问题。"}},{"kind":"image","src":"/mods/showcase/MiracleForest/NaturesLodestone/select-biome.webp","width":1280,"height":720,"title":{"en":"Every biome of the world","zh-CN":"世界中的每一个生物群系"},"caption":{"en":"Select Biome lists every biome the world can generate. Filter it by name, by $tag or by @source, sort it seven ways, and see what a search costs in XP levels.","zh-CN":"“选择生物群系”列出世界能生成的所有生物群系：可按名称、$标签或 @来源筛选，有七种排序方式，并显示每次搜索消耗的经验等级。"}},{"kind":"image","src":"/mods/showcase/MiracleForest/NaturesLodestone/hud-found.webp","width":1280,"height":720,"title":{"en":"Found, with coordinates and distance","zh-CN":"已发现：坐标与距离"},"caption":{"en":"While you hold the compass, the HUD shows its status, the biome, the coordinates and your live distance. Players without the client mod see the same block, drawn by the server's resource pack.","zh-CN":"手持罗盘时，HUD 显示状态、生物群系、坐标和实时距离。没有安装客户端模组的玩家也能看到同样的信息，由服务器的资源包绘制。"}},{"kind":"image","src":"/mods/showcase/MiracleForest/NaturesLodestone/hud-found-next.webp","width":1280,"height":720,"title":{"en":"Search for Next","zh-CN":"搜索下一个"},"caption":{"en":"Search for Next finds another desert, one that is not part of a desert found before.","zh-CN":"“搜索下一个”会找到另一片沙漠，它与之前找到的沙漠互不相连。"}}],"variants":[{"label":"","versions":["0.1.1"]},{"label":"client","versions":["0.1.1"]}],"versions":[{"version":"0.1.1","prerelease":false,"released":"2026-11-01T15:24:11Z","releaseUrl":"https://github.com/MiracleForest/NaturesLodestone/releases/tag/v0.1.1","manifestUrl":"https://github.com/MiracleForest/NaturesLodestone/blob/v0.1.1/tooth.json","info":{"name":"NaturesLodestone","description":"Nature's Compass for Minecraft Bedrock Edition: pick a biome and a compass leads you to it","tags":["platform:levilamina","type:mod","server","client","category:utility","category:adventure","biome","compass"],"avatar_url":""},"variants":[{"label":"","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina":"26.51.*"},"leviLamina":"26.51.*","install":"lip install github.com/MiracleForest/NaturesLodestone@0.1.1"},{"label":"client","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina#client":"26.51.*"},"leviLamina":"26.51.*","install":"lip install github.com/MiracleForest/NaturesLodestone#client@0.1.1"}]}],"dependencies":{"github.com/liteldev/levilamina":{"tooth":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[]}