# BMAPS 2.0.0-ALPHA.build.002 > ⚠️ Still **alpha**. Expect bugs and breaking changes between builds. ## Messages - Introduced `messages.yml`, generated on first startup, containing every chat message (including the prefix) in **MiniMessage format** - Fully reloadable at runtime via `/bmaps reload` — no server restart needed to change wording or colors - Internally, error handling was restructured so each error carries a structured reason instead of hardcoded text, making all messages consistently editable through the new file

# BMAPS 2.0.0 (Alpha) > ⚠️ This is an **alpha release**. Expect bugs, breaking changes, and incomplete features. Not recommended for production servers yet. ## Overview Complete rewrite of BMAPS as a modern, modular navigation plugin. Players can browse an in-game menu of categories (e.g. states/regions/cities) and teleport to warps inside them. No more YAML-based city/warp management — everything now runs on SQLite. ## Architecture - Rebuilt as a multi-module Gradle project (`core` + `paper`, more platforms planned) - `core` module is fully platform-agnostic (no Bukkit/Paper dependencies) so future modules (Fabric, Velocity, etc.) can reuse the same data layer and business logic - Built for Paper 1.21.8+, Java 21, with Folia support - Native Paper Brigadier command system (no legacy `plugin.yml`/`onCommand`) ## Data & Storage - Switched from YAML files to SQLite, connected through a HikariCP connection pool - Single `nodes` table holds both categories and warps, linked via `parent_id` — supports **unlimited nesting depth** (e.g. State → County → City → Warp) - Automatic schema migrations on startup (e.g. added `permission` column without breaking existing databases) ## In-Game GUI - `/bmaps` opens a navigable inventory menu - Click a category to go deeper, click a warp to teleport (uses `teleportAsync`, Folia-safe) - Back button to return to the parent category - Pagination: categories with more than 45 entries automatically get Previous/Next Page buttons, no menu reopening needed ## Bedrock / Geyser Support - Added optional Floodgate integration (soft dependency, plugin works fine without it) - Bedrock players automatically get a native Cumulus form menu instead of the Java inventory GUI - Same permission filtering and pagination logic as the Java GUI ## Permissions Per Node - Categories and warps can now have an optional permission node attached - Players without the required permission simply don't see the entry — including everything nested inside a locked category (implicit inheritance through navigation) ## Admin Commands All admin commands require the `bmaps.admin` permission (default: op). - `/bmaps addcategory <path>` — creates categories along a path, auto-creating missing parents (`mkdir -p` style); icon = held item - `/bmaps addwarp <path>` — creates a warp at your current position; last path segment is the warp name; icon = held item - `/bmaps updatecategory <path>` — updates a category's icon (held item) - `/bmaps updatewarp <path>` — updates a warp's icon (held item) - `/bmaps setdescription <path> <text>` — sets/clears a description (`-` or `clear` removes it) - `/bmaps setpermission <path> <permission|clear>` — sets/removes a required permission node - `/bmaps move <from> <to>` — moves and/or renames a node, with cycle protection and collision protection - `/bmaps removenode <path>` — deletes a node and all its children (cascading) - `/bmaps reload` — reloads the navigation tree from the database ## Known Limitations / Not Yet Implemented - No Velocity module yet (planned after other platform modules) - No Fabric/Forge/NeoForge/Quilt/BungeeCord modules yet - No text-based `/bmaps list` command (tree is only browsable via the GUI)

- Hotfixes

- Hotfixes

## Update 1.0.3 - The Folia Update - Added [**Folia**](https://modrinth.com/discover/plugins?g=categories:folia) Support

## Update 1.0.2 (Update Checker) - The Update Checker - Added an Updatechecker

## Update 1.0.2 - The Language Update - Added a new Directory `configs` with the files `config-en.yml` and `config-de.yml`

## Version 1.0.1 - The Logic Update 🛠️ This update focuses on fixing the message system and improving the internal command logic to make management even smoother. ### ✨ Improvements * **Smarter Command Logic**: The plugin now perfectly distinguishes between "City" and "Warp" actions. * **Dynamic Messages**: Added specific feedback for creating or removing warps, so you always know exactly what happened. * **Enhanced Safety**: Improved argument checks to prevent errors when a command is typed incompletely. ### 🐛 Bug Fixes * **Placeholder Fix**: Resolved an issue where `%city%` or `%target%` were not correctly replaced in chat messages. * **Feedback Correction**: Fixed a bug where creating a warp would incorrectly trigger the "City Created" message. * **Icon Stability**: Optimized the saving process for `CustomModelData` to ensure your icons always show up correctly. --- *Found a bug? Report it on our [GitHub](https://github.com/benyt9/BMAPS)!*

## Version 1.0.0 - The Beginning 🌍 We are excited to release the first version of **BMaps**! ### ✨ Features * **Cross-Platform Support**: Full compatibility for Java and Bedrock (via Geyser). * **Custom Model Data**: Use your own resource pack icons for menu buttons. * **Easy Management**: Add, update, and remove cities or warps directly in-game. * **Localization**: Fully customizable `config.yml` for all messages and titles. ### 🛠️ Technical Changes * Added reflection-based Bedrock UI to ensure stability across different Geyser versions. * Implemented automatic icon saving from the player's main hand. --- *Found a bug? Report it on our [GitHub](https://github.com/benyt9/BMAPS)!*