# 0.4.0-Beta ## New Features & Major Changes - No new modules in this release — this is a reliability and hardening update. ## Fixes & Hardening - **Core:** Module reloads and toggles now handle asynchronous work, persistence and listener/command lifecycles more safely. - **Teleport:** RTP samples random destinations across the configured world area and checks for safe landing spots; search and warmup state handling is more robust. TPA requests and arrival handling were hardened for Paper/Folia scheduling. - **Moderation:** Improved database error handling and consistency during concurrent ban operations; added validation and clearer feedback for self-bans, IP addresses and empty result pages. - **Vanish:** Improved visibility consistency across joins, quits, respawns and other lifecycle events, including Folia scheduling. - **Plugin metadata:** Permission nodes and defaults are now documented in `paper-plugin.yml` alongside the runtime registrations. ## Config Changes - **moderation.yml** includes additional messages for database errors, self-bans, invalid IP addresses and empty pages. - Existing module configuration versions are unchanged; no configuration version migration is required. ## Tested Environments * Paper 26.1.2 (local end-to-end tests with VitaminMCP) It should work on Paper, Purpur and Folia Servers for 1.21.6 to 26.3! Spigot is not supported.

# 0.3.0-Beta ## New Features & Major Changes - **Team Module**: Create and manage player teams, fully config-driven (`modules/team.yml`): - `/team list|info|accept|deny|leave|request|invite|add|kick|setrole|deny-request` — plus `/team requests` and `/team invites` for pending join requests and invites. - **Roles:** MEMBER / ADMIN per team. Members can only leave; everything else needs a team admin. The first member automatically becomes admin, and the last admin can never be removed or demoted (server admins via `plainbase.team.admin` can always step in). - Teams are defined in the config (no create command) — membership, roles, invites and join requests are managed at runtime and stored per player (by UUID), surviving reloads and restarts. - **Vanilla scoreboard mirror:** every team is mirrored to a real scoreboard team (`pb_<id>`), so any command with a target selector works — e.g. `/tp @a[team=pb_red] 0 100 0`. Not available on Folia (scoreboard API unsupported there); everything else works on Folia. - Fine-grained permissions: one node per subcommand under `plainbase.team.*`, usable by every player by default (the team role itself decides who may do what). - **PlaceholderAPI Support**: - Added `%plainbase_team_names%`, `%plainbase_teams_count%`, `%plainbase_team_primary%`, `%plainbase_team_pending_invites%`, `%plainbase_team_role_<team>%` and `%plainbase_team_members_<team>%`. ## Fixes & Hardening - **FirstSpawn** (`/setfirstspawn`) never took effect due to a config-key mismatch — fixed and live-verified. - **Moderation:** ban checks no longer fail open on corrupt database rows, IP addresses are normalized before comparing, self-bans are blocked, and the IP-ban screen now shows the remaining time correctly. - **Teleport:** TPA/RTP state is now Folia-safe (no more cross-region access or thread-unsafe collections), RTP no longer blocks server threads while searching, and spamming `/rtp` during a search or warmup is no longer possible. - **JoinItems:** items no longer duplicate on death and no longer silently overwrite occupied slots; `/clear` re-give only triggers for real clears. - **Vanish:** deaths, advancements, joins and quits of vanished players stay hidden, including across rejoins. - Commands survive `/plainbase reload|toggle` correctly, and pure usage permissions (`/spawn`, `/tpa`, `/rtp`, …) no longer require OP. ## Config Changes - **config.yml** updated to **Version 1.7** (Added configuration entry for the `team` module). - **team.yml** added, **Version 1.2** (New configuration file: team definitions, messages and per-command toggles). ## Tested Environments * Paper 26.1.2 (full end-to-end test with real bots: every module, every command) * Folia 26.2 (team membership/roles/commands live-tested, scoreboard mirror skipped there by design) It should work on Paper, Purpur and Folia Servers for 1.21.6 to 26.2! Spigot is not supported.

# 0.2.0-Beta ## New Features & Major Changes - **Moderation Module**: Added a complete ban/kick system with persistent database storage: - `/ban <player> [reason]` — Permanently ban a player. - `/tempban <player> <duration> [reason]` — Temporarily ban a player (e.g. `1d`, `2h30m`, `7d`). - `/unban <player>` — Revoke an active ban. - `/kick <player> [reason]` — Kick an online player. - `/banip <ip|player> [reason]` — Ban an IP address (raw IP or resolved from a player name). - `/unbanip <ip>` — Revoke an active IP ban. - `/banlist [page]` — List all currently active bans and IP bans. - `/baninfo <player>` — Show ban status, total ban/kick count and the last ban reason. - Everything is stored by the player's **UUID** — name changes can never evade a ban. - Full history is kept forever: total bans, total kicks and the last ban reason stay available even after a ban expires or gets revoked. - **Cross-server ready:** defaults to a local SQLite file (zero setup), or point every server in your network at the same MySQL database and they all enforce the exact same ban/IP-ban list instantly. - IP bans are checked independently of name/UUID bans on every login. - Works for offline players too (pre-emptive bans) — a warning is shown if the target never joined before. - `plainbase.moderation.exempt` protects a player from being banned/kicked by non-admins. - All commands also work from the console, replacing vanilla's `/ban`/`/kick`. - Fully configurable ban/kick/IP-ban/broadcast messages (MiniMessage) in `modules/moderation.yml`. - Fine-grained permissions under `plainbase.moderation.*`. - **PlaceholderAPI Support**: - Added `%plainbase_moderation_bancount%`, `%plainbase_moderation_kickcount%` and `%plainbase_moderation_banned%`. ## Config Changes - **config.yml** updated to **Version 1.6** (Added configuration entry for the `moderation` module). - **moderation.yml** added, **Version 2.0** (New configuration file to manage the Moderation module: storage backend, messages, broadcasts and commands). ## Tested Environments * Paper 26.2 * Folia 26.2 It should work on Paper, Purpur and Folia Servers for 1.21.6 to 26.1.2! Spigot is not supported.

