
PacketBlocks
A lightweight Spigot/Paper library for creating and managing client-side, packet-based Minecraft blocks.
- Загрузки
- 271
- Подписчики
- 3
- Обновлён
- 22 января 2026 г.
- Лицензия
- MIT
Опубликован 30 сентября 2025 г.
PacketBlocks is a library for Spigot/Paper servers that lets you create and manage client-side blocks.
It does not do anything on its own — it provides APIs to:
- Display blocks to specific players without modifying the world
- Simulate block breaking with drops
- Manage per-player visibility and metadata
- Use utilities like bounding boxes and animations
Perfect for custom maps, minigames, and advanced server features.
📖 Full instructions and API usage are available in the GitHub README.
🌐 API documentation (Javadocs): https://bitbylogics.github.io/PacketBlocks/
Ченджлог
1.2.4Релиз26.1.1, 26.1.2, 26.2 · 22 января 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.
1.2.3Релиз1.21.9, 1.21.10, 1.21.11 · 22 января 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!
1.2.2Релиз1.21.9, 1.21.10, 1.21.11 · 21 января 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
1.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 23 декабря 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.
1.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 22 декабря 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
1.1.1Релиз1.21.9, 1.21.10, 1.21.11 · 18 декабря 2025 г.
🚀 PacketBlocks v1.1.1 — Block Position Keying Fix & Stability Improvements
⚙️ Internal Changes
- Migrated block indexing to WorldPosition rather than Location
- PacketBlock's may now have a set of BoundingBoxes rather than a single one.
Performance Improvements
This update should drastically improve lookup times and raytracing performance using the PacketBlockUtil#rayTrace method.
1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 18 декабря 2025 г.
🚀 PacketBlocks v1.1.0 - Improved Bounding Boxes & Ray Tracing
✨ Changes
- Reworked bounding boxes to be identified by block state, allowing accurate shape retrieval for all block variants
- Overhauled packet block ray tracing to more accurately detect blocks
- Improved reliability when interacting with non-full and complex block shapes
1.0.2Релиз1.21.8, 1.21.9, 1.21.10 · 19 ноября 2025 г.
🚀 PacketBlocks v1.0.2 — Block Update Fixes
✨ What's New
- ✔ Fixed player-specific block updates in
BlockUpdateAdapter - 🧹 Removed unused parameter in
handleStopDestroyfor cleaner code.
Комментарии
Загружаем…