Added shortcut method ScpArgMsg

src/ZoneServer/Scripting/Shortcuts.cs

@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
 using Melia.Shared.Configuration.Files;
@@ -417,6 +418,44 @@ public static void AddChatCommand(string command, string usage, string descripti
 			ZoneServer.Instance.ChatCommands.Add(command, usage, description, func);
 			ZoneServer.Instance.Conf.Commands.CommandLevels[command] = new CommandAuthLevels(auth, targetAuth);
 		}
+
+		/// <summary>
+		/// Formats the given message name and arguments in a way that the
+		/// client can recognize as a client message with arguments.
+		/// </summary>
+		/// <param name="messageName">Name of the client message.</param>
+		/// <param name="args">Optional list of arguments as key/value pairs.</param>
+		/// <returns></returns>
+		/// <exception cref="ArgumentException"></exception>
+		/// <example>
+		/// ScpArgMsg("KlaipedaCentralPlaza")
+		/// ScpArgMsg("InputPriceBetween{MIN}{MAX}", "MIN", 1, "MAX", 10)
+		/// </example>
+		public static string ScpArgMsg(string messageName, params object[] args)
+		{
+			if (args != null && args.Length % 2 != 0)
+				throw new ArgumentException("Expected an even amount of arguments for the key/value arguments.");
+
+			var result = new StringBuilder();
+
+			result.Append("!@#$" + messageName);
+
+			if (args != null)
+			{
+				for (var i = 0; i < args.Length; i += 2)
+				{
+					var key = args[i];
+					var value = args[i + 1];
+
+					result.Append("$*$" + key);
+					result.Append("$*$" + value);
+				}
+			}
+
+			result.Append("#@!");
+
+			return result.ToString();
+		}
 	}
 
 	/// <summary>