Refactored Feature to Mod (renamed)

2026-03-24 11:50:21 +01:00
parent 3138f7ec62
commit 8471894248
22 changed files with 96 additions and 96 deletions
@@ -0,0 +1,90 @@
+package org.saturnclient.mod.mods;
+
+import org.saturnclient.common.provider.Providers;
+import org.saturnclient.config.property.BoolProperty;
+import org.saturnclient.config.property.KeybindingProperty;
+import org.saturnclient.config.property.Property;
+import org.saturnclient.mod.Mod;
+import org.saturnclient.mod.ModSpec;
+import org.saturnclient.common.module.RenderModule;
+import org.saturnclient.common.provider.GLFWProvider;
+
+/**
+ * FreelookMod lets the player look around freely (in third-person)
+ * without changing the direction their character walks.
+ *
+ * Camera perspective is controlled through {@link RenderModule} so
+ * that the feature itself contains no direct Minecraft API calls.
+ */
+public class FreelookMod extends Mod {
+
+    private static final BoolProperty enabled = Property.bool(false);
+    private static final BoolProperty toggle = Property.bool(true);
+    public static final KeybindingProperty freelookKey = Property.keybinding(GLFWProvider.GLFW_KEY_H);
+
+    /** Whether freelook is currently active (read by the camera mixin). */
+    public static boolean isFreeLooking = false;
+    private static boolean wasFirstPerson = false;
+
+    public FreelookMod() {
+        super(
+                new ModSpec("Freelook", "freelook")
+                        .description("Look around freely without moving your character")
+                        .tags("Movement", "Camera")
+                        .version("v0.2.0"),
+                enabled.named("Enabled"),
+                toggle.named("Toggle freelook"),
+                freelookKey.named("Freelook Keybinding"));
+    }
+
+    // ---------------------------------------------------------------
+    // Mod contract
+    // ---------------------------------------------------------------
+
+    @Override
+    public void tick() {
+        if (toggle.value) {
+            if (freelookKey.wasKeyPressed()) {
+                if (isFreeLooking)
+                    stopFreelook();
+                else
+                    startFreelook();
+            }
+        } else if (freelookKey.isKeyPressed()) {
+            if (!isFreeLooking)
+                startFreelook();
+        } else if (isFreeLooking) {
+            stopFreelook();
+        }
+    }
+
+    @Override
+    public void onEnabled(boolean e) {
+        enabled.value = e;
+        if (!e && isFreeLooking)
+            stopFreelook();
+    }
+
+    @Override
+    public boolean isEnabled() {
+        return enabled.value;
+    }
+
+    // ---------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------
+
+    private void startFreelook() {
+        RenderModule render = Providers.module.render();
+        wasFirstPerson = render.isFirstPerson();
+        render.setThirdPersonBack();
+        isFreeLooking = true;
+    }
+
+    private void stopFreelook() {
+        if (wasFirstPerson) {
+            Providers.module.render().setFirstPerson();
+        }
+        isFreeLooking = false;
+    }
+}