Merge branch 'skidfuscatordev:master' into master

Author: anjeshshrestha

.github/workflows/release.yml

@@ -0,0 +1,136 @@
+name: Update Homebrew Formula
+
+on:
+  release:
+    types: [published]
+
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag to update the formula (e.g., 'v2.0.12')"
+        required: false
+        default: "2.0.11"
+
+jobs:
+  update-formula:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Extract version from input or release
+        id: extract_version
+        run: |
+          # Use the provided tag if triggered manually, otherwise use the release tag
+          if [ "${{ github.event.inputs.tag }}" != "" ]; then
+            VERSION="${{ github.event.inputs.tag }}"
+          else
+            VERSION="${GITHUB_REF#refs/tags/}"
+          fi
+
+          # Normalize by removing a leading 'v' if present
+          VERSION="${VERSION#v}"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Find jar asset download URL
+        id: find_asset
+        run: |
+          # Get release data from GitHub API
+          release_data=$(curl -sL -H "Accept: application/vnd.github+json" \
+            "https://api.github.com/repos/skidfuscatordev/skidfuscator-java-obfuscator/releases/tags/${{ steps.extract_version.outputs.version }}")
+
+          # Find the asset named 'skidfuscator.jar' (adjust if needed)
+          asset_url=$(echo "$release_data" | jq -r '.assets[] | select(.name == "skidfuscator.jar") | .browser_download_url')
+
+          if [ -z "$asset_url" ]; then
+            echo "Could not find skidfuscator.jar in the release."
+            exit 1
+          fi
+
+          echo "asset_url=$asset_url" >> $GITHUB_OUTPUT
+
+      - name: Download jar
+        run: |
+          curl -L ${{ steps.find_asset.outputs.asset_url }} -o skidfuscator.jar
+
+      - name: Compute SHA256
+        id: sha256
+        run: |
+          SHA256=$(shasum -a 256 skidfuscator.jar | awk '{print $1}')
+          echo "sha256=$SHA256" >> $GITHUB_OUTPUT
+
+      - name: Checkout tap repository
+        uses: actions/checkout@v3
+        with:
+          repository: skidfuscatordev/homebrew-skidfuscator
+          token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
+          ref: master
+      - name: List Files
+        run: ls -R
+      - name: Cleanup and Prepare Formula
+        run: |
+          # Ensure Formula directory exists
+          mkdir -p Formula
+
+          # Use absolute path and verify directory exists
+          FORMULA_DIR="$(pwd)/Formula"
+          FORMULA_PATH="${FORMULA_DIR}/skidfuscator.rb"
+
+          echo "Working directory: $(pwd)"
+          echo "Formula directory: ${FORMULA_DIR}"
+          echo "Formula path: ${FORMULA_PATH}"
+
+          # Remove any existing formula files
+          rm -f ${FORMULA_DIR}/skidfuscator*.rb
+
+          # Create the new formula file
+          cat > "${FORMULA_PATH}" << 'EOF'
+          class Skidfuscator < Formula
+            desc "A JVM-based obfuscation suite designed for Java and Android bytecode"
+            homepage "https://github.com/skidfuscatordev/skidfuscator-java-obfuscator"
+            url "https://github.com/skidfuscatordev/skidfuscator-java-obfuscator/releases/download/2.0.11/skidfuscator.jar"
+            sha256 "8d5bc1f6854995495a8451417cf5235a31a56d20fc4ce6079b19963ed84c49d9"
+            version "2.0.11"
+            license "MIT"
+
+            def install
+              libexec.install Dir["*.jar"]
+              jar_name = Dir["#{libexec}/*.jar"].first
+              (bin/"skidfuscator").write <<~EOS
+                #!/usr/bin/env bash
+                exec java -jar "#{jar_name}" "$@"
+              EOS
+              (bin/"skidfuscator").chmod 0755
+            end
+
+            test do
+              output = shell_output("#{bin}/skidfuscator --help", 0)
+              assert_match "Usage", output
+            end
+          end
+          EOF
+
+          # Verify file was created
+          ls -la ${FORMULA_DIR}
+
+          # Show file contents
+          echo "Formula contents:"
+          cat "${FORMULA_PATH}"
+
+      - name: Debug Formula Content
+        run: |
+          echo "Formula content:"
+          cat Formula/skidfuscator.rb || echo "Failed to read formula file"
+          echo "Git status:"
+          git status
+          echo "Directory contents:"
+          ls -R
+
+      - name: Commit and push changes
+        run: |
+          git config user.name "github-actions"
+          git config user.email "github-actions@github.com"
+          git add Formula/skidfuscator.rb
+          git commit -m "Update Skidfuscator formula to version 2.0.11"
+          git push origin HEAD:master
+        env:
+          GITHUB_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
+
+

