PlayerInventory API
This version introduces new experimental PlayerInventory API.
For now, it can be used only to get player's inventory content and equipped items. It can be useful for integration with plugins providing custom player inventory.
API changes
This version introduces new experimental PlayerInventory API.
For now, it can be used only to get player's inventory content and equipped items. It can be useful for integration with plugins providing custom player inventory.
Code (Java):
// Get player's inventory
Mimic mimic = Mimic. getInstance ( ) ;
BukkitPlayerInventory inventory = mimic. getPlayerInventory (player ) ;
// Get items equipped on the player
List <ItemStack > equippedItems = inventory. getEquippedItems ( ) ;
// Get not equipped items stored in the inventory
List <ItemStack > storedItems = inventory. getStoredItems ( ) ;
// Get both equpped and not equipped items
List <ItemStack > allItems = inventory. getItems ( ) ;
Mimic mimic = Mimic. getInstance ( ) ;
BukkitPlayerInventory inventory = mimic. getPlayerInventory (player ) ;
// Get items equipped on the player
List <ItemStack > equippedItems = inventory. getEquippedItems ( ) ;
// Get not equipped items stored in the inventory
List <ItemStack > storedItems = inventory. getStoredItems ( ) ;
// Get both equpped and not equipped items
List <ItemStack > allItems = inventory. getItems ( ) ;
- Make implementations ID validation less strict.
Since now, it may contain more special symbols: ._- - Make ServicesManager extensions inaccessible from Java
- Added command /mimic inventory info to get info about current player inventory provider
- Catch not only Exceptions from ItemsRegistry implementations but also Errors.
ItemsRegistry will not crash other plugins.
- Versioning strategy changed.
Now version always includes PATCH version according to SemVer. - Update Kotlin to 1.6.20
- Update bStats to 3.0.0
- Update ACF to 0.5.1-SNAPSHOT
- Update Gradle to 7.4.2
- Update Dokka to 1.6.20
- Update binary-compatibility-validator to 0.9.0
- Update gradle-download-task to 5.0.5
Fixed
- Compatibility with Minecraft 1.13 - 1.16.5
- FileNotFoundException on config initialization
BE CAREFUL!
This update brings breaking changes for ClassSystem and LevelSystem registration.
Please verify levels and classes integrations works properly after update to Mimic v0.7.
New implementations registration API
Registration via ServiceManager is deprecated because it was error-prone and not intuitive.
Since now, you should use class Mimic to register or get APIs implementations.
New mechanism allows maintaining better backward compatibility for APIs implementations.
It also allows users to select preferred APIs implementation via config.
API Changes
This update brings breaking changes for ClassSystem and LevelSystem registration.
Please verify levels and classes integrations works properly after update to Mimic v0.7.
New implementations registration API
Registration via ServiceManager is deprecated because it was error-prone and not intuitive.
Since now, you should use class Mimic to register or get APIs implementations.
Code (Java):
Mimic mimic
= Mimic.
getInstance
(
)
;
// Register ItemsRegistry implementation
mimic. registerItemsRegistry ( new MyItemsRegistry ( ), plugin ) ;
// Get items registry imlpementation
BukkitItemsRegistry registry = mimic. getItemsRegistry ( ) ;
// Register ItemsRegistry implementation
mimic. registerItemsRegistry ( new MyItemsRegistry ( ), plugin ) ;
// Get items registry imlpementation
BukkitItemsRegistry registry = mimic. getItemsRegistry ( ) ;
It also allows users to select preferred APIs implementation via config.
API Changes
- Added default implementations for MimicService methods:
- isEnabled() returns true by default
- getId() returns lowercase plugin name by default
- Breaking change! ID should contain only lowercase Latin letters and digits (a-z, 0-9).
- Breaking change! BukkitClassSystem.Provider and BukkitLevelSystem.Provider converted to interface instead of abstract classes.
If you want to use ID different from plugin name, you should override getId() method. - BukkitClassSystem.Provider and BukkitLevelSystem.Provider are functional interfaces since now.
- Added config file allowing to specify preferred APIs implementations.
- Fixed errors in case when commands used from console.
Fixed
- Update MMOItems and MMOCore to the latest version
API Changes
- Added vararg variants of ClassSystem methods
- Check plugin exists before registering built-in integrations
- Isolate MimicItemsRegistry from exceptions thrown from other items registries implementations.
- Update Kotlin to 1.6.10
- Update Gradle to 7.3.3
- Migrate tests to MockK and Kotest assertions
Fixed
- MimicApiLevel.checkApiLevel now works correctly
API
- Add MimicApiLevel class to check current running Mimic API version:
Code (Java):// Specify here the version required for APIs you use.
if ( !MimicApiLevel. checkApiLevel (MimicApiLevel. VERSION_0_6 ) ) {
println ( "At least Mimic 0.6 is required. Please download it from {link here}" )
} - Add optional payload to ItemsRegistry.getItem. It may be used to customize item.
- More detailed output of command /mimic items info:
Code (Text):Items Service: mimic
Known IDs amount: 1161
rpginventory: 4
quantumrpg: 55
mmoitems: 126
minecraft: 976 - Improve integration with Heroes class system (#14)
- Add statistics about used items registries
- Add payload support to MinecraftItemsRegistry.
- Add API binary compatibility validation
- Publish docs to GitHub Pages
- Update Kotlin to 1.5.21
- Update bukkit-gradle to 0.10.0
- Update Gradle to 7.2
- Simplified ClassSystem
Resource Information
Author:
----------
Total Downloads:
2,941
First Release:
Aug 8, 2020
Last Update:
Apr 18, 2022
Category:
---------------
All-Time Rating:
2 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings