
PacketBlocks
A lightweight Spigot/Paper library for creating and managing client-side, packet-based Minecraft blocks.
Автор: BitByLogic5546обновлён 21 окт. 2026 г.
БиблиотекиУтилиты
Описание
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/
Галерея
Последние версии
Все версии →release
Added: bisected block support
1.2.721 окт. 2026 г.22Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, purpur, spigot
Что нового
## PacketBlocks 1.2.7
### Added: bisected block support
Packet blocks now render both halves of two-block-tall blocks such as doors, tall flowers, tall grass and rose bushes. Previously only the bottom half would appear.
- Create a packet block or group with the bottom half and the top half is added automatically.
- Works with single packet blocks and packet block groups.
- Removing the bottom half also removes the top half, and both halves are restored for the viewer.
- Chunk loads, block updates and ray tracing all handle the top half too.
- Stairs and trapdoors are unaffected.
You no longer need to place the two halves yourself. If you already do, your code keeps working.
### Fixed
- `PacketBlockUtil.getBlockData` and `getBlockType` now return the player's own data for a single packet block, where they used to return the shared data. If you pass a player, you now get that player's data.
release
v1.2.6 - Folia Support
1.2.612 авг. 2026 г.122Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur, spigot
Что нового
- Added Folia support
- Bumped version to `1.2.6`
release
PacketBlocks - v1.2.5
1.2.514 июл. 2026 г.37Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2paper, purpur, spigot
Что нового
- Bumped required PacketEvents version to `2.13.0`
- Removed requirement to disable fly in server.properties
- Added `Block-Flight-Kick` config option to block *all* player flight kicks
release
Hotfix - v1.2.4
1.2.422 янв. 2026 г.117Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, paper, purpur, spigot
Что нового
## 🩹 PacketBlocks - v1.2.4 Hotfix
### 🐛 Fix
- Fixed an issue where `PacketBlockGroup` blocks 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.
release
Group Updates - v1.2.3
1.2.322 янв. 2026 г.29Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
## 📦 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 `PacketBlockManager` to:
- 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(...)`)
### 🧠 Why This Matters
Previously, block groups were static after creation. With this update, developers can dynamically modify groups at runtime!
release
Hotfix - 1.2.2
1.2.221 янв. 2026 г.16Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
## 🔧 Hotfix - 1.2.2
**Summary**
- Ensures `updateConsumer` is 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
release
PacketBlocks 1.2.1
1.2.123 дек. 2025 г.24Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
# 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.
release
PacketBlocks 1.2.0
1.2.022 дек. 2025 г.24Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
# 📦 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:
- `BlockBreakAdapter`
- `BlockPlaceAdapter`
- `BlockUpdateAdapter`
- `ChunkLoadAdapter`
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:
- `PacketBlockStartBreakEvent`
- `PacketBlockBreakEvent`
- `PacketBlockInteractEvent`
Event consumers can now determine whether an interaction applies to:
- A single block
- A block group
release
PacketBlocks 1.1.1
1.1.118 дек. 2025 г.17Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
## 🚀 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.
release
PacketBlocks 1.1.0
1.1.018 дек. 2025 г.21Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
## 🚀 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
