Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Each release is associated with a specific API version, and any changes to API will have a prefix (API).

Unless otherwise specified, any version comparison below is the comparison of the server version, not the API version.

0.12.1 (API 0.28.0) - Unreleased

Compare with 0.12.0

Added

• (API) Added DDUI support for Bedrock 1.26.10+ (protocol v944+), including DDUI, DDUIViewer, DDUIScreenSession, CustomFormScreen, MessageBoxScreen, Observable, Property, and the custom-form element set (Label, Header, Spacer, Divider, TextField, Toggle, Slider, Dropdown, Button, CloseButton).
• (API) Added custom dimension support via DimensionType, DimensionTypes, and Registries.DIMENSIONS, allowing plugins to register custom dimension types with persistent numeric ids.
• (API) Added ItemTags.FIREPROOF for items that should remain fireproof when dropped as item entities.
• Added dimension-ids.yml in the server working directory to persist custom dimension identifier-to-id mappings for custom dimensions.
• Added support for changing the height of vanilla dimensions.
• Implemented bone meal interaction on grass blocks, allowing grass, flowers, and tall grass to generate from grass blocks.
• Added support for NetEase 1.21.90.
• Updated feature version to 1.26.10

Changed

• (API) Merged org.allaymc.server.bossbar.AllayBossBar into the concrete org.allaymc.api.bossbar.BossBar class, so boss bars no longer use separate API interface and server implementation types.
• (API) Replaced DimensionInfo across world, chunk, storage, generator-context, and player dimension-change APIs with the new DimensionType model.
• (API) Implemented meaningful toString() output for EffectType and EffectInstance to improve logs and debugging output.
• Changed world and player persistence to store dimension identifiers instead of raw numeric ids, while keeping backward-compatible reads for old numeric dimension data.
• Changed world-settings.yml dimension configuration to use a dimensions: map keyed by identifiers. Legacy overworld/nether/the-end entries are still read, identifiers missing a namespace are normalized to the minecraft namespace when saved.
• Added custom dimension definition syncing during login through DimensionDataPacket; Bedrock generator type mapping is now handled internally by the network layer.

Fixed

• Fixed soul fire so it now damages and ignites living entities correctly, and fixed dropped fireproof items such as netherite gear being incorrectly destroyed by fire or lava.
• Fixed redundant food-level change events and repeated food-level packet sends when the effective food level did not change.
• Fixed small dripleaf breaking recursively triggering Dimension.breakBlock() between its upper and lower halves, which could spam BlockSmallDripleafBaseComponentImpl.onBreak() stack traces and overflow the stack.

Removed

• (API) Removed legacy DimensionInfo.
• Removed support for bedrock (NetEase) 1.21.50 and 1.21.80.

0.12.0 (API 0.27.0) - 2026/3/29

Compare with 0.11.1

Added

• (API) Added entity-attached debug shape support via DebugShape.get/setAttachedEntity() and EntityBaseComponent.attachDebugShape(), getAttachedDebugShapes(), detachDebugShape(), allowing debug shapes to follow entities client-side.
• (API) Added camera shake API (Player.shakeCamera(), Player.stopCameraShake()) and implemented /camerashake command.
• (API) Added fog API (Player.pushFog(), Player.popFog(), Player.removeFog(), Player.removeAllFogs(), Player.getFogs()) with FogIds constants, and implemented /fog command.
• (API) Added BiomeTags constants interface with code-generated biome tag definitions.
• (API) Added BlockEntityChiseledBookshelf, BlockEntityChiseledBookshelfContainerHolderComponent, ContainerTypes.CHISELED_BOOKSHELF, ItemTags.CHISELED_BOOKSHELF_BOOK, and ChiseledBookshelfSound.
• (API) Added ItemTags.ALLOW_OFFHAND for marking items that are allowed in the offhand slot.
• (API) Added ItemWearableComponent as the shared wearable contract for armor, elytra, carved pumpkins, and heads.
• Added custom biome support. Plugins can register custom biomes via new AllayBiomeType(Identifier, BiomeData) with auto-allocated persistent IDs (starting from 30000, saved to biome_ids.yml).
• Added AllayBlockType.Builder.customizeItemType(Consumer<AllayItemType.Builder>) to customize automatically generated block item types for custom blocks.
• Added BlockStateDefinition.MaterialInstance.alphaTestToOpaque(String), alphaTestSingleSidedToOpaque(String), and blendToOpaque(String) convenience factories for custom block material instances.
• Added CustomBlockDefinitionGenerator.setRotationOffset(float) to configure the minecraft:placement_direction y_rotation_offset for custom blocks that use directional state properties.
• Added terminal command prompt tab completion backed by the command tree, including command names, aliases, enum values, and online player targets.
• Added inventory transaction validation for restricted container slots to reject invalid item moves and swaps, such as non-armor items being placed into armor slots.
• Added support for client blob cache.
• Added handler for AutoCraftRecipeAction. Now the player can craft items through the recipe book directly.
• Added shared human-like equipment containers for zombies and armor stands, including armor, offhand, and main-hand item synchronization.
• Implemented the following blocks:
  • Chiseled bookshelf
  • Waterlily
  • Vine
  • Glow lichen
  • Sculk vein
  • Firefly bush
  • Spore blossom
  • Resin clump
  • Redstone ore
• Implemented the following entities:
  • Zombie
• Added support for bedrock 1.26.10.

Changed

• (API) Renamed ArmorStandHandContainer / ContainerTypes.ARMOR_STAND_HAND to EntityHandContainer / ContainerTypes.ENTITY_HAND for shared non-player entity main-hand equipment.

Fixed

• Fixed netherite armor knockback resistance on players and entity equipment containers not being restored after loading from NBT.
• Fixed NBT read errors for players joining with newly created player data by writing a default Rotation field.
• Fixed non-living entities lingering below the world; they are now removed when they fall into the void.
• Fixed /kick message templating so command feedback includes the target player name and custom kick reasons are formatted correctly.
• Aligned multiple tree world features more closely with vanilla/Paper generation behavior, including trunk, foliage, root, vine, podzol, and propagule placement across oak-family, birch-family, spruce-family, jungle-family, cherry, azalea, pale oak, and mangrove trees.
• Fixed mega spruce tree foliage generation by no longer treating existing leaves as free space during tree placement.
• Fixed a bug where custom item tags are not correctly sent.
• Fixed a bug where turn off option network-settings.enable-encoding-protection doesn't have effect.
• Fixed the exception when sending SimpleSound.SHIELD_BLOCK.

Removed

• Removed field CustomItemDefinitionGenerator.allowOffHand, use new item tag ItemTags.ALLOW_OFFHAND instead.

0.11.1 (API 0.26.0) - 2026/3/9

Compare with 0.11.0

Added

• (API) Added WorldGeneratorInitEvent — fired after a WorldGenerator is created but before it is attached to its dimension, allowing plugins to append custom noisers, populators, and post-processors to any generator.
• (API) Added WorldGenerator.addNoiser(), addPopulator(), and addPostProcessor() for dynamically extending generators during initialization (must be called within WorldGeneratorInitEvent).
• (API) Implemented command block.
• (API) Added entity AI framework:
  • EntityAIComponent — core component providing behavior group, memory storage, movement speed, and look/move targets.
  • EntityIntelligent — marker interface for entities with AI.
  • BehaviorGroup — orchestrates the AI tick pipeline: sensors, evaluators, executors, route finding, and controllers.
  • Behavior, BehaviorEvaluator, BehaviorExecutor, BehaviorState — behavior definition and lifecycle.
  • Controller — AI controllers (walk, look, fluctuate).
  • Sensor — environment sensing (nearest player, nearest feeding player).
  • MemoryStorage, MemoryType, MemoryTypes — typed memory system for AI state.
  • RouteFinder, Node — A* pathfinding with flat and 3D route finders.
  • EntityParallelTickComponent — parallel tick support for entity AI.
• (API) Added entity property system:
  • EntityPropertyType<DATATYPE> sealed interface with BooleanPropertyType, IntPropertyType, FloatPropertyType, and EnumPropertyType<T> concrete types.
  • EntityPropertyTypes constants class (e.g., CLIMATE_VARIANT).
  • EntityType.getProperties() / hasProperty() for querying property definitions on entity types.
  • EntityBaseComponent.getPropertyValue() / setPropertyValue() for reading and writing property values at runtime.
  • Entity properties are persisted via NBT and synchronized to clients via SyncEntityPropertyPacket.
• (API) Added portal-related APIs:
  • Added EntityPortalEnterEvent (cancellable) and PortalCreateEvent (cancellable).
  • Added NETHER_PORTAL and END_PORTAL reasons to EntityTeleportEvent.
  • Added portal state/cooldown API to EntityBaseComponent: get/setPortalTicks(), get/setPortalCooldown(), is/setInNetherPortal(), NETHER_PORTAL_TRANSITION_TICKS, PORTAL_COOLDOWN_TICKS.
  • Added POI APIs for portal lookup: PoiType, PoiTypes, Registries.POI_TYPES, Dimension.findNearestPoi(...), and POI methods on UnsafeChunk.
  • Added dimension change UI helpers to Player: isChangingDimension(), beginDimensionChange(...), completeDimensionChange().
• (API) Added freeze mechanic for powder snow:
  • EntityLivingComponent.getFreezeTicks() / setFreezeTicks() — tracks how long an entity has been inside powder snow (0–140 ticks).
  • EntityLivingComponent.isInPowderSnow() / setInPowderSnow() — flag set each tick by the powder snow block component.
  • EntityLivingComponent.isFrozen() — returns true when freeze ticks reach the maximum.
  • EntityLivingComponent.MAX_FREEZE_TICKS — constant (140) for the freeze threshold.
  • DamageContainer.freezing(float) — factory method for DamageType.FREEZING damage.
• (API) Added NetworkManager interface for managing multiple network interfaces, allowing plugins to register custom transport protocols (QUIC, TCP, WebSocket, etc.) alongside the built-in RakNet interface.
  • Added PlayerManager.getNetworkManager() method.
  • Added cancellable NetworkInterfaceRegisterEvent and NetworkInterfaceUnregisterEvent.
• (API) Added liquid physics for entities including buoyancy and drag in water and lava, with configurable parameters per entity type via EntityPhysicsComponent.
  • Added LiquidState record to EntityPhysicsComponent for tracking entity liquid submersion state.
  • Added EntityBaseComponent.isTouchingLava() method.
• (API) Added entity-related component interfaces:
  • EntityAnimalComponent with breeding item check, EntityAnimal interface.
  • EntityBabyComponent for baby entity growth, EntityDyeableComponent for dyeable entities.
  • EntityHeadYawComponent for head yaw tracking, EntitySheepBaseComponent.
• (API) Added ClimateVariant enum (TEMPERATE, WARM, COLD) and BiomeData.getEntityClimateVariant() for biome-based climate variant resolution.
• (API) Added the following methods to Player:
  • sendHealth(float, float) — sends health and max health to the client.
  • sendAbsorption(float) — sends absorption value to the client.
  • sendMapData(long, BufferedImage) — sends map image data to the client.
  • sendDeathInfo(Pair<String, String[]>) — sends death info to the client.
  • sendItemChargingFinished() — notifies the client that item charging has finished.
  • setMotion(Vector3dc) — sets the motion of the player.
  • getInputMode() — tracks the player's current input mode (mouse, touch, gamepad, etc.).
  • getPlayMode() — tracks the player's current play mode (normal, screen, etc.).
  • getInputInteractionModel() — tracks the player's current input interaction model (touch, crosshair, classic).
• (API) Added InputMode, ClientPlayMode, and InputInteractionModel enums for player input state tracking.
• (API) Added WorldViewer.viewEnchantOptions(List<Pair<Integer, EnchantOption>>) for sending enchantment table options to the viewer.
• (API) Added EntityLivingComponent.getLastDamageTime() / setLastDamageTime().
• (API) Added EntityBaseComponent.getEntityTick() for per-entity tick counter.
• (API) Added translationKey field to BlockStateData and ItemData for block/item translation key support.
• (API) Added ContainerTypes.SHELF container type and Container.saveNBT(boolean saveEmptySlots) overload.
• (API) Added cancellable ShelfUseEvent with SINGLE_SWAP and MULTI_SWAP actions.
• (API) Added new sounds to SimpleSound: BIG_DRIPLEAF_TILT_UP, BIG_DRIPLEAF_TILT_DOWN, BELL_HIT, MILKING, EGG_LAY, POWER_ON, POWER_OFF, ACTIVATED, DEACTIVATED, SHELF_SWAP_SINGLE, SHELF_SWAP_MULTI.
• (API) Added new block tag minecraft:moss_replaceable.
• Implemented nether portal and end portal mechanics:
  • Nether portal frame detection, activation, portal pairing, and cross-dimension teleport.
  • End portal frame completion logic and end portal teleport behavior.
  • End spawn platform creation during teleport to The End.
• Implemented the following blocks:
  • Amethyst, amethyst bud & cluster, budding amethyst
  • Azalea and flowering azalea (bone meal → azalea tree growth)
  • Bamboo and bamboo sapling
  • Big dripleaf and small dripleaf
  • Brown mushroom and red mushroom
  • Cave vines
  • Cocoa
  • Crimson fungus and warped fungus
  • Dragon egg
  • Kelp
  • Moss
  • Moss carpet
  • Nether wart
  • Pale moss
  • Pale moss carpet
  • Pitcher crop and torchflower crop
  • Powder snow
  • Rail, golden rail, detector rail, activator rail
  • Shelf
  • Sea pickle
  • Seagrass
  • Sweet berry bush
• Implemented the following items: cocoa beans, sweet berries, glow berries, kelp, nether wart, torchflower seeds, pitcher pod, blue egg, brown egg.
• Implemented the following entities: sheep, cow, chicken, pig.
• Implemented the following world features: huge brown mushroom, huge red mushroom, huge crimson fungus, huge warped fungus, azalea tree.
• Implemented climate variant property for pig, cow, chicken, and egg entities, with biome-based initialization on spawn.
• Implemented Fire Aspect enchantment.
• Implemented entity item and XP drops on death.
• Added per-chunk POI persistence (LevelDB) and runtime indexing for fast nearest-portal lookup.
• Updated the chunk version to 42 (1.21.120).
• Implemented SHOW_DEATH_MESSAGES game rule — death messages are now suppressed when this rule is disabled.
• Server no longer broadcasts blank join or quit messages when the message text is empty.
• Significantly reduced world save time on shutdown. All chunk and entity writes for each dimension are now accumulated into a single LevelDB WriteBatch and flushed in one db.write() call, instead of one call per chunk/entity-chunk pair. This also required adding WorldStorage.startBatchWrite() and flushBatchWrite() API hooks (no-op defaults) for custom storage implementations.

