Skidfuscator Java Obfuscator

The help command is not the primary entrypoint for performing obfuscation. To obfuscate a Java archive, use the obfuscate command followed by the input JAR file and any desired options.

Usage Pattern: java -jar skidfuscator.jar obfuscate <input jar> [options here]

The DecryptorDictionary class is used to store and retrieve the mapping between keys and their corresponding decryption values (e.g., keys, salts, or constants) required by the obfuscator's string encryption logic.

Usage Pattern:

1. Create a dictionary using DecryptorDictionary.create().
2. Populate it using the .of(String key, Object value) method.
3. Retrieve values using .get(String key).

DecryptorDictionary dictionary = DecryptorDictionary.create()
    .of("secret_key", "my-super-secret-value")
    .of("salt", 12345);

String key = dictionary.get("secret_key");

The following flags and parameters are available for the obfuscate command:

<input> (positional)  The file which will be obfuscated.

Options:
  -rt, --runtime       Path to the runtime jar
  -li, --libs          Path to the libs folder
  -ex, --exempt        Path to the exempt file (Deprecated: triggers migration to HOCON)
  -o, --output         Path to the output jar location
  -cfg, --config       Path to the config file
  -ph, --phantom       Declare if phantom computation should be used
  -fuckit, --fuckit    Do not use!
  -dbg, --debug        Do not use!
  -notrack, --notrack If you do not wish to be part of analytics!

The following table lists the command-line interface for the mappings command.

Parameters:
  index 0: The directory which will be used to create the mappings file

Options:
  -o, --output: Path to the output mappings file location (default: compressed-mappings.json)

The mappings command (alias for mappings) scans a specified directory or a single JAR file to create a collated mappings file. This is useful for aggregating mapping information from multiple .jar or .jmod files into a single JSON file.

Usage: mappings <input-directory-or-jar> [options]

Arguments:

• <input-directory-or-jar>: The directory or specific JAR file to be used for creating the mappings file. The input must be a directory or a file ending in .jar.

Options:

• -o, --output <file>: The path where the output mappings file will be saved. If not provided, it defaults to compressed-mappings.json.

# Example: Create mappings from a directory of jars
mappings ./libs -o my-mappings.json

# Example: Create mappings from a single jar
mappings my-library.jar

The dependency analysis tool can be executed from the command line to identify required JAR files for a given application. You must provide the path to the main application JAR and the directory containing its dependencies (libraries).

java dev.skidfuscator.dependanalysis.Main <main.jar> <lib_folder>

# Example usage:
java dev.skidfuscator.dependanalysis.Main my-app.jar libs/

When implementing custom string encryption logic, use the @InjectMethod annotation to mark methods that should be injected into the obfuscated code. This annotation allows you to specify a name for the injected method and assign tags to control its properties.

Parameters:

• value: The name of the method to be injected.
• tags: An array of InjectMethodTag values.

Available Tags:

• RANDOM_NAME: Indicates the method name should be randomized.

@InjectMethod(value = "decryptionHelper", tags = {InjectMethodTag.RANDOM_NAME})
public String myDecryptionMethod(String input) {
    // implementation
}

Use the @InjectField annotation to mark fields that should be injected into the obfuscated code. This is used to provide necessary state or keys for decryption logic.

Parameters:

• value: The name of the field to be injected.
• tags: An array of InjectFieldTag values.

Available Tags:

• RANDOM_NAME: The field name should be randomized.
• FINAL: The field should be marked as final.
• NO_INTERFACE_COMPAT: The field should not be compatible with interfaces.

@InjectField(value = "encryptionKey", tags = {InjectFieldTag.FINAL})
private final String encryptionKey;