HTDevLib

Version 0.2.0 (2026-01-17)

Major Release - New Helper Classes

This release introduces three major new helper classes and significantly expands the library's capabilities for managing game state, items, and zones.

New Helper Classes

ZoneHelper

• Zone discovery tracking system with username-based storage
• initializeZoneTracking() - Initialize zone tracking for a world
• getCurrentZone() - Get a player's current zone
• setCurrentZone() - Set a player's current zone
• isInZone() - Check if player is in a specific zone
• getDiscoveredZones() - Get all zones a player has discovered
• discoverZone() - Mark a zone as discovered for a player
• hasDiscoveredZone() - Check if player has discovered a specific zone
• getPlayersInZone() - Find all players currently in a zone
• getDiscoveredZoneCount() - Get count of zones discovered by player
• getAllDiscoveredZones() - Get all zones discovered by any player
• getZoneDiscoveryCount() - Get how many players discovered a zone
• clearDiscoveredZones() - Clear a player's discovery progress
• Thread-safe concurrent storage for multi-player support
• Integrates with EcsEventHelper.onZoneDiscovery() for automatic tracking

BlockStateHelper

• Utilities for working with block states (chests, signs, containers)
• hasState() - Check if a block has state data
• getState() - Get block state at position
• setState() - Set block state at position
• ensureState() - Get or create block state
• removeState() - Remove block state
• markNeedsSave() - Mark state for persistence
• Abstracts deprecated BlockState API for future compatibility
• Essential for working with containers, signs, and other stateful blocks

ItemHelper

• Comprehensive item and container management utilities
• createItemStack() - Create item stacks with quantities
• addToContainer() - Add items to first available slot
• addToContainerSlot() - Add items to specific slot
• fillContainer() - Fill container with multiple items sequentially
• addToContainerRandom() - Add items to random available slot
• fillContainerRandom() - Fill container with items in random slots
• removeFromContainer() - Remove items from container
• countItemInContainer() - Count specific items in container
• hasSpaceInContainer() - Check if container has space
• getItemName() - Get display name of item
• getItemId() - Get ID from item stack
• Random slot placement for loot distribution and variety

PlayerHelper Enhancements

• getPlayerComponent() - Get player component from entity for ECS operations
• getPlayerSkin() - Get player's cosmetic appearance data (hair, face, clothing, etc.)
• Access to player avatar customization data for UI and display purposes

UIHelper

• Custom page management and HUD control
• openCustomPage() - Open custom UI pages for players
• closeCustomPage() - Close custom UI pages
• showHudComponents() - Show specific HUD elements
• hideHudComponents() - Hide specific HUD elements
• fadeInCustomPage() - Fade in UI with smooth animation
• fadeOutCustomPage() - Fade out UI with smooth animation
• fadeCustomPage() - Custom fade with start/end opacity control
• Smooth UI transitions using UICommandBuilder and tick scheduling