
PacketBlocks
A lightweight Spigot/Paper library for creating and managing client-side, packet-based Minecraft blocks.
Hotfix - v1.2.4
release22 января 2026 г.🩹 PacketBlocks - v1.2.4 Hotfix
🐛 Fix
- Fixed an issue where
PacketBlockGroupblocks outside a chunk could wrap and render on the wrong side.
🔧 Details
- Blocks are now validated against the target chunk before being written.
- Prevents cross-chunk wraparound and visual inconsistencies.
Safe to update. No API changes.
Group Updates - v1.2.3
release22 января 2026 г.📦 PacketBlocks — v1.2.3 Group Updates
📌 What’s New
This release enhances the PacketBlocks API by adding support for adding and removing blocks from existing PacketBlockGroup instances. These new methods make it significantly easier to modify block groups after creation.
✅ Highlights
- Added methods in
PacketBlockManagerto:- Add multiple blocks to a group (
addBlocksToGroup(...)) - Add single blocks to a group (
addBlockToGroup(...)) - Remove multiple blocks from a group (
removeBlocksFromGroup(...)) - Remove single blocks from a group (
removeBlockFromGroup(...))
- Add multiple blocks to a group (
🧠 Why This Matters
Previously, block groups were static after creation. With this update, developers can dynamically modify groups at runtime!
Hotfix - 1.2.2
release22 января 2026 г.🔧 Hotfix - 1.2.2
Summary
- Ensures
updateConsumeris invoked when a viewer is added and updated - Fixes cases where viewers were not receiving updates after being registered
Impact
- Viewer state is now correctly synchronized on add
Notes
- No breaking changes
PacketBlocks 1.2.1
release23 декабря 2025 г.PacketBlocks v1.2.1 — Hotfix Release
🛠 Fixed
An oversight in the previous version caused any updates to the data in a PacketBlock or PacketBlock group to not properly reflect in updates sent to players.
This is a hotfix release, intended for all users of v1.2.0 to ensure block updates work as expected.
PacketBlocks 1.2.0
release22 декабря 2025 г.📦 PacketBlocks — 1.2.0 Release Notes
This release introduces grouped packet blocks, along with a substantial internal refactor to improve extensibility, clarity, and long-term maintainability.
🚀 New Features
✅ Packet Block Groups
PacketBlocks now supports grouped blocks, allowing multiple packet blocks to behave as a single logical unit.
With PacketBlockGroup, you can:
- Treat multiple blocks as one entity
- Share metadata and state across a block cluster
- Handle interactions (break, place, update) at the group level
- Resolve BlockData dynamically per group
This enables more advanced structures such as multi-block machines, large custom blocks, or linked visual elements.
Group logic is implemented in
net.bitbylogic.packetblocks.group.PacketBlockGroup
🔄 Group-Aware Packet Handling
Packet adapters have been updated to detect and respect block groups automatically:
BlockBreakAdapterBlockPlaceAdapterBlockUpdateAdapterChunkLoadAdapter
Each adapter now:
- Detects whether a block belongs to a group
- Resolves group-specific BlockData
- Applies packet overrides consistently across the entire group
This ensures correct rendering and interaction behavior on the client.
🧩 Event Improvements
Existing events now support group context, including:
PacketBlockStartBreakEventPacketBlockBreakEventPacketBlockInteractEvent
Event consumers can now determine whether an interaction applies to:
- A single block
- A block group
