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)