# 0.1.0-Beta ## New Features & Major Changes - **Vanish Module**: Added a complete vanish system: - `/vanish` — Toggle your own vanish state. - * `/vanish <player>` — Toggle vanish for another player. - `/vanish world` — Toggle vanish for all players in your world. - `/vanish all` — Toggle vanish for all online players. - Per-viewer entity visibility and Tab-list hiding. - Optional vanish persistence across re-joins. - Configurable invincibility, no collision, silent movement, projectile pass-through, mob ignoring and join/quit message hiding. - Optional `op-see` functionality. - Thread-safe and Folia-compatible state handling. - Fine-grained permissions under `plainbase.vanish.*`. - - **Menu Module**: Added a lightweight, configuration-driven GUI system: - `/menu new <name>` — Create a menu template. - `/menu delete <name>` — Delete a menu. - `/menu open <name>` — Open a menu. - `/menu list` — List available menus. - Configurable MiniMessage titles and inventory sizes from 9–54 slots. - Optional player inventory display. - Configurable fill material and per-slot items. - Item actions for commands, sounds, messages and closing the menu. - Fine-grained permissions under `plainbase.menu.*`. - **PlaceholderAPI Support**: - Added optional PlaceholderAPI integration. - Added `%plainbase_version%` and `%plainbase_vanished%`. - Placeholders can be used in menu titles, item names, lore, messages and commands. - `%player%` remains supported. - PlainBase remains fully functional without PlaceholderAPI installed. ## Improvements & Fixes - **Update Check**: - Fixed `/plainbase update` failing to retrieve the latest version from Modrinth. - Modrinth API query parameters are now properly URL-encoded. - Update responses are parsed as JSON using Gson. - Added HTTP request timeouts and improved handling of non-successful responses. ## Config Changes - **config.yml** updated to **Version 1.5** (Added configuration entries for the `vanish` and `menu` modules). - **vanish.yml** added, **Version 1.1** (New configuration file added to manage Vanish settings). - **menu.yml** added, **Version 1.0** (New configuration file added to manage Menu settings. ## Tested Environments * Paper 26.2 * Folia 26.2 It should work on Paper, Purpur and Folia Servers for 1.21.6 to 26.1.2! Spigot is not supported.

# 0.0.4-Experimental ## New Features & Major Changes - **Permission System**: PlainBase now registers all permissions programmatically on startup, giving server admins fine-grained control over every command: - **Per-Command Permissions**: Every command across the Teleport and Spawn modules now has its own dedicated permission node (e.g. `plainbase.teleport.tpa.tpa`, `plainbase.spawn.setspawn`). - **Module Admin Nodes**: Added `.admin` permission nodes for each module and sub-module (e.g. `plainbase.teleport.tpa.admin`, `plainbase.teleport.rtp.admin`, `plainbase.teleport.admin`, `plainbase.spawn.admin`), allowing you to grant access to an entire feature set with a single node instead of assigning commands one by one. - **Global Admin Node**: Added `plainbase.admin`, which grants access to every permission across all modules. - **Secure Defaults**: All permissions default to `OP`, so regular players won't have access to any command until permissions are explicitly granted via a permissions plugin (e.g. LuckPerms). ## Config Changes - No config changes in this release. ## Tested Environments Paper 26.2 Paper 1.21.6 Folia 26.1.2 It should work on Paper, Purpur and Folia Servers for 1.21.6 to 26.2! Spigot is not supported.

