Changelog

✨ Major New Utility Classes

📂 FileUtils - File System Utilities

• File Operations: `readFile()`, `writeFile()`, `copyFile()`, `moveFile()`, `deleteFile()`
• Directory Operations: `createDirectory()`, `listFiles()`
• File Search: `searchFiles()`

💻 Command Framework - Easy command creation and management

• Command Interface: A simple interface for creating commands.
• Command Manager: A centralized manager for registering commands.

🔧 General

• Internal version updated to: 1.6.0

Bug Fixes

NetworkUtils

• Fixed an issue where networking methods were incompatible with the latest Fabric API version. The methods have been updated to use `CustomPayload` for modern, type-safe packet handling. This is a breaking change for any mods that were using the old networking methods.
• Safety Validation: validateBlockPlacement(), checkBlockIntegrity(), verifyAreaAccess()

🔧 General

• Internal version updated to: 1.5.1

✨ Major New Utility Classes

🔧 AdvancedBlockOps - Enhanced Block Manipulation

Enhanced block manipulation with safety checks and transactional editing:

• Transactional Operations: replaceBlocksTransactional(), applyBatchEditsTransactional()
• Safety Validation: validateBlockPlacement(), checkBlockIntegrity(), verifyAreaAccess()
• Undo System: createUndoPoint(), restoreUndoPoint(), clearUndoHistory()
• Area Operations: fillAreaSafely(), replaceAreaSafely(), cloneAreaSafely()
• Block Analysis: analyzeBlockPattern(), detectBlockStructures(), findBlockBoundaries()
• Performance Monitoring: measureOperationTime(), getOperationStats()

🤖 EntityAIUtils - AI-Related Helper Functions

AI utilities for custom mobs and behavior management:

• Goal Management: addGoal(), removeGoal(), clearGoals(), setGoalPriority()
• Pathfinding: findPathTo(), findPathAround(), isPathClear(), optimizePath()
• Behavior States: setBehaviorState(), getBehaviorState(), triggerBehavior()
• Target Selection: selectNearestTarget(), selectRandomTarget(), evaluateTarget()
• Movement Control: moveTowards(), stopMovement(), setMovementSpeed()
• Sensory Systems: canSeeTarget(), canHearTarget(), detectNearbyEntities()
• Memory System: storeMemory(), retrieveMemory(), clearMemory()

💾 DataPersistence - Data Storage and Retrieval

World, player, and global data storage with compression and migration:

• World Data: saveWorldData(), loadWorldData(), deleteWorldData()
• Player Data: savePlayerData(), loadPlayerData(), deletePlayerData()
• Global Data: saveGlobalData(), loadGlobalData(), deleteGlobalData()
• Data Validation: validateData(), backupData(), restoreData()
• Compression: compressData(), decompressData(), isCompressed()
• Migration: migrateData(), checkDataVersion(), updateDataFormat()

✨ EffectsUtils - Sound & Particle Effect Utilities

Sound and particle effect utilities with timing control and combinations:

• Sound Effects: playSound(), playSoundAt(), stopSound(), setSoundVolume()
• Particle Systems: spawnParticle(), spawnParticleLine(), spawnParticleSphere()
• Effect Combinations: createExplosionEffect(), createMagicEffect(), createTrailEffect()
• Timing Control: scheduleEffect(), repeatEffect(), stopEffectLoop()
• Custom Effects: registerCustomEffect(), createCustomParticle(), playCustomSound()
• Performance: optimizeEffectRendering(), limitEffectCount(), cleanupEffects()

🌐 AdvancedNetworking - Sophisticated Packet Handling

Advanced networking with routing, synchronization, compression, and encryption:

• Packet Types: CustomPacket, SyncPacket, EventPacket, RequestPacket
• Packet Routing: routePacket(), broadcastPacket(), sendReliablePacket()
• Synchronization: syncEntityData(), syncBlockData(), syncPlayerData()
• Compression: compressPacket(), decompressPacket(), isPacketCompressed()
• Encryption: encryptPacket(), decryptPacket(), setEncryptionKey()
• Packet Queuing: queuePacket(), processPacketQueue(), clearPacketQueue()
• Error Handling: handlePacketError(), retryFailedPacket(), logPacketStats()

🌍 DimensionUtils - Custom Dimension Management

Utilities for working with custom dimensions and portal systems:

• Dimension Management: createDimension(), deleteDimension(), getDimensionInfo()
• Teleportation: teleportToDimension(), teleportFromDimension(), validateTeleport()
• Dimension Properties: setDimensionGravity(), setDimensionTime(), setDimensionWeather()
• Chunk Management: generateChunks(), unloadChunks(), getChunkStatus()
• Spawn Points: setDimensionSpawn(), getDimensionSpawn(), resetSpawnPoint()
• Portal Creation: createPortal(), linkPortals(), destroyPortal()

🔴 RedstoneUtils - Circuit and Automation Helpers

Redstone circuit analysis and automation with signal manipulation:

• Circuit Analysis: analyzeRedstoneCircuit(), findRedstoneSources(), traceRedstonePath()
• Signal Manipulation: setRedstoneSignal(), getRedstoneSignal(), invertSignal()
• Timing Control: createTimer(), createPulseGenerator(), createSequencer()
• Logic Gates: createANDGate(), createORGate(), createNOTGate(), createXORGate()
• Automation: createAutoFarm(), createItemSorter(), createElevatorSystem()
• Debugging: highlightRedstoneBlocks(), showSignalStrength(), traceCircuitFlow()

📊 PerformanceMonitor - Built-in Performance Profiling

Comprehensive performance monitoring and optimization tools:

• Profiling: startProfiling(), stopProfiling(), getProfileData()
• Memory Monitoring: getMemoryUsage(), getGCStats(), monitorMemoryLeaks()
• Tick Analysis: measureTickTime(), getTPSData(), analyzeLagSpikes()
• Entity Performance: countEntities(), getEntityStats(), optimizeEntityUpdates()
• Chunk Performance: getChunkStats(), analyzeChunkLoading(), optimizeChunkGeneration()
• Reporting: generatePerformanceReport(), exportPerformanceData(), createPerformanceGraph()

🔧 Enhanced Existing Utilities

🌍 WorldUtils - Advanced Block Operations

• Transactional Editing: replaceBlocksTransactional(), applyBatchEditsTransactional()
• Safety Checks: validateBlockPlacement(), checkAreaIntegrity(), verifyChunkAccess()
• Undo System: createUndoPoint(), restoreUndoPoint(), getUndoHistory()
• Performance: optimizeBlockOperations(), batchBlockUpdates(), cacheBlockStates()
• Advanced Queries: findBlockStructures(), analyzeBlockPatterns(), detectBlockBoundaries()

👤 EntityUtils - AI Integration

• AI Utilities: setAIEnabled(), getAIState(), triggerAIBehavior()
• Enhanced Pathfinding: findOptimalPath(), avoidObstacles(), calculatePathCost()
• Memory System: storeEntityMemory(), retrieveEntityMemory(), clearEntityMemory()
• Behavior States: setEntityBehavior(), getEntityBehavior(), triggerEntityAction()
• Performance: optimizeEntityUpdates(), batchEntityOperations(), cacheEntityData()

🌐 NetworkUtils - Advanced Networking

• Reliable Packets: sendReliablePacket(), acknowledgePacket(), retryFailedPackets()
• Compression: compressPacketData(), decompressPacketData(), getCompressionRatio()
• Packet Queuing: queuePacketForSending(), processPacketQueue(), getQueueStatus()
• Error Recovery: handleNetworkError(), recoverFromDisconnect(), validatePacketIntegrity()
• Performance: optimizePacketSending(), batchPacketOperations(), monitorNetworkStats()

🎒 ItemUtils - Enhanced Item Management

• Data Persistence: saveItemData(), loadItemData(), syncItemData()
• Advanced Validation: validateItemStack(), checkItemIntegrity(), repairCorruptedItems()
• Performance: optimizeItemOperations(), batchItemUpdates(), cacheItemProperties()
• Custom Items: registerCustomItem(), createItemVariants(), manageItemMetadata()

📝 TextUtils - Advanced Formatting

• Rich Formatting: createRichText(), applyTextStyles(), animateText()
• Performance: optimizeTextRendering(), cacheTextComponents(), batchTextOperations()
• Localization: translateText(), loadLanguagePack(), getSupportedLanguages()
• Accessibility: createAccessibleText(), addScreenReaderSupport(), optimizeForAccessibility()

⚡ Performance Optimizations

• Advanced Caching Systems: Multi-level caching (L1/L2/L3) with intelligent invalidation
• Batch Operations: Batch block updates, entity operations, packet operations, and item operations
• Memory Management: Smart object pooling, automatic GC optimization, memory leak detection
• Thread Safety: All operations are thread-safe with concurrent data structures
• Performance Monitoring: Built-in profiling and optimization tools

🔧 Command Improvements

• /chosenlib Command Enhancements: Interactive feature showcase with demonstrations
• Real-time Performance Monitoring: Built-in performance display and analysis
• Advanced Configuration: Comprehensive configuration options and settings
• Plugin System: Extensible functionality for custom integrations
• Enhanced Help System: Detailed examples and usage guides

🔧 General

• Internal version updated to: 1.5.0
• Comprehensive documentation: with code examples for all new utilities
• Extensive error handling: and recovery mechanisms
• Thread-safe operations: across all utilities
• Backward compatibility maintained: no breaking changes
• Performance monitoring: and optimization tools built-in
• Advanced debugging: and profiling capabilities

✨ Major New Utility Classes

🌍 WorldUtils - World and Block Manipulation

Complete world and block manipulation utilities with safe operations:

• Block Operations: getBlockState(), setBlockState(), isPositionLoaded()
• Area Queries: getBlocksInCube(), getBlocksInSphere(), getBlocksInArea()
• Block Finding: findBlocks(), findNearestBlock(), replaceBlocks()
• World Properties: getBiome(), getLightLevel(), canSeeSky()
• Chunk Utilities: getChunk(), isChunkLoaded(), getChunkPos()
• Fluid Operations: getFluidState(), hasFluid()
• Entity Queries: getEntitiesInBox(), getEntitiesAround(), getNearestEntity()

👤 EntityUtils - Entity-Related Operations

Comprehensive entity management and manipulation utilities:

• Block Operations: getBlockState(), setBlockState(), isPositionLoaded()
• Area Queries: getBlocksInCube(), getBlocksInSphere(), getBlocksInArea()
• Block Finding: findBlocks(), findNearestBlock(), replaceBlocks()
• World Properties: getBiome(), getLightLevel(), canSeeSky()
• Chunk Utilities: getChunk(), isChunkLoaded(), getChunkPos()
• Fluid Operations: getFluidState(), hasFluid()
• Entity Queries: getEntitiesInBox(), getEntitiesAround(), getNearestEntity()
• Physics: setVelocity(), launchTowards(), knockback()
• Player Operations: sendMessage(), giveItem()

🌐 NetworkUtils - Networking and Packet Utilities

Advanced networking utilities for packet creation and communication:

• Packet Creation: createBuffer(), createSimplePacket(), createPositionPacket()
• Player Targeting: sendToPlayer(), sendToPlayers(), sendToWorld()
• Radius Sending: sendToPlayersInRadius()
• Data Serialization: writeString(), writeBlockPos(), writeVec3d(), writeUuid()
• Array Support: writeBooleanArray(), writeIntArray(), writeStringArray()
• Safe Operations: safeBufferOperation(), hasReadableBytes()

🔧 Enhanced Existing Utilities

🎨 GuiUtils - Server-Side Compatibility

• Server-Side Compatible: Core GuiUtils now works on both client and server
• ClientGuiUtils: Extended client-side functionality for rendering operations
• Color Operations: getRed(), getGreen(), getBlue(), getAlpha()
• Mathematical: rectanglesOverlap(), distance(), interpolateColor()
• Performance: Cached operations for better performance

📝 TextUtils - Advanced Operations

• Interactive Text: clickableCommand(), withTooltip(), interactiveText()
• Text Wrapping: wrapText(), createMultiLineTextBox()
• Validation: isBlank(), matches() with pattern caching
• Formatting: formatNumber(), formatDecimal(), formatDuration()
• Performance: Cached regex patterns and formatting styles

