3.1.0, improving API to be robust on sharing units [https://trello.com/c/tg1OcR80/]

Author: PepeAmpere

customCommands.lua

@@ -205,4 +205,21 @@ customCommands = {
 			end
 		end
 	end,
+	
+	-- @description handler API used for removing unit by any means which (re)sets the system to proper state once called (by removing)
+	-- @argument unitID [number] Spring unitID
+	-- @argument unitDefID [number] Spring unitDefID
+	-- @argument teamID [number] Spring teamID
+	-- @comment IMPORTANT NOTE: this funciton removes units commands regards CURRENT team. If supposed to be called to remove commands to solve sharing units cleanup, it should be called with oldTeamID.
+	["UnitRemoved"] = function(unitID, unitDefID, teamID)
+		unitName = UnitDefs[unitDefID].name
+		for internalCmdName, cmdDesc in pairs(customCommandsDescriptions) do
+			if (customCommandsNameToTeamID[internalCmdName] == teamID) then -- if not owned by proper team
+				local index = Spring.FindUnitCmdDesc(unitID, cmdDesc.id)
+				if (index ~= nil) then 
+					Spring.RemoveUnitCmdDesc(unitID, index)
+				end
+			end
+		end
+	end,
 }

readme.md

@@ -1,4 +1,4 @@
-customCommands 3.0.2
+customCommands 3.1.0
 ===
 
 This module allows you to
@@ -8,6 +8,11 @@ This module allows you to
   * registration/unregistration of commands
   * informing rest of the game synced way about changes and stored synced list of all commands readable by their owners
   * informing unsynced modules (UI, custom widgets) about changes via unsynced handlers
+  
+Important compatibility notes
+---
+  
+* since 3.1.x should provide tools to be robust on units sharing
 
 
 Actual development references