MythicSkriptAddon: Reborn

v1.2.0 – The Placeholder Update

Introduces a brand-new integration point between MythicMobs and Skript: read global Skript variables directly inside any MythicMobs config field using a native custom Placeholder — no skfunction bridge required for simple value reads.

---

New Syntax (Placeholders API)

- New Placeholder: - <skript.variable_name> — reads the value of a global Skript variable directly inside any MythicMobs config field that supports placeholders (messages, display names, numeric attributes, conditions, and more). - List Variable Support: - <skript.my_list::1> — returns a single indexed value from a Skript list variable. - <skript.my_list::*> — flattens the entire list variable into a single comma-separated string. - Live Resolution: Values are read directly from Skript's variable storage at parse time, so any script that updates a global variable (a command, an event, another skill) is reflected immediately on the placeholder's next resolution — no reload required. ---

Core Refactoring & Improvements

- Clean Up: Cleaned up some code and comments. Nothing out of the ordinary.

Check out [the Wiki](https://github.com/Andromedov/MythicSkriptAddon/wiki/Skript-Variable-Placeholder) for a full guide and examples on how to use this new placeholder!

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](https://bstats.org/plugin/bukkit/MythicSkriptAddon/31569) to help monitor plugin usage and statistics.

Check out [the Wiki](https://github.com/Andromedov/MythicSkriptAddon/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](https://github.com/Andromedov/MythicSkriptAddon/wiki) with full syntax reference and examples.