bump version to 1.5.3, update GUI interactions, and clean up documentation

Author: ptthanh02

NMS/v1_21/src/main/java/github/nighter/smartspawner/v1_21/TextureInitializer.java

@@ -3,7 +3,16 @@
 import github.nighter.smartspawner.nms.TextureWrapper;
 import org.bukkit.entity.EntityType;
 
+/**
+ * This class is responsible for initializing version-specific textures
+ * for various entity types in the SmartSpawner plugin.
+ */
 public class TextureInitializer {
+
+    /**
+     * Initializes version-specific textures for various entity types.
+     * This method should be called during the plugin's initialization phase.
+     */
     public static void init() {
         TextureWrapper.addVersionSpecificTexture(
                 EntityType.ARMADILLO,

NMS/v1_21_4/src/main/java/github/nighter/smartspawner/v1_21_4/TextureInitializer.java

@@ -3,7 +3,16 @@
 import github.nighter.smartspawner.nms.TextureWrapper;
 import org.bukkit.entity.EntityType;
 
+/**
+ * This class is responsible for initializing version-specific textures
+ * for various entity types in the SmartSpawner plugin.
+ */
 public class TextureInitializer {
+
+    /**
+     * Initializes version-specific textures for various entity types.
+     * This method should be called during the plugin's initialization phase.
+     */
     public static void init() {
         TextureWrapper.addVersionSpecificTexture(
                 EntityType.ARMADILLO,

NMS/v1_21_6/src/main/java/github/nighter/smartspawner/v1_21_6/TextureInitializer.java

@@ -3,7 +3,16 @@
 import github.nighter.smartspawner.nms.TextureWrapper;
 import org.bukkit.entity.EntityType;
 
+/**
+ * This class is responsible for initializing version-specific textures
+ * for various entity types in the SmartSpawner plugin.
+ */
 public class TextureInitializer {
+
+    /**
+     * Initializes version-specific textures for various entity types.
+     * This method should be called during the plugin's initialization phase.
+     */
     public static void init() {
         TextureWrapper.addVersionSpecificTexture(
                 EntityType.ARMADILLO,

README.md

@@ -6,11 +6,6 @@
 
 <br>
 
-[![Release](https://img.shields.io/github/v/release/NighterDevelopment/smartspawner?logo=github&logoColor=white&label=release&labelColor=%230D597F&color=%23116BBF)](https://github.com/NighterDevelopment/smartspawner/releases/latest)
-[![Modrinth Downloads](https://img.shields.io/modrinth/dt/smart-spawner-plugin?logo=modrinth&logoColor=white&label=downloads&labelColor=%23139549&color=%2318c25f)](https://modrinth.com/plugin/smart-spawner-plugin)
-[![Spigot Downloads](https://img.shields.io/spiget/downloads/120743?logo=spigotmc&logoColor=white&label=spigot%20downloads&labelColor=%23ED8106&color=%23FF994C)](https://www.spigotmc.org/resources/smart-spawner-gui-spawner-plugin%E2%9C%A8-1-21-1-21-3-%EF%B8%8F.120743/)
-[![License](https://img.shields.io/badge/license-CC%20BY--NC--SA%204.0-brightgreen.svg)](LICENSE)
-
 [![Modrinth](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/modrinth_vector.svg)](https://modrinth.com/plugin/smart-spawner-plugin)
 [![Spigot](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/spigot_vector.svg)](https://www.spigotmc.org/resources/120743/)
 [![Hangar](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/hangar_vector.svg)](https://hangar.papermc.io/Nighter/SmartSpawner)
@@ -22,43 +17,10 @@
 
 ## Requirements
 
-- **Minecraft Version:** 1.20 - 1.21.8
+- **Minecraft Version:** 1.21 - 1.21.8
 - **Server Software:** Paper, Folia or compatible forks
 - **Java Version:** 21+
 
-## Installation
-
-1. Download the latest release from [Modrinth](https://modrinth.com/plugin/smart-spawner-plugin)
-2. Place the `.jar` file in your server's `plugins` folder
-3. Restart your server
-4. Configure the plugin in `plugins/SmartSpawner/config.yml`
-5. Reload with `/ss reload`
-
-## Commands
-
-| Command | Permission | Description |
-|---------|------------|-------------|
-| `/ss reload` | `smartspawner.reload` | Reload plugin configuration |
-| `/ss give <player> <type> <amount>` | `smartspawner.give` | Give spawners to players |
-| `/ss list` | `smartspawner.list` | Open admin spawner management GUI |
-| `/ss hologram` | `smartspawner.hologram` | Toggle hologram visibility |
-
-**Aliases:** `/ss`, `/spawner`, `/smartspawner`
-
-## Permissions
-
-| Permission | Default | Description |
-|------------|---------|-------------|
-| `smartspawner.reload` | OP      | Access to reload command |
-| `smartspawner.give` | OP      | Access to give command |
-| `smartspawner.list` | OP      | Access to admin GUI |
-| `smartspawner.hologram` | OP      | Toggle hologram display |
-| `smartspawner.stack` | true    | Allow spawner stacking |
-| `smartspawner.break` | true    | Allow spawner breaking |
-| `smartspawner.sellall` | true    | Allow selling storage items |
-| `smartspawner.changetype` | OP      | Allow changing spawner types with eggs |
-| `smartspawner.limits.bypass` | false   | Bypass spawner limits per chunk |
-
 ## Localization
 
 | Language | Locale Code | Contributor | Status |
@@ -71,12 +33,12 @@
 
 ## API
 
-For developers interested in integrating with SmartSpawner, visit our [Developer API Documentation](https://github.com/ptthanh02/SmartSpawner/wiki/Developer-API-Documentation) for installation instructions and documentation.
+For developers interested in integrating with SmartSpawner, visit our [Developer API Documentation](https://nighterdevelopment.github.io/smartspawner-docs/developer-api/) for installation instructions and documentation.
 
 ## Building
 
 ```bash
-git clone https://github.com/ptthanh02/SmartSpawner.git
+git clone https://github.com/NighterDevelopment/smartspawner.git
 cd SmartSpawner
 ./gradlew build
 ```
@@ -94,7 +56,7 @@ The compiled JAR will be available in `build/libs/`
 
 ## Support
 
-- **Issues & Bug Reports:** [GitHub Issues](https://github.com/ptthanh02/SmartSprawner/issues)
+- **Issues & Bug Reports:** [GitHub Issues](https://github.com/NighterDevelopment/smartspawner/issues)
 - **Discord Community:** [Join our Discord](https://discord.gg/zrnyG4CuuT)
 
 ## Statistics

api/src/main/java/github/nighter/smartspawner/api/SmartSpawnerAPI.java

@@ -10,15 +10,15 @@
 public interface SmartSpawnerAPI {
 
     /**
-     * Creates a spawner item with the specified entity type
+     * Creates a SmartSpawner item with the specified entity type
      *
      * @param entityType The type of entity this spawner will spawn
      * @return An ItemStack representing the spawner
      */
     ItemStack createSpawnerItem(EntityType entityType);
 
     /**
-     * Creates a spawner item with the specified entity type and a custom amount
+     * Creates a SmartSpawner item with the specified entity type and a custom amount
      *
      * @param entityType The type of entity this spawner will spawn
      * @param amount The amount of the item stack
@@ -27,18 +27,18 @@ public interface SmartSpawnerAPI {
     ItemStack createSpawnerItem(EntityType entityType, int amount);
 
     /**
-     * Gets the entity type from a spawner item
+     * Gets the entity type from a SmartSpawner item
      *
-     * @param item The spawner item to check
-     * @return The EntityType of the spawner, or null if the item is not a valid spawner
+     * @param item The SmartSpawner item to check
+     * @return The EntityType of the SmartSpawner, or null if the item is not a valid spawner
      */
     EntityType getSpawnerEntityType(ItemStack item);
 
     /**
      * Checks if an item is a valid spawner created by SmartSpawner
      *
      * @param item The item to check
-     * @return true if the item is a valid spawner, false otherwise
+     * @return true if the item is a valid SmartSpawner, false otherwise
      */
     boolean isValidSpawner(ItemStack item);
 }

api/src/main/java/github/nighter/smartspawner/api/events/SpawnerBreakEvent.java

@@ -6,7 +6,7 @@
 import org.jetbrains.annotations.NotNull;
 
 /**
- * SpawnerBreakEvent is called when a spawner being broke by a player or an explosion.
+ * SpawnerBreakEvent is called when a spawner being broken by a player or an explosion.
  */
 public class SpawnerBreakEvent extends SpawnerEvent {
     private final Entity entity;

build.gradle

@@ -9,7 +9,7 @@ allprojects {
     apply plugin: 'maven-publish'
 
     group = 'github.nighter'
-    version = '1.5.2'
+    version = '1.5.3'
 
     repositories {
         mavenCentral()

core/src/main/resources/gui_layouts/DonutSMP/main_gui.yml

@@ -23,6 +23,7 @@ buttons:
     condition: "shop_integration"
     actions:
       left_click: "sell_inventory"    # Collect EXP and sell items in storage
+      right_click: "sell_inventory"   # Collect EXP and sell items in storage
 
   # Spawner information display without shop integration
   # Without shop integration: Both clicks open stacker GUI

core/src/main/resources/mob_drops.yml

@@ -335,18 +335,6 @@ MOOSHROOM:
       amount: 1-3
       chance: 100.0
 
-# Reference: https://minecraft.wiki/w/Mooshroom#Drops
-# Legacy 1.20 fallback
-MUSHROOM_COW:
-  experience: 1
-  loot:
-    LEATHER:
-      amount: 0-2
-      chance: 100.0
-    BEEF:
-      amount: 1-3
-      chance: 100.0
-
 # Reference: https://minecraft.wiki/w/Mule#Drops
 MULE:
   experience: 1

core/src/main/resources/spawners_data.yml

@@ -6,6 +6,7 @@
 #      entityType: ENTITY_TYPE
 #      settings: exp,active,range,stop,delay,slots,maxExp,minMobs,maxMobs,stack,maxStack,time,atCapacity
 #      filteredItems: MATERIAL1,MATERIAL2,...
+#      lastInteractedPlayer: PlayerName
 #      inventory:
 #      - ITEM_TYPE:amount