.gitignore

@@ -5,6 +5,7 @@
 .idea/*
 *.iml
 
+*.json
 
 # Maven output
 */target/*

README.md

@@ -6,7 +6,6 @@
   Skidfuscator: Obfuscation like never seen before.
 </p>
 <p align="center">
-  <a><img alt="Server Version" src="https://github.com/terminalsin/skidfuscator-java-obfuscator/actions/workflows/maven.yml/badge.svg?branch=master"></a>
   <a><img alt="Api Type" src="https://img.shields.io/badge/API-MapleIR-blue"></a>
   <a><img alt="Authors" src="https://img.shields.io/badge/Authors-Ghast-blue"></a>
   <a><img alt="Issues" src="https://img.shields.io/github/issues/terminalsin/skidfuscator-java-obfuscator"></a>
@@ -21,8 +20,35 @@
 </p>
 
 ---
-
-# 🕵️ What is Skidfuscator?
+## 🚀 Quickstart
+
+> [!TIP]
+> You can download Skidfuscator [here](https://github.com/skidfuscatordev/skidfuscator-java-obfuscator/releases) and run it directly using:
+> ```
+> java -jar skidfuscator.jar obfuscate <path to your jar>
+> ```
+
+Skidfuscator uses a config system, which allows you to customize your obfuscation. We try to automatically download all compatible libraries, but some may slip through the cracks. The Gradle plugin is a work in progress. For now, use:
+```
+java -jar skidfuscator.jar obfuscate <path to your jar> -li=<path to folder with all libs>
+```
+
+### 🔥 Homebrew (macOS)
+```
+brew tap skidfuscatordev/skidfuscator
+brew install skidfuscator
+```
+
+### 🔥 Bash (Linux/macOS)
+```
+curl -sL https://raw.githubusercontent.com/skidfuscatordev/skidfuscator-java-obfuscator/refs/heads/master/scripts/install.sh | bash
+```
+### 🔥 Powershell [Admin required] (Windows)
+```
+iex "& { $(iwr -useb https://raw.githubusercontent.com/skidfuscatordev/skidfuscator-java-obfuscator/refs/heads/master/scripts/install.ps1) }"
+```
+
+## 🕵️ What is Skidfuscator?
 Skidfuscator is a proof of concept obfuscation tool designed to take advantage of SSA form to optimize and obfuscate Java bytecode
 code flow. This is done via intra-procedural passes each designed to mingle the code in a shape where neither the time complexity
 neither the space complexity suffers from a great loss. To achieve the such, we have modeled a couple of well known tricks to 
@@ -36,6 +62,9 @@ Skidfuscator is now feature-complete and continues to be actively maintained wit
 
 ### 1. Automatic Dependency Downloading
 Skidfuscator intelligently identifies and downloads missing dependencies needed for your project, minimizing manual configuration. Known frameworks such as Bukkit are automatically handled, streamlining setup.
+
+![autodepend](https://github.com/user-attachments/assets/958349aa-582b-4751-88e1-ed61408d24b8)
+
 ### 2. Smart Recovery
 In the event of errors or failed obfuscation, Skidfuscator implements a recovery system that intelligently resolves conflicts and provides suggestions to fix issues. This ensures minimal disruption in your development workflow.
 ### 3. Auto Configuration
@@ -54,6 +83,33 @@ not to be commercial but to inspire some more clever approaches to code flow obf
 
 ## Third Generation Flow
 
+### Flow Obfuscation
+- [x] Bogus Exception Flow
+- [x] Bogus Condition Flow
+- [x] **NEW** ✨ Pure Function Hashing Flow
+- [x] Switch Flow
+- [x] Factory Initiation Flow (**Enterprise**)
+- [x] Integer Return Flow (**Enterprise**)
+- [x] Exception Return Flow (**Enterprise**)
+
+### Encryption Obfuscation
+- [x] String Encryption
+- [x] Annotation Encryption (**Enterprise**)
+- [x] Reference Encryption (**Enterprise**)
+
+### Structure Obfuscation
+- [x] Field Renamer (**Enterprise**)
+- [x] Method Renamer (**Enterprise**)
+- [x] Class Renamer (**Enterprise**)
+- [x] Mixin Support (**Enterprise**)
+- [x] Spigot Plugin Support (**Enterprise**)
+
+### Miscelleanous 
+- [x] Ahegao Trolling
+- [x] Driver Protection
+- [x] **Experimental** Outlining Obfuscation (**Enterprise**)
+- [x] Native Driver Protection (**Enterprise**)
+
 What is third generation flow obfuscation? Well, contrary to Zelix's [second generation flow obfuscation](https://www.zelix.com/klassmaster/featuresFlowObfuscation.html), we use an even more complex system with private and public seeds. Here's 
 how it works:
 
@@ -69,24 +125,7 @@ how it works:
 
 We currently are working on a variety of ways to approach this system using various lightweight obfuscation methods. Here are the current ones
 to date:
-Here are the features:
-
-| Feature | Type | Description | Status |
-| --- | --- | --- | --- |
-| `Flow GEN3` | Flow (Community) | Obfuscates methods using the GEN3 Obfuscation methodology | ✅ |
-| `Bogus Jump` | Flow (Community) | Invalid jump to some random generated code to prevent skidding | ✅ |
-| `Bogus Exception`| Flow (Community) | Invalid jump to some random generated exception | ✅ |
-| `Mangled Jump` | Flow (**Enterprise**) | Mutation to the jump condition to make it appear more complex than it actually is | ❌ |
-| `Exception Jump` | Flow (**Enterprise**) | Changes done to flow semantics by forcing an exception then handling all the code in the catch clause | ❌ |
-| `Exception Return`| Flow (**Enterprise**) | Throw an exception with the value and catch it as opposed to returning it (Very heavy) | ❌ |
-| `Strong Opaque Predicate` | Flow (Community) | Use heredity and method invocation to pass a predicate as opposed to declaring it at the beginning of the CFG | ✅ |
-| `Method Inlining` | Flow (**Enterprise**) | Inline uncommon methods which aren't too big | ❌ |
-| `Method Outlining` | Flow (**Enterprise**) | Outline some non-sensitive blocks | ❌ |
-| `Loop Unrolling` | Flow (**Enterprise**) | Rewrite some loops instructions into continuous segments if the loop limit can be pre-determined | ❌ |
-| `Flattening` | Flow (Community) | Use a dispatcher method to harden the semantics of some block ranges (do not use entire method) | ⚠️ |
-| `String Encryption` | String | Encrypt the strings using the opaque predicate | ✅ |
-| `Reference Encryption` | Reference | Encrypt the reference calls using InvokeDynamic using the opaque predicate | ❌ |
-| `Reference Proxying` | Reference | Proxy references using a builder pattern OR dispatcher classes (mostly for initialisation) | ❌ |
+
 # Credits
 
 ## Libraries used

build.gradle

@@ -8,6 +8,9 @@ allprojects {
         jcenter()
         mavenCentral()
         mavenLocal()
+        maven {
+            url 'https://repo.cleanroommc.com/releases/'
+        }
     }
 
     apply plugin: 'java'