Custom Command Prefixes

Author: cev-api

README.md

@@ -387,6 +387,14 @@ I did not, nor could I copy their code directly as most are Meteor based mods. S
 - Auto Attack, your jab attack will continue to auto hit once the cooldown has expired so long as you're hitting an entity.
 - Designed for elytra-free ground PvP/PvE, though may be even more interesting with one.
 
+### Custom Command Prefixes
+- In the Wurst Options menu you can now change your command prefix
+- Cycle through commonly used command prefixes by pressing the Command Prefix button
+
+![CMD](https://i.imgur.com/A79Het4.png)
+![CMD2](https://i.imgur.com/qBhwEUf.png)
+![CMD3](https://i.imgur.com/veagIsN.png)
+
 ## What’s changed or improved in this fork?
 
 ### ItemESP (Expanded)

src/main/java/net/wurstclient/command/CmdList.java

@@ -94,7 +94,13 @@ public CmdList()
 					continue;
 
 				Command cmd = (Command)field.get(this);
-				cmds.put(cmd.getName(), cmd);
+				// Store commands by their base name without the leading prefix
+				// (e.g. "help" instead of ".help"). This allows the command
+				// prefix to be configured independently.
+				String baseName = cmd.getName();
+				if(baseName.startsWith("."))
+					baseName = baseName.substring(1);
+				cmds.put(baseName, cmd);
 			}
 
 		}catch(Exception e)
@@ -107,7 +113,13 @@ public CmdList()
 
 	public Command getCmdByName(String name)
 	{
-		return cmds.get("." + name);
+		if(name == null)
+			return null;
+		
+		if(name.startsWith("."))
+			name = name.substring(1);
+		
+		return cmds.get(name);
 	}
 
 	public Collection<Command> getAllCmds()

src/main/java/net/wurstclient/command/CmdProcessor.java

@@ -32,11 +32,20 @@ public void onSentMessage(ChatOutputEvent event)
 			return;
 
 		String message = event.getOriginalMessage().trim();
-		if(!message.startsWith("."))
+		// Use the configured command prefix from the Wurst options.
+		String prefix = ".";
+		try
+		{
+			prefix = WurstClient.INSTANCE.getOtfs().commandPrefixOtf
+				.getPrefixSetting().getSelected().toString();
+		}catch(Throwable ignored)
+		{}
+		
+		if(!message.startsWith(prefix))
 			return;
 
 		event.cancel();
-		process(message.substring(1));
+		process(message.substring(prefix.length()));
 	}
 
 	public void process(String input)
@@ -108,19 +117,28 @@ public CmdNotFoundException(String input)
 		public void printToChat()
 		{
 			String cmdName = input.split(" ")[0];
-			ChatUtils.error("Unknown command: ." + cmdName);
+			String prefix = ".";
+			try
+			{
+				prefix = WurstClient.INSTANCE.getOtfs().commandPrefixOtf
+					.getPrefixSetting().getSelected().toString();
+			}catch(Throwable ignored)
+			{}
+			
+			ChatUtils.error("Unknown command: " + prefix + cmdName);
 
 			StringBuilder helpMsg = new StringBuilder();
 
 			if(input.startsWith("/"))
 			{
-				helpMsg.append("Use \".say " + input + "\"");
+				helpMsg.append("Use \"" + prefix + "say " + input + "\"");
 				helpMsg.append(" to send it as a chat command.");
 
 			}else
 			{
-				helpMsg.append("Type \".help\" for a list of commands or ");
-				helpMsg.append("\".say ." + input + "\"");
+				helpMsg.append(
+					"Type \"" + prefix + "help\" for a list of commands or ");
+				helpMsg.append("\"" + prefix + "say " + prefix + input + "\"");
 				helpMsg.append(" to send it as a chat message.");
 			}
 

src/main/java/net/wurstclient/commands/HelpCmd.java

@@ -10,6 +10,7 @@
 import java.util.ArrayList;
 
 import net.wurstclient.DontBlock;
+import net.wurstclient.WurstClient;
 import net.wurstclient.command.CmdException;
 import net.wurstclient.command.CmdSyntaxError;
 import net.wurstclient.command.Command;
@@ -57,21 +58,45 @@ private void listCommands(int page) throws CmdException
 		int start = (page - 1) * CMDS_PER_PAGE;
 		int end = Math.min(page * CMDS_PER_PAGE, cmds.size());
 
+		String prefix = ".";
+		try
+		{
+			prefix = WurstClient.INSTANCE.getOtfs().commandPrefixOtf
+				.getPrefixSetting().getSelected().toString();
+		}catch(Throwable ignored)
+		{}
+		
 		ChatUtils.message("Command list (page " + page + "/" + pages + ")");
 		for(int i = start; i < end; i++)
-			ChatUtils.message("- " + cmds.get(i).getName());
+		{
+			String name = cmds.get(i).getName();
+			if(name.startsWith("."))
+				name = name.substring(1);
+			ChatUtils.message("- " + prefix + name);
+		}
 	}
 
 	private void help(String cmdName) throws CmdException
 	{
-		if(cmdName.startsWith("."))
-			cmdName = cmdName.substring(1);
+		String prefix = ".";
+		try
+		{
+			prefix = WurstClient.INSTANCE.getOtfs().commandPrefixOtf
+				.getPrefixSetting().getSelected().toString();
+		}catch(Throwable ignored)
+		{}
+		
+		if(cmdName.startsWith(prefix))
+			cmdName = cmdName.substring(prefix.length());
 
 		Command cmd = WURST.getCmds().getCmdByName(cmdName);
 		if(cmd == null)
-			throw new CmdSyntaxError("Unknown command: ." + cmdName);
+			throw new CmdSyntaxError("Unknown command: " + prefix + cmdName);
+		
+		ChatUtils.message("Available help for " + prefix + cmdName + ":");
 
-		ChatUtils.message("Available help for ." + cmdName + ":");
-		cmd.printHelp();
+		String desc = cmd.getDescription().replaceAll("\\.(?=\\w)", prefix);
+		for(String line : desc.split("\n"))
+			ChatUtils.message(line);
 	}
 }

src/main/java/net/wurstclient/options/WurstOptionsScreen.java

@@ -49,7 +49,7 @@ public void init()
 		addRenderableWidget(Button
 			.builder(Component.literal("Back"),
 				b -> minecraft.setScreen(prevScreen))
-			.bounds(width / 2 - 100, height / 4 + 168 - 16, 200, 20).build());
+			.bounds(width / 2 - 100, height / 4 + 192 - 16, 200, 20).build());
 
 		addSettingButtons();
 		addManagerButtons();
@@ -67,6 +67,8 @@ private void addSettingButtons()
 			wurst.getOtfs().translationsOtf.getForceEnglish();
 		CheckboxSetting unsafeChatToast =
 			wurst.getOtfs().noChatReportsOtf.getUnsafeChatToast();
+		net.wurstclient.other_features.CommandPrefixOtf commandPrefixOtf =
+			wurst.getOtfs().commandPrefixOtf;
 
 		new WurstOptionsButton(-154, 24,
 			() -> "Click Friends: "
@@ -105,6 +107,15 @@ private void addSettingButtons()
 			"Shows a toast warning when a server enforces insecure chat/reporting.",
 			b -> unsafeChatToast.setChecked(!unsafeChatToast.isChecked()));
 
+		new WurstOptionsButton(-154, 168,
+			() -> "Command Prefix: "
+				+ commandPrefixOtf.getPrefixSetting().getSelected().toString(),
+			"Cycle through available command prefixes.", b -> {
+				commandPrefixOtf.getPrefixSetting().selectNext();
+				ChatUtils.message("Command prefix set to " + commandPrefixOtf
+					.getPrefixSetting().getSelected().toString());
+			});
+		
 		if(NiceWurstModule.showAntiFingerprintControls())
 		{
 			new WurstOptionsButton(-154, 144, () -> "Anti-Fingerprint",

src/main/java/net/wurstclient/other_feature/OtfList.java

@@ -30,6 +30,8 @@ public final class OtfList
 	public final ServerFinderOtf serverFinderOtf = new ServerFinderOtf();
 	public final TabGuiOtf tabGuiOtf = new TabGuiOtf();
 	public final TranslationsOtf translationsOtf = new TranslationsOtf();
+	public final net.wurstclient.other_features.CommandPrefixOtf commandPrefixOtf =
+		new net.wurstclient.other_features.CommandPrefixOtf();
 	public final VanillaSpoofOtf vanillaSpoofOtf = new VanillaSpoofOtf();
 	public final WikiDataExportOtf wikiDataExportOtf = new WikiDataExportOtf();
 	public final WurstCapesOtf wurstCapesOtf = new WurstCapesOtf();

src/main/java/net/wurstclient/other_features/CommandPrefixOtf.java

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2014-2025 Wurst-Imperium and contributors.
+ *
+ * This source code is subject to the terms of the GNU General Public
+ * License, version 3. If a copy of the GPL was not distributed with this
+ * file, You can obtain one at: https://www.gnu.org/licenses/gpl-3.0.txt
+ */
+package net.wurstclient.other_features;
+
+import net.wurstclient.other_feature.OtherFeature;
+import net.wurstclient.settings.EnumSetting;
+import net.wurstclient.util.text.WText;
+
+public final class CommandPrefixOtf extends OtherFeature
+{
+	public enum Prefix
+	{
+		DOT("."),
+		COLON(":"),
+		SEMICOLON(";"),
+		COMMA(","),
+		EXCLAMATION("!"),
+		AT("@"),
+		HASH("#"),
+		DOLLAR("$"),
+		PERCENT("%"),
+		CARET("^"),
+		AMPERSAND("&"),
+		ASTERISK("*");
+		
+		private final String symbol;
+		
+		Prefix(String symbol)
+		{
+			this.symbol = symbol;
+		}
+		
+		@Override
+		public String toString()
+		{
+			return symbol;
+		}
+	}
+	
+	private final EnumSetting<Prefix> prefixSetting =
+		new EnumSetting<>("Command Prefix",
+			WText.translated("options.command_prefix.description"),
+			Prefix.values(), Prefix.DOT);
+	
+	public CommandPrefixOtf()
+	{
+		super("Command Prefix",
+			"Change the command prefix used to trigger Wurst commands.");
+		addSetting(prefixSetting);
+	}
+	
+	public EnumSetting<Prefix> getPrefixSetting()
+	{
+		return prefixSetting;
+	}
+}