Version 0.1.3

Major Update: Network System Overhaul

This release completely reimagines how Experience Cores connect to Collectors with the introduction of the Pipe Network System!

NEW FEATURES

Pipe Network System

• Added Gold-Inlaid Pipe (Tier 1)
  • Entry-level pipe for basic XP networks
  • Compatible with Cores MK-I to MK-III and Basic Collectors
  • Configurable distance (default: 10 blocks) and core limits (default: 10 cores)
  • Requires iron pickaxe or better to break
  • Crafts 8 pipes per recipe (gold ingots, glass pane, iron ingots)
• Added Diamond-Studded Pipeline (Tier 2)
  • Advanced pipe for massive XP networks
  • Compatible with ALL Core tiers (MK-I to MK-V) and Advanced Collectors
  • Unlimited distance and cores by default (configurable)
  • Requires diamond pickaxe or better to break
  • Crafts 16 pipes per recipe (diamonds, netherite ingots, gold pipes)
• Smart Network Connections
  • Pipes automatically connect to adjacent pipes in all 6 directions
  • Visual connection system shows which directions pipes are connected
  • Pipes intelligently connect to compatible cores and collectors
  • Real-time network topology updates
• Adaptive Network Scanning
  • Small networks (<100 blocks): Scan every 5 seconds
  • Medium networks (100-300 blocks): Scan every 10 seconds
  • Large networks (>300 blocks): Scan every 20 seconds
  • Automatic performance optimization based on network size

Enhanced Collector System

• Completely Rewritten Network Detection
  • Collectors now actively scan pipe networks using BFS algorithm
  • Automatic discovery of all connected cores through pipes
  • Distance tracking for each core through the network path
  • Real-time network health monitoring
• New Collector GUI
  • Left Panel: Connected cores breakdown by tier with visual indicators
  • Center Panel: XP storage with animated progress bar
  • Right Panel: Comprehensive production statistics
    • Total production rate (XP/hour)
    • Average production per core
    • Network capacity information
    • Flow rate and distance limits
• Network Statistics
  • Real-time core count by tier (MK-I through MK-V)
  • Total connected cores counter
  • Total network production rate
  • Core prioritization when limits are reached (higher tiers prioritized)

New Configuration Options

• Pipe Network Settings
  • maxDistance: Maximum blocks from core to collector through pipes
  • maxCores: Maximum cores per network
  • flowRate: XP transfer rate when flow limiting is enabled
  • limitedFlowrate: Toggle for instant vs. rate-limited transfer
  • requiredTool: Minimum tool tier to break pipes
  • maxScanBlocks: Maximum blocks to scan when building networks
  • maxNetworkCores: Absolute hard limit for network size

CHANGES

Core System

• Removed Direct Push Mechanics
  • Cores no longer push XP directly to collectors
  • XP transfer is now handled entirely by collectors through pipe networks
  • Removed pushInterval configuration (obsolete)
  • Removed xpPerPush configuration (obsolete)
• Improved Core Storage
  • Cores continue generating XP until full
  • Full cores wait for collector to extract XP
  • No XP wasted when cores reach capacity

Collector System

• New Transfer Mechanics
  • Collectors scan networks periodically (adaptive intervals)
  • XP extracted from connected cores every tick
  • Configurable flow rate limiting (disabled by default for best performance)
  • Intelligent chunk loading checks to prevent errors

Configuration File

• Restructured Config Layout
  • New [pipes] section with subsections for each pipe tier
  • New [pipes.flowrate] for global flow rate settings
  • New [pipes.network] for network scanning settings
  • Removed obsolete push-related settings
  • Updated documentation and examples

BUG FIXES

Critical Fixes

• Fixed "Saving World" Freeze Issue
  • Completely rewrote pipe removal handling
  • Added chunk loading verification before accessing block entities
  • Implemented removal state checking to prevent infinite loops
  • Server save/exit now works flawlessly even with large networks
• Fixed Network Memory Leaks
  • Proper cleanup of cached network data when pipes are removed
  • Collectors invalidate network cache when topology changes
  • Block entities no longer cause memory leaks during world unload

Performance Improvements

• Optimized Network Scanning
  • Implemented BFS algorithm for efficient network discovery
  • Added scan limits to prevent lag spikes (250 blocks for Gold, 750 for Diamond)
  • Adaptive scan intervals reduce overhead for large networks
  • Early termination when maximum cores are reached
• Reduced Tick Overhead
  • Pipes are now completely passive (no ticking required)
  • Only collectors tick for network management
  • Significantly reduced per-tick computation

Stability Fixes

• Thread-Safe Network Operations
  • All network scanning operations properly check chunk loading
  • Added removal state verification to prevent race conditions
  • Improved error handling for edge cases

MIGRATION GUIDE (0.1.2 → 0.1.3)

Existing Worlds

IMPORTANT: This update changes how cores connect to collectors!

Before Updating:

1. Collect all stored XP from your cores and collectors
2. Note your current setup layout

After Updating:

1. Your existing cores and collectors will still have their stored XP
2. Cores will NO LONGER automatically transfer XP to collectors
3. You MUST craft and place pipes to reconnect your networks
4. Place pipes directly above or below collectors to start the network
5. Connect cores anywhere along the pipe network

Recommended Setup:

• Basic Collector + Gold Pipes for Tier I-III cores
• Advanced Collector + Diamond Pipes for Tier IV-V cores

Configuration Migration

• Old pushInterval and xpPerPush settings are now ignored (removed)
• New pipe-related settings have been added with sensible defaults
• Review config/fruitsicecreamutilities-common.toml for new options