HTDevLib

Version 0.4.1

ContainerHelper - Item Duplication Fix

• FIXED: Item duplication when dragging items outside container UI
• Automatically removes dropped item entities when transactions are cancelled
• Uses EntityHelper.removeNearbyItemEntities() to clean up dropped items
• Schedules removal after 3 ticks to allow item entity to spawn
• Works with all transaction types including drag-outside-UI

EntityHelper - Item Entity Removal

• NEW: removeNearbyItemEntities(world, position, itemId, quantity, radius) - Remove dropped item entities within radius
• Uses Hytale's ECS (Entity Component System) for efficient entity queries
• Queries EntityStore for entities with ItemComponent (dropped items)
• Checks distance from center position and removes entities within radius
• Uses CommandBuffer.removeEntity() for proper ECS-based removal

ItemHelper - Item Entity Management

• NEW: getItemEntities(world) - Get all dropped item entities in the world
• NEW: getItemEntitiesByItemId(world, itemId) - Filter dropped items by item type
• NEW: getItemEntitiesInRadius(world, center, radius) - Get items within radius of position
• NEW: removeItemEntity(world, itemEntity) - Remove a specific dropped item
• NEW: removeAllItemEntities(world) - Clear all dropped items from world
• NEW: removeItemEntitiesByItemId(world, itemId) - Remove all items of specific type
• NEW: countItemEntities(world) - Count total dropped items
• NEW: countItemEntitiesByItemId(world, itemId) - Count items of specific type
• NEW: teleportItemEntity(world, itemEntity, position) - Teleport a specific item entity
• NEW: teleportItemEntity(world, itemEntity, x, y, z) - Teleport item to coordinates
• NEW: teleportItemEntitiesByItemId(world, itemId, position) - Teleport all items of type
• NEW: teleportItemEntitiesInRadius(world, center, radius, destination) - Teleport items in radius
• NEW: teleportAllItemEntities(world, position) - Teleport all dropped items
• NEW: ItemEntity class - Represents dropped item with ref, itemId, quantity, and position

TitleHelper - Event Title System

• NEW: Display on-screen titles to players using Hytale's built-in title system
• showMajorTitle(player, primaryText, secondaryText, durationSeconds) - Large prominent titles
• showMinorTitle(player, primaryText, secondaryText, durationSeconds) - Smaller subtle notifications
• showTitle(player, isMajor, primaryText, secondaryText, iconPath, duration, fadeIn, fadeOut) - Full control
• showTitleWithIcon(player, isMajor, primaryText, secondaryText, iconPath, duration) - Titles with icons
• hideTitle(player, fadeOutSeconds) - Hide title with fade animation
• clearTitle(player) - Instantly clear title
• Convenience methods:
  • showNotification(player, text) - Quick 1-second notification
  • showQuestUpdate(player, questName, objective) - 3-second quest title
  • showBossTitle(player, bossName, subtitle) - 4-second boss encounter
  • showZoneEntry(player, zoneName) - 2-second zone entry
  • showAchievement(player, achievementName) - 3-second achievement unlock