Safepaths (MineColonies)

🌿 Safepaths (MineColonies)

<img src="https://img.shields.io/badge/Patreon-Support_Me-FF424D?style=flat-square&logo=patreon&logoColor=white" alt="Patreon"> <img src="https://img.shields.io/badge/Minecraft-1.21.1%20%7C%201.20.1-228B22?style=flat-square&logo=minecraft&logoColor=white" alt="Minecraft"> <img src="https://img.shields.io/badge/Wiki-Documentation-097979?style=flat-square&logo=github&logoColor=white" alt="Wiki">

Natural, immersive path generation for your Minecraft world.
Repeatedly walk over ground blocks to trample them into paths with custom speed boosts.

Supported editions

| Minecraft | Loader | Java | Release file | | :--- | :--- | :--- | :--- | | 1.21.1 | NeoForge 21.1.235+ | 21 | safepaths-2.0.2-1.21.1-neoforge.jar | | 1.20.1 | Forge 47.3.0+ | 17 | safepaths-2.0.2-1.20.1-forge.jar |

2.0.2 — Stability prevents holes caused by restoring unsupported falling terrain, including paths directly over water. It does not reconstruct blocks already missing.

✨ Features

| Feature | Description | | :--- | :--- | | 🚶 Organic Pathing | Blocks naturally compress into paths the more you walk over them. | | ⚡ Speed-Only Road Blocks | Self-map blocks (A -> A, like stone bricks or gravel) to grant speed boosts without alteration or decay. | | 🔘 Master Speed Switch & Multiplier | Toggle path speed and adjust its global multiplier directly inside the in-game conversion menu. | | 🎨 Visual Palette GUI | In-game visual editor with live search, animated block selection, and smart filters. | | ⏳ Smart Decay | Inactive paths gradually revert to their original block; active paths refresh on traffic. | | 🛡️ Colony Protection | Protects farmland, block entities, and colony blocks; checks MineColonies permissions before changing claimed ground. | | 🏛️ MineColonies Support | Citizens form paths during daily work routines and benefit from speed boosts. | | 🌍 Mod Compatibility | Built-in defaults for vanilla soils, BWG, BOP, and Regions Unexplored, plus the supported vanilla terrain blocks used by Terralith and Geophilic. | | 🌐 9 Languages | English, German, Spanish, French, Japanese, Russian, Chinese, Turkish, Portuguese. |

📖 Documentation & Wiki

Comprehensive documentation is hosted on the Safepaths GitHub Wiki and maintained in the wiki/ directory on main for both editions:

| Guide | Description | | :--- | :--- | | 🚀 Getting Started (Wiki) | Prerequisites, singleplayer & dedicated server installation, first steps. | | ⚙️ Core Mechanics (Wiki) | Step tracking (getOnPos), construction time windows, decay restoration, chunk persistence. | | ⚡ Speed Boosts & Roadways (Wiki) | Speed modifiers, 15-tick smoothing grace window, self-mapping speed roadways (A -> A). | | 🎨 In-Game GUI & Palette (Wiki) | In-game conversion editor, live search, visual block palette, international decimal support. | | 📝 Configuration Reference (Wiki) | Full property definitions for safepaths-common.toml, tick conversions, and tuning presets. | | 🏷️ Block & Entity Tags (Wiki) | Datapack tags for pathable blocks, protected areas, and NPC path creator entities. | | 🌐 Compatibility & Integrations (Wiki) | Integration with MineColonies, biomes mods (BWG, BOP, RU), Terralith, and Geophilic. | | ❓ FAQ & Troubleshooting (Wiki) | Performance considerations, chunk loading behavior, common questions, bug reports. |

⚙️ Configuration

Access in-game via Mods ➔ Safepaths ➔ Config, or edit config/safepaths-common.toml: