Add network tools

Author: Aedial

CHANGELOG.md

@@ -8,6 +8,15 @@ The format is based on Keep a Changelog and this project adheres to Semantic Ver
 - Semantic Versioning: https://semver.org/spec/v2.0.0.html
 
 
+## [1.3.0-rc1] - 2026-02-02
+### Added
+- Add Network Tools as a 6th tab:
+  - Unique Content Distributor tool to partition unique each cell with a unique content type (from filtered cells) and move the existing content accordingly
+  - Mass Partition All Cells tool to set all filtered cells' partitions to match their current contents
+  - Mass Partition Storage Bus tool to set the filter of a Storage Bus to match its current inventory contents
+  - All tools come with heavy warnings and eager confirmation dialogs to avoid accidental usage
+
+
 ## [1.2.1] - 2026-01-30
 ### Added
 - Add a button to decide the max number of slots to show per cell/storage bus in inventory (8, 32, 64, or all)

README.md

@@ -21,11 +21,18 @@ A terminal and wireless terminal for managing storage cells and storage buses ac
   - **Cell Partition**: Grid view for quick partition editing
   - **Storage Bus Inventory**: View contents accessible through Storage Buses
   - **Storage Bus Partition**: Edit Storage Bus filter configurations
+  - **Network Tools**: Various tools for managing and optimizing the whole network
 - **Search & Filter**: Find items across all cells/Storage Buses with inventory/partition search modes
 - **In-World Highlighting**: Double-click any storage entry to highlight its block in-world and show coordinates in chat
 - **Priority Management**: Set ME Chest/Drive/Storage Bus priority directly from the GUI
 - **Quick Partition Keybinds**: Configurable keybinds for quick partitioning with the hovered item
 
+### Network Tools
+A set of tools to manage and optimize your ME network storage. All tools can be matched against all available filtering options (search text, advanced search, filter buttons).
+- **Attribute Unique Tool**: Redistributes items/fluids/essentia from matching cells to ensure each cell contains 1 unique type. May use free, unpartitioned cells on the network if needed.
+- **Partition Storage Cells from Content**: Automatically partitions storage cells that match the filter, based on their current contents.
+- **Partition Storage Buses from Content**: Automatically configures Storage Bus filters that match the filter, based on their current accessible contents.
+
 
 ## Building
 Run:

build.gradle

@@ -14,7 +14,7 @@ buildscript {
 
 apply plugin: 'net.minecraftforge.gradle.forge'
 
-version = "1.2.1"
+version = "1.3.0"
 group = "com.cellterminal"
 archivesBaseName = "cell-terminal"
 
@@ -122,6 +122,10 @@ if (cfProjectId) {
                 optionalDependency 'thaumic-energistics'
                 // Optional: AE2WUT (Wireless Universal Terminal integration)
                 optionalDependency 'ae2uel-wireless-universal-terminal'
+                // Optional: CrazyAE
+                optionalDependency 'crazyae'
+                // Optional: ECO AE Extension
+                // Not on CurseForge
             }
         }
 

src/main/java/com/cellterminal/Tags.java

@@ -4,5 +4,5 @@
 public class Tags {
     public static final String MODID = "cellterminal";
     public static final String MODNAME = "Cell Terminal";
-    public static final String VERSION = "1.2.1";
+    public static final String VERSION = "1.3.0";
 }

src/main/java/com/cellterminal/config/CellTerminalServerConfig.java

@@ -36,12 +36,14 @@ public class CellTerminalServerConfig {
     private final Property tabPartitionEnabledProperty;
     private final Property tabStorageBusInventoryEnabledProperty;
     private final Property tabStorageBusPartitionEnabledProperty;
+    private final Property tabNetworkToolsEnabledProperty;
 
     private boolean tabTerminalEnabled = true;
     private boolean tabInventoryEnabled = true;
     private boolean tabPartitionEnabled = true;
     private boolean tabStorageBusInventoryEnabled = true;
     private boolean tabStorageBusPartitionEnabled = true;
+    private boolean tabNetworkToolsEnabled = true;
 
     // Polling settings
     private final Property storageBusPollingEnabledProperty;
@@ -110,6 +112,11 @@ private CellTerminalServerConfig(File configDir) {
         this.tabStorageBusPartitionEnabledProperty.setLanguageKey("config.cellterminal.config.server.tabs.storage_bus_partition");
         this.tabStorageBusPartitionEnabled = this.tabStorageBusPartitionEnabledProperty.getBoolean();
 
+        this.tabNetworkToolsEnabledProperty = config.get(CATEGORY_TABS, "networkToolsTabEnabled", true,
+            "Enable the Network Tools tab (mass operations on cells and storage buses)");
+        this.tabNetworkToolsEnabledProperty.setLanguageKey("config.cellterminal.config.server.tabs.network_tools");
+        this.tabNetworkToolsEnabled = this.tabNetworkToolsEnabledProperty.getBoolean();
+
         // Polling settings
         config.setCategoryComment(CATEGORY_POLLING,
             "Storage bus polling settings.\n" +
@@ -233,6 +240,7 @@ public void syncFromConfig() {
         this.tabPartitionEnabled = this.tabPartitionEnabledProperty.getBoolean();
         this.tabStorageBusInventoryEnabled = this.tabStorageBusInventoryEnabledProperty.getBoolean();
         this.tabStorageBusPartitionEnabled = this.tabStorageBusPartitionEnabledProperty.getBoolean();
+        this.tabNetworkToolsEnabled = this.tabNetworkToolsEnabledProperty.getBoolean();
 
         this.storageBusPollingEnabled = this.storageBusPollingEnabledProperty.getBoolean();
         this.pollingInterval = this.pollingIntervalProperty.getInt();
@@ -310,9 +318,13 @@ public boolean isTabStorageBusPartitionEnabled() {
         return tabStorageBusPartitionEnabled;
     }
 
+    public boolean isTabNetworkToolsEnabled() {
+        return tabNetworkToolsEnabled;
+    }
+
     /**
      * Check if a specific tab is enabled by its index.
-     * @param tabIndex The tab index (0-4)
+     * @param tabIndex The tab index (0-5)
      * @return true if the tab is enabled
      */
     public boolean isTabEnabled(int tabIndex) {
@@ -327,6 +339,8 @@ public boolean isTabEnabled(int tabIndex) {
                 return tabStorageBusInventoryEnabled;
             case 4:
                 return tabStorageBusPartitionEnabled;
+            case 5:
+                return tabNetworkToolsEnabled;
             default:
                 return false;
         }

src/main/java/com/cellterminal/container/ContainerCellTerminalBase.java

@@ -36,9 +36,11 @@
 import appeng.util.Platform;
 
 import com.cellterminal.CellTerminal;
+import com.cellterminal.client.CellFilter;
 import com.cellterminal.config.CellTerminalServerConfig;
 import com.cellterminal.container.handler.CellActionHandler;
 import com.cellterminal.container.handler.CellDataHandler;
+import com.cellterminal.container.handler.NetworkToolActionHandler;
 import com.cellterminal.container.handler.StorageBusDataHandler;
 import com.cellterminal.container.handler.StorageBusDataHandler.StorageBusTracker;
 import com.cellterminal.gui.overlay.MessageHelper;
@@ -716,10 +718,23 @@ protected Comparator<StorageTracker> createTrackerComparator(BlockPos terminalPo
         };
     }
 
-    protected static class StorageTracker {
-        protected final long id;
-        protected final TileEntity tile;
-        protected final IChestOrDrive storage;
+    /**
+     * Handle network tool action from client.
+     * This executes batch operations on cells and storage buses based on filters.
+     */
+    public void handleNetworkToolAction(String toolId, Map<CellFilter, CellFilter.State> activeFilters) {
+        EntityPlayer player = this.getPlayerInv().player;
+        NetworkToolActionHandler.handleAction(toolId, activeFilters, byId, storageBusById, grid, player);
+
+        // Trigger refresh after tool execution
+        this.needsFullRefresh = true;
+        this.needsStorageBusRefresh = true;
+    }
+
+    public static class StorageTracker {
+        public final long id;
+        public final TileEntity tile;
+        public final IChestOrDrive storage;
 
         public StorageTracker(long id, TileEntity tile, IChestOrDrive storage) {
             this.id = id;