BMAPS (Java & Bedrock)

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

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)!