Added Wurst Addon Support

Author: cev-api

README.md

@@ -1262,11 +1262,48 @@ Examples:
 - ```.xray off``` / ```.xray on```
 - Existing ```.xray add/remove/list/reset``` still works
 
----
-
-## License
-
-This code is licensed under the GNU General Public License v3. 
+---
+
+## Wurst Addon API
+
+This fork now supports Fabric-style Wurst addons through a custom entrypoint.
+
+- Entrypoint key: `wurst`
+- Entrypoint class type: `net.wurstclient.addons.WurstAddon`
+- Registration API:
+  - `addHack(Hack hack)`
+  - `addCommand(Command command)`
+  - `addOtherFeature(OtherFeature feature)`
+
+Minimal example:
+
+```java
+public final class MyAddon extends WurstAddon
+{
+	@Override
+	public void onInitialize()
+	{
+		addHack(new MyHack());
+		addCommand(new MyCommand());
+	}
+}
+```
+
+`fabric.mod.json` entrypoint example:
+
+```json
+"entrypoints": {
+  "wurst": ["com.example.addon.MyAddon"]
+}
+```
+
+A ready-to-publish starter project is included in this repository at:
+
+- `wurst-addon-template/`
+
+## License
+
+This code is licensed under the GNU General Public License v3. 
 
 
 

src/main/java/net/wurstclient/Feature.java

@@ -52,6 +52,12 @@ public Category getCategory()
 		return null;
 	}
 
+	public String getCategoryName()
+	{
+		Category category = getCategory();
+		return category != null ? category.getName() : null;
+	}
+	
 	public abstract String getPrimaryAction();
 
 	public void doPrimaryAction()

src/main/java/net/wurstclient/WurstClient.java

@@ -14,6 +14,7 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 import net.minecraft.client.Minecraft;
+import net.wurstclient.addons.AddonManager;
 import net.wurstclient.altmanager.AltManager;
 import net.wurstclient.altmanager.Encryption;
 import net.wurstclient.analytics.PlausibleAnalytics;
@@ -132,6 +133,8 @@ public void initialize()
 
 		otfs = new OtfList();
 
+		AddonManager.init();
+		
 		Path settingsFile = wurstFolder.resolve("settings.json");
 		settingsProfileFolder = wurstFolder.resolve("settings");
 		this.settingsFile = new SettingsFile(settingsFile, hax, cmds, otfs);

src/main/java/net/wurstclient/addons/AddonManager.java

@@ -0,0 +1,97 @@
+/*
+ * Copyright (c) 2014-2026 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.addons;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+import net.fabricmc.loader.api.FabricLoader;
+import net.fabricmc.loader.api.entrypoint.EntrypointContainer;
+import net.fabricmc.loader.api.metadata.ModMetadata;
+import net.fabricmc.loader.api.metadata.Person;
+
+public final class AddonManager
+{
+	private static final ArrayList<WurstAddon> addons = new ArrayList<>();
+	private static boolean initialized;
+	
+	private AddonManager()
+	{}
+	
+	public static void init()
+	{
+		if(initialized)
+			return;
+		
+		initialized = true;
+		
+		loadAddons();
+		initializeAddons();
+		
+		if(!addons.isEmpty())
+			System.out.println("Loaded Wurst addons: " + addons.stream()
+				.map(a -> a.name).collect(Collectors.joining(", ")));
+	}
+	
+	private static void loadAddons()
+	{
+		for(EntrypointContainer<WurstAddon> entrypoint : FabricLoader
+			.getInstance().getEntrypointContainers("wurst", WurstAddon.class))
+		{
+			ModMetadata metadata = entrypoint.getProvider().getMetadata();
+			WurstAddon addon;
+			try
+			{
+				addon = entrypoint.getEntrypoint();
+				
+			}catch(Throwable t)
+			{
+				throw new RuntimeException(
+					"Exception while preparing Wurst addon \""
+						+ metadata.getName() + "\".",
+					t);
+			}
+			
+			addon.id = metadata.getId();
+			addon.name = metadata.getName();
+			addon.version = metadata.getVersion().getFriendlyString();
+			
+			if(metadata.getAuthors().isEmpty())
+				throw new RuntimeException("Wurst addon \"" + addon.name
+					+ "\" requires at least one author in fabric.mod.json.");
+			
+			addon.authors = new String[metadata.getAuthors().size()];
+			int i = 0;
+			for(Person author : metadata.getAuthors())
+				addon.authors[i++] = author.getName();
+			
+			addons.add(addon);
+		}
+	}
+	
+	private static void initializeAddons()
+	{
+		for(WurstAddon addon : addons)
+			try
+			{
+				addon.onInitialize();
+				
+			}catch(Throwable t)
+			{
+				throw new RuntimeException(
+					"Exception during Wurst addon init \"" + addon.name + "\".",
+					t);
+			}
+	}
+	
+	public static List<WurstAddon> getAddons()
+	{
+		return Collections.unmodifiableList(addons);
+	}
+}

src/main/java/net/wurstclient/addons/WurstAddon.java

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2014-2026 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.addons;
+
+import net.wurstclient.WurstClient;
+import net.wurstclient.command.Command;
+import net.wurstclient.hack.Hack;
+import net.wurstclient.other_feature.OtherFeature;
+
+public abstract class WurstAddon
+{
+	/** Automatically assigned from fabric.mod.json. */
+	public String id;
+	
+	/** Automatically assigned from fabric.mod.json. */
+	public String name;
+	
+	/** Automatically assigned from fabric.mod.json. */
+	public String version;
+	
+	/** Automatically assigned from fabric.mod.json. */
+	public String[] authors;
+	
+	/**
+	 * Called during Wurst startup after hack/cmd/feature registries are
+	 * available but before GUI/HUD initialization.
+	 *
+	 * Register addon hacks, commands, and other features here.
+	 */
+	public abstract void onInitialize();
+	
+	public String getWebsite()
+	{
+		return null;
+	}
+	
+	protected final WurstClient getWurst()
+	{
+		return WurstClient.INSTANCE;
+	}
+	
+	protected final void addHack(Hack hack)
+	{
+		WurstClient.INSTANCE.getHax().addHack(hack);
+	}
+	
+	protected final void addCommand(Command command)
+	{
+		WurstClient.INSTANCE.getCmds().addCmd(command);
+	}
+	
+	protected final void addOtherFeature(OtherFeature otherFeature)
+	{
+		WurstClient.INSTANCE.getOtfs().addOtf(otherFeature);
+	}
+}