PokeNotify

PokePlugin v3 - The Ultimate Player Interaction & Privacy Update

Platform Support

[![Paper](https://img.shields.io/badge/Paper-1.20.x--1.21.x-blue.sv… [![Spigot](https://img.shields.io/badge/Spigot-1.20.x--1.21.x-orange… [![Purpur](https://img.shields.io/badge/Purpur-1.20.x--1.21.x-purple… [![Bukkit](https://img.shields.io/badge/Bukkit-1.20.x--1.21.x-red.sv… [![Folia](https://img.shields.io/badge/Folia-1.20.x--1.21.x-green.s… --- Release Date: 20 October 2025 Maintained by: AlanTheDev Public Brand Name: PokeNotify ---

Version Overview

PokePlugin v3 is a major technical refinement release focused on performance, thread safety, and reliability. This version rebuilds the plugin core for faster initialization, platform-accurate scheduling, stronger privacy enforcement, and better cross-platform support — all while remaining lightweight and stable across Folia, Paper, Spigot, Purpur, and Bukkit servers. ---

Core System Changes

Database Initialization

- Converted async initialization to synchronous during plugin startup. - Prevents server hang and ensures faster boot times (<1 second). - Auto-disables the plugin if database creation or connection fails. - Enhanced error reporting and recovery handling.

Scheduler System

- Implemented Platform-Aware Execution Model: - Folia: Uses player.getScheduler().run() (region-safe). - Others: Uses Bukkit.getScheduler().runTask(). - Database operations remain fully async-safe. - GUI operations are automatically routed to the correct scheduler. - Centralized utility ensures uniform task dispatching across all server types. ---

Privacy & Interaction Enhancements

Poke Validation Improvements

- Verifies target’s privacy mode before sending a poke. - Prevents poking blocked players or those who disabled pokes. - Improved error messages for blocked/disabled targets. - Admin command /poke @a bypasses all restrictions for announcements.

Enhanced Command System

- Added context-aware tab completion for: - /poke settings - /poke allow - /poke disable - /poke block <player> - /poke unblock <player> - Autocompletes @a for admins. - Sorted alphabetically for cleaner UX. ---

GUI & Event System

GUI Click Handling

- GUI interactions now use platform-specific thread handling. - Fixed async inventory creation causing GUI not to open. - Improved color code stripping for reliable item title detection. - Separated logic paths for Folia vs Bukkit-based servers. - Optional debug logs for developer builds.

Player GUI Experience

- Smooth transitions between settings and blocked players list. - Dynamic sizing (auto-resizes up to 54 players). - Fully thread-safe GUI operations. ---

Technical Stability Fixes

Server Hang on Startup

- Eliminated blocking .join() calls. - Database operations no longer freeze the main thread. - Startup initialization time: under 1 second on Folia.

Cross-Platform Compatibility

- Fixed Folia scheduler conflicts and Paper async issues. - Corrected Bukkit main-thread violations. - Fully tested on 1.20.x – 1.21.4 versions.

Database Thread Safety

- All SQLite calls are fully asynchronous. - Prevents concurrent modification and threading issues. - Uses PreparedStatements for SQL injection protection. - UUID validation and malformed data filtering added. ---

Message & Localization Updates

- Fixed placeholder replacements (%poke_status%, %poke_privacy%) across all message contexts. - Corrected color formatting (now supports & and § codes). - Added multi-line message support for cleaner formatting. - Hot-reload compatible with /poke reload. ---

Security & Permissions

- Players can now block unwanted pokes with full privacy enforcement. - Blocked players cannot detect their status (hidden protection). - Permission validation for all commands: - pokeplugin.settings – Access to player settings GUI (default: true) - pokeplugin.admin – Use /poke @a (default: op) - Database hardened with safe query execution and data filtering. ---

Performance & Metrics

- Fully integrated bStats (Plugin ID: 27606). - Tracks installations, Minecraft versions, and platforms. - Automatically relocates metrics package to com.alan.pokePlugin.metrics. - Lightweight — adds <5KB overhead to plugin size. ---

Configuration Overview

```yaml privacy: default-mode: ALLOW_ALL # Default privacy for new players database: type: sqlite file: data/pokedata.db placeholders: enabled: true gui: enabled: true title: "&aPoke Settings" size: 27 metrics: enabled: true debug: false # Enable detailed debug logging