🎒 ItemUtils - Performance and Features

• Enhanced Validation: canMerge(), isDamageable(), isEnchanted()
• Item Lookup: getItemById() for Identifier and String
• Durability: getDurabilityPercentage(), damageItem(), repairItem(), fullyRepairItem()
• NBT Operations: getNbt(), setNbt(), hasNbt()
• Enchantments: getEnchantmentLevel(), hasEnchantment()
• Inventory: findFirst(), findAll(), countItem(), consumeItem(), insertStack()
• Performance: Caching for getItemId() and getMaxStackSize()

⚡ Performance Optimizations

• Caching Systems: Concurrent caching for item IDs, stack sizes, regex patterns, and formatting styles
• Thread Safety: All caches use concurrent hash maps for thread-safe operations
• Memory Efficiency: Lazy initialization and efficient data structures
• Cache Management: getCacheStats() and clearCache() methods for debugging

🔧 General Improvements

• Internal version updated to: 1.5.0
• Comprehensive JavaDoc documentation: for all new utilities
• Extensive null safety checks and error handling:
• Thread-safe operations across all utilities:
• Enhanced /chosenlib command: showcasing new features
• Backward compatibility maintained: no breaking changes

✨ New Features:

• /chosenlib Command Improvements: Added a clickable Modrinth link to the command output.
• Provides an easy way for players and developers to quickly access the Modrinth page directly from in-game chat.

🔧 Improvements:

• Minor enhancements to command feedback for a smoother user experience.
• Internal version bumped to 1.3.1.

🐛 Bug Fixes:

• No bug fixes in this release.

✨ New Features

🎨 GuiUtils - Client-side GUI Utilities

Complete client-side GUI utility class for creating beautiful Minecraft interfaces:

• Screen Positioning: centerX(), centerY(), center()
• Color Utilities: rgba(), rgb(), withAlpha(), hsvToRgb(), adjustBrightness()
• Drawing Helpers: drawRect(), drawBorderedRect(), drawGradient(), drawTexture()
• UI Components: drawProgressBar(), isPointInRect()

📝 Enhanced TextUtils

Major expansion of text manipulation capabilities:

• Text Manipulation: truncate(), toTitleCase(), reverse(), isPalindrome(), wordCount()
• Text Validation: isAlphanumeric(), isValidEmail(), removeSpecialChars()
• Visual Elements: progressBar(), centerText(), createTextBox()
• Clickable Links: clickable() - Create clickable chat text with URLs

🎒 ItemUtils - Item Management

Comprehensive item management and manipulation utilities:

• Item Validation: isEmpty(), isNotEmpty(), isSameItem(), isExactMatch()
• Item Information: getItemId(), getDisplayName(), getMaxStackSize(), isStackable()
• Durability Utilities: getDurability(), getMaxDurability(), isDamaged(), getDamagePercentage()
• Stack Manipulation: copyWithCount()

🔧 Improvements

• API Compatibility: Fixed compatibility issues for Minecraft 1.21.1
• Documentation: Comprehensive JavaDoc coverage for all new utilities
• Code Organization: Proper client/server separation with GuiUtils in client source set
• Performance: Optimized utility methods for better performance

🐛 Bug Fixes

• Fixed compilation errors with client-side classes
• Resolved API compatibility issues with Minecraft 1.21.1
• Improved error handling in utility methods

🔧 Improvements

• Enhanced: /chosenlib with version info and clickable links
• Improved: clickable link functionality in chat
• Better error: handling and logging

🐛 Bug Fixes

• Fixed version display in command output
• Resolved configuration loading issues

✨ New Features:

• Custom Command: /chosenlib with version info and clickable links
• Configuration System: JSON-based config with auto-generation
• Enhanced TextUtils: New text manipulation helpers

🔧 Improvements:

• Better documentation and examples
• Improved code organization
• Enhanced error handling

✨ Initial Features:

• TextUtils: Basic text formatting and manipulation
• General Utilities: Math helpers, random functions, and utility methods
• Fabric Integration: Proper Fabric mod setup and structure

🔧 Foundation:

• Modern Gradle setup with Fabric Loom
• Java 21 compatibility
• MIT License
• Basic documentation