Changed

• (API) Renamed ItemStuffStorableComponent to ItemShulkerBoxBaseComponent and changed it to extend ItemBaseComponent. The API now uses Map<Integer, ItemStack> (slot index → item) instead of List<NbtMap> for getStoredItems()/setStoredItems().
• (API) Replaced boolean water parameter in BucketFillSound and BucketEmptySound with a Type enum (WATER, LAVA, POWDER_SNOW, FISH) to support all bucket content types.
• (API) Changed EntityPhysicsComponent.updateMotion(boolean) to updateMotion(LiquidState) for richer liquid state information.
• (API) Added EntityPlayerBaseComponent.setBlockSpawnPoint(Location3ic, SpawnPointType) and getSpawnPointType() to distinguish block-anchored spawn points (bed, respawn anchor) from forced ones (e.g., /spawnpoint). Added SpawnPointType enum (FORCED, BED, RESPAWN_ANCHOR) with a stable numeric id for NBT persistence and an invalidSpawnKey field carrying the appropriate i18n message key per type.
• (API) Scoreboard.displayName and Scoreboard.criteriaName are now mutable — added corresponding setter methods.
• Improved physics engine motion threshold handling: small forces (e.g. buoyancy) now accumulate across ticks instead of being zeroed out.
• Refactored network layer: extracted shared session initialization into abstract AllayNetworkInterface base class, renamed RakNet implementation to AllayRakNetInterface.
• Made network settings detection transport-aware, allowing each network interface to report its own compression and encryption capabilities.
• Improved entity auto-save mechanism: entities in loaded chunks are now periodically written to disk on every entityAutoSaveCycle tick interval, rather than only being saved when unloaded or on server shutdown.

Fixed

• Fixed ConcurrentModificationException when registering or unregistering event listeners during event dispatch. Handler lists in AllayEventBus now use CopyOnWriteArrayList instead of ArrayList.
• Fixed block collision shapes being clamped to a maximum height of 1.0. Blocks such as fences, fence gates, walls, and border blocks now correctly use their vanilla collision height of 1.5, preventing players from jumping over them.
• Fixed door collision shapes not changing based on block state. Doors now correctly compute their collision and selection shapes based on cardinal direction, open state, and hinge side.
• Fixed shulker box losing its stored items when cleaned in a cauldron.
• Fixed players without COMMAND_VIEW_OTHER_OUTPUTS permission being unable to view their own command output.
• Fixed incorrect permissions used for gamemode and plugin commands.
• Fixed a bug where permission node Permissions.ABILITY_OPERATOR_COMMAND_QUICK_BAR does not have effect.
• Fixed a bug where player permission in the player list is always visitor even if the player is already an operator.
• Fixed a bug where boss bar is not shown.
• Fixed snow layers incorrectly decaying in cold biomes.
• Fixed default interface methods not being recognized as @EventHandler candidates during event handler scanning.
• Fixed player spawn point not being reset when the bed or respawn anchor it was set by is destroyed. Players with a block-anchored spawn whose block is missing on death now receive the appropriate "not valid" message and respawn at the world spawn.
• Fixed a typo in StructureFile.fromNBT.
• Fixed cancelled BlockBreakEvent occasionally causing the block to disappear from the client's view. The server now correctly reverts the client's predicted block destroy by sending block updates for both layers, and also handles early-rejection cases (insufficient break progress).
• Fixed missing NBT list entries in vector read methods (AllayNBTUtils), which could cause errors when reading incomplete vector data.
• Fixed player location not being set correctly before spawn, which could cause initial position issues.
• Fixed Locale-sensitive string case conversion in AllayStringUtils — now uses Locale.ROOT to avoid locale-dependent behavior.

Removed

• (API) Removed deprecated viewEntityLocation overload from WorldViewer.
• (API) Removed PowerSound record. Use SimpleSound.POWER_ON / SimpleSound.POWER_OFF instead.
• (API) Removed PlayerManager.getNetworkInterface(). Use PlayerManager.getNetworkManager().getDefaultInterface() instead.

0.11.0 (API 0.25.0) - 2026/2/12

Compare with 0.10.7

Added

• (API) Added EntitySleepableComponent interface for entities that can sleep in beds (players, villagers, etc.).
• (API) Added EntitySleepEvent (cancellable) and EntityWakeEvent for entity sleep lifecycle.
• (API) Added WAKE_UP action to SimpleEntityAction for broadcasting wake-up animations.
• (API) Added World.setRequiredSleepTicks() method for controlling sleep-to-day-advance countdown.
• (API) Added PLAYERS_SLEEPING_PERCENTAGE game rule (default 100).
• (API) Added new permission Permissions.COMMAND_VIEW_OTHER_OUTPUTS, player now must have that permission to be able to view other's command outputs.
• (API) Added event PlayerStartFishEvent that will be called when a player tries to throw a fishing rod.
• (API) Added method WorldViewer.viewSleepingIndicator().
• (API) Added method WorldViewer.viewSignEditor() for opening the sign editor interface.
• (API) Added method World.isVirtualTickingThread().
• Implemented bed sleeping: time/weather validation, occupied state, sleeping indicator UI, day advancement after 5-second countdown, and wake-up animation.
• Added max-decompressed-bytes network setting to server-settings.yml to control the maximum decompressed packet size (default 50 MB).
• Added NettyPipelineInitEvent for packet level middleware support. The AllayPlayer instance is attached to the channel attribute.
• Added pitch and yaw parameters to the teleport command.
• Added support for loading and sending behavior packs (NetEase client requires sending behavior packs to the client).
• Implemented tripwire hook and tripwire.
• Implemented armor stand.
• Implemented mangrove propagule growth mechanics (hanging/non-hanging states, bone meal interaction, tree growth).
• Implemented stonecutter recipe crafting support.
• Implemented nether vines including twisting vines and weeping vines.
• Implemented copper bulb.
• Added op/deop options to the Dashboard player list context menu.
• Added per-dimension line charts to the Dashboard chunk and entity graphs, with a right-click context menu to select which world to view. Each dimension (Overworld, Nether, The End) is displayed as a separate colored line with a legend.
• Improved entity tasks handling. Now the Entity Manager task queue uses the same handling strategy as the synced packets, and the entity will be spawned/removed as soon as possible, rather than waiting for the next game tick.
• Added use-virtual-thread world setting to server-settings.yml, allowing worlds to use virtual threads instead of platform threads for world and the dimensions in the world.

Changed

• Changed server module dependencies from implementation to api scope in build.gradle.kts, allowing plugins that depend on the server module to access its transitive dependencies.
• Refactored AllayLevelDBWorldStorage by extracting serialization/deserialization logic into independent codec classes under org.allaymc.server.world.storage.leveldb.codec (ChunkSectionCodec, HeightAndBiomeCodec, BlockEntityCodec, ScheduledUpdateCodec, WorldDataCodec, LevelDBUtils), and moved data enums (LevelDBKey, ChunkVersion, etc.) to the data subpackage.
• (API) Refactored WorldPool.loadWorld() to accept WorldSetting and DimensionSetting records instead of individual parameters.
• (API) Added WorldPool.WorldSetting record containing world name, storage, and virtual ticking thread option.
• (API) Added WorldPool.DimensionSetting record containing world generator and light calculation toggle.
• (API) EntityPlayer now extends EntitySleepableComponent.
• (API) Removed parameter locationLastSent in method WorldViewer.viewEntityLocation() since the use of delta move packet have been removed.
• (API) Moved BlockEntitySignBaseComponent.openSignEditorFor() to WorldViewer.viewSignEditor().
• (API) Renamed EntityState.SPAWNED_NEXT_TICK and EntityState.DESPAWNED_NEXT_TICK to EntityState.SPAWNED_LATER and EntityState.DESPAWNED_LATER to match the code behavior.

Fixed

• Fixed a bug where doors, trapdoors and fence gates would close when placing or breaking normal blocks next to them. Now redstone power is only checked when a power source is placed or removed.
• Fixed a bug where item is used twice when facing a villager.
• Fixed a bug where stonecutter is unusable.
• Fixed a bug where player pitch and yaw could not be specified during teleporting.
• Fixed a bug where in some cases the client will stick at Locating Server stage when joining the server.
• Fixed a bug where player collision box was not updated on the client side after stopping gliding (elytra).
• Fixed a bug where sneaking players could interact with blocks (e.g. opening doors, sleeping in beds) while holding an item, instead of placing the block.
• Fixed a bug where other players' skins would become Steve after the viewer respawns. The old chunk loader was not properly cleaned up during respawn, causing duplicate AddPlayerPacket to be sent without prior RemoveEntityPacket.
• Event EntityDieEvent now will be called before the player's items being dropped.

Removed

• Removed options diff-position-threshold, diff-rotation-threshold and use-delta-move-packet since we no longer use MoveEntityDeltaPacket.

0.10.7 (API 0.24.0) - 2026/1/29

Compare with 0.10.6

Added

• (API) Implemented dispenser and dropper:
  • Added DispenseBehavior interface for defining custom item dispense behaviors.
  • Added DispenseResult class for representing dispense operation results.
  • Added BlockEntityDispenser and BlockEntityDropper interfaces.
  • Added BlockEntityDispenserBaseComponent interface with tryDispense() method.
  • Added BlockDispenseEvent event fired when a dispenser or dropper dispenses an item, allowing plugins to modify or cancel the behavior.
  • Added Registries.DISPENSER_BEHAVIORS registry for registering custom dispense behaviors.
  • Added BlockEntityTypes.DISPENSER and BlockEntityTypes.DROPPER block entity types.
  • Added ContainerTypes.DISPENSER and ContainerTypes.DROPPER container types.
  • Added ItemSpawnEggBaseComponent interface with getEntityType() method for spawn egg items.
  • Added ShootParticle particle for dispenser/dropper shoot effects.
  • Added sounds SimpleSound.BLOCK_CLICK and SimpleSound.BLOCK_CLICK_FAIL.
  • Implemented dispense behaviors for: TNT, fireworks, flint and steel, glass bottle, water bottle, buckets (water, lava, powder snow, fish, axolotl, tadpole), spawn eggs, and projectiles (arrows, eggs, snowballs, tridents, experience bottles, splash/lingering potions).
• (API) Implemented composter:
  • Added ComposterEvent event fired when items are added to or harvested from a composter.
  • Added Registries.COMPOSTABLE_ITEMS for registering compostable items and their composting chances.
• (API) Implemented bell:
  • Added BlockEntityBell interface for bell block entities.
  • Added BellRingEvent event fired when a bell is rung by players, projectiles, or redstone.
  • Added BlockEntityTypes.BELL block entity type.
• (API) Implemented lectern:
  • Added BlockEntityLectern interface with methods for managing stored books and current page.
  • Added BlockLecternBaseComponent interface with methods for book placement and removal.
  • Added LecternPlaceBookEvent, LecternPageTurnEvent, and LecternDropBookEvent events.
  • Added BlockEntityTypes.LECTERN block entity type.
• (API) Implemented pointed dripstone:
  • Added PointedDripstoneDripEvent event fired when pointed dripstone drips fluid.
  • Added PointedDripstoneDripSound for dripstone drip sounds.
  • Added DamageType.STALACTITE and DamageType.STALAGMITE damage types.
• (API) Added method WorldViewer.playPointedDripstoneDripSound() for playing dripstone drip sounds.
• (API) Added method BlockFallableComponent.checkAndFall() for programmatically triggering block falling.
• (API) Added BlockRespawnPointComponent interface for blocks that can serve as respawn points (bed, respawn anchor), with onPlayerRespawn() method to handle respawn logic and safe position finding.
• (API) Added method Block.getLocation() for creating a Location3i from the block's position.
• (API) Added Explosion.sourceBlockType field for custom death messages when explosion is caused by specific blocks (e.g., bed, respawn anchor).
• (API) Implemented decorated pot:
  • Added PotSherds record class representing the four sherds on a decorated pot (front, back, left, right).
  • Added BlockEntityDecoratedPot interface with methods for item storage, sherd management, and comparator output.
  • Added ItemDecoratedPotBaseComponent interface with methods for managing sherds on decorated pot items.
  • Added BlockEntityTypes.DECORATED_POT block entity type.
  • Implemented decorated pot crafting recipe with sherds/bricks pattern support.
• (API) Implemented trident:
  • Added EntityThrownTridentBaseComponent interface with methods for managing trident item, favored slot, loyalty/impaling/channeling enchantments, and returning state.
  • Added EntityThrownTrident entity interface.
  • Added PlayerPickupTridentEvent event fired when a player picks up a trident, allowing plugins to cancel the pickup.
  • Added PlayerToggleSpinAttackEvent event fired when a player starts or stops a spin attack (riptide).
  • Added methods isSpinAttacking(), setSpinAttacking(), and canUseRiptide() to EntityPlayerBaseComponent.
  • Added TridentRiptideSound record class for riptide sounds with level parameter.
  • Added sounds SimpleSound.TRIDENT_THROW, TRIDENT_HIT, TRIDENT_HIT_GROUND, TRIDENT_RETURN, and TRIDENT_THUNDER.
  • Implemented trident dispense behavior for dispensers.
• (API) Implemented lightning bolt:
  • Added EntityLightningBoltBaseComponent interface with methods isEffect() and setEffect() for controlling lightning effects.
  • Added EntityLightningBolt entity interface.
  • Added LightningStrikeEvent event fired when lightning strikes, with cause types (WEATHER, TRIDENT, COMMAND, CUSTOM).
  • Added methods strikeLightning() to Dimension interface for spawning lightning at a position.
  • Added DamageContainer.lightning() factory method for lightning damage.
