- init to 26.1.2

Author: mrfloris

.gitignore

@@ -1,113 +1,5 @@
-# User-specific stuff
-.idea/
-
-*.iml
-*.ipr
-*.iws
-
-# IntelliJ
-out/
-
-# Compiled class file
-*.class
-
-# Log file
-*.log
-
-# BlueJ files
-*.ctxt
-
-# Package Files #
-*.jar
-*.war
-*.nar
-*.ear
-*.zip
-*.tar.gz
-*.rar
-
-# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
-hs_err_pid*
-
-*~
-
-# temporary files which can be created if a process still has a handle open of a deleted file
-.fuse_hidden*
-
-# KDE directory preferences
-.directory
-
-# Linux trash folder which might appear on any partition or disk
-.Trash-*
-
-# .nfs files are created when an open file is removed but is still being accessed
-.nfs*
-
-# General
 .DS_Store
-.AppleDouble
-.LSOverride
-
-# Icon must end with two \r
-Icon
-
-# Thumbnails
-._*
-
-# Files that might appear in the root of a volume
-.DocumentRevisions-V100
-.fseventsd
-.Spotlight-V100
-.TemporaryItems
-.Trashes
-.VolumeIcon.icns
-.com.apple.timemachine.donotpresent
-
-# Directories potentially created on remote AFP share
-.AppleDB
-.AppleDesktop
-Network Trash Folder
-Temporary Items
-.apdisk
-
-# Windows thumbnail cache files
-Thumbs.db
-Thumbs.db:encryptable
-ehthumbs.db
-ehthumbs_vista.db
-
-# Dump file
-*.stackdump
-
-# Folder config file
-[Dd]esktop.ini
-
-# Recycle Bin used on file shares
-$RECYCLE.BIN/
-
-# Windows Installer files
-*.cab
-*.msi
-*.msix
-*.msm
-*.msp
-
-# Windows shortcuts
-*.lnk
-
-target/
-
-pom.xml.tag
-pom.xml.releaseBackup
-pom.xml.versionsBackup
-pom.xml.next
-
-release.properties
-dependency-reduced-pom.xml
-buildNumber.properties
-.mvn/timing.properties
-.mvn/wrapper/maven-wrapper.jar
-.flattened-pom.xml
-
-# Common working directory
-run/
+.gradle/
+build/
+out/
+/servers/

README.md

@@ -1,10 +1,90 @@
-# EndCrystals
-1MB Helper plugin
+# 1MB-EndCrystals
 
-This is a helper for my server to prevent grief by players. Separate from other protection plugins, I want to make sure that end crystals we place for decoration purposes don't cause certain damage, nor that they can get griefed by other players. 
+`1MB-EndCrystals` is a small Paper plugin for one job: let end crystals behave like end crystals, but never let them break blocks. It also optionally protects decorative crystals from players and player-fired projectiles, independent from WorldGuard or any other region plugin.
 
-## Versions
+This refresh targets Java 25 and has been built for modern Paper installs, with validation intended for:
 
-The 1.x old version got updated now to 1.16.5, which seems fine.
+- Paper `1.21.11`
+- Paper `26.1.2`
 
-The 1.16.5 update got updated to Spigot 1.17, and has been tested.
+The produced jar is named:
+
+`1MB-EndCrystals-v2.0.1-021-v25-26.1.2.jar`
+
+## What It Does
+
+- Clears end crystal block damage without cancelling the whole explosion event
+- 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`
+- Supports `/_endcrystals reload`
+- Supports `/_endcrystals toggle <setting> [true|false]` for live boolean config toggles
+- Supports `/_endcrystals debug` for runtime/build/config diagnostics
+
+## Commands
+
+- `/_endcrystals debug`
+- `/_endcrystals reload`
+- `/_endcrystals toggle`
+- `/_endcrystals toggle protection.prevent-block-damage`
+- `/_endcrystals toggle debug.log-block-protection true`
+
+Aliases:
+
+- `/endcrystals`
+- `/ec`
+
+## Permissions
+
+- `1mb.endcrystals.admin`
+- `1mb.endcrystals.debug`
+- `1mb.endcrystals.reload`
+- `1mb.endcrystals.toggle`
+- `1mb.endcrystals.bypass`
+
+`1mb.endcrystals.admin` grants the command permissions. `1mb.endcrystals.bypass` allows a player to break otherwise protected crystals.
+
+## Config
+
+The plugin reads and writes its main config here:
+
+`~/plugins/1MB-EndCrystals/config.yml`
+
+That makes it easy to share one config across multiple local servers started by the same user account.
+
+Important defaults:
+
+- `protection.prevent-block-damage: true`
+- `protection.prevent-player-break: true`
+- `protection.prevent-projectile-break: true`
+- `protection.allow-player-break-in-the-end: true`
+- `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`.
+
+## 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.
+
+Build with:
+
+```bash
+./gradlew build
+```
+
+Output jar:
+
+`build/libs/1MB-EndCrystals-v2.0.1-021-v25-26.1.2.jar`
+
+## Install
+
+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/`.
+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.

pom.xml

@@ -1,9 +1,34 @@
-name: ${project.artifactId}
-version: ${project.version}
-main: com.mrfloris.endcrystals.pluginEvents
-api-version: 1.17
-prefix: ${project.name}
+name: ${pluginName}
+version: ${pluginVersion}
+main: com.mrfloris.endcrystals.EndCrystalsPlugin
+api-version: "1.21"
+prefix: ${pluginName}
 author: adrianwowk
 authors: [mrfloris, the456gamer]
-description: ${project.description}
-website: ${project.url}
+description: ${pluginDescription}
+website: ${website}
+commands:
+  _endcrystals:
+    description: End crystal protection admin commands
+    usage: /_endcrystals <debug|reload|toggle>
+    aliases: [endcrystals, ec]
+permissions:
+  1mb.endcrystals.admin:
+    description: Grants every 1MB-EndCrystals admin command
+    default: op
+    children:
+      1mb.endcrystals.debug: true
+      1mb.endcrystals.reload: true
+      1mb.endcrystals.toggle: true
+  1mb.endcrystals.debug:
+    description: Allows the debug subcommand
+    default: op
+  1mb.endcrystals.reload:
+    description: Allows the reload subcommand
+    default: op
+  1mb.endcrystals.toggle:
+    description: Allows live config toggles
+    default: op
+  1mb.endcrystals.bypass:
+    description: Allows breaking protected end crystals
+    default: op