# 0.0.3-Experimental ## New Features & Major Changes - **Teleportation Module (TPA & RTP)**: A comprehensive teleportation system has been added, including: - **TPA System**: Send requests with /tpa <player> or request players to come to you with /tpahere <player>. - **Auto-Accept**: Players can toggle automatic acceptance of teleport requests using /tpauto. Settings persist across sessions. - **Random Teleport (RTP)**: Teleport to a random safe location in the world with /rtp. Includes cooldowns and safety checks for biomes and dangerous blocks (water, lava, etc.). - **Safety Mechanisms**: Teleports can have a configurable countdown that cancels if the player moves, takes damage, or dies. - **Request Management**: Easily accept, deny, or cancel sent requests with /tpaccept, /tpdeny, and /tpacancel. - **Enhanced Module Control**: - Added checks to verify if specific module functions (like Spawn) are enabled in their respective configurations. - Adjusted default module activation states in config.yml. - **Improved Command System**: The /plainbase command provides three core functions for server administrators: - **Reload**: Instantly reload all configurations and module settings without restarting the server. - **Toggle**: Enable or disable specific modules (spawn, joinitems, messages, teleport) on the fly. - **Update**: Check for the latest version of PlainBase directly from Modrinth to keep the plugin up to date. ## Config Changes - **config.yml**: Updated to **Version 1.3** (Added teleport module toggle; default values updated). - **teleport.yml**: **Version 1.0** (New configuration file added to manage TPA and RTP settings). ## Tested Environments Paper 26.1.2 Paper 1.21.11 Paper 1.21.6 Folia 26.1.2 It should work on Paper, Purpur and Folia Servers for 1.21.6 to 26.1.2! Spigot is not supported.

# 📦 0.0.2-Experimental ## 🚀 New Features & Major Changes - **Native Folia Support**: Fully compatible with Folia servers through the implementation of region-based scheduling and async task management. - **New Module: Messages**: - Fully configurable **Join, Quit, and First-Join messages**. - **MOTD (Message of the Day)**: Greet your players with custom messages upon login. - **Automated Broadcasts**: Create timed server announcements with individual intervals. - **Enhanced Join-Items Module**: - **Skull Support**: Items can now be defined as player heads using `skull-owner: "%player%"`. - **Advanced Security System**: New flags for precise item control (`no-drop`, `no-inventory-move`, `no-creative-move`, `no-drag`, `no-swap`). - **Persistence Features**: Items can be configured to be automatically re-given after a `/clear` command or upon player death. - **OP-Bypass**: Administrators can now (optionally) bypass item restrictions. - **New Command System**: Introduction of the `/plainbase` main command with three core functions: - **Reload**: Instantly reload all configurations and modules. - **Toggle**: Enable or disable specific modules on the fly. - **Update**: Check for the latest version of PlainBase directly from Modrinth. - **Refactored Config System**: - All module configurations are now organized within the `modules/` subdirectory. - Full **UTF-8 Support** for all files, allowing special characters and icons. - Improved internal version tracking for all configuration files. ## 📄 Config Changes - **Structure**: Configuration files moved to the `plugins/PlainBase/modules/` directory. - **config.yml**: Updated to **Version 1.2** (Added module toggles for the Messages system). - **joinitems.yml**: Updated to **Version 1.1** (New format for item definitions and flags). - **spawn.yml**: Updated to **Version 1.2** (Internal update & path adjustment). - **messages.yml**: **Version 1.0** (New file added for the Messages module). ## ✅ Tested Environments Paper 26.1.2 Paper 1.21.11 Paper 1.21.6 Folia 26.1.2 It should work on Paper, Purpur and Folia Servers for 1.21.6 to 26.1.2! Spigot is not supported.

# 📦 0.0.1-Experimental ## 🚀 New Features - Modular Architecture: High-performance core using Paper’s modern Bootstrap and Loader systems. - Teleportation Suite: Full implementation of /spawn, /setspawn, and /setfirstspawn with orientation support (Yaw/Pitch) and relative coordinate parsing (~). - Join-Items Module: Automated item distribution on join with custom materials, MiniMessage-styled names/lores, and command execution on right-click. - Inventory Lockdown: "Lock-Item" technology using PersistentDataContainer to prevent moving or dropping specific lobby items while keeping normal items interactable. - Config Health Monitoring: Integrated version-tracking system that alerts Operators and console if internal configuration files require updates from GitHub. - Native Adventure Support: Deep integration of MiniMessage across all modules for professional-grade HEX colors and gradients. ## 📄 Config Changes - config.yml: Updated to version 1.1 (Added module toggles and versioning). - spawn.yml: Updated to version 1.1 (New command entries for /spawn). - joinitems.yml: Version 1.0 (Initial release of the item definitions and lockdown settings). ## ✅ Tested Environments Paper 26.1.2 (Build 63-stable)

# 📦 0.0.0-Experimental ## 🚀 New Features - Modular Architecture: High-performance core using Paper’s modern Bootstrap and Loader systems. - Advanced Spawn System: Fully featured /setspawn and /setfirstspawn commands with support for player orientation (Yaw/Pitch) and relative coordinates (~). - Dynamic Module Control: On-the-fly toggling of spawn points via /disablespawn and /disablefirstspawn. - Intelligent Join Handling: Automatic teleportation for new and returning players, configurable via specialized data files. - Native Adventure Integration: Full MiniMessage support for modern chat formatting, including HEX colors and gradients. - Tiered Configuration: Separation of global plugin settings (config.yml) and module-specific data (spawn.yml) for better organization. ## ✅ Tested Environments Paper 26.1.2 (Build 63-stable)