• (API) Implemented fireball entities:
  • Added EntityFireballBaseComponent interface with getExplosionPower() and setExplosionPower() methods for large fireballs.
  • Added EntitySmallFireball and EntityFireball entity interfaces.
  • Implemented fire charge dispense behavior for dispensers.
• (API) Implemented egg projectile:
  • Added EntityEgg entity interface.
  • Implemented egg throwing mechanics with chicken spawning chance.
• (API) Added afterApplyMotion() method to EntityPhysicsComponent interface, called sequentially after parallel motion processing completes, allowing safe modification of shared world state.
• Added dimension-level light calculation toggle:
  • (API) Added new WorldPool.loadWorld() overload with light calculation parameters for programmatic world creation.
  • Added enable-light-calculation config option in world-settings.yml for each dimension.
  • When disabled, all light queries return max value (15), improving performance for dimensions where lighting is not important.
• (API) Implemented fishing:
  • Added EntityFishingHookBaseComponent interface with fishing state management (FLYING, WAITING, ATTRACTING, CAUGHT), hooked entity handling, and reelLine() method.
  • Added PlayerFishEvent event fired when a player catches something while fishing, allowing plugins to modify caught items, experience, hooked entities, and motion.
  • Added FishingLoot interface for defining custom fishing loot entries.
  • Added FishingLootCategory enum (FISH, TREASURE, JUNK) with Bedrock Edition base chances.
  • Added FishingLootTable utility class for selecting fishing loot based on Luck of the Sea and Lure enchantments with Bedrock Edition mechanics.
  • Added Registries.FISHING_LOOTS registry for registering custom fishing loot.
  • Added EntityPlayer.getFishingHook(), setFishingHook(), and isFishing() methods for managing the player's active fishing hook.
  • Added EnchantmentType.isFishable() method for checking if an enchantment can be obtained from fishing (excludes Soul Speed, Swift Sneak, and Wind Burst).
  • Added SimpleEntityAction.FISHING_HOOK_BITE for displaying the fish bite animation with bubble and splash effects.
  • Added SimpleParticle.WATER_WAKE for fish attraction effects and SimpleParticle.BUBBLE for fish bite effects.

Changed

• (API) Refactored flight permission system for game mode specific control:
  • Replaced single ability.fly permission with game mode specific permissions: ability.fly.survival, ability.fly.creative, ability.fly.adventure.
  • Spectator mode always allows flight (hardcoded behavior).
  • Creative mode allows flight by default (unless explicitly denied with ability.fly.creative=FALSE).
  • Survival and Adventure modes deny flight by default (require explicit ability.fly.survival=TRUE or ability.fly.adventure=TRUE).
  • Added canFly() method to EntityPlayerBaseComponent for unified flight permission checking.
  • OP players now follow the same default flight behavior as regular players.
• (API) Changed EntityFallEvent and ProjectileHitEvent caller thread annotation from COMPUTE to DIMENSION, as these events are now fired sequentially in the dimension thread.
• (API) Refactored knockback system for better extensibility:
  • Added knockback-related fields to DamageContainer: knockback, knockbackVertical, knockbackAdditional, knockbackSource, and ignoreKnockbackResistance.
  • Knockback values are now calculated before EntityDamageEvent is fired, allowing event listeners to modify knockback parameters.
  • Renamed EntityPhysicsComponent.knockback() parameters for clarity: source → knockbackSource, kb → knockback, kby → knockbackVertical, additionalMotion → knockbackAdditional.
  • Projectiles (arrow, egg, snowball, trident) now use DamageContainer knockback fields instead of manually calling knockback() method.
• (API) Renamed ContainerViewer methods for clarity and consistency: viewContents() → viewContainerContents(), viewSlot() → viewContainerSlot(), viewOpen() → viewContainerOpen(), viewClose() → viewContainerClose().
• Extracted NetEase protocol extension code to separate library org.allaymc:protocol-extension, reducing codebase complexity and improving maintainability.

Fixed

• (API) Added missing attack sounds:
  • Added attack sound when player punches air (ATTACK_NODAMAGE).
  • Added attack sound when player attacks an entity (ATTACK_STRONG on hit, ATTACK_NODAMAGE on miss).
  • PlayerPunchAirEvent now implements CancellableEvent, allowing plugins to cancel the event and prevent the sound from playing.
• Fixed packet serializer of PlayerEnchantOptionsPacket for NetEase 1.21.50.
• Fixed an issue where too long command outputs will make the client disconnect in 1.21.130+.
• Fixed race condition in physics engine where onFall() and projectile hit callbacks were called in parallel context, potentially causing concurrent modification issues when modifying shared world state.
• Fixed hunger and air supply not being handled correctly for creative/spectator mode players:
  • Creative and spectator mode players no longer have their hunger or air supply updated.
  • Switching to creative or spectator mode now resets hunger and air supply to maximum values.

Removed

• (API) Removed Permissions.ABILITY_FLY constant, replaced by game mode specific permissions (ABILITY_FLY_SURVIVAL, ABILITY_FLY_CREATIVE, ABILITY_FLY_ADVENTURE).

0.10.6 (API 0.23.0) - 2026/1/24

Compare with 0.10.5

Added

• (API) Implemented banner:
  • Added BannerPattern record class representing a single pattern with color and type.
  • Added BannerPatternType enum with all vanilla banner pattern types (border, bricks, creeper, cross, flower, globe, mojang, piglin, skull, etc.).
  • Added BannerType enum for normal, ominous, and illager banner types.
  • Added BlockEntityBanner interface and BlockEntityBannerBaseComponent interface with methods for managing base color, banner type, and patterns.
  • Added ItemBannerBaseComponent interface with methods for banner color, patterns, and type management.
  • Added BlockEntityTypes.BANNER block entity type.
• (API) Implemented loom:
  • Added BannerPatternType.getRequiredPatternItem() method to get the required pattern item for special patterns.
  • Added LoomTakeResultEvent event fired when a player takes a result from the loom, allowing plugins to cancel or modify the result.
• (API) Implemented shield:
  • Added ItemShieldBaseComponent interface with methods for directional blocking, durability consumption, and shield-disable detection.
  • Added EntityDamageBlockedEvent event fired when a player successfully blocks damage with a shield.
  • Added EntityPlayerBaseComponent.isBlocking() method to check if player is actively blocking.
  • Added sound SimpleSound.SHIELD_BLOCK.
• (API) Added method Dimension.updateComparatorOutputLevel() for updating comparators that may be reading a block's comparator output, including second-level neighbors (comparators behind solid blocks).
• (API) Added method Container.calculateComparatorSignal() for calculating the comparator signal strength based on container contents.
• (API) Added method ItemMusicDiscBaseComponent.getComparatorSignal() for getting the comparator signal output for music discs.
• (API) Added comparatorSignal field to DiscType enum for each music disc's comparator output value.
• (API) Added a new overload to method WorldViewer.viewPlayerEmote which accepts a boolean silence parameter.
• (API) Introduced new thread type ThreadType.DIMENSION which responses the ticking thread of a dimension.
• (API) Added events PlayerPickupItemEvent and PlayerPickupArrowEvent for player picking up item and arrow entities.
• (API) Initial implementation of custom block support:
  • Added CustomBlockDefinitionGenerator for generating custom block definitions with support for various components like geometry, materials, collision box, selection box, and transformation.
  • Added AllayBlockType.Builder.autoCreateItemType(boolean) option to automatically create the corresponding item type for a custom block.
• (API) Implemented piston and sticky piston:
  • Added BlockPistonEvent event which is called when a piston extends or retracts, allowing plugins to monitor and cancel piston operations.
  • Added BlockEntityPistonArm and BlockEntityPistonArmBaseComponent interfaces for piston arm block entities with properties like facing direction, sticky state, progress, and attached blocks.
  • Added BlockEntityMovingBlock and BlockEntityMovingBlockBaseComponent interfaces for moving block entities that handle the visual block movement animation.
  • Added BlockEntityTypes.PISTON_ARM and BlockEntityTypes.MOVING_BLOCK block entity types.
  • Added block tags BlockTags.UNPUSHABLE, BlockTags.UNPULLABLE, BlockTags.BREAK_WHEN_PUSHED, and BlockTags.CAN_STICK_BLOCKS to control piston push/pull behavior for different block types.
  • Added sounds SimpleSound.PISTON_PUSH and SimpleSound.PISTON_PULL.
