BlockTracker - Block Tracking API

BlockTracker is a specialized library for Minecraft mod developers, offering a comprehensive API for monitoring and tracking specific blocks across the game world. The system is designed with maximum performance in mind and provides efficient methods for storing, retrieving, and processing block position data.

Key Features

Cross-Dimensional Tracking - Block monitoring works across all dimensions and chunks of the game world

Smart Filtering - Customizable world generation rules and conditional block tracking

Thread Safety - Built-in protection mechanisms ensuring proper server operation

High Performance - Optimized data structures using FastUtil for minimal overhead

Persistent Storage - Automatic saving and loading of tracked block data

Flexible Query System - Various methods for obtaining block information by chunk, radius, or dimension

For Mod Developers

Simple Integration

// Tracking blocks with custom conditions
// Recommended initialization place: ServerAboutToStartEvent
BlockTrackerApi.trackBlock(Blocks.BEACON, true, block -> {
    return customConditionCheck(block);
});

Multiple Query Options

// Getting blocks in a specific chunk
LongSet blocks = BlockTrackerApi.getTrackedBlocks(level, chunkPos, Blocks.BEACON);

// Getting blocks in area around position
ObjectList<LongSet> areaBlocks = BlockTrackerApi.getTrackedBlocks(level, centerPos, 3, Blocks.BEACON);

Note: This modification is primarily intended for developers. Regular users will need mods that implement BlockTracker API to experience the benefits of the system.