AbyssalLib -----
An all-purpose library, which makes integration easier aswell- Structure API along with ingame Structure Block for saving/loading ingame
- Worldgen API for generating features with json config support (default has ore, geode, spring and structure and more)
- Color API for Color conversions, creation, and more
- ItemPredicate for weak stack checks
- Transaction and Batch query support for Database
- MySQL implementation for Database
- A few other useful methods for queries and batch queries
- From-scratch Energy API with EnergyUnit support and builtin Energy Network
- Loot table API rewritten to be datadriven, can also be now used to replace or merge with vanilla tables
- More hooks for CustomBlock, and more properties for it
- Almost all loaders can now be used to load relevant object from jar or a folder
- Particle API now uses ColorProvider instead of Gradient
- Tag API now uses ItemPredicate, and has overall been rewritten
- DataComponent uses Type instead of ID, this also removes all reflection related to data component API (thus making it faster than before)
- CustomBlock#place no longer resets placed blocks state (this also means if calling via API, the vanilla block should be placed before calling CustomBlock#place)
- Try utility has been entirely rewritten, any usages must update to new format
- insert() no longer refers to INSERT_OR_REPLACE, use new replace() chain
- All database operations (player statistics, block manager etc) now use optimized db calls (transactions, batch calls, async calls)
- Gradient has been removed (replaced by ColorProvider)
- Removed Deprecated Energy and Particle API
- CustomRecipe class
- RECIPE_CHOICES and RECIPE_TYPES registries
- Rewritten from-scratch Particle API.
- Timeline API for animating particles (optional, particles can be animated directly in generator or in your own transformers)
- Merge PR #2 , Adding Player-aware tooltips and slot validation for Item#onClickInInventory (by @ynovka)
- CTag#set(String, CTag) and CTag#getCompound(String) for setting compound tags
- Old particle API is marked for removal
- renamed Item#getRawStack() -> Item#getStack() (#2)
- CustomRecipe class
- RECIPE_CHOICES and RECIPE_TYPES registries
- Removed Item#getStack()
## **Fix:**
- Kotlin classes no longer cause errors when used
- Kotlin classes no longer cause errors when used
- Item#onInventoryClick fires for hotbar swapped items now
- Plugin Hooks now properly load
New:
Changes:
- Command /abyssallib reload pack which resends all packs (including external packs)
- Config#value method that takes in a Codec for serializing values.
- PacketEvent#setPacket so that the packet may be modified in Recieve/Send events
- Experimental entity natural spawning system for custom entities.
- external_packs: list in config to allow sending packs other than ones registered using ResourcePack#register
- InventoryClickType (Bukkit ClickType duplicate) to avoid conflict with ClickType
- Item#onClickInInventory and Item#onInventoryTick (tick is untested and may be removed if performance is impacted too much)
- ItemBridge and BlockBridge have been vastly improved.
Changes:
- ItemStack Codec no longer forces YAML format for `data:` section.
- Most save/remove DB operations are now Async (should improve performance)
- All permissions have been changed to more standard ones and should now appear in LuckPerms web editor properly
Code (Text):
abyssallib.admin.give -> abyssallib.items.give
abyssallib.admin.attribute -> abyssallib.attribute.get
abyssallib.admin.summon -> abyssallib.entity.summon
abyssallib.player.statistic_self -> abyssallib.statistics.view.self
abyssallib.player.statistic_all -> abyssallib.statistics.view.all
abyssallib.player.statistic_self.menu -> abyssallib.statistics.menu.self
abyssallib.player.statistic_all.menu -> abyssallib.statistics.menu.all
abyssallib.admin.reload -> abyssallib.reload
abyssallib.content.items.view (new)
abyssallib.admin.attribute -> abyssallib.attribute.get
abyssallib.admin.summon -> abyssallib.entity.summon
abyssallib.player.statistic_self -> abyssallib.statistics.view.self
abyssallib.player.statistic_all -> abyssallib.statistics.view.all
abyssallib.player.statistic_self.menu -> abyssallib.statistics.menu.self
abyssallib.player.statistic_all.menu -> abyssallib.statistics.menu.all
abyssallib.admin.reload -> abyssallib.reload
abyssallib.content.items.view (new)
New:
- Network based Energy system in favor of isolated energy system
- EnergyNetworkTransferEvent, EnergyNodeChangeEvent, EnergyNodeAddEvent, EnergyNodeRemoveEvent for new Energy API
- ItemEnergyNode datacomponent for custom items that supports holding any EnergyNode
- Multiblock API completely overhauled and is now ready for use (docs soon)
- Old Energy API completely marked as Deprecated for removal
New:
- ItemsAdder items can now be used in recipes and tags (ia:namespace:id), (Blocks for tags too)
- Either<A, B> (kinda just DFU version) aswell as Codec<Either<A, B>> type has been added (Codec.either)
- OneOf codec for allowing attempt of many codecs (next-if-previous-failed) (Codec.oneOf)
- Item Definitions inside recipes and tags now support data component modifications (e.g
-
check out docs for the format of each component). this also makes it cleaner (as before items wwith amount were defined as {"item:id", amount}).Code (YAML):id : minecraft:stick
[*] amount : 2
[*] data:
[*] minecraft:unbreakable : ""
[*] minecraft:max_stack_size : 2
- Codec.either -> Codec.fallback
- EitherCodec -> FallbackCodec
- Codec#list/collection now works as intended on FallbackCodec
- Only one BlockEntity ticking after chunk is reloaded (or server restarts)
New:
- ListedLayers#reset() and PaginatedElements#reset() [Useful if layer hasn't been added to GUI and is being handled by another layer]
- Item#onSwapHand, Item#onSlotChange, Item#onDrop, Item#onPickup ( #1)
Changes:
- Item#onUse now has a third argument ClickType showing what type of click it was (left/right) ( #1)
Fixes:
- BlockInteractionEvent#getInteractionPoint is now Nullable
- ListedLayers#reset() and PaginatedElements#reset() [Useful if layer hasn't been added to GUI and is being handled by another layer]
- Item#onSwapHand, Item#onSlotChange, Item#onDrop, Item#onPickup ( #1)
Changes:
- Item#onUse now has a third argument ClickType showing what type of click it was (left/right) ( #1)
Fixes:
- BlockInteractionEvent#getInteractionPoint is now Nullable
- Selector.Select type has been added (Component select has NOT been added yet)
- BukkitBlockExtensions with (currently) 1 method, Block#getPDC, this calls BlockPersistentData.get(Block)
Fixes:
- Blocks properly load now.
- Selector.Select json output is now ordered
- Block/Entity/Multiblock databases no longer duplicate content
- BlockEntity superclass Property<>(s) also get saved now
- Blocks now get properly removed from database
Removal:
- (none)
Fixes:
Additionally, I apologize for not including -mcx.x.x in previous 2 version
- Blocks properly get saved
- BlockEntity no longer gets overwritten on new block placement
Additionally, I apologize for not including -mcx.x.x in previous 2 version
- Default plugin_icon is no longer a missing texture (no resourcepack reset needed)
- BlockInteractionEvent is now called and handled correctly
- Plugin Icon items no longer show in give cmd and Item Menu
- CustomRecipe#getCodec (had no real use)
From now on AbyssalLib will receive
smaller updates as well as
dev versions (dev only on GitHub)
For Developers: you should now add a lang key `plugin.<plugin_id>` so that you can show a proper name inside ItemMenu (default is plugin_id). Optionally, also add an icon.
New:
For Developers: you should now add a lang key `plugin.<plugin_id>` so that you can show a proper name inside ItemMenu (default is plugin_id). Optionally, also add an icon.
New:
- Statistics Menu, and Item Menu for viewing said content (view permissions in docs)
- Namespace#icon for specifying the plugin icon to show in /abyssallib content items (textures/items/icon.png)
- EntitySpawner component for items that spawn custom entities
- Statistics API for adding custom Statistics to players
- Command now supports aliases
- Codecs for all DataComponents
- Codec#collection and Codec#collection(collectionConstructor) (e.g. codec.collection(HashSet::new))
- Entity now supports DataComponent (not Vanilla ones, only custom)
- EnergyContainer component (wrapper for SimpleEnergyContainer)
- A lot of new codecs in ExtraCodecs and Codecs
- oversizedInGui field for ItemDefinition
- Kotlin player and entity extensions for various methods
- Kotlin GuiBuilder, DamageTypeBuilder, ParticlesBuilder, LootTableBuilder, LootPoolBuilder, RecordCodec
- Model now includes guiLight, textureSize, ambientOcclusion
- Model.Element now includes shade and lightEmission
- Added byte[] data Overloads for all assets (cannot edit them via code afterward)
- ResourcePack#unregister (does nothing under RSPM; reload RSPM instead)
- Add back many constructors to DataComponents to fix component loading
- BlockEntity now only serializes variables of type Property<>
- BlockManager no longer uses TextUtil.GSON for serialization/deserialization
- AttributeModifier → ItemAttributeModifier
- Many constructors with easier-to-use versions for DataComponents
- DataComponent constructor now accepts subclass Codecs (Codec<ToolComponent> instead of Codec<DataComponent<Tool>>)
- Entity Loading is now fixed
- Codec<Component> (TEXT_COMPONENT in Codecs) now uses MiniMessage for serializing/deserializing
- ItemBridge properly loads items now (also fixes ITEM_STACK codec)
- Registry no longer crashes plugin if a duplicate ID is registered (it skips instead)
- Item Components randomly not applying
- Typo in ItemModel which caused it to replace ItemName
- Possibly fix Entity Spawning
- Logging from SimpleEnergyContainer
- WorldMeta
- Experimental Multiblock API
- PaginatedElements#getPage to get current page
- Experimental Energy API
- Config class as a wrapper to YamlConfiguration
- Rewritten Item api (mostly same, only getSettings() is no longer applicable)
- Server owners can load recipes using yml files.
- Codec API for serialization
- ItemBridge for easily getting ItemStacks from different sources based on ID (used in Recipe loading)
Removal:
- BlockInteractionEvent {buggy and redundant}
- Annotation based Config API {Extremely fucked}
- CustomBlockBreak {very buggy, and not useful}
- ToolType and ToolTier {may or may not be temporary}
- MySQL impl of Database API {impl wasnt good}
Changes:
- Full rewrite of Particles, Shape, Shapes and AnimatedShapes
- EventBus.post is now a static method
- Classes from /world/level/ moved to /world/ (some more classes were also moved to common/)
- Block.java -> CustomBlock.java to resolve name conflict
Fixes:
- Gui no longer opens if player is sleeping or in a portal
New:
Changes:
Fixed:
- Equipment .json loading/creating
- Blockstate .json loading/creating
- PostEffect .json loading/creating
- WaypointStyle loading/creating
- Updated to RSPM 1.5.0
Changes:
- No longer delays resourcepack generation/registration.
Fixed:
- McMeta files being created in root of resourcepack
New:
- McMeta, PackMcMeta and Pack icon support in ResourcePack/Namespace
Changes:
Fixes:
* I apologize for messing up versioning, previous version was meant to be 1.4.0
- BlockManager now only ticks BlockEntities of loaded chunks (should improve performance)
- registerTypeAdapter seperate into itself and registerTypeHierarchyAdapter in BlockManager.
Fixes:
- Error when breaking block
- All Blocks sharing same BlockEntity
- Blocks not being removed
* I apologize for messing up versioning, previous version was meant to be 1.4.0
New:
Fixed:
Changes:
- Update to 1.21.7
- BlockBrokenEvent contains fortune level of item and can be used to interrupt drops and handle them manually
- Item(s) can be made to place Block(s) using getSettings().blockItem(Block) now
- Newconfig api! (old one is in .legacy package)
- New gui api (no javadocs yet)
Fixed:
- ItemTag#contains
- BlockTag#contains
- BlockManager loads blocks properly
- TextOffset not working properly
Changes:
- Removed RecipeAPI (broken)
- Item#data changed to #setData and #getData
- GuiManager methods are now static
- ChatInputHandler methods are now static
Fixes:
- Blocks not being saved
- EntityAttributes db file not being created
- Entity db file not being created
- Packets causing players to disconnect
- TextOffset not working
- Bitmaps not loading properly
New:
Changes:
Fix:
- Block(Identifier, Material) constructor
Changes:
- PlayerAttributes renamed to EntityAttributes (can store attributes for any entity now)
Fix:
- Static getHandlerList in all custom events
New:
Changes:
- Config option
to disable/enable the block hardness mechanic (default false as visuals are buggy)Code (YAML):`features.custom_block_breaking`
- AttributeModifier and AttributeOperation for PlayerAttribute API (modifiers are unloaded upon restart, they must be manually added back)
- Font#glyph has been readded
Changes:
- Packet API now provides PacketReceiveEvent and PacketSendEvent
- PlayerData renamed to PlayerAttribute (now only supports Number (int, float, byte, etc))
Changes:
New:
Removed:
- Item and Block API have been rewritten in alot of parts.
- Config API has been moved to .legacy in favor of possibly new API
- ResourceLocation is now Identifier and made using Identifier#of
- ResourcePack API has been rewritten from scratch
New:
- BaseMap which can be extended to make your own maps
- BlockEntity (for Block ticking and data)
- ParticleEmitter for dynamic particle source
- ItemDisplay capabilities to particle API
- PlayerData and Attribute API
- DamageType API (not tested, requires BootStrap)
- WorldMeta class for easy use of world PDC
- DataPack class for loading datapacks from within plugin (requires bootstrap)
- BlockProperties which allow setting custom hardness, allowing fortune/requiring silktouch for blocks (will be expanded).
- Custom block break handling (has visual bugs)
- Experimental entity api (no loot table/ event hooks in-class, need to be handled in respective events for now)
- ItemType and ItemTier
- Experimental packet api
- TTF, bitmap char arrays, unihex and space provider support for Font class
- TextOffset class for easily getting any offset (gui position etc)
- keepAlive to MySQL database
Removed:
- BlockData removed in favor of BlockEntity
- Builtin RecipeViewer and Recipe serialization removed in favor of WIP separate plugin.
Changes:
- Rewrote GUI API to support multi-player inventories (docs will be updated soon)
- GUI still ticking after closing
New:
- Middle Click now picks the blocks item (if it exists) instead of the vanilla item
- Rewrote Item class (for devs):
- There is NO change in how you register the item or create them, but now, instead of passing the Item as an ItemStack, you must call Item#stack() instead
- Item no longer extends ItemStack
New:
- ResourcePackDeleteEvent and ResourcePackGenerateEvent
- Added EventBus#post(Event) for calling events (overlay for bukkits method)
- Added a static instance of EventBus in AbyssalLib class, can be used if you dont want to make your own instance
- You need to call GlyphWriter#writeAll(modid) to generate the glyphs into the pack properly now, this MUST be done BEFORE ResourcePack#generate()
Changes:
- Rewrote Particle API
Added PlayerEnterWaterEvent and PlayerExitWaterEvent
Changes:
- Rewrote LootTable API
- Rewrote ConfigSpec
- Rewrote Block API (BlockItem related)
- Rewrote Tag API
Added Database api
Added Particle API - Beta
Added Particle API - Beta
Fixed Class not found
Reworked Contexts to be more consistent
Reworked GUI system to use MenuType, docs are being updated
added JavaDocs! (most classes are covered)
Glyps will be reworked next!!
Reworked GUI system to use MenuType, docs are being updated
added JavaDocs! (most classes are covered)
Glyps will be reworked next!!
Resource Information
Author:
----------
Total Downloads:
536
First Release:
May 4, 2025
Last Update:
Jan 29, 2026
Category:
---------------
All-Time Rating:
Find more info at darksoulq.github.io...
1 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings