ColonyLink v1.1.3 — RF Energy System

New Features

⚡ RF Energy System

The Colony Link Wand now requires RF energy to operate.

• Charging : insert the wand into an AE2 Charger (native, via IAEItemPowerStorage) or any FE-compatible charger (Powah, Mekanism, Immersive Engineering, Flux Networks…)
• Passive drain : RF is consumed while the GUI is open
• Action costs : each Send and Craft action costs RF
• Energy bar : displayed on the item in hotbar/inventory (green → yellow → red)
• Tooltip : shows current RF / max RF and charge percentage on hover
• Out of Power : GUI actions are blocked when the wand has no RF
  
  

🔧 Tool Upgrade System

The wand now automatically substitutes tool requests with the best available tier.

• Respects the MineColonies Work Hut level table (Wood → Stone → Iron → Diamond → Netherite based on hut level)
• Respects enchantment level caps per tier and hut level
• Priority request also benefits from substitution
• Searches ME stock first, then craftable patterns
• If a higher-tier tool is craftable and a lower-tier is in stock, prefers crafting the better one
• Configurable via enable_tool_upgrade, tool_upgrade_send_auto, respect_enchant_level_cap


💤 Builder Idle Reason

When the builder status is Idle, the GUI now shows the reason:

• Blocking interaction pending
• Sick
• No home assigned
• Low happiness
• Hungry, Raided, Mourning, Bad weather, Sleeping
  
  
  

⚙️ Full Configuration (colonylink-common.toml)

All major parameters are now configurable without recompiling:

[energy]

• wand_rf_capacity — wand buffer size (default: 160,000 RF)
• wand_rf_transfer_rate — max charge rate (default: 2,500 RF/t)
• passive_drain_rf — drain while GUI is open (default: 1,200 RF/40t)
• send_cost_rf — RF per Send action (default: 1,500 RF)
• craft_cost_rf — RF per Craft job (default: 2,500 RF)
• block_actions_if_no_power — block Send/Craft when empty (default: true)
• low_power_threshold_percent — bar turns red below this % (default: 10)

[general]

• max_builders_per_wand — max linked builders (default: 5, range: 1–10)
• ticker_interval_ticks — GUI update rate (default: 40t, range: 10–200)
• wand_range_check — enforce WAP range check (default: false)

[tools]

• enable_tool_upgrade — enable/disable tool substitution (default: true)
• tool_upgrade_send_auto — auto-send best tool (default: true)
• respect_enchant_level_cap — enforce MineColonies enchant table (default: true)

[interface]

• show_crafting_status — show items being crafted (default: true)
• show_no_pattern_items — show items with no AE2 pattern (default: true)
• max_resources_displayed — max entries in GUI list (default: 100)
• warehouse_snapshot_validity_ticks — warehouse scan cache duration (default: 400t)

[network]

• redirector_buffer_rows — Redirector buffer rows (default: 10)
• redirector_buffer_cols — Redirector buffer columns (default: 12)

Improvements

Performance

• getClosestColony() result cached in viewer state — O(1) lookup after first tick instead of O(n) every cycle
• IColonyManager.getBuilding(Level, BlockPos) used for direct building lookup
• getBuilderEntries() NBT deserialization reduced from 3× to 1× per tick cycle
• findWandInInventory() inventory scan reduced from 2× to 1× per tick cycle
• Tool candidate list (getCandidateItems) cached via ConcurrentHashMap — BuiltInRegistries.ITEM iterated once at first call instead of every tick
• ConcurrentHashMap replaces HashMap + defensive copy for activeViewers
• Config values read once per tick cycle instead of 6+ individual .get() calls
• computeIdleReason() only called when worker status is actually Idle
• Domum tooltip built after filter check, not before
  
  
  

AE2 Charger Integration

• Wand implements IAEItemPowerStorage directly — recognized natively by the AE2 Charger without any extra configuration
• shouldCauseReequipAnimation() returns false when only NBT changes — eliminates the visual "pop" on the durability bar every 2 seconds
  
  
  

GUI

• RF display removed from GUI — shown only via item durability bar and hover tooltip
• "Out of Power" state displayed in GUI info panel
• Tool upgrade substitution shown with dedicated tooltip (⚙ Tool Upgrade — Work Hut Level X)
• Priority request panel also benefits from tool upgrade tooltip

Notes

• Delete colonylink-common.toml in your config folder on first launch to regenerate with all new sections
• FluxNetworks wireless charging works out of the box via IEnergyStorage — requires a Flux Controller in the network and wireless charging enabled in the controller GUI
  
  

  Requirements

  • NeoForge 21.1.228
  • MineColonies 1.1.1299
  • Applied Energistics 2 19.2.17
  • Domum Ornamentum 1.0.233