Refresh EndCrystals for modern Paper, Java 25, and config-driven protection

Author: mrfloris

README.md

@@ -11,16 +11,24 @@ The produced jar is named:
 
 `1MB-EndCrystals-v2.0.1-021-v25-26.1.2.jar`
 
-## What It Does
+## Feature List
 
 - Clears end crystal block damage without cancelling the whole explosion event
+- Prevents item and decorative entity destruction from crystal explosions
+- Protects minecart variants, boat or raft variants, display entities, paintings, frames, armor stands, leash knots, and dropped items
 - Optionally blocks players from breaking protected crystals
 - Optionally blocks player projectiles from breaking protected crystals
 - Keeps The End configurable so dragon-fight style gameplay can stay intact if desired
-- Stores config in a shared home-folder location: `~/plugins/1MB-EndCrystals/config.yml`
+- Uses the normal Paper plugin data folder: `plugins/1MB-EndCrystals/config.yml`
+- Migrates the misplaced legacy home-folder config into the correct server-local folder on first startup
 - Supports `/_endcrystals reload`
-- Supports `/_endcrystals toggle <setting> [true|false]` for live boolean config toggles
+- Supports `/_endcrystals toggle [setting] [true|false]` for live boolean config toggles
 - Supports `/_endcrystals debug` for runtime/build/config diagnostics
+- Supports configurable command aliases from `config.yml`
+- Uses MiniMessage formatting for plugin output
+- Uses strict permission nodes with op not automatically bypassing protection
+- Targets Java `25` and modern Paper builds
+- Builds with Gradle from a fresh clone without requiring any private `/servers/` test setup
 
 ## Commands
 
@@ -30,42 +38,73 @@ The produced jar is named:
 - `/_endcrystals toggle protection.prevent-block-damage`
 - `/_endcrystals toggle debug.log-block-protection true`
 
-Aliases:
+Configurable aliases:
 
 - `/endcrystals`
 - `/ec`
 
+Those aliases are controlled by `commands.aliases` in `plugins/1MB-EndCrystals/config.yml`. Set `commands.aliases: []` if you want no extra aliases. Changes apply after `/_endcrystals reload`.
+If another plugin or the server already owns one of those names, 1MB-EndCrystals skips that alias and logs a warning while keeping `/_endcrystals` available.
+
 ## Permissions
 
-- `1mb.endcrystals.admin`
-- `1mb.endcrystals.debug`
-- `1mb.endcrystals.reload`
-- `1mb.endcrystals.toggle`
-- `1mb.endcrystals.bypass`
+- `onembendcrystals.admin`
+- `onembendcrystals.debug`
+- `onembendcrystals.reload`
+- `onembendcrystals.toggle`
+- `onembendcrystals.break`
 
-`1mb.endcrystals.admin` grants the command permissions. `1mb.endcrystals.bypass` allows a player to break otherwise protected crystals.
+All of these permissions default to `false`, so being op alone does not grant them. `onembendcrystals.admin` grants the command permissions. `onembendcrystals.break` allows a player to break otherwise protected crystals.
 
 ## Config
 
 The plugin reads and writes its main config here:
 
-`~/plugins/1MB-EndCrystals/config.yml`
+`plugins/1MB-EndCrystals/config.yml`
+
+Each Paper server gets its own local config folder, which is the normal Bukkit/Paper behavior.
 
-That makes it easy to share one config across multiple local servers started by the same user account.
+If you are upgrading from an older build that wrote to `~/plugins/1MB-EndCrystals/config.yml`, the plugin will copy that legacy file into the server-local plugin folder on first startup if the new server-local config does not already exist.
 
 Important defaults:
 
+- `commands.aliases: [endcrystals, ec]`
 - `protection.prevent-block-damage: true`
 - `protection.prevent-player-break: true`
 - `protection.prevent-projectile-break: true`
-- `protection.allow-player-break-in-the-end: true`
+- `protection.prevent-protected-entity-damage: true`
+- `protection.allow-player-break-in-the-end: false`
 - `protection.clear-explosion-yield: true`
 
-Live toggle keys are listed in the config under `live-toggles`. Those settings can be changed immediately with `/_endcrystals toggle ...` and also refresh when you run `/_endcrystals reload`.
+By default the protected entity list includes armor stands, dropped items, item frames, glow item frames, paintings, display entities, leash knots, minecart variants, and boat or raft variants. Live toggle keys are listed in the config under `live-toggles`. Those settings can be changed immediately with `/_endcrystals toggle [setting] [true|false]` and also refresh when you run `/_endcrystals reload`.
+
+## Changelog
+
+### Legacy -> `v2.0.1` Refresh
+
+This section summarizes the modernization work completed for the current refresh.
+
+- Migrated the plugin to a Gradle build for Java `25`
+- Retargeted the plugin for modern Paper, validated against `1.21.11` and `26.1.2`
+- Standardized the shipped jar name to `1MB-EndCrystals-v2.0.1-021-v25-26.1.2.jar`
+- Reworked config storage to use the active server's `plugins/1MB-EndCrystals/config.yml`
+- Added one-time migration support for the old misplaced `~/plugins/1MB-EndCrystals/config.yml`
+- Added `/_endcrystals reload`
+- Added `/_endcrystals debug`
+- Added live config toggles through `/_endcrystals toggle [setting] [true|false]`
+- Moved command aliases into `config.yml` so they can be added or removed without editing `plugin.yml`
+- Kept `/_endcrystals` as the permanent primary command
+- Switched to explicit `onembendcrystals.*` permission nodes with `default: false`
+- Made crystal breaking permission-driven instead of implicitly allowing ops
+- Expanded protection beyond blocks to cover decorative and item entities
+- Added protection for minecart and boat-style entities that were still vulnerable on the legacy path
+- Improved debug output to show build/runtime info, config path, permissions, live toggles, and active commands
+- Moved plugin messages into config and formatted output with MiniMessage
+- Updated docs so public builds do not depend on any private local `/servers/` test directory
 
 ## Build
 
-If the local Paper `1.21.11` API jar is available in `servers/Server-One-Paper-1.21.11`, Gradle uses that directly for offline local builds. Otherwise it falls back to the Paper Maven repository.
+The public build does not depend on any local `servers/` directory. A normal checkout builds against the Paper API from the Paper Maven repository, and any repo-local test servers are strictly optional private development tooling.
 
 Build with:
 
@@ -81,10 +120,10 @@ Output jar:
 
 1. Build the jar.
 2. Copy it into a Paper server's `plugins/` folder.
-3. Start the server once so the shared config is created under `~/plugins/1MB-EndCrystals/`.
+3. Start the server once so the plugin creates `plugins/1MB-EndCrystals/config.yml`.
 4. Use `/_endcrystals debug` to verify runtime information.
 5. Use `/_endcrystals reload` after editing the config.
 
 ## Testing Notes
 
-The plugin is meant to be testable without WorldGuard present. If an end crystal explodes near normal blocks, the explosion should still happen but the blocks should remain intact while the plugin is enabled.
+The plugin is meant to be testable without WorldGuard present. If an end crystal explodes near normal blocks, the explosion should still happen but the blocks should remain intact while the plugin is enabled. Any `/servers/` directory used in development is for private local testing only and is not part of the public build flow.

build.gradle.kts

@@ -8,6 +8,7 @@ description = "1MB helper plugin that prevents end crystals from damaging blocks
 val pluginVersion = providers.gradleProperty("pluginVersion").get()
 val buildNumber = providers.gradleProperty("buildNumber").get()
 val javaTarget = providers.gradleProperty("javaTarget").get()
+val paperApiVersion = providers.gradleProperty("paperApiVersion").get()
 val targetPaperVersion = providers.gradleProperty("targetPaperVersion").get()
 val targetMinecraftVersion = providers.gradleProperty("targetMinecraftVersion").get()
 
@@ -18,20 +19,8 @@ repositories {
     maven("https://repo.papermc.io/repository/maven-public/")
 }
 
-val localPaperApi = layout.projectDirectory.file(
-    "servers/Server-One-Paper-1.21.11/libraries/io/papermc/paper/paper-api/1.21.11-R0.1-SNAPSHOT/paper-api-1.21.11-R0.1-SNAPSHOT.jar"
-).asFile
-val localPaperLibraries = layout.projectDirectory.dir("servers/Server-One-Paper-1.21.11/libraries").asFile
-
 dependencies {
-    if (localPaperApi.exists() && localPaperLibraries.isDirectory) {
-        compileOnly(files(localPaperApi))
-        compileOnly(fileTree(localPaperLibraries) {
-            include("**/*.jar")
-        })
-    } else {
-        compileOnly("io.papermc.paper:paper-api:1.21.11-R0.1-SNAPSHOT")
-    }
+    compileOnly("io.papermc.paper:paper-api:$paperApiVersion")
 }
 
 java {

gradle.properties

@@ -1,6 +1,7 @@
 pluginVersion=2.0.1
 buildNumber=021
 javaTarget=25
+paperApiVersion=1.21.11-R0.1-SNAPSHOT
 targetPaperVersion=26.1.2
 targetMinecraftVersion=1.21.11+
 org.gradle.jvmargs=-Xmx1G -Dfile.encoding=UTF-8

src/main/java/com/mrfloris/endcrystals/ConfiguredAliasCommand.java

@@ -0,0 +1,33 @@
+package com.mrfloris.endcrystals;
+
+import java.util.List;
+import net.kyori.adventure.text.Component;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.PluginCommand;
+
+final class ConfiguredAliasCommand extends Command {
+
+    private final PluginCommand delegate;
+
+    ConfiguredAliasCommand(String alias, PluginCommand delegate) {
+        super(alias, delegate.getDescription(), delegate.getUsage(), List.of());
+        this.delegate = delegate;
+        setPermission(delegate.getPermission());
+
+        Component permissionMessage = delegate.permissionMessage();
+        if (permissionMessage != null) {
+            permissionMessage(permissionMessage);
+        }
+    }
+
+    @Override
+    public boolean execute(CommandSender sender, String commandLabel, String[] args) {
+        return delegate.execute(sender, commandLabel, args);
+    }
+
+    @Override
+    public List<String> tabComplete(CommandSender sender, String alias, String[] args) throws IllegalArgumentException {
+        return delegate.tabComplete(sender, alias, args);
+    }
+}