AmbleScript ( LUA ) & JSON defined GUIs

build.gradle

@@ -90,6 +90,9 @@ dependencies {
     include(modApi("dev.drtheo:scheduler:${project.scheduler_version}"))
     include(modApi("dev.drtheo:queue:${project.queue_version}"))
 
+    // LuaJ for GUI scripting
+    include(implementation("org.luaj:luaj-jse:3.0.1"))
+
 	// getter setter
 	compileOnly 'org.projectlombok:lombok:1.18.34'
 	annotationProcessor 'org.projectlombok:lombok:1.18.34'

src/main/java/dev/amble/lib/AmbleKit.java

@@ -7,7 +7,9 @@
 import dev.amble.lib.client.bedrock.BedrockAnimationAdapter;
 import dev.amble.lib.client.bedrock.BedrockModel;
 import dev.amble.lib.command.PlayAnimationCommand;
+import dev.amble.lib.command.ServerScriptCommand;
 import dev.amble.lib.command.SetSkinCommand;
+import dev.amble.lib.script.ServerScriptManager;
 import dev.amble.lib.skin.SkinTracker;
 import dev.drtheo.multidim.MultiDimMod;
 import dev.drtheo.scheduler.SchedulerMod;
@@ -35,10 +37,12 @@ public void onInitialize() {
         ServerLifecycleHooks.init();
 		SkinTracker.init();
 		AnimationTracker.init();
+		ServerScriptManager.getInstance().init();
 
 		CommandRegistrationCallback.EVENT.register((dispatcher, access, env) -> {
 			SetSkinCommand.register(dispatcher);
 			PlayAnimationCommand.register(dispatcher);
+			ServerScriptCommand.register(dispatcher);
 		});
 
         FabricLoader.getInstance().invokeEntrypoints("amblekit-main", AmbleKitInitializer.class,

src/main/java/dev/amble/lib/client/AmbleKitClient.java

@@ -3,10 +3,14 @@
 import dev.amble.lib.client.bedrock.BedrockAnimationRegistry;
 import dev.amble.lib.client.bedrock.BedrockModel;
 import dev.amble.lib.client.bedrock.BedrockModelRegistry;
+import dev.amble.lib.client.gui.registry.AmbleGuiRegistry;
+import dev.amble.lib.client.command.ClientScriptCommand;
 import dev.amble.lib.register.AmbleRegistries;
+import dev.amble.lib.script.ScriptManager;
 import dev.amble.lib.skin.client.SkinGrabber;
 import dev.drtheo.scheduler.client.SchedulerClientMod;
 import net.fabricmc.api.ClientModInitializer;
+import net.fabricmc.fabric.api.client.command.v2.ClientCommandRegistrationCallback;
 import net.fabricmc.fabric.api.client.event.lifecycle.v1.ClientTickEvents;
 import net.fabricmc.loader.api.FabricLoader;
 
@@ -25,13 +29,20 @@ public void onInitializeClient() {
 
         AmbleRegistries.getInstance().registerAll(
                 BedrockModelRegistry.getInstance(),
-                BedrockAnimationRegistry.getInstance()
+                BedrockAnimationRegistry.getInstance(),
+                AmbleGuiRegistry.getInstance()
         );
 
-	    ClientTickEvents.END_CLIENT_TICK.register((client) -> {
-			SkinGrabber.INSTANCE.tick();
-	    });
+        AmbleGuiRegistry.init();
 
+        ClientCommandRegistrationCallback.EVENT.register((dispatcher, access) -> {
+            ClientScriptCommand.register(dispatcher);
+        });
+
+        ClientTickEvents.END_CLIENT_TICK.register((client) -> {
+            SkinGrabber.INSTANCE.tick();
+            ScriptManager.getInstance().tick();
+        });
 
 	}
 }

src/main/java/dev/amble/lib/client/command/ClientScriptCommand.java

@@ -0,0 +1,220 @@
+package dev.amble.lib.client.command;
+
+import com.mojang.brigadier.CommandDispatcher;
+import com.mojang.brigadier.context.CommandContext;
+import com.mojang.brigadier.suggestion.SuggestionProvider;
+import dev.amble.lib.AmbleKit;
+import dev.amble.lib.script.LuaScript;
+import dev.amble.lib.script.ScriptManager;
+import net.fabricmc.fabric.api.client.command.v2.FabricClientCommandSource;
+import net.minecraft.client.MinecraftClient;
+import net.minecraft.command.CommandSource;
+import net.minecraft.command.argument.IdentifierArgumentType;
+import net.minecraft.text.Text;
+import net.minecraft.util.Formatting;
+import net.minecraft.util.Identifier;
+import org.luaj.vm2.LuaValue;
+
+import java.util.Set;
+
+import static net.fabricmc.fabric.api.client.command.v2.ClientCommandManager.argument;
+import static net.fabricmc.fabric.api.client.command.v2.ClientCommandManager.literal;
+
+/**
+ * Client-side command for managing client scripts.
+ * Usage: /amblescript [execute|enable|disable|toggle|list|available] [script_id]
+ */
+public class ClientScriptCommand {
+
+	private static final String SCRIPT_PREFIX = "script/";
+	private static final String SCRIPT_SUFFIX = ".lua";
+
+	/**
+	 * Converts a full script identifier to a display-friendly format.
+	 * Removes the "script/" prefix and ".lua" suffix.
+	 */
+	private static String getDisplayId(Identifier id) {
+		return id.getPath().replace(SCRIPT_PREFIX, "").replace(SCRIPT_SUFFIX, "");
+	}
+
+	/**
+	 * Converts a user-provided script ID to the full internal identifier.
+	 */
+	private static Identifier toFullScriptId(Identifier scriptId) {
+		return scriptId.withPrefixedPath(SCRIPT_PREFIX).withSuffixedPath(SCRIPT_SUFFIX);
+	}
+
+	private static final SuggestionProvider<FabricClientCommandSource> SCRIPT_SUGGESTIONS = (context, builder) -> {
+		return CommandSource.suggestIdentifiers(
+				ScriptManager.getInstance().getCache().keySet().stream()
+						.map(id -> Identifier.of(id.getNamespace(), getDisplayId(id))),
+				builder
+		);
+	};
+
+	private static final SuggestionProvider<FabricClientCommandSource> ENABLED_SCRIPT_SUGGESTIONS = (context, builder) -> {
+		return CommandSource.suggestIdentifiers(
+				ScriptManager.getInstance().getEnabledScripts().stream()
+						.map(id -> Identifier.of(id.getNamespace(), getDisplayId(id))),
+				builder
+		);
+	};
+
+	public static void register(CommandDispatcher<FabricClientCommandSource> dispatcher) {
+		dispatcher.register(literal("amblescript")
+				.then(literal("execute")
+						.then(argument("id", IdentifierArgumentType.identifier())
+								.suggests(SCRIPT_SUGGESTIONS)
+								.executes(ClientScriptCommand::execute)))
+				.then(literal("enable")
+						.then(argument("id", IdentifierArgumentType.identifier())
+								.suggests(SCRIPT_SUGGESTIONS)
+								.executes(ClientScriptCommand::enable)))
+				.then(literal("disable")
+						.then(argument("id", IdentifierArgumentType.identifier())
+								.suggests(ENABLED_SCRIPT_SUGGESTIONS)
+								.executes(ClientScriptCommand::disable)))
+				.then(literal("toggle")
+						.then(argument("id", IdentifierArgumentType.identifier())
+								.suggests(SCRIPT_SUGGESTIONS)
+								.executes(ClientScriptCommand::toggle)))
+				.then(literal("list")
+						.executes(ClientScriptCommand::listEnabled))
+				.then(literal("available")
+						.executes(ClientScriptCommand::listAvailable)));
+	}
+
+	private static int execute(CommandContext<FabricClientCommandSource> context) {
+		Identifier scriptId = context.getArgument("id", Identifier.class);
+		Identifier fullScriptId = toFullScriptId(scriptId);
+
+		try {
+			LuaScript script = ScriptManager.getInstance().load(
+					fullScriptId,
+					MinecraftClient.getInstance().getResourceManager()
+			);
+
+			if (script.onExecute() == null || script.onExecute().isnil()) {
+				context.getSource().sendError(Text.literal("Script '" + scriptId + "' has no onExecute function"));
+				return 0;
+			}
+
+			LuaValue data = ScriptManager.getInstance().getScriptData(fullScriptId);
+			script.onExecute().call(data);
+			context.getSource().sendFeedback(Text.literal("Executed script: " + scriptId));
+			return 1;
+		} catch (Exception e) {
+			context.getSource().sendError(Text.literal("Failed to execute script '" + scriptId + "': " + e.getMessage()));
+			AmbleKit.LOGGER.error("Failed to execute script {}", scriptId, e);
+			return 0;
+		}
+	}
+
+	private static int enable(CommandContext<FabricClientCommandSource> context) {
+		Identifier scriptId = context.getArgument("id", Identifier.class);
+		Identifier fullScriptId = toFullScriptId(scriptId);
+
+		// Ensure script is loaded
+		try {
+			ScriptManager.getInstance().load(fullScriptId, MinecraftClient.getInstance().getResourceManager());
+		} catch (Exception e) {
+			context.getSource().sendError(Text.literal("Script '" + scriptId + "' not found"));
+			return 0;
+		}
+
+		if (ScriptManager.getInstance().isEnabled(fullScriptId)) {
+			context.getSource().sendError(Text.literal("Script '" + scriptId + "' is already enabled"));
+			return 0;
+		}
+
+		if (ScriptManager.getInstance().enable(fullScriptId)) {
+			context.getSource().sendFeedback(Text.literal("Enabled script: " + scriptId).formatted(Formatting.GREEN));
+			return 1;
+		} else {
+			context.getSource().sendError(Text.literal("Failed to enable script '" + scriptId + "'"));
+			return 0;
+		}
+	}
+
+	private static int disable(CommandContext<FabricClientCommandSource> context) {
+		Identifier scriptId = context.getArgument("id", Identifier.class);
+		Identifier fullScriptId = toFullScriptId(scriptId);
+
+		if (!ScriptManager.getInstance().isEnabled(fullScriptId)) {
+			context.getSource().sendError(Text.literal("Script '" + scriptId + "' is not enabled"));
+			return 0;
+		}
+
+		if (ScriptManager.getInstance().disable(fullScriptId)) {
+			context.getSource().sendFeedback(Text.literal("Disabled script: " + scriptId).formatted(Formatting.RED));
+			return 1;
+		} else {
+			context.getSource().sendError(Text.literal("Failed to disable script '" + scriptId + "'"));
+			return 0;
+		}
+	}
+
+	private static int toggle(CommandContext<FabricClientCommandSource> context) {
+		Identifier scriptId = context.getArgument("id", Identifier.class);
+		Identifier fullScriptId = toFullScriptId(scriptId);
+
+		// Ensure script is loaded
+		try {
+			ScriptManager.getInstance().load(fullScriptId, MinecraftClient.getInstance().getResourceManager());
+		} catch (Exception e) {
+			context.getSource().sendError(Text.literal("Script '" + scriptId + "' not found"));
+			return 0;
+		}
+
+		boolean wasEnabled = ScriptManager.getInstance().isEnabled(fullScriptId);
+		ScriptManager.getInstance().toggle(fullScriptId);
+
+		if (wasEnabled) {
+			context.getSource().sendFeedback(Text.literal("Disabled script: " + scriptId).formatted(Formatting.RED));
+		} else {
+			context.getSource().sendFeedback(Text.literal("Enabled script: " + scriptId).formatted(Formatting.GREEN));
+		}
+		return 1;
+	}
+
+	private static int listEnabled(CommandContext<FabricClientCommandSource> context) {
+		Set<Identifier> enabled = ScriptManager.getInstance().getEnabledScripts();
+
+		if (enabled.isEmpty()) {
+			context.getSource().sendFeedback(Text.literal("No client scripts are currently enabled").formatted(Formatting.GRAY));
+			return 1;
+		}
+
+		context.getSource().sendFeedback(Text.literal("━━━ Enabled Client Scripts (" + enabled.size() + ") ━━━").formatted(Formatting.GOLD, Formatting.BOLD));
+		for (Identifier id : enabled) {
+			String displayId = getDisplayId(id);
+			context.getSource().sendFeedback(
+					Text.literal("✓ ").formatted(Formatting.GREEN)
+							.append(Text.literal(id.getNamespace() + ":" + displayId).formatted(Formatting.WHITE))
+			);
+		}
+		return 1;
+	}
+
+	private static int listAvailable(CommandContext<FabricClientCommandSource> context) {
+		Set<Identifier> available = ScriptManager.getInstance().getCache().keySet();
+		Set<Identifier> enabled = ScriptManager.getInstance().getEnabledScripts();
+
+		if (available.isEmpty()) {
+			context.getSource().sendFeedback(Text.literal("No client scripts available").formatted(Formatting.GRAY));
+			return 1;
+		}
+
+		context.getSource().sendFeedback(Text.literal("━━━ Available Client Scripts (" + available.size() + ") ━━━").formatted(Formatting.GOLD, Formatting.BOLD));
+		for (Identifier id : available) {
+			String displayId = getDisplayId(id);
+			Text statusIcon = enabled.contains(id)
+					? Text.literal("✓ ").formatted(Formatting.GREEN)
+					: Text.literal("○ ").formatted(Formatting.GRAY);
+			context.getSource().sendFeedback(
+					statusIcon.copy().append(Text.literal(id.getNamespace() + ":" + displayId).formatted(Formatting.WHITE))
+			);
+		}
+		return 1;
+	}
+}