Merge pull request #44 from Lyttle-Development/dev This pull request introduces several new configuration options for customizing nametag rendering, improves the config migration process, and ensures that changes to the config are properly applied at runtime. The most important changes are grouped below: ### New Nametag Rendering Options * Added new config options: `see_through_blocks`, `hide_when_sneaking`, `text_opacity`, and `background_opacity` to both `config.yml` and `#defaults/config.yml`, allowing server admins to control whether nametags render through blocks, hide when sneaking, and set opacity levels for text and background. * Updated `NametagHandler` to use these new config options when rendering nametags, including calculating and applying opacity and see-through behavior. [[1]](diffhunk://#diff-36a32a5cc72ef43fc5ac37bf78c0c4017ab6df087e7eb8bb2e05dd886af08f1bL342-R349) [[2]](diffhunk://#diff-36a32a5cc72ef43fc5ac37bf78c0c4017ab6df087e7eb8bb2e05dd886af08f1bL524-R547) ### Configuration Management and Migration * Enhanced the config migration logic to handle migration to version 4, ensuring new options are added and existing configs are updated correctly. * Updated the plugin version to `1.3.3` in `gradle.properties` to reflect the new features. ### Runtime Behavior * Ensured that both the config and the nametag handler are reloaded when the reload command is executed, so changes to config options take effect immediately.

Merge pull request #43 from Lyttle-Development/dev Fix legacy formatting

v1.3.0 This pull request updates the build tooling and dependencies to keep the project up-to-date and compatible with recent versions. The main changes are version bumps for the plugin, Paper platform, and Gradle itself. Dependency and tooling updates: * Bumped the `pluginVersion` from `1.3.0` to `1.3.1` and updated the `paperVersion` from `1.21.8` to `1.21.11` in `gradle.properties` to ensure compatibility with the latest Paper server releases. * Upgraded the Gradle wrapper from version `8.11.1` to `8.14.4` in `gradle/wrapper/gradle-wrapper.properties` to use the latest Gradle features and bug fixes.

v1.3.1 This pull request updates the build tooling and dependencies to keep the project up-to-date and compatible with recent versions. The main changes are version bumps for the plugin, Paper platform, and Gradle itself. Dependency and tooling updates: * Bumped the `pluginVersion` from `1.3.0` to `1.3.1` and updated the `paperVersion` from `1.21.8` to `1.21.11` in `gradle.properties` to ensure compatibility with the latest Paper server releases. * Upgraded the Gradle wrapper from version `8.11.1` to `8.14.4` in `gradle/wrapper/gradle-wrapper.properties` to use the latest Gradle features and bug fixes.

v1.3.0 This pull request introduces significant updates to modernize the LyttleNametag plugin for Minecraft 1.21 and Paper, including a migration to Paper's new command and plugin lifecycle system, integration with PacketEvents, and several configuration and dependency improvements. The changes enhance maintainability, compatibility, and future-proofing of the plugin. **Core Plugin Modernization and Refactoring:** * Migrated command registration to use Paper's Brigadier-based command system and lifecycle events, replacing Bukkit's legacy command executor and tab completer. The `LyttleNametagCommand` class now defines commands using Brigadier and is registered during the appropriate plugin lifecycle event. [[1]](diffhunk://#diff-e3f55625c58389ac1a7178f3f0c0a48ccecfee966a413474e16ba527159187e6L34-R81) [[2]](diffhunk://#diff-5425d2451b1b04e45457a35837c1c32bbd6a822b665d0dbb34ad50ab7e639ac2R4-R46) * Integrated PacketEvents using the recommended lifecycle (`onLoad`, `onEnable`, `onDisable`), ensuring proper initialization, configuration, and termination of the PacketEvents API within `LyttleNametag`. [[1]](diffhunk://#diff-e3f55625c58389ac1a7178f3f0c0a48ccecfee966a413474e16ba527159187e6L3-R16) [[2]](diffhunk://#diff-e3f55625c58389ac1a7178f3f0c0a48ccecfee966a413474e16ba527159187e6R28-R37) [[3]](diffhunk://#diff-e3f55625c58389ac1a7178f3f0c0a48ccecfee966a413474e16ba527159187e6L34-R81) **Configuration and Dependency Management:** * Replaced the legacy `plugin.yml` with the new `paper-plugin.yml` format, including updated metadata and explicit server dependency declarations for plugins like PlaceholderAPI, ProtocolLib, and ViaVersion, improving compatibility and startup order. [[1]](diffhunk://#diff-c235d408701263315a47b8f23549a44f341c330677a112e48480de86cc86d7baR1-R41) [[2]](diffhunk://#diff-98201effe40eaf4a0e8826fadd6c5c9d5beaf9d737226b514f0853f44987a67fL1-L20) * Updated the default and main configuration files to fix formatting issues in the `nametag` template, ensuring correct display of placeholders and colors. **Build System Updates:** * Updated the plugin version to `1.3.0` in `gradle.properties` and upgraded the Gradle wrapper to version 8.11.1 for improved build reliability and compatibility. [[1]](diffhunk://#diff-3d103fc7c312a3e136f88e81cef592424b8af2464c468116545c4d22d6edcf19L2-R2) [[2]](diffhunk://#diff-40640fe1078ece83d7ea8fb67daacd77923a86d13447baf9769660b3b46f2eceL3-R3)

v1.3.0 This pull request migrates the plugin from Bukkit's legacy command and plugin registration system to Paper's modern APIs, refactoring command handling to use Brigadier and updating plugin metadata files for Paper compatibility. The main changes are the switch to Paper's lifecycle events for command registration, a complete rewrite of the command logic to use Brigadier, and the removal of the old `plugin.yml` in favor of Paper's `paper-plugin.yml`. **Migration to Paper API and Brigadier commands:** * Replaced Bukkit's command registration with Paper's lifecycle event system, registering commands via `LifecycleEventManager` and the new `registerCommands` method in `LyttleNametag.java`. * Refactored `LyttleNametagCommand` to use Brigadier for command structure, permissions, and execution, removing the old `CommandExecutor` and `TabCompleter` implementations. Now commands are registered and handled using the `Commands` API and Brigadier nodes. **Plugin metadata and configuration updates:** * Removed the legacy `plugin.yml` and replaced it with `paper-plugin.yml` and a template `#defaults/paper-plugin.yml`, specifying plugin metadata, authors, and dependencies in the Paper format. [[1]](diffhunk://#diff-98201effe40eaf4a0e8826fadd6c5c9d5beaf9d737226b514f0853f44987a67fL1-L25) [[2]](diffhunk://#diff-c235d408701263315a47b8f23549a44f341c330677a112e48480de86cc86d7baR1-R41) * Updated dependencies to use the new Paper plugin system, including specifying soft dependencies and load order for compatibility plugins like PlaceholderAPI, ProtocolLib, and ViaVersion. **Codebase modernization:** * Updated imports and removed unused Bukkit command classes, ensuring all command-related logic is now Paper/Brigadier-based. [[1]](diffhunk://#diff-e3f55625c58389ac1a7178f3f0c0a48ccecfee966a413474e16ba527159187e6R13-R16) [[2]](diffhunk://#diff-5425d2451b1b04e45457a35837c1c32bbd6a822b665d0dbb34ad50ab7e639ac2R4-R46)

v1.2.5 This pull request updates the plugin to version 1.2.5 and introduces PacketEvents as a dependency, including its initialization and shutdown logic in the main plugin class. It also updates the Gradle wrapper version, improves configuration for nametag formatting, and adjusts plugin dependencies for better compatibility. **Dependency and Build System Updates:** - Updated `pluginVersion` to `1.2.5` in `gradle.properties` to reflect the new release. - Upgraded Gradle wrapper to version 8.11.1 in `gradle-wrapper.properties` for improved build tooling and compatibility. **PacketEvents Integration:** - Added PacketEvents as a dependency and implemented its initialization (`onLoad`, `onEnable`, and `onDisable`) in `LyttleNametag.java`. This includes configuring settings such as disabling update checks and debug mode, and ensuring proper startup and shutdown of PacketEvents. [[1]](diffhunk://#diff-e3f55625c58389ac1a7178f3f0c0a48ccecfee966a413474e16ba527159187e6L3-R12) [[2]](diffhunk://#diff-e3f55625c58389ac1a7178f3f0c0a48ccecfee966a413474e16ba527159187e6R24-R33) [[3]](diffhunk://#diff-e3f55625c58389ac1a7178f3f0c0a48ccecfee966a413474e16ba527159187e6R52-R69) **Configuration and Formatting Improvements:** - Updated the `nametag` format in both `config.yml` and `#defaults/config.yml` to close the `<gray>` tag properly, improving display consistency. [[1]](diffhunk://#diff-7b63c1703ad2ad2fd45bca45c4e0d120b974f46407da0cd17ae8ae4b048e256bL13-R14) [[2]](diffhunk://#diff-7b63c1703ad2ad2fd45bca45c4e0d120b974f46407da0cd17ae8ae4b048e256bL13-R14) **Plugin Dependency Management:** - Removed PacketEvents from the hard `depend` list in `plugin.yml` and added several plugins (`ProtocolLib`, `ProtocolSupport`, `ViaVersion`, `ViaBackwards`, `ViaRewind`, `Geyser-Spigot`) to `softdepend` for broader compatibility with various protocol and proxy plugins.

v1.2.4 This pull request makes significant improvements to the build and release automation, enhances configuration flexibility, and introduces a new configurable view distance for nametags. The main changes are the consolidation and enhancement of CI workflows, updates to configuration handling, and improvements to how nametag visibility is managed in-game. **Build & Release Automation:** * Consolidated the separate `main.yml` and `alpha.yml` GitHub Actions workflows into a single, unified workflow file (`release-and-publish.yml`) that handles both the `main` and `alpha` branches, automates tagging, artifact uploads, and publishing to GitHub Releases, Hangar, and Modrinth. This streamlines maintenance and ensures consistent behavior across release channels. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR1-R144) [[2]](diffhunk://#diff-77705eb5ee9cd3186d976656ab5cd8d5177355a6a4f3631c004205b636830473L1-L57) [[3]](diffhunk://#diff-7829468e86c1cc5d5133195b5cb48e1ff6c75e3e9203777f6b2e379d9e4882b3L1-L57) **Configuration System Enhancements:** * Migrated from the custom `Config` class to the more robust `YamlConfig` class for all configuration files in the `Configs` class, improving type safety and YAML handling. * Updated configuration migration logic to support new config versions and ensure seamless upgrades, including auto-migration for the new `view_distance` setting. **Nametag View Distance Feature:** * Added a new `view_distance` configuration option (default: 64 blocks) to both default and main config files, allowing server owners to control how far away nametags are visible. [[1]](diffhunk://#diff-58cdd3d308ccba6c594e040ff9c065bb11eeb6e30f35ba87694ea45d5ae6096cR22-R26) [[2]](diffhunk://#diff-7b63c1703ad2ad2fd45bca45c4e0d120b974f46407da0cd17ae8ae4b048e256bR17-R26) * Updated the nametag rendering logic in `NametagHandler` to use the new `view_distance` value when calculating the visibility range for nametags. **Other Improvements:** * Minor code cleanup and import optimizations in `NametagHandler` for better readability and maintainability. * Bumped the plugin version from `1.2.3` to `1.2.4` to reflect these new features and improvements.

v1.0.2 This pull request refactors the GitHub Actions workflow in `.github/workflows/release-and-publish.yml` to simplify the build and publish process. It removes unnecessary credential handling, consolidates build steps, and adds helpful comments for clarity. The workflow now directly builds and publishes in each job, making the process more straightforward and maintainable. **Workflow refactoring and simplification:** * Merged the build and release steps into each publish job (`publish-github`, `publish-hangar`, `publish-modrinth`), removing the separate `build-and-release` job and the need for artifact downloading between jobs. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dL10-R10) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dL77) * Removed explicit setup and use of GitHub Packages credentials (`GPR_USER`, `GPR_API_KEY`) from the build and publish steps, simplifying the environment and command usage. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR20-R36) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR83-L119) [[3]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR120-R144) * Consolidated the build process in each job to use `./gradlew build shadowJar --stacktrace` before publishing, ensuring a fresh build for each publish target. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR20-R36) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR83-L119) [[3]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR120-R144) **Documentation and clarity improvements:** * Added descriptive comments to each workflow step to explain their purpose and improve maintainability for future contributors. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR20-R36) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR83-L119) [[3]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR120-R144) **Consistency improvements:** * Standardized step names (e.g., "Validate Gradle Wrapper") and ensured all jobs use the same sequence of setup steps for consistency across publishing targets. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR20-R36) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR83-L119) [[3]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR120-R144)

v1.2.4 This pull request refactors the GitHub Actions workflow for releasing and publishing the project. The main focus is on simplifying the build and publish steps, removing unnecessary credentials, and improving clarity with additional comments. The workflow now builds the project directly in each publish job instead of relying on artifacts from a centralized build job. **Workflow refactoring and simplification:** * Removed the centralized `build-and-release` job and replaced it with a `publish-github` job, and updated dependent jobs (`publish-hangar`, `publish-modrinth`) to build the project independently. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dL10-R10) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dL77) * Removed the use of GitHub Packages credentials (`GPR_USER`, `GPR_API_KEY`) and related Gradle properties from all jobs, simplifying the authentication process. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR20-R36) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR83-L119) [[3]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR120-R144) **Build and publishing improvements:** * Each publish job now checks out the repository, validates the Gradle wrapper, sets up JDK 21, and builds the project using `./gradlew build shadowJar --stacktrace`, ensuring consistent build environments. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR20-R36) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR83-L119) [[3]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR120-R144) * Removed the use of artifact upload/download steps; jobs build the JAR directly instead of relying on artifacts from another job. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR83-L119) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR120-R144) **Documentation and clarity:** * Added comments throughout the workflow steps to explain the purpose of each action, improving maintainability and clarity for future contributors. [[1]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR20-R36) [[2]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR83-L119) [[3]](diffhunk://#diff-f1aa31b040aa63ad53feecf5f41bcf0699b50576cc2b1f1ed23daf0d12b5fe8dR120-R144)