v1.1.0 – The Item Update

A massive expansion for MythicMobs items integration, introducing powerful new syntax for giving, taking, dropping, and checking custom items, alongside significant internal optimizations.

✨ New Syntax (Items API)

• New Effects:
  • give mythic[ ]item %string% [with amount %-number%] to %players% — gives a mythic item to one or more players. If the inventory is full, the leftover items are safely dropped at the player's feet.
  • take [amount %-number%] mythic[ ]item %string% from %players% — safely removes a specific amount of a mythic item from player inventories.
  • drop mythic[ ]item %string% [with amount %-number%] at %locations% — drops a mythic item naturally at the specified location(s).
• New Expressions:
  • [the ]mythic[ ]type of %itemstack% — retrieves the internal MythicMobs type name of a given item.
  • [the ]amount of mythic[ ]item %string% (in|of) %player%['s inventory] — counts exactly how many items of a specific mythic type a player currently has.
• New Conditions:
  • %itemstack% is[n't] [a ]mythic[ ]item %string% — checks if an item matches a specific mythic type.
  • %player% (has|does(n't| not) have) mythic[ ]item %string% [with amount %-number%] — checks if a player has a required amount of a specific mythic item.
• Negation Support: Added robust negation support (isn't, does not have) for all new and existing mythic item conditions.

♻️ Core Refactoring & Improvements

• Safe API Migration: The ItemStackisMythicItem condition was migrated from legacy direct NBT access to the official Utils.itemManager API, preventing hidden NullPointerExceptions when interacting with damaged or modified items.
• Centralized Item Logic: Introduced the MythicItemHelper utility class to handle item generation and amount parsing, ensuring DRY principles and consistent behavior across all item-related effects.
• Improved Debugging: Added automatic Skript.warning() logs to the console whenever an unknown MythicItem name is used in scripts, preventing silent failures and making debugging much easier.
• Metrics: Added anonymous plugin tracking via bStats to help monitor plugin usage and statistics.

📖 Check out the Wiki for guides and examples on how to use these new features!

v1.0.0 — Major Rewrite & API Migration

Full rewrite of the plugin targeting Paper 1.21.x, MythicMobs 5.12.0, and Skript 2.15.2 (new arguments API).

🔧 Build & Dependencies

• Migrated to Java 21 (previously Java 16).
• Replaced legacy Maven repositories with official ones:
  • repo.papermc.io for Paper API
  • repo.skriptlang.org for Skript
  • mvn.lumine.io for MythicMobs
• All plugin dependencies (paper-api, Skript, Mythic-Dist) are now declared as compileOnly.
• Added the Shadow Gradle plugin (com.github.johnrengelman.shadow 8.1.1) for proper JAR packaging.
• Added gradle.properties with explicit version variables for all dependencies.

♻️ Core Refactoring (Skript 2.14+ / 2.15+ API)

• Completely rewrote the addon entrypoint (MythicSkript.java):
  • Proper dependency validation on enable — plugin disables itself with a clear error if MythicMobs or Skript is missing or not enabled.
  • Migrated from the old Skript.registerAddon(plugin) call to the new Skript.instance().registerAddon(Class, name) API that returns a SkriptAddon.
  • Replaced scattered MythicClasses, Conditions, Effects, Events, Expressions, Functions static registration calls with a single AddonModule implementation.
• Introduced MythicSkriptModule — a new AddonModule that consolidates all class, condition, effect, expression, event, and event-value registrations using the new SyntaxRegistry API.

🐛 Bug Fixes

• Fixed potential ArrayIndexOutOfBoundsException in condition classes (e.g. CompareEntityLocationCondition) caused by unguarded argument access.
• Fixed an argument overwriting bug in the ItemDrop class.
• Improved type safety for SkillMetadata, Location, and Entity argument checks in SkriptfunctionMechanic.

✨ New / Changed Syntax

• Added GetMythicSpawnerByName expression: mythicspawner of name %string%.
• Added SpawnerName expression: name of mythicspawner %mythicspawner%.
• Registered the activeplayer class (wrapper around ActivePlayer).
• All previously supported expressions, effects, conditions, events, and classes are preserved and re-registered under the new API.

📄 Project & Documentation

• Added README.md with feature overview, requirements, quick-start example, and links to the wiki.
• Added CHANGELOG.md documenting all versions from v0.83a to v1.0.0.
• Added LICENSE (Apache License 2.0).
• Removed the old readme.md (legacy, outdated).
• Published a Wiki page with full syntax reference and examples.