ВЕРСИИ (4)

## v1.3.0 – The Function Update > Adds custom named parameters to `skfunction`, allowing MythicMobs skills to pass text, numbers, booleans, and colors directly into Skript functions. --- ### ✨ New Syntax (Custom Parameters API) - **Named Function Parameters:** - MythicMobs skill fields are now passed to Skript function parameters with the same name. - `text`, `number`, `boolean`, and `colordata` parameters are supported. - **Runtime Values:** - Custom parameter values support MythicMobs placeholders and are resolved when the skill is cast. - Entity and location targets can be used when resolving parameter values. - **Color Data Support:** - `#RRGGBB`, `#AARRGGBB`, `R,G,B`, and Bukkit dye-color names are supported. --- ### ♻️ Core Refactoring & Improvements - **Validation:** Missing, unsupported, and invalid function parameters now produce clear Skript warnings and return `INVALID_CONFIG`. - **Compatibility:** Updated support for Paper (and its forks) to 1.21.4 - 26.2. - **Clean Up:** Removed the unused `version.txt` resource, the obsolete ActiveMob wiki page, and legacy `javax.annotation.Nullable` usages. > *Check out [the Wiki](https://github.com/Andromedov/MythicSkriptAddon/wiki) for a full guide and examples on how to use the new `skfunction` parameters!*

## 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 `NullPointerException`s 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.