Update criteria documentation authored by Ashijin's avatar Ashijin
0.0.5 [[_TOC_]]
=====
# 5.12.0
General
-------
- Updated the MythicMobs dependency to `5.12.0`
- Converted achievement config loading to use Mythic's `MythicConfig`
- Added unit test support
- Added `deployToTest` Gradle task using `mcPluginTestServer.host`, `mcPluginTestServer.port`, `mcPluginTestServer.user`, and `mcPluginTestServer.password`
- Made deploy tasks run unit tests before deployment
- Expanded the default `ExampleAchievements` category with examples covering every built-in criteria
Criteria
--------
### NEW: DamageDealt
- Added `damageDealt` criteria for tracking player damage against matching entity types, damage causes, and minimum damage values
### NEW: DamageTaken
- Added `damageTaken` criteria for tracking damage taken by players, with optional damager type, damage cause, and minimum damage filters
### NEW: Enchant
- Added `enchant` criteria for tracking item enchanting, enchantment keys, level costs, and minimum enchantment levels
### NEW: Fish
- Added `fish` criteria for tracking fishing states, caught items, and caught entities
### NEW: ItemConsume
- Added `itemConsume` criteria for tracking consumed items and equipment slots
### NEW: ItemPickup
- Added `itemPickup` criteria for tracking picked-up items by actual picked-up stack amount
- Added `IgnorePlayerDrops`, `PreventPlayerDrops`, and `ExcludePlayerDrops` options for pickup criteria
- `IgnorePlayerDrops` now defaults to `true`
- Player-dropped item tracking is stored on the item entity, not the item stack, so item stacking is not broken
### NEW: PlayerInteract
- Added `playerInteract` criteria for tracking player actions against matching held items, clicked blocks, and hands
### NEW: PlayerStatistic
- Added `playerStatistic` criteria for tracking Bukkit statistic increments with optional material or entity filters
### NEW: ProjectileHit
- Added `projectileHit` criteria for tracking player-shot projectile hits against matching hit types, entities, and blocks
### NEW: Trade
- Added `trade` criteria for tracking villager trade result items
Improvements
------------
- Item-related criteria now use MythicMobs' `BukkitItemMatcher`
- Item-related criteria now support matching multiple items with comma-separated values or `Items` lists
- Block break and block place criteria now support comma-separated block material lists
- Added Mythic command and menu functions for achievements
- Added configurable registration for player and admin commands
Bug Fixes
---------
- Fixed SQL persistence issues
- Fixed `incrementAchievement` mechanic issues
- Fixed command handling issues
- Fixed achievement rewards not activating when achievements were granted through plugin-controlled grant paths
# 0.0.5
General General
------- -------
- Added MySQL support - Added MySQL support
0.0.1 # 0.0.1
=====
General General
------- -------
...@@ -14,4 +75,4 @@ General ...@@ -14,4 +75,4 @@ General
Bug Fixes/Other Bug Fixes/Other
--------------- ---------------
- ??? - ???
\ No newline at end of file