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 or request players to come to you with /tpahere .
  • 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)