Перейти к содержимому
Mineforgian

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 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.

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 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!

1.2.2Релиз1.21.9, 1.21.10, 1.21.11 · 21 января 2026 г.

🔧 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
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:

  • 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
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 handleStopDestroy for cleaner code.

Комментарии

Загружаем…