NVPlugin

[1.4.0] — 2026-10-01

Major Highlights

• Universal 1.21 to 26.3+ Support: Native support across all modern Minecraft versions (1.21, 1.21.1–1.21.4, through 26.3+).
• Native Folia Support: Added full compatibility for Folia's multi-threaded regional scheduling, plus Paper, Purpur, Gale, and legacy Spigot.
• Okaeri Configs Integration: Complete rewrite of the configuration system using Okaeri Configs with automatic schema updates, formatted comments, and automated .bk backup generation on update.
• Zero-Setup PersistentDataContainer (PDC): Toggle preferences are now stored directly in player NBT data, surviving server restarts and player deaths with zero external database configuration.
• Modrinth Update Checker: Added an asynchronous, non-blocking update checker communicating with the Modrinth API (https://modrinth.com/plugin/nvplugin).

New Features & Enhancements

• Folia Regional Threading:
  • Implemented TaskScheduler with an isolated PaperFoliaBridge that uses entity.getScheduler().runDelayed() for regional player operations and Bukkit.getAsyncScheduler() for asynchronous tasks.
  • Added folia-supported: true to plugin.yml.
  • Safe graceful fallbacks for standard Paper and Spigot.
• Automated Config Backups & Schema Migration:
  • Detects legacy configurations (config-version < 2) and automatically generates a config.yml.bk (or timestamped backup) before generating the new Okaeri schema.
  • Okaeri preserves custom edits while automatically inserting any newly introduced configuration keys and comments.
• Player State Persistence:
  • Replaced transient in-memory UUID set with Minecraft's native PersistentDataContainer (night_vision_enabled).
  • Player states persist across server restarts, reboots, crashes, world transfers, and player deaths.
  • Added memory-leak-free caching that automatically cleans up when players disconnect.
• Modrinth Update Checker:
  • Non-blocking REST client query to https://api.modrinth.com/v2/project/nvplugin/version.
  • Logs a notification in the console on server startup if an update is found.
  • Sends an in-game notification to operators or players with nightvision.admin upon login.
  • Configurable in config.yml under update-checker.
• Visuals & Color Formatting:
  • Added ColorUtil supporting both standard legacy color codes (&a, &l) and modern Hex color formatting (&#RRGGBB).
  • Clean potion effects: ambient particles disabled by default and potion icon hidden from the HUD.
• Clean Codebase:
  • Removed all inline and block comment clutter across all Java source files.
  • Replaced reflection-heavy scheduler wrappers with direct native calls in isolated class bridges.
  • Shaded and relocated all Okaeri dependencies to org.ayosynk.nightVision.libs.okaeri.configs to prevent classpath conflicts.