• (API) Added block tag BlockTags.REDSTONE_WIRE_CONNECT_TO for controlling redstone wire connection behavior.
• (API) Added method BlockEntityBaseComponent.saveCleanNBT() to save clean NBT data without position-related information, useful for piston block movement.
• (API) Added methods BlockEntityContainerHolderComponent.shouldDropItemOnBreak() and setDropItemOnBreak(boolean) for controlling whether items should drop when the block is broken, useful for pistons moving container blocks.
• (API) Added method Dimension.updateAllAround() for triggering second-order neighbor updates (updates adjacent blocks and each adjacent block's neighbors).
• (API) Added method BlockBaseComponent.onMoved() callback for blocks to handle being moved by pistons. Observers use this to trigger pulses when pushed.
• (API) Implemented cauldron:
  • Added BlockEntityCauldron interface and BlockEntityCauldronBaseComponent interface with methods for managing potion type, cauldron potion type (normal/splash/lingering), and custom color.
  • Added CauldronPotionType enum to distinguish between normal, splash, and lingering potions stored in cauldrons.
  • Added BlockEntityTypes.CAULDRON block entity type.
  • Added sounds SimpleSound.CAULDRON_FILL_WATER, CAULDRON_TAKE_WATER, CAULDRON_FILL_LAVA, CAULDRON_TAKE_LAVA, CAULDRON_FILL_POWDER_SNOW, CAULDRON_TAKE_POWDER_SNOW, CAULDRON_FILL_POTION, CAULDRON_TAKE_POTION, CAULDRON_ADD_DYE, CAULDRON_DYE_ARMOR, CAULDRON_CLEAN_ARMOR, CAULDRON_CLEAN_BANNER, and CAULDRON_EXPLODE.
• (API) Added ItemDyeableComponent interface for items that can be dyed with custom colors, such as leather armor.
• (API) Added leather armor item interfaces: ItemLeatherBootsStack, ItemLeatherChestplateStack, ItemLeatherHelmetStack, ItemLeatherHorseArmorStack, and ItemLeatherLeggingsStack.
• Implemented comparator signal reading for various blocks: containers (chest, barrel, hopper, shulker box), item frames, cake, candle cake, jukebox, campfire, and end portal frame.
• Implement candle, cake and candle cake.
• Improved server-authorized block breaking logic in PlayerAuthInputPacketProcessor for better accuracy and reliability.
• Added support for (NetEase) bedrock 1.21.50 (protocol version 766).
• Custom entities will be sent to the client now.

Changed

• (API) Replaced BlockBehavior#isPowerSource() method with block tag BlockTags.POWER_SOURCE.
• (API) Changed BlockTntBaseComponent.prime(Block block, int fuse) method signature to prime(Position3ic pos, int fuse) for better API consistency.

Fixed

• Fixed a bug where NpcDialoguePacket used RuntimeEntityId instead of UniqueEntityId, causing NPC dialogs to not display for non-actual players (e.g., fake players created by plugins).
• Fixed a bug where skin can't be set for fake player.
• Fixed duplicate "Client disconnected" messages during server shutdown caused by players not being removed from the dimension's player list when disconnecting.
• Fixed method WorldViewer.viewPlayerEmote not working.
• Fixed duplicate player quit messages caused by DISCONNECTED state being set multiple times due to missing state check in PacketProcessorHolder.setClientState().
• Fixed redstone torch incorrectly turning off when receiving weak power through solid blocks from redstone wire.
• Fixed redstone wire not correctly pointing to all connected directions in L-shape, T-shape, and cross configurations.
• Fixed observer placement direction - the observing face now correctly points in the direction the player is looking.
• Fixed lever placement check - now verifies that the attachment surface is a full face instead of just checking if the block is solid.
• Fixed block replacement order - onReplace is now called before onPlace to ensure old block entities are removed before new ones are created, preventing block entity type mismatch issues.
• Fixed piston to trigger second-order neighbor updates after animation completes at both original and target positions.
• Fixed several observer bugs:
  • Not responding to short redstone pulses (e.g., from other observers) - implemented proper activation delay and scheduling.
  • Face-to-face observers not forming oscillators - state changes now notify all neighbors including the observed face.
  • Oscillator frequency being too fast - corrected activation delay to 4 game ticks (2 redstone ticks) to match MCBE behavior per MCPE-15793.
• Fixed repeaters/comparators not responding to short input pulses (e.g., from observers) - implemented latching behavior to capture pulses even if input is gone when scheduled update runs.
• Fixed Dimension.getWeakPowerAt() not considering strong power through solid blocks, causing pistons to not extend when powered indirectly.
• Fixed several blocks not properly checking attachment surface support (now uses collision shape instead of just solid flag):
  • Item frames
  • buttons
  • pressure plates
  • redstone torch
  • redstone diodes (repeaters/comparators)
• Fixed TNT not responding to redstone signals - TNT now ignites when receiving redstone power.
• Fixed ghost block issue on mobile clients where blocks would appear placed client-side but not server-side, caused by mobile clients sometimes skipping START_ITEM_USE_ON packet.
• Fixed viewing self animations.

Removed

• (API) Removed ItemBaseComponent.rightClickItemOnBlock() method. Its functionality has been merged into useItemOnBlock().

0.10.5 (API 0.22.0) - 2026/1/15

Compare with 0.10.4

Added

• (API) Added method Player.sendCooldown().
• (API) Added event ItemDamageEvent which is called when an item is about to be damaged.
• (API) Added method ItemBaseComponent.calculateAttackDamage(Entity, Entity) for context-aware attack damage calculation.
• (API) Implemented lingering potion and area effect cloud:
  • Added EntityAreaEffectCloudBaseComponent interface with radius, duration, and reapplication delay properties.
  • Added EntityPotionComponent interface for entities that hold potion types (splash potion, lingering potion, area effect cloud, arrow).
  • Removed getPotionType() and setPotionType() from EntityArrowBaseComponent, use EntityPotionComponent instead.
• (API) Implemented mace item:
  • Added sounds SimpleSound.MACE_SMASH_AIR, SimpleSound.MACE_SMASH_GROUND and SimpleSound.MACE_SMASH_HEAVY_GROUND.
  • Added particle SimpleParticle.SMASH_ATTACK_GROUND_DUST.
• (API) Implemented wind charge:
  • Added WindExplosion class in org.allaymc.api.world.explosion package for wind charge knockback effects.
  • Added particles SimpleParticle.WIND_EXPLOSION and SimpleParticle.BREEZE_WIND_EXPLOSION.
  • Added sounds SimpleSound.WIND_CHARGE_BURST and SimpleSound.BREEZE_WIND_CHARGE_BURST.
  • Wind Charged effect now triggers wind explosion on entity death.
• (API) Added PotionType.WIND_CHARGED, WEAVING, OOZING, and INFESTED for 1.21 tipped arrows and potions.
• Implemented Wind Burst enchantment effects for mace attacks.
• Implemented Density enchantment damage bonus for mace.
• Implemented Breach enchantment effect for mace armor reduction.
• Implemented mending repairs from experience orbs.

Changed

• (API) Classes Explosion and FireworkExplosion are moved from package org.allaymc.api.world to package org.allaymc.api.world.explosion.
• (API) Corrected field name EffectTypes.WEAVING_OMEN to EffectTypes.WEAVING.

Fixed

• (API) Renamed method HasAABB.getBaseAABB() back to HasAABB.getAABB().
• Fixed a possible NPE in method EntityPlayerBaseComponent.setCooldown().
• Fixed a bug where aabb not being updated in the physics engine due to missing join() call on parallel forEach.
• Fixed a bug where sometimes the player can't respawn.
• Fixed PotionType enum order where STRONG_SLOWNESS was incorrectly placed, causing potion effects to be mismatched (e.g., healing potion giving water breathing).
• Fixed enchant table option cleanup when closing the table to avoid stale cached entries.
• Fixed wind burst enchantment max level and applicable type.
• Fixed 2x2 crafting grid.

0.10.4 (API 0.21.0) - 2026/1/12

Compare with 0.10.3

Added

• (API) Implemented world feature system and tree saplings:
  • Added WorldFeature interface and WorldFeatureContext class for defining world generation features.
  • Added WorldFeatures class and Registries.WORLD_FEATURES registry.
  • Implemented tree saplings that can grow into trees when bone mealed or after random ticks.
  • Added tree features for all wood types: Oak, Birch, Spruce, Jungle, Acacia, Dark Oak, Cherry, Mangrove, Pale Oak, and their variants (Fancy Oak, Tall Birch, Mega Jungle, Mega Pine, Mega Spruce).
• (API) Added Entity.setPersistent() method to control entity persistence.
• (API) Added redstone power methods to BlockBaseComponent:
  • getWeakPower(Block, BlockFace) - gets weak power output from a block.
  • getStrongPower(Block, BlockFace) - gets strong power output from a block.
  • isPowerSource() - checks if a block is a redstone power source.
  • MAX_REDSTONE_POWER constant (15).
• (API) Added BlockEntityNoteblockBaseComponent.isPowered() and setPowered() methods to track redstone power state.
• (API) Added sound PowerSound which is used by redstone components such as lever.
• (API) Implemented basic redstone system, here is a list of implemented redstone components:
  • Redstone Wire
  • Redstone Block
  • Redstone Lamp
  • Redstone Torch
  • Pressure Plate
  • Lever
  • Button
  • Door
  • Trapdoor
  • Fence Gate
  • Observer
  • Noteblock (responds to redstone signal)
  • Hopper (stops transferring items when powered)
  • Daylight Detector (normal and inverted)
  • Trapped Chest (outputs signal based on viewer count)
  • Redstone Repeater
  • Redstone Comparator
  • Target (outputs signal when hit by projectiles)
  • Dragon Head and Piglin Head (animate when powered)
• (API) Implemented campfire and soul campfire:
  • Added BlockEntityCampfire and BlockEntityCampfireBaseComponent interfaces.
  • Added CampfireSmeltEvent event.
  • Added DamageType.CAMPFIRE and DamageContainer.campfire() for campfire damage.
• (API) Implemented crossbow:
  • Added ItemCrossbowBaseComponent interface with isLoaded(), getLoadedProjectile(), and setLoadedProjectile() methods.
  • Added EntityShootCrossbowEvent event fired when shooting crossbow.
  • Added EntityArrowBaseComponent.getPiercingLevel() and setPiercingLevel() for Piercing enchantment support.
  • Added ItemBaseComponent.onUseInAirTick() callback for tick-based item usage logic.
• (API) Added Instrument.fromBlockBelow(BlockType<?>) static method to determine instrument based on block below noteblock.
• (API) Added BlockEntityNoteblockBaseComponent.getNextPitch() method to increment and return pitch.
• Added onIdle callback and wakeUp() method to GameLoop class for event-driven idle processing.

Changed

• (API) Renamed Entity.willBeSaved() to Entity.isPersistent().
• (API) Merged sound classes:
  • PressurePlateActivateSound and PressurePlateDeactivateSound -> PressurePlateSound(blockState, activated)
  • DoorOpenSound and DoorCloseSound -> DoorSound(blockState, open)
  • TrapdoorOpenSound and TrapdoorCloseSound -> TrapdoorSound(blockState, open)
  • FenceGateOpenSound and FenceGateCloseSound -> FenceGateSound(blockState, open)
• (API) Moved AbstractEffectType from api module to server module.
• Merged world tick thread and network thread into a single thread using an event-driven wake-up mechanism. This simplifies the threading model while maintaining low packet processing latency through LockSupport.parkNanos/unpark.

Fixed

• Fixed noteblock being triggered when player is sneaking (should allow placing blocks on top instead).
• Fixed eating animation incorrectly triggering after interacting with blocks while holding food.
• Added missing ambient crackle sounds for furnace, blast furnace, smoker, and campfire.

Removed

• Removed enableIndependentNetworkThread configuration option from server-settings.yml as it is no longer necessary.

0.10.3 (API 0.20.0) - 2026/1/7

Compare with 0.10.2

Added

• (API) Added API for setting player hud element's visibility.
• (API) Added Runnable overloads to Scheduler for scheduleDelayed, scheduleRepeating, and scheduleDelayedRepeating methods.
• (API) Added methods WorldViewer.stopSound(String) and WorldViewer.stopAllSounds().
• (API) Added method Player.transfer() to transfer the player to another server.
• (API) Added method Entity.setImmobile() to make the entity immobile.
• (API) Added method Container.isFull() to check if a container is full.
• (API) Added method BlockEntityChest.getDoubleChestContainer() to get the container object to use when the chest is paired.
• (API) Implemented hopper:
  • (API) Added BlockEntityHopper and related interfaces.
  • (API) Added SidedContainer interface to represent a container that restricts insertion/extraction by side.
  • (API) Added ContainerItemPickupEvent for item entity pickups into containers.
  • (API) Added ContainerTypes.HOPPER.
• (API) Added methods ChunkLoader.isWorldViewer() and ChunkLoader.toWorldViewer().
• (API) Added entity and dimension level scheduler.
• (API) Added APIs for setting the scale of entity:
  • Added methods Entity.setScale() and Entity.getScale().
  • Added method Entity.getBaseAABB() to get the original aabb which is not affected by the scale factor.
• (API) Added method EntityPhysicsComponent.resetFallDistance().
• Added properties network-settings.raknet-send-cookie and network-settings.raknet-max-mtu to server.properties.
• Implemented Totem of Undying.
• Implemented End Crystal.
• Implemented commands /playsound, /stopsound, /playanimation, /hud, and /particle.

Changed

• (API) Refactor and clean up the config util under org.allaymc.api.config. This refactor is backward-compatible and shouldn't affect any plugin.
• (API) Added ServerPlayerEvent base class for all Player related events under org.allaymc.api.eventbus.event.server package.
• (API) Made AllayAPI.APIInstanceHolder<T> public in allay-api by removing the @ApiStatus.Internal annotation.
• (API) EntityEnderCrystal now extends EntityLiving and EntityEnderCrystalBaseComponent interfaces.
• Entity's display name is now default to the title case. For example: minecraft:arrow -> Arrow.
• List plugin command (/plugin list) now will show the plugin version.

Fixed

• (API) Fixed method Container.removeAllViewers() won't remove all viewers from the container.
• Fixed a bug where calling method Container.removeViewer() server-side will make the client no longer able to open any container.
• Fixed a bug where the speed of the player would be incorrect in some special cases.
• Fixed a bug where a player teleporting into another player's loaded area would not be visible to that player.
• Fixed a bug where the jukebox could not eject music discs.
• Fixed a bug where the block will not be recovered client-side when events BlockBreakEvent and PlayerInteractBlockEvent is cancelled.
• Fixed a bug where packed and blue ice will melt.
• RAK_SEND_COOKIE is set to true by default in AllayNetworkInterface to resolve connection issue.

Removed

• (API) Removed @ApiStatus.OverrideOnly annotation in WorldStorage.shutdown() method.

0.10.2 (API 0.19.0) - 2025/12/22

Compare with 0.10.1

Added

• (API) Added API for npc dialog. The related classes are under org.allaymc.api.dialog package.
• Updated the feature version to 1.21.130.
• Implemented /tell (aka. /msg and /w) command.
• Implemented /say command.
• Implemented small and big flowers:
  • Small flowers: Dandelion, Poppy, Blue Orchid, Allium, Azure Bluet, Red Tulip, Orange Tulip, White Tulip, Pink Tulip, Oxeye Daisy, Cornflower, Lily of the Valley, Wither Rose, Torchflower, Closed Eyeblossom, Open Eyeblossom.
  • Big flowers: Sunflower, Lilac, Rose Bush, Peony, Pitcher Plant
• Implemented Leaf Litter, Pink Petals, and Wildflowers.

Changed

• (API) Moved PlayerKickEvent from player package to server package.
• (API) Renamed field blockEntityBrewingStand to brewingStand in classes BrewingStandBrewEvent, BrewingStandConsumeFuelEvent, and BrewingStandStartBrewEvent.
• (API) Renamed field blockEntityFurnace to furnace in classes FurnaceConsumeFuelEvent and FurnaceSmeltEvent.
• (API) Renamed method FormViewer.removeAllForms() to FormViewer.closeAllForms().
• (API) Event PlayerItemHeldEvent is now cancellable with some field name changes.

Fixed

• (API) Fixed the issue that some item class do not extend ItemToolComponent interface.
• Fixed a rare NPE when saving the nbt of painting entity.
• Fixed a NPE when using TargetNode (.target()) in command.
• Fixed a client-side hotbar flicking issue when changing the hotbar slot quickly.
• Fixed a bug where right-clicking on a bow briefly would cause the wrong charge state.

Removed

• (API) Removed selector type @initiator since it is useless in third server software implementation:
  • EntitySelectorAPI no longer regard @initiator as a valid selector type.
  • Removed enum member SelectorType.NPC_INITIATOR.

0.10.1 (API 0.18.0) - 2025/12/10

Compare with 0.10.0

Fixed

• Used explicit version numbers for the Cloudburst protocol library to resolve compilation inconsistencies due to upstream maven repository updates.

0.10.0 (API 0.18.0) - 2025/12/10

Compare with 0.9.1

Added

• Added support for bedrock 1.21.130 (protocol version 897/898).
• Javadoc for allay-api is now published to maven central and is available here.

Changed

• (API) Moved field joinMessage from PlayerSpawnEvent to PlayerJoinEvent.
• (API) Added field disconnectReason to PlayerJoinEvent.

Fixed

• Fixed method AllayStringUtils.splitCommandArgs() when using quote and curly brace together.
• Fixed relative parameter of method WorldViewer.viewSound() being inverted unexpectedly.

0.9.1 (API 0.17.0) - 2025/11/28

Compare with 0.9.0

Added

• (API) DebugText now support scale property.
• (API) Introduced CallerThread annotation to events to specify the execution thread's type.
• (API) Added methods PlayerManager.isOperator() and PlayerManager.setOperaotor().
• (API) Readded DebugShapeViewer, and WorldViewer now extends DebugShapeViewer. There should be no breaking changes.
• (API) Added SenderType.ACTUAL_PLAYER which limits the command sender from must be an actual player.
• (API) Introduced new Player class, there are some things worth noting:
  • A Player object is basically controlling an EntityPlayer object now. Most client-related methods are moved to the new Player class (e.g. most of the methods in the old EntityPlayerClientComponent).
  • A EntityPlayer object now can be either a real player or a fake player. This is determined by checking if the player entity is controlled by a Player object (use EntityPlayer.isActualPlayer() method).
  • You can now create fake player via EntityTypes.PLAYER just like how you created the other entity.
  • The type of some variables has been changed from EntityPlayer to Player to better fit their purpose, such as the player variable in PlayerJoinEvent.
• (API) Added PlayerSpawnEvent event.
• Command nodes that the player doesn't have permission to access will not be sent to the player, and the commands will be resent when the specific permission changes.
• Updated log4j2 patterns to use %logger{0} instead of %c{0}.
• Added support for bedrock 1.21.124 (protocol version 860).

Changed

• (API) Renamed class Structure to StructureFile to avoid confusion with the upcoming structure feature in world gen.
• (API) Refactored the permission system. The permission system has now been reconstructed into a lightweight, easy-to-interface system in preparation for docking with LuckPerms. There are some breaking changes, especially in command creation. Check the updated documentation on our website for details.
• (API) Update some events:
  • IPBanEvent and IPUnbanEvent are moved from network to server package.
  • PlayerBanEvent, PlayerUnbanEvent, PlayerLoginEvent, PlayerJoinEvent and PlayerQuitEvent are moved from player to server package.
  • ClientConnectEvent and ClientDisconnectEvent are renamed to PlayerXXXEvent. They are also moved from network to server package.
• (API) Added a new permissions parameter to the parameter list of method MessageReceiver.sendCommandOutputs().
• (API) Changed member SimpleEntityAction.CRITICAL_HIT to independent CriticalHit(int count) record (the same to ENCHANTED_HIT) due to the addition of the newly added count parameter since protocol version 859.
• (API) Renamed method PlayerManager.getOnlinePlayerByName() to PlayerManager.getPlayerByName() for clarity and consistency.
• (API) Moved field joinMessage in PlayerLoginEvent to PlayerSpawnEvent since the server now will broadcast the join message when the player spawns instead of when logged in.
• Permission data now will not be saved into the player's nbt data, which allows third permission plugins to store the permission data in their own way. The core will only saved a operator list now.

Fixed

• Fixed debug shape rendering in 1.21.120.

Removed

• (API) Removed useless method Entity.isHeadYawEnabled().
• (API) Removed classes EntityPlayerBossBarViewerComponent, EntityPlayerChunkLoaderComponent, EntityPlayerFormViewerComponent and EntityPlayerScoreboardViewerComponent.

0.9.0 (API 0.16.0) - 2025/10/30

Compare with 0.8.3

Added

• (API) Implemented FakeChestContainer and FakeDoubleChestContainer. Plugin developer can get fake container instance through the new FakeContainerFactory class.
• (API) Introduced record EntityPlayerBaseComponent.Speed to represent the speed, flySpeed, and verticalFlySpeed for player.
• Implemented copper torch.
• Implemented copper door.
• Add support for bedrock 1.21.120.

Changed

• (API) Event ContainerCloseEvent is not cancellable now.
• (API) Changed the getter/setter methods for speed, flySpeed, and verticalFlySpeed to use the new Speed record.

Fixed

• Fixed (maybe a bug) sometime event ContainerOpenEvent will be called twice.
• Fixed incorrect player speed after applying speed and slowness effect. These effects now will also affect the fly speed and vertical fly speed of the player.
• Fixed a rare NPE when the client disconnects while haven't logged in.

Removed

• (API) Removed headYaw from Location3d(c), Location3f(c), and Location3i(c).

0.8.3 (API 0.15.0) - 2025/10/20

Compare with 0.8.2

Added

• (API) Added method MessageChannel.hasReceiver() to check if the specific message receiver is registered in the message channel.
• (API) Added events PlayerRightClickItemInAirEvent, PlayerStartUseItemInAirEvent, PlayerUseItemInAirEvent.
• (API) Added events PlayerPunchBlockEvent and PlayerPunchAirEvent.
• (API) Added event PlayerCraftItemEvent.
• (API) Added tooltip field to Dropdown, Input, Slider, StepSlider, and Toggle which are used in CustomForm.
• Implemented short and tall dry grass.

Changed

• (API) Renamed method ItemStack.clickItemInAir() to ItemStack.rightClickItemInAir().
• (API) Renamed method ItemStack.rightClickItemOn() to ItemStack.rightClickItemOnBlock().

Fixed

• Fixed a bug that custom command sender (which is not registered in the default message channel) cannot receive command outputs.
• Fixed a bug where all player skins would be set to the same skin.
• Fixed an issue where commands had two permission nodes.
• Fixed a bug where players' name tags are not always shown.
• Fixed a bug where using firework rocket in a block won't decrease the item count.
• Fixed a client crash bug due to the incorrect absorption attribute sending.
• Fixed a bug where water block cannot extinguish the fire on the entity.
• Fixed a bug where the player dying in a non-overworld dimension could not be properly teleported back to the spawn point in overworld.
• Fixed a NPE when interacting bed block in a non-overworld dimension.
• Fixed a bug where chunks sent to the client sometimes did not display immediately.
• Fixed a NPE which rarely happens in the light engine.

Removed

• (API) Removed method ItemStack.releaseItem() which is duplicated with method ItemStack.useItemInAir().

0.8.2 (API 0.14.0) - 2025/10/16

Compare with 0.8.1

Added

• (API) Added method OtherChunkAccessibleContext.getBlockEntity().
• (API) Added method DyeColor.getColor() to get the corresponded Color object of the dye color.
• (API) Added methods EntityPlayerClientComponent.viewPlayerListChange() and EntityPlayerClientComponent.viewPlayerPermission().
• (API) Added particle SimpleParticle.FIREWORK_CONTRAIL.
• (API) Added event FireworkExplodeEvent which will be called when a firework rocket is about to explode.
• (API) Added class ItemDyeComponent which is used in all items that can be used as dye.
• (API) Implemented firework and firework star. Multiple classes including FireworkType, FireworkExplosion were added.
• Implemented recipes for fireworks.
• Implemented elytra. The fall distance for the player will be reset if the player is gliding.
• Player's height will be changed when the player is sneaking, swimming, gliding, or crawling now.

Changed

• (API) Method ItemStack.saveExtraTag() won't return a null value when the encoded extra tag is empty now.
• (API) Used double instead of float for player speed, fly speed, and vertical fly speed.
• (API) Renamed field SimpleSoundEvent.TWINKLE to SimpleSoundEvent.FLICKER.
• (API) Renamed field SimpleEntityAction.FIREWORK_EXPLOSION to SimpleEntityAction.FIREWORK_EXPLODE.
• (API) Renamed class AllayNbtUtils to AllayNBTUtils.
• (API) Flattened packages except events under package org.allaymc.api.entity.component.
• Optimized memory performance when loading chunks by reducing the large number of temporary objects generated in the light update queue.
• Renamed ItemComponent to ItemDefinition in many places.

Fixed

• Player in spectator mode will no longer lose the saturation level.
• Speed, fly speed, and vertical fly speed for the player won't be saved now.
• The online player list shown in the dashboard will be correctly updated when a player quits now.
• Fixed an issue where the client would sometimes get stuck on the screen of death.
• The client will be disconnected now if failed to decode the login packet sent from the client.

Removed

• (API) Removed internal method ArmorContainer.onArmorChange().

0.8.1 (API 0.13.0) - 2025/10/7

Compare with 0.8.0

Added

• (API) Implemented void damage. New methods EntityLivingComponent.hasVoidDamage() and DamageContainer.voidDamage() were added.
• (API) Implemented lightning rods.
• (API) Implemented (copper) lanterns.
• (API) Implemented copper golem statues.
• (API) Implemented copper chains.
• (API) Implemented heads.
• (API) Implemented painting.
• (API) Added field SimpleSound.PAINTING_PLACE.
• (API) Added classes PaintingType, EntityPaintingBaseComponent.
• (API) Added method DamageContainer.api(float).
• (API) Added method MathUtils.grow(AABBd, BlockFace, double).
• (API) Added method overload Entity.remove(Runnable).

Changed

• (API) Renamed field SimpleSound.SIGN_WAXED to SimpleSound.WAXED.
• (API) Renamed method EntityUndeadComponent.getCatchesFireUnderSunlight() to EntityUndeadComponent.ignitedBySunlight().
• (API) Changed the return type of methods Entity.getOffsetAABB() and Entity.getOffsetAABBForCollisionCheck(). They return AABBdc instead of AABBd now.
• Changed the behavior of method EntityLivingComponent.kill(). It now applies 1,000,000 damage to the entity instead of setting the health to zero directly.

Fixed

• Disabled dead timer for item entity.
• Fixed fire damage wasn't given when the on fire tick is continuously updated.
• Fixed the bug that air supply, effect particle, and on fire state are invisible.
• Fixed an issue where the server could not be launched in certain locales (e.g. Turkey).

0.8.0 (API 0.12.0) - 2025/10/4

Compare with 0.7.1

Added

• (API) Implemented basic bed feature.
• (API) Implemented arrow and bow. A new event EntityShootBowEvent is added.
• (API) Implemented noteblock.
• (API) Introduced PlayerInteractBlockEvent.
• (API) Introduced PlayerBookEditEvent.
• (API) Introduced methods Entity.getOffsetAABBForCollisionCheck() and Entity.checkBlockCollision().
• (API) Introduced event BlockExplodeEvent.
• (API) Introduced option ServerSettings.NetworkSettings.enablev6 to close ipv6 if needed.
• (API) Introduced field PlayerRespawnEvent.respawnLocation which can be changed to modify the respawn location of a player after death.
• (API) Introduced field LiquidHardenEvent.hardenedBlockPosition which is the position of the hardened block.
• (API) Introduced api_version for plugin descriptor, which can set the api version requirement of a plugin.
• (API) Introduced component EntityPlayerScoreboardViewerComponent for player.
• (API) Introduced a bunch of XXXViewer (e.g. WorldViewer) interfaces which is a tiny wrapper for packet operations. This is inspired by df-mc/dragonfly to reduce the code associated with network packet contained in api module.
• (API) Introduced a bunch of functional interfaces in package utils.funtion.
• (API) Introduced classes EntityFlag and EntityData which are correspond to classes in the protocol library.
• (API) Introduced enum DiscType for music disc.
• (API) Introduced method Chunk.addChunkTask() that adds a task which will be performed later in the chunk tick.
• (API) Introduced method EntityBaaeComponent.applyAnimation() and class EntityAnimation.
• (API) Introduced classes EntityAction and BlockAction.
• (API) Introduced class Skin as the replacement for the SerializedSkin class in protocol lib.
• (API) Introduced a new MessageChannel system to replace the old broadcastXXX() methods in Server. The default message channel of the server can be got using method Server.getMessageChannel() and can be changed using method Server.setMessageChannel().
• (API) Introduced new registry Registries.BIOMES which contains all available biomes in the game. This is the replacement for the old BiomeId enum. Biome data is also accessible through method BiomeType.getBiomeData now.
• (API) Introduced method Command.isDebugCommand() which can be overridden to determine whether the command is a debug command. Debug command name will be shown blue client-side.
• (API) Introduced class NBTIO which replaced the old fromNBT() methods in XXXHelper classes.
• (API) Introduced interfaces FormViewer and EntityPlayerFormViewerComponent.
• Implemented sharpness enchantment.
• Implemented SetDifficultyPacketProcessor to support changing level difficulty through setting menu.
• Block entity's custom name will be set to the custom name of the item now, which allows the player to change the inventory name of containers.
• Players can now extinguish the fire on the surface of the block by left-clicking.
• Introduced a dirty flag for block layers in chunk sections. Now blocks will only be rewritten to the database if they are changed. This would speed up the time used during server shutdown significantly if there are many only loaded chunks.
• Added support for basic multi-version. The server now supports 1.21.80 - 1.21.110 client to join.
• The motion of the player will be added to the arrow shot by the player now.

Changed

• (API) Renamed method Entity.despawn() to Entity.remove() as a clarification with other methods like Entity.despawnFrom() and Entity.despawnFromAll().
• (API) Renamed entries in class TrKeys. The old M_XXX is renamed to MC_XXX and A_XXX is renamed to ALLAY_XXX.
• (API) Renamed field Block.pos to Block.position.
• (API) Renamed class BlockUpdateService to BlockUpdateManager.
• (API) Renamed class ChunkService to ChunkManager.
• (API) Renamed class EntityService to EntityManager.
• (API) Renamed class EntityPhysicsService to EntityPhysicsEngine, and physics engine related classes are now moved to package org.allaymc.api(server).world.physics.
• (API) Renamed class LightService to LightEngine, and light engine related classes are now moved to package org.allaymc.api(server).world.light.
• (API) Renamed class PlayerService to PlayerManager.
• (API) Renamed class ScoreboardService to ScoreboardManager.
• (API) Renamed package org.allaymc.api(server).client to org.allaymc.api(server).player.
• (API) Renamed classes BlockStateSafeGetter and ItemTypeSafeGetter to BlockStateGetter and ItemTypeGetter.
• (API) Renamed class ApiInstanceHolder to APIInstanceHolder.
• (API) Renamed class EntityStatus to EntityState.
• (API) Renamed FullContainerType to ContainerType. All the network related code inside are moved to server module.
• (API) Renamed classes PlayerArmorContainer, PlayerInventoryContainer and PlayerOffhandContainer to ArmorContainer, InventoryContainer and OffhandContainer.
• (API) Renamed method TextReceiver.sendTr() to TextReceiver.sendTranslatable() for better readability.
• (API) Renamed method LoginData.isXboxAuthenticated() to LoginData.isAuthed().
• (API) Renamed package i18n to message.
• (API) Renamed class TextReceiver to MessageReceiver and method TextReceiver.sendText() to MessageReceiver.sendMessage().
• (API) Renamed class DefaultDescriptor to ItemTypeDescriptor.
• (API) Renamed item stack network id to unique id for better readability, changes are made to multiple related methods.
• (API) Renamed method Command.getCommandOverloads() to Command.getOverloads().
• (API) Renamed method BlockState.getBlockStateTag() to BlockState.getBlockStateNBT().
• (API) Renamed class EntityDamageComponent to EntityLivingComponent.
• (API) Renamed class EntityPlayerNetworkComponent to EntityPlayerClientComponent.
• (API) Renamed class BlockEntityHolderComponent to BlockBlockEntityHolderComponent to match the naming convention.
• (API) Refactored the container system, multiple methods were renamed/deleted. See the commit history for details.
• (API) Refactored the permission system to add support for multiple parents in a permission group. See the commit history for details.
• (API) Due to the new XXXViewer system, a number of network related methods are removed (e.g. Entity.createSpawnPacket()). See the commit history for details.
• (API) Flattened all classes under player package.
• (API) Introduced new GameMode enum, and the old GameType used in protocol lib is unused since it has many game types which only exist in vanilla.
• (API) Moved effect-related methods from EntityBaseComponent to EntityLivingComponent.
• (API) Moved class ComponentManager from api to server module since it is useless in api module.
• (API) Moved classes BlockPropertyProcessor, BlockPlaceHelper and FortuneDropHelper from api to server.
• (API) Moved classes Structure and StructureException from utils to world package.
• (API) Moved class BlockAndItemIdMapper from api to server module.
• (API) Moved all effect implementations from api to server module.
• (API) Moved classes under package component.interfaces to component package.
• (API) Moved class ScoreboardStorage form package scoreboard.storage to scoreboard package.
• (API) Moved classes HashUtils and HashException from package utils to utils.hash.
• (API) Moved classes Identified, Identifier, IdentifierUtils and InvalidIdentifierException from package utils to utils.identifier.
• (API) Moved class GameLoop from api module to server module.
• (API) Moved class JSONUtils and the classes only used by this util from api module to server module.
• (API) Moved class Difficulty, DimensionInfo, Sound and Weather from package world to package world.data.
• (API) Moved class NPCCommandSender from api module to server module.
• (API) Moved class ClientStatus from package network to package player and renamed it to ClientState.
• (API) Moved the implementations of EnchantmentType from api module to server module.
• (API) Moved class CommandParseException from api module to server module.
• (API) Moved methods BlockStateData.fromJson() to class BlockStateDataLoader.
• (API) Moved several data classes for block and item to packages block.data and item.data.
• (API) Moved class XXXId from api to server, since the user is expected to use objects in XXXTypes.
• (API) Moved events PacketSendEvent and PacketReceiveEvent from api module to server module.
• (API) Moved package item.descriptor to item.recipe.descriptor since the item descriptor is only used in recipe system.
• (API) Moved XXXInitInfo classes to their parent packages.
• (API) Moved class CommonEnums from api to server.
• (API) Moved classes CachedSimpleSelectorArgument and CachedFilterSelectorArgument from api to server.
• (API) Moved classes XXXTag and XXXTags from tag package to data package.
• (API) Moved class DamageType out from class DamageContainer.
• (API) Moved class ServerSettings from api to server.
• (API) Moved class WorldSettings from api to server.
• (API) Moved classes BanInfo and Whitelist from api to server. Plugin should use the APIs in PlayerManager instead of reading/writing the config directly.
• (API) Updated several methods in EntityBaseComponent to use WorldViewer as the viewer of entity instead of EntityPlayer.
• (API) Refactored the weather system. World will hold only one Weather instance now.
• (API) Refactored the container system. All container implementations are moved to server module now.
• (API) Refactored the sound and particle system, now each sound and particle instance is a pure data object or an enum of SimpleSound/SimpleParticle if it doesn't require additional parameters.
• (API) Refactored the recipe system, network-related code is moved to the server module.
• (API) Made classes UIProfile, DeviceInfo and Device as the inner classes of LoginData.
• (API) Made classes APINotImplementedException, MissingImplementationException, MissingRequirementException and APIInstanceHolder as the private subclasses of AllayAPI.
• (API) Made class LoginData as an interface, the implementation is moved to the server module.
• (API) Replaced protocol library class ModalFormCancelReason with FormCancelReason in the modal form APIs.
• (API) Replaced protocol library class CreativeItemCategory with CreativeItemCategory.Type in the creative item APIs.
• (API) Class BossBar now accepts BossBarViewer instead of EntityPlayer directly, but the usage won't change since EntityPlayer implemented BossBarViewer.
• (API) Changed methods in ItemSignBaseComponent to return BlockType instead of BlockId.
• (API) Changed the parameters of method WorldPool.loadWorld().

Fixed

• Fixed the bug that snowball will always make knockback even if the entity being hit is in damage cool down.
• Fixed the bug where Ender Pearls would deal damage to Blazes.
• Fixed an NPE bug that could occur in extreme cases for the light engine.
• Fixed incorrect hardened block pos when lava flow to the water from above.
• Fixed the bug where plugins lacking soft dependencies could not be loaded.
• Fixed the bug where plugins which have dependencies will only be loaded but not enabled.
• Fixed the sub chunk sending system.
• Fixed the bug that food leve is not frozen when world difficulty is set to peaceful.
• Fixed the placement of wall sign.
• Fixed the bug that jukebox accepts any type of item, it now only allows music disc item to be placed.

Removed

• (API) Removed methods isClientCacheEnabled(), isNetworkEncryptionEnabled() and getEncryptionSecretKey() in EntityPlayerClientComponent because these methods are not very useful as APIs.
• (API) Removed classes Abilities and AdventureSettings.
• (API) Removed class CustomBlockComponent since it is never used.
• (API) Removed class Metadata which is used in entity. Using the getter/setter methods for entity data and flag in EntityBaseComponent directly.
• (API) Removed class EntityAttributeComponent, health related methods are moved to EntityLivingComponent and experience/food related methods are moved to EntityPlayerBaseComponent.
• (API) Removed class XXXCustomTags, all the custom tags are merged to XXXTags and the namespace is renamed to minecraft instead of allay.
• (API) Removed classes BaseCommand and SimpleCommand, and plugin commands now should extend Command directly.
• (API) Removed class PacketReceiver.
• (API) Removed class IntMappedRegistry.
• (API) Removed class WorldGeneratorType which is not very useful.
• (API) Removed adventure settings related permissions in Permissions since adventure settings should only change when the game mode change.
• (API) Removed field CommonEnums.GAMEMODE_ENUM.
• (API) Removed field networkId in EntityId since it is never used.
• (API) Removed method Difficulty.from(String).
• (API) Removed methods ChunkLoader.onChunkInRangeSend() and ChunkLoader.onChunkOutOfRange(), they are replaced by WorldViewer.viewChunk() and WorldViewer.removeChunk().
• (API) Removed method WorldData.sendTimeOfDay().
• (API) Removed method UnsafeChunk.getPlayerChunkLoaders().
• (API) Removed methods Dimension.addLevelSoundEvent() and Dimension.addLevelEvent() due to the new sound/particle system.
• (API) Removed methods Dimension.sendBlockUpdateTo(), please use WorldViewer.viewBlockUpdate() instead.
• (API) Removed network-related methods in class BlockEntityBaseComponent, use the newly introduced world viewer interface instead.
• (API) Removed methods BlockEntityHolderComponent.createBlockEntity() and BlockEntityHolderComponent.removeBlockEntity() since these methods are not expected to be touched by the user.
• (API) Removed method EntityBaseComponent.applyEntityEvent() which is replaced by the new entity action system.
• (API) Removed method EntityBaseComponent.saveNBTWithoutPos() which is never used.
• (API) Removed method Position3ic.toNetwork().
• (API) Removed method BlockEntityBaseComponent.sendPacketToViewers().
• (API) Removed chunk packet related methods in UnsafeChunk.
• (API) Removed method CommandSender.getCommandOriginData().
• (API) Removed method CommandSender.handleResult().
• (API) Removed network related methods in classes ScoreboardLine and Scorer.
• (API) Removed method BlockState.toNetworkDefinition().
• (API) Removed method Container.toNetworkItemData().
• (API) Removed methods toNetwork(), getChunkDataPacket() and toEntryInfo() in class Pack.
• (API) Removed method EntityPlayerClientComponent.getClientSession().
• (API) Removed method EnchantmentInstance.toNetwork().
• (API) Removed network-related methods in the command system.
• (API) Removed method Command.getCommandFormatTips().
• (API) Removed methods BlockPropertyType.getProcessor() and BlockPropertyType.setProcessor().
• (API) Removed network-related code in Weather
• (API) Removed method BlockType.register().
• (API) Removed method GenerateFunction.getName().
• (API) Removed method Entity.teleportAsync() since the normal teleport method is not blocking now.
• (API) Removed field BlockPlaceEvent.entity since the entity can be obtained from the interact info.
• (API) Removed a number of useless build-in permissions which are listed in class Permissions, the developer should listen to the corresponded events.

0.7.1 (API 0.11.0) - 2025/8/20

Compare with 0.7.0

Added

• (API) Introduced EntityPhysicsComponent, EntityAgeComponent and EntityProjectileComponent to split different logic to different components instead of all in base component.
• (API) Introduced a new mutable field throwForce in ProjectileLaunchEvent which indicates the force of the projectile when it is launched.
• (API) Introduced method Entity.getLastLocation() which returns the last tick location of the entity.
• (API) Introduced a new configuration ServerSettings.WorldSettings.removeUnusedProtoChunkCycle which controls how long a proto chunk can remain in memory.
• Introduced component EntityBreatheComponent which handle the logic of entity breathe.
• Added armor component to the newly added copper armor items.
• Introduced a new optional arg for command /enchant which indicates whether the entered level should be checked to be in acceptable range.
• Implemented xp bottle.
• Added back spawn point finding logic, and now the world will look for a suitable spawn point when it is first created.

Changed

• (API) ChunkLoadEvent and ChunkUnloadEvent were uncancellable now. Consider using FakeChunkLoader instead.
• (API) Refactored the chunk system, some APIs are changed.
• (API) Renamed ServerSettings.WorldSettings.removeUnneededChunkCycle to ServerSettings.WorldSettings.removeUnusedFullChunkCycle.
• (API) Renamed ServerSettings.WorldSettings.chunkTrySendCountPerTick to ServerSettings.WorldSettings.chunkMaxSendCountPerTick. in corresponding to the new removeUnusedProtoChunkCycle configuration.
• Refactored EntityPhysicsComponentImpl for readability.
• Resending available commands is now the default behavior for PermissionListener.
• Removed Command.createPermissionForCommand(), use Permission.createForCommand() instead. See commit history for details.

Fixed

• Fixed client lag due to AvailableCommandsPacket being sent continuously.
• Fixed client sometime miss textures for some items like snowball, ender pearl, etc.
• Fixed ClassCastException on BlockChorusFlowerBaseComponentImpl.
• Fixed recursive wall updating.
• Farmland trampling now correctly considers any entity whose bounding box exceeds a certain size threshold, instead of relying solely on a fixed entity whitelist.
• Player movement now normally reduces satiety
• /world tp <world> now teleports the player to the spawn point for overworld dimension.
• Fixed the physics for some entities including TNT, and stepping is disabled by default now.
• Fixed WeatherChangeEvent spamming.
• Removed Utils.convertByteBuf2Array(). Use ByteBufUtil.getBytes() instead for better safety and reliability.

Removed

• (API) Removed EntityPhysicsBaseComponent.
• (API) Removed ChunkPreLoadEvent.
• (API) Removed keep loading chunk related methods in ChunkService. Consider using FakeChunkLoader instead.

0.7.0 (API 0.10.0) - 2025-8-10

Compare with 0.6.0

Added

• (API) Added GameRule.LOCATOR_BAR.
• (API) Added method BlockFace.getHorizontalIndex() to get the horizontal index of the block face.
• (API) Added method BlockFace.fromHorizontalIndex() to get the block face from the horizontal index.
• (API) Added event PlayerInteractEntityEvent.
• (API) Added events PlayerBucketFillEvent and PlayerBucketEmptyEvent.
• (API) Added class CustomItemComponentDataGenerator which adds basic support for custom item.
• (API) Added method CreativeItemCategory.getNamedGroup() to get a named group in a creative category by its name.
• (API) Added class CreativeItemGroups which contains all the available creative item groups in vanilla.
• (API) Added event ItemFrameUseEvent which is called when an item frame is used.
• (API) Added scale property for DebugArrow.
• (API) Added methods updateMotion(), trySetLocation() and applyMotion() to EntityBaseComponent. These methods are intended only be called by physics engine, and user should override them only.
• (API) Added method onCollideWithBlock() to EntityBaseComponent.
• (API) Added ProjectileLaunchEvent and ProjectileHitEvent events.
• (API) Added PlayerMapInfoRequestEvent event.
• (API) Added method EffectType.getColor() to get the color of an effect type.
• (API) Added class PotionType which represents the type of potion bottle item.
• (API) Added methods BlockBehavior.onEntityInside() and Entity.onInsideBlock().
• (API) Added method CustomItemComponentDataGenerator.Builder.cooldown() to set cooldown for custom item.
• (API) Added methods BlockBehavior.onProjectileHit() and Entity.onProjectileHit().
• (API) Implemented writable book and written book.
• (API) Implemented (glowing) item frame.
• (API) Implemented map.
• (API) Implemented snowball.
• (API) Implemented potion and splash potion.
• (API) Implemented ender pearl.
• The color of the player on the locator bar is now calculated based on their name.
• Added overloads for methods AllayXXXType.Builder.build() which accept a custom ClassLoader. This parameter should be used by plugins if plugins want to create custom item type, because plugins classes are loaded by JarPluginClassLoader.
• Added support for in-plugin resource pack, which allows plugins to include their resource pack under assets/resource_pack. This is useful for plugins that have custom items or blocks that require a resource pack to be displayed correctly.
• Players now can see each other's permission level in pause menu.
• Improved /kick command.
• Added support for 1.21.100.

Changed

• (API) Renamed method BlockFace.fromId() to BlockFace.fromIndex().
• (API) Several methods in PackLoader are renamed to better match their usage.
• (API) Renamed method CommandSender.getCmdExecuteLocation() to CommandSender.getCommandExecuteLocation().
• (API) Moved plugin i18n file directory from lang to assets/lang.
• (API) Renamed ItemFoodComponent to ItemEdibleComponent.
• (API) Renamed PlayerEatFoodEvent to PlayerEatEvent.
• (API) Method Entity.teleport() now return a boolean value which indicates whether the event is cancelled.
• (API) Updated method Entity.knockback(). It now accepts a custom additionalMotion vector.
• (API) Renamed class BlockStateWithPos to Block.
• Commands /op and /deop now use player target parameter instead of string parameter.`
• Refactored knockback related logic, it now better matches the vanilla.

Fixed

• Fixed the bug that AvailableCommandsPacket won't be resent to the player if command permissions changed, usually when using /op and /deop commands.
• Fixed trapdoor placement.
• Fixed melon/pumpkin stem drop.
• Fixed the bug that vibration visual feature can't be enabled in the settings menu when playing in the server.
• Fixed lag in entity movement due to packets not being sent immediately.
• Fixed falling blocks, they now become blocks instead of dropped items when they hit the ground.
• Fixed the bug that client's offhand won't get updated when setting offhand item.
• Fixed a possible NPE in method ItemBaseComponent.isCorrectToolFor().
• Fixed the bug that lava and fire won't ignite the entity
• Fixed NPE when creative player breaks bedrock.

Removed

• (API) Removed method BlockPlaceHelper.processDirection4Property().
• (API) Removed several default methods in EntityPlayerNetworkComponent that forward call to LoginData for better codebase.
• (API) Removed methods PackLoader.hasFolder() and PackLoader.forEachIn(), since these methods are never used.
• (API) Removed method MathUtils.grow(). Consider using AABBd.expand instead.
• (API) Removed methods BlockBehavior.canCollideWithEntity() and EntityBaseComponent.hasBlockCollision().
• (API) Removed fields customKnockbackXXX in DamageContainer. Consider setting DamageContainer.hasKnockback to false and apply your own knockback logic.

0.6.0 (API 0.9.0) - 2025-7-7

Compare with 0.5.0

Added

• (API) Added APIs for the new DebugShape system. Available debug shape classes can be found under org.allaymc.api.debugshape, and add/remove methods for debug shape are available in Dimension class.
• (API) Added method World.getState as the replacement for the removed World.isRunning method.
• (API) Added ServerSettings.NetworkSettings.raknetGlobalPacketLimit to control the global packet limit for RakNet.
• (API) Added support for ipv6, and two new options ipv6 and portv6 are added to server-settings.yml.
• (API) Added PlayerMoveEvent.setRevertTo() method which allow to specify custom cancel/revert position for PlayerMoveEvent.
• Added support for bedrock 1.21.93.

Changed

• (API) Method EntityService.getEntitiesInChunk is considered not thread-safe to better its behavior now.
• (API) Refactored LoginData to match the update of LoginPacket recently. Method LoginData.getDisplayName() was renamed to LoginData.getXname().
• (API) All constructors of EffectXXXType are now package-private to prevent plugins from constructing them directly. Plugin developers are expected to use EffectTypes class to get the effect types.
• (API) Method Dimension.setBlockState() now return boolean instead of void, since in some cases the block state may not be set successfully.

Fixed

• (API) Fixed the bug that BlockPlaceEvent.getBlockState() won't return the accurate block state that is being placed.
• Fixed the bug that in some cases entities would still spawn after a server reboot even though they had been killed.
• Fixed /fill command behavior, it now more closely matches the vanilla behavior.

Removed

• (API) Removed World.isRunning method, please use World.getState method instead.
• (API) Removed BlockPlaceEvent.getItemUsed(), consider using EntityPlayer.getItemInHand() instead.

0.5.0 (API 0.8.0) - 2025-6-19

Compare with 0.4.1

Added

• (API) Introduced new option raknet-packet-limit in ServerSettings to control the maximum number of datagram packets each client can send within a single RakNet tick.
• Added docker and docker-compose support, now you can build docker image by your own (image will be uploaded to Docker Hub in the future).
• Added support for bedrock 1.21.90.

Changed

• (API) Removed classes under org.allaymc.api.client.skin. SerializedSkin class in protocol library is used directly now.
• Replaced the outdated event loop group handling with new MultiThreadIoEventLoopGroup.
• Refactored permission system, see commit history for more info.

Fixed

• Fixed block picking behavior.
• Fixed fence gate opening in server-side.
• Fixed quartz and purpur blocks behavior.
• Fixed BlockFace.UP axis.
• Fixed potential NPE in light service during server shutdown.

0.4.1 (API 0.7.0) - 2025-5-11

Compare with 0.4.0

Fixed

• Fixed item components.

0.4.0 (API 0.7.0) - 2025-5-10

Compare with 0.3.0

Added

• (API) Added DamageContainer#fallingBlock(float).
• (API) Added BlockStateWithPos#updateBlockProperty(BlockPropertyType<DATATYPE>, DATATYPE) method.
• Added Glided Blackstone, Gravel, and Glowstone drop.
• Implemented ladder, infested blocks, ice, snow, sea lantern, dead bush, and end portal frame behavior.
• Implemented basic behavior for scaffolding.
• Implemented chorus plant & flower behavior.
• Implemented walls & fence gate behavior.
• Added support for bedrock 1.21.80.

Changed

• (API) onFall() now accepted fallDistance.
• Refactored light engine, and it should work much faster than before with multiple bug fixes.
• Refactored falling block system, see commit history for more info.
• Replaced PaleMossCarpetSide(FACE) and WallConnectionType(FACE) to PaleMossCarpetSide and WallConnectionType.
• Refactored BlockStateWithPos, now this allows calling BlockState methods directly through BlockStateWithPos.

Fixed

• (API) Fixed binomial chance.
• (API) Fixed DIRECTION_4 mapper.
• Fixed swords block breaking time.
• Fixed NullPointerException when breathe disabled.
• Fixed Beetroot, Carrots, Leaves, Potatoes, Redstone Ore, Grass, and Wheat drops.
• Fixed SetTimePacket spamming.
• Fixed random bounds.
• Fixed BlockBreakEvent cancelling.
• Fixed spam click bug.
• Fixed chicken food points.
• Fixed jukebox music continue playing when broken.
• Fixed incorrect horizontal sky light propagation.
• Fixed Position3i math methods.
• Fixed execute commands in terminal.

0.3.0 (API 0.6.0) - 2025-3-28

Compare with 0.2.0

Added

• (API) Added ANVIL, STONECUTTER, GRINDSTONE, CARTOGRAPHY_TABLE, LOOM and SMITHING_TABLE container types.
• (API) Implemented all behaviors for Stonecutter, Grindstone, Smithing Table and Anvil.
• (API) Added ItemStack#isEmptyOrAir() method.
• (API) Added BlockPlaceHelper#processDirection4Property() method.
• (API) Added RecipeContainer interface for validating crafting packets.
• (API) Added ItemRepairableComponent to check if an item can be repaired with a specific material.
• (API) Added ItemTrimmableComponent for trimming armor.
• (API) Added AnvilDamageEvent, AnvilTakeResultEvent and GrindstoneTakeResultEvent for plugins.
• (API) Added ProtocolInfo.ITEM_STATE_UPDATER which corresponds to ProtocolInfo.BLOCK_STATE_UPDATER.
• (API) Added CommandNode#addLeaf(Function<CommandNode, CommandNode>) method which helps keeping chain calls when using custom command node.
• (API) Introduced PlayerService, and added Server#getPlayerService method. Note that there are also a number of method moves from Server to PlayerService.
• (API) Added ClientDisconnectEvent.
• (API) Added PlayerJoinEvent#joinMessage and PlayerQuitEvent#quitMessage and correspond setters. Now these messages can be edited by plugins.
• (API) Added BlockBaseComponent#getDropXpAmount method.
• (API) Added option tickDimensionInParallel to control whether tick dimensions in the same world in parallel during world tick.
• (API) Added BlockFace#fromMinecraftCardinalDirection and BlockFace#isVertical methods.
• (API) Added BlockStateWithPos#getBlockEntity method.
• (API) Implemented chest pairing, and several related interfaces & objects including BlockEntityPairableComponent, DoubleChestContainer, are added to api module, see commit history for more details.
• (API) Added support for the new elements in simple and custom form: divider and header. Label element now can be added to simple form as well.
• Added support for bedrock 1.21.70.
• Implemented ores.
• Added InternalRegistries#TRIM_PATTERNS and InternalRegistries#TRIM_MATERIALS.

Changed

• (API) Renamed durability related methods inItemBaseComponent:
  • getDurability() -> getDamage()
  • setDurability() -> setDamage()
  • tryReduceDurability() -> tryIncreaseDamage()
• (API) Moved player, ban/whitelist related methods from Server to the new PlayerService class.
• (API) Moved Server#getNetworkInterface method from Server to the new PlayerService class. NetworkInterface is now held by PlayerService rather than Server.
• (API) Moved PlayerQuitEvent#reason to the newly introduced event ClientDisconnectEvent. PlayerQuitEvent will only be called for already logged in player now.
• (API) Removed BlockEntityBaseComponent#clearCustomName method, use BlockEntityBaseComponent#setCustomName(null) to clear custom name.
• Removed BlockEntityContainerHolderComponentImpl#constructor(Supplier<Container>, Consumer<ContainerViewer>, Consumer<ContainerViewer>).
• Optimized setItemStack handling in ItemStackRequestPacket to no longer require sending an InventorySlotPacket (Issue #66).
• Use AtomicReference<ServerState> instead of AtomicBoolean's fields for state management

Fixed

• (API) Fixed BlockStateData#isTransparent() method.
• Fixed torch placement on non-full blocks (e.g., walls, fences) and automatic placement detection.
• Fixed skin display issue in 1.21.60.
• Fixed EnderChest behaviour and drops.
• Fixed LightningRod placing.
• Fixed Door placing.
• Fixed two bugs in /give command which make the gave item amount being shown incorrectly.
• Fixed block breaking time calculation to match Minecraft's official breaking time formula, resolving a rounding issue that caused slight discrepancies.
• Fixed a bug in sky light calculation which causes the sky light stop propagating.

Removed

• (API) Removed Server#findOnlinePlayerByName method which is duplicated with Server#getOnlinePlayerByName.
• Removed loot table api.

0.2.0 (API 0.5.0) - 2025-3-3

Compare with 0.1.3

Added

• (API) Implemented ender chest, and several related interfaces & objects including BlockEntityEnderChest, EnderChestContainer, are added to api module, see commit history for more details.
• (API) Added VoxelShape#intersectsRay method, which can determine whether the given ray intersects the voxel shape.
• (API) Added multiple BlockUpdateService#scheduleRandomBlockUpdate method overloads, which can schedule a random block update at a specified position. These methods are used by fire block currently to make it able to change fire spreading speed by changing random block update speed.
• (API) Added WorldSettings.WorldSetting#runtimeOnly, If set this to true, the information of this world will not be saved to world-settings.yml, therefore it won't be loaded after the server restarted. This is useful for world created for game room by plugin and will be deleted when shutdown.
• (API) Added PluginManager#registerCustomSource and PluginManager#registerCustomLoaderFactory, custom plugin loaders and sources can be registered by plugin now.
• (API) Added Form#onClose(Consumer<ModalFormCancelReason>) method that can be used to set a callback which will be called with the close reason when the form is closed. The old Form#onClose method is still available that just ignores the reason.
• (API) Added ChunkService#removeUnusedChunksImmediately method that can remove unused chunks immediately. Also, the /gc command will call this method in all dimensions now.
• (API) Added ItemBaseComponent#getLockMode and ItemBaseComponent#setLockMode methods to get and set the lock mode of an item.
• (API) Added ChunkSection, chunk section can be obtained from chunk.
• (API) Added EnchantmentType#canBeAppliedTo, EnchantmentType#getAppliableType and ApplicableType, these methods can be used to check if an enchantment type can be applied to a specific item type.
• (API) Introduced new item tag allay:head and helper method ItemHelper#isHead which can be used to check if an item is a head item.
• (API) Introduced ItemStack#isAllEnchantmentsAvailableInEnchantTable method. This method is used in book item.
• (API) Introduced EntityBaseComponent#getStatus which can get the status of an entity. This status replaced the old boolean flags such as spawned, dead, willBeSpawnedNextTick and provide better stability and extensibility.
• (API) Added ClientConnectEvent#setDisconnectReason and PlayerLoginEvent#setDisconnectReason methods to set the disconnect reason that will be shown to the client when cancelling these events.
• (API) Implemented flower pot, and add custom block tag allay:pottable_plant which mark thant the plant can be potted.
• (API) Introduced PDC (Persistent Data Container) system. The PDC is a way to store custom data on a whole range of objects, such as items, entities, block entities, and world. More PDC types will be added in the future.
• (API) Added ItemType#getItemData method which replaces the old ItemDataComponent.
• (API) Introduced new option entity-auto-save-cycle in ServerSettings to control the interval of entity auto save.
• (API) Entities are now held by EntityService directly, and a variety of new methods are added into EntityService. See the commit history for more details.
• (API) Introduced WorldStorage#readEntities, WorldStorage#writeEntities and their correspond sync methods. These methods are used to read and write entities in a specified chunk area.
• (API) Introduced a variety of methods for sending toast, title, subtitle, and actionbar text to player, and new command /title is added.
• (API) Introduced CommandNode#permission method which can be used to set the permission requirement for accessing a specified command node. This is useful for setting permission for sub commands.
• Add support for bedrock 1.21.60.
• Add support for the new entity storage format used in 1.18.30+. Now entities in newer vanilla maps can be loaded correctly.
• Implemented reeds (also called sugar cane) and cactus.
• Implemented UpdateSubChunkBlocksPacket related logic, which will make client load large range block updates much quicker (e.g. using /fill command to fill a large area).
• Introduced ChunkSectionLocks, which replaced the old StampedLock in Chunk. Instead of locking the whole chunk when reading/writing blocks/biomes, only the related chunk section will be locked now. This should improve the performance of chunk reading/writing.
• Added PluginDisableEvent and PluginEnableEvent events.

Changed

• (API) We now used double instead of float in entity location, motion, aabb, and some other classes which require high precision. This should improve the accuracy of entity movement and collision detection.
• (API) Renamed FullContainerTypeBuilder to Builder.
• (API) Moved method Chunk#isLoaded to UnsafeChunk#isLoaded.
• (API) Made method Dimension#createUpdateBlockPacket private, consider using Dimension#sendBlockUpdateTo method instead.
• World will be skipped if failed to be load.
• (API) Moved and renamed UnsafeChunk#index method to HashUtils#hashChunkSectionXYZ.
• (API) Refactored Chunk and UnsafeChunk, now Chunk works more likely a wrapper for UnsafeChunk that provides safe access to chunk data in multi-threads environment.
• (API) Replaced Chunk#batchProcess method with new Chunk#applyOperation and Chunk#applyOperationInSection methods.
• (API) Moved inner class ItemArmorBaseComponent#ArmorType to package org.allaymc.api.item.data.
• (API) Changed the default value of ServerSettings#GenericSettings#defaultPermission to PlayerPermission.MEMBER.
• (API) VoxelShape have being refactored. Now it doesn't allow using vacancy, this change is required by physics engine to fix some bugs.
• (API) Renamed BlockState#setProperty and BlockState#setProperties to BlockState#setPropertyValue and BlockState#setPropertyValues to match the getter methods.
• (API) Refactored the creative item registry and related classes & methods, which allow plugin to customize item groups.
• (API) Renamed Command#COMMAND_PERM_PREFIX to Command#COMMAND_PERMISSION_PREFIX.
• Main thread will sleep a short time if gui is enabled when the server exits abnormally. This gives user time to see what goes wrong.
• Server won't crash if failed to load the descriptor of a plugin now. An error message will be print to the console instead.
• Server won't crash if failed to create world generator. Void world generator will be used instead.
• It is not allowed to reset the dimension of player back to null now, and doing such thing will result in an exception.
• Changed PlayerAuthInputPacketProcessor#TELEPORT_ACK_DIFF_TOLERANCE from public to protected.
• Scheduled block updates are saved in vanilla format instead of our custom format now. This should improve the compatibility with vanilla map.

Fixed

• Plugins are able to create their own world generator implementation now. In previous versions a ClassCastException would be thrown when initializing the dimension.
• Explosion now calculates entity exposure correctly. In previous version any non-air block will block the explosion ray.
• Explosion damage now scales with game difficulty.
• Fixed a rare NPE exception that may occur if player disconnect when joining the server.
• Fixed missing block breaking particle when breaking block.
• Item entity will be despawned immediately instead of having a dead timer when its health become 0. It's dead smoke is also removed.
• Fixed the bug that unusable enchantment types may be shown in enchantment table.
• Fixed the bug that /give command will stack item that cannot be stacked like sword.
• Fixed the bug that damage that smaller than 1 will never kill an entity even if the entity has only 1 health.
• Fixed the bug caused by incorrect initial value of runtime id counter. The initial value should be 1 instead of 0.
• Fixed the bug that /alwaysday command actually do the opposite thing.
• Several bugs in physics engine, including wrong collision detection and wrong movement calculation are fixed.
• Gamerule doDaylightCycle now works correctly.
• Fixed touch-mode player (phone player usually) block breaking with "delayed block breaking" option enabled.
• A series of getter/setter method in Dimension class now won't load the chunk. This behavior causes a lot of deadlock in the past.

Removed

• (API) Removed UnsafeChunk#SECTION_SIZE.
• (API) Removed UnsafeChunk#setHeight, it is an unexpected behavior to set height of a chunk without block change.
• (API) Removed BlockBaseComponent#canKeepExisting method to eliminate ambiguity.
• (API) Removed PlayerStorage#tick and PlayerStorage#shutdown methods, these methods shouldn't be in api module.
• (API) Removed Registries#BLOCK_STATE_DATA. This registry is moved to InternalRegistries.
• (API) Removed Registries#ITEM_DATA. This registry is moved to InternalRegistries.
• (API) Removed VoxelShapes#buildStairShape method, we now have accurate collision shape data dumped from BDS.
• (API) Removed the old BlockState#toNetworkBlockDefinition method, and BlockState#toNetworkBlockDefinitionRuntime was renamed without Runtime suffix.
• (API) Removed ItemDataComponent. ItemData is now located in ItemType<?>.
• (API) Removed Dimension#getEntityByRuntimeId. This method is replaced by EntityService#getEntityByRuntimeId.
• (API) Removed Dimension#getEntityPhysicsService. This method is replaced by EntityService#getPhysicsService.
• (API) Removed ChunkLoader#spawnEntity and ChunkLoader#despawnEntity methods.
• (API) Removed UnsafeChunk#getEntity, UnsafeChunk#getEntities, UnsafeChunk#spawnEntitiesTo and UnsafeChunk#despawnEntitiesFrom methods. Because entity is not held by chunk now.
• Removed Extension#afterServerStarted method.
• Removed org.allaymc.server.datastruct.collections.nb.*, we now use the implementations provided by JCTools. Consider using NonBlockingHashMap and NonBlockingHashMapLong if your plugins use these classes.

0.1.3 (API 0.4.0) - 2025-1-17

Compare with 0.1.2

Added

• (API) Introduced AllayAPI#isDevBuild to let plugin know if the current server is a dev build.
• (API) Introduced BlockCustomTags#WATER and BlockCustomTags#LAVA to allow checking if a block is water or lava easier. This is because there are two types of water (minecraft:water and minecraft:flowing_water) and lava ( minecraft:lava and minecraft:flowing_lava) in vanilla.
• (API) Introduced Dimension#getLiquid, Dimension#setLiquid and Dimension#removeLiquid methods to help plugin operate liquid easier.
• (API) Introduced Dimension#addLevelSoundEvent(Vector3ic pos, SoundEvent soundEvent, int extraData) and Dimension#addLevelSoundEvent(Vector3fc pos, SoundEvent soundEvent, int extraData).
• (API) Added EntityTrampleFarmlandEvent. EntityTrampleFarmlandEvent is called when a farmland is trampled by an entity.
• (API) Added BlockGrowEvent which will be called when crops grow.
• (API) Added two overloads LightService#getInternalLight(Vector3ic) and LightService#getSkyLight(Vector3ic), they have the same functionality as LightService#getXXXLight(int, int, int).
• (API) BlockContainer#getBlockPos and BlockContainer#setBlockPos now return/require Position3ic instead of Vector3ic, this enables us to get the dimension information of a BlockContainer.
• (API) Implemented brewing stand, and several related interfaces & objects including BlockEntityBrewingStand, BrewingStandContainer, Registries#POTION_MIX_RECIPES, PotionMixRecipe are added to api module, see commit history for more details. Added BrewingStandBrewEvent, BrewingStandConsumeFuelEvent and BrewingStandStartBrewEvent events.
• (API) Implemented slab, and several related interfaces are added to api module.
• (API) Introduced BlockBaseComponent#combine method which is used by slab. For the details of this method, see the javadoc.
• (API) Implemented beacon block, and several related interfaces are added to api module.
• (API) Implemented brewing stand, and several related interfaces & objects including BlockEntityBrewingStand, BrewingStandContainer, Registries#POTION_MIX_RECIPES, PotionMixRecipe are added to api module. See commit history for more details.
• (API) Implemented picking block with block entity data. The following methods are added: ItemBaseComponent#getBlockEntityNBT, ItemBaseComponent#setBlockEntityNBT, ItemBaseComponent#clearBlockEntityNBT and ItemBaseComponent#hasBlockEntityNBT.
• (API) Implemented TNT. There is now a new class called Explosion which can be used by plugin to make custom explosion.
• (API) Introduced a number of overloads of Dimension#addSound.
• (API) Introduced method EntityAttributeComponent#supportAttribute to check if the entity support specified attribute type.
• (API) Introduced methods DamageContainer#blockExplosion and DamageContainer#entityExplosion to create explosion related damage.
• (API) Introduced methods EntityBaseComponent#getDragFactorOnGround and EntityBaseComponent#getDragFactorInAir, which can be used to customize the drag factor of an entity.
• (API) Introduced event EntityExplodeEvent which will be called when tnt or creeper(WIP) is about to explode.
• (API) Introduced method EntityBaseComponent#isTouchingWater to check if an entity is touching water.
• (API) Implemented TNT entity, block, and related features. Several related interfaces are added to api module.
• Implemented trapdoor except redstone feature (Redstone feature requires the implementation of redstone system).
• Implemented sponge and wet sponge.
• Implemented farmland and hoe.
• Implemented most of the crops, including wheat, potato, carrot, beetroot, melon, and pumpkin.
• Introduced sentry to capture exception and upload them to sentry server automatically, which helps us to track and fix bug more efficiently. Sentry is only enabled in non-dev version.
• Server version will also be uploaded to bStats now.
• Introduced Extension#afterServerStarted method which will be called after the server is started.

Changed

• (API) Removed BlockFace#toStairDirectionValue, this method shouldn't exist in api module.
• (API) BlockTags, BlockCustomTags, ItemTags and ItemCustomTags are now annotated with @MinecraftVersionSensitive as these tags may change between different versions.
• (API) The second parameter of BlockBaseComponent#onEntityFallOn now accepts BlockStateWithPos instead of BlockState.
• (API) EntityBaseComponent#getBlockStateStandingOn now return BlockStateWithPos instead of BlockState.
• (API) Removed BlockFace#horizontalIndex which is useless.
• (API) Removed ScoreboardService#ServerEventListener as it is not supposed to be touched by plugin.
• (API) Methods BlockEntityFurnaceBaseComponent#getStoredXP and BlockEntityFurnaceBaseComponent#setStoredXP now accept int instead of float.
• (API) Renamed Structure#pickStructure to Structure#pick.
• (API) Renamed ItemItemStorableComponentImpl to ItemStuffStorableComponentImpl, and now ItemShulkerBoxStack extends ItemStuffStorableComponent.
• (API) Removed methods EntityAttributeComponent#supportHealth and EntityAttributeComponent#supportAbsorption. Consider using new method EntityAttributeComponent#supportAttribute.
• (API) Renamed method EntityBaseComponent#getBaseOffset to EntityBaseComponent#getNetworkOffset for better understanding.
• (API) Removed method Dimension#setBlockStates. This method is considered to be unsafe as it will only set the block state, block entity won't be created if the block has block entity. Further research is currently needed.
• Removed useless class PackageClassLoaderUtils, dependency org.reflections.reflections is also removed.
• Added -dev suffix to api version in development build.
• Changed ContainerActionProcessorHolder to a final class instead of an interface, because this abstraction is meaningless.
• Changed enableGui to enable-gui in server-settings.yml
• Disabled packet limit only in dev build.
• Optimized the performance of physics calculation when there are a lot of entities.
• Changed the gravity of item and xp orb entity to 0.04f to better match vanilla behavior.

Fixed

• (API) BlockHangingSignBehavior now extends BlockEntityHolderComponent<BlockEntityHangingSign> which was forgotten to be added.
• Fixed several bugs that can led falling block keep existing even if it is already on ground or can't move.
• Fixed the ClassCastException when breaking shulker box.
• Fixed the bug that interacting with door doesn't have any sound.
• Waxing copper-made block using honeycomb won't call BlockFadeEvent now.
• Fixed the bug that player can still open enchant table even if he is sneaking.
• Fixed NaN motion caused by liquid in some very special cases.
• Fixed the bug that entity will still get ticked after called removeEntity().
• Fixed the bug that player's pos sometimes get frozen after teleport. This is caused by the issue that sometimes client doesn't send back teleport ack after server sends teleport packet to client.
• Fixed the bug that flint and steel durability reduced in creative mode.
• Fixed the network offset of item entity. Its visual position should now be normal.
• Liquid won't be broken into item by falling block now.

0.1.2 (API 0.3.0) - 2024-12-31

Compare with 0.1.1

Added

• (API) Added an extra argument to Dimension#breakBlock method to control if the block breaking particle should be played.
• (API) Added LiquidHardenEvent#setHardenedBlockState method to allow changing the hardened block state.
• (API) Introduced MathUtils#normalizeIfNotZero method to normalize a vector only if it is not zero, this method prevents NaN caused by Vector3fc#normalize method.
• (API) Introduced EntityBaseComponent#computeLiquidMotion method to control whether an entity has liquid motion.
• (API) Introduced EntityDamageComponent#hasDrowningDamage method to control whether an entity has drowning damage.
• Added liquid motion for water and lava. Now entity will be moved by liquid flow if it is in the liquid.
• Pos sent by the client will only be handled when the pos is changed, as PlayerAuthInputPacket is sent every tick but the player may not move every tick.

Changed

• (API) Removed BlockFace#getBlockFaceByStairDirectionValue method, some fields in VoxelShapes are also private for better maintainability now.
• (API) Remove fat-aabb-margin and stepping-offset fields from server settings as these properties shouldn't be touched by users.
• Introduced tag name constants for where a large number of NBT saving and reading are involved. This improved the maintainability of the project.
• Introduced better names for some of the fields in PlayerAuthInputPacketProcessor, this improved the readability of the code.

Fixed

• (API) Corrected the return type of Dimension#breakBlock(Vector3ic, ItemStack, Entity) from void to boolean. Some overloads for this method are also added.
• (API) Fixed incorrect bit operations in BlockLiquidBaseComponent#getLiquidBlockState and BlockLiquidBaseComponent#getLiquidBlockState#getDepth, although it seems that they do not cause any issues.
• Block breaking particle won't be sent if block is broken by flowing liquid.
• Water placed in nether dimension will disappear immediately now.
• Pos, Motion and Rotation in entity nbt are now saved as list tag instead of compound tag to match vanilla. This also fixed the bug that entities being spawned in incorrect position when placing structure using /structure command. Please note that this change is not backward compatible and will break the old world and player data.
• Fixed several NaNs caused by Vector3fc#normalize methods in the physics engine, and now setting the motion/location of an entity to a vector which contains NaN will result in an exception.
• EntityItem now won't have drowning damage when it is in water, this bug causes entity item died after a period of time in water.
• ServerboundLoadingScreenPacket won't spam warnings in the console when switching dimension now.
• Fixed the bug that sometimes there may be NaN values in PlayerAuthInputPacket, this bug is also confirmed in df-mc (issue#425).

0.1.1 (API 0.2.0) - 2024-12-29

Compare with 0.1.0

Added

• (API) Added TextFormat#MATERIAL_RESIN.
• (API) Entity#teleport method now accepts an extra Reason argument.
• (API) Added structure API by @harry-xi.
• (API) Added a number of new methods to BlockLiquidBaseComponent.
• (API) Added LiquidFlowEvent, LiquidDecayEvent and LiquidHardenEvent.
• (API) Added BlockBehavior#afterPlaced and BlockBehavior#afterReplaced that are correspond to BlockBehavior#onPlace and BlockBehavior#onReplace.
• (API) Added BlockStateData#liquidReactionOnTouch, there are also a number of new methods in BlockStateData.
• Added /structure command to manage structures.
• Implemented liquid features including water, lava, and related features.

Changed

• (API) GameRules is changed to an interface.
• Breaking block related warnings are now moved to debug channel.
• Improved code readability for I18n module.
• NBT library is now updated to 3.0.10.
• /gametest command is now only available in dev build.
• Removed the dimension field in BlockBreakEvent, which is duplicated with block#dimension.
• Removed unused cn.powernukkitx:libdeflate-java library, related classes are also removed.

Fixed

• (API) Fixed exception when setting item count or meta to zero.
• (API) VoxelShapes#buildLiquidShape now works correctly.
• (API) Correct BlockStateData#canContainLiquid to BlockStateData#canContainLiquidSource.
• Passing non-positive amount or negative meta arguments to /give command now will result in a syntax error.
• Entity#teleport method now will reset fall distance correctly.
• Fixed visual flashes when eating chorus fruits.
• Fixed incorrect comparison of Position3x#dimension.
• Fixed a number of falling block related bugs.
• Fixed incorrectly drops when destroying the upper part of a door in creation mode.

0.1.0 (API 0.1.0) - 2024-12-22

Hello Allay! This is the first release of Allay.

Comments