Lorenz

Lorenz is a library intended for creating and altering de-obfuscation mappings for Java programs (compiled or otherwise), this is done independent of the format being used. Lorenz supports a variety of mapping formats:

SRG and its variants (CSRG, TSRG, and XSRG)
Enigma (through lorenz-io-enigma)
JAM (through lorenz-io-jam)
Tiny V1 & V2 (through lorenz-io-tiny)
ProGuard (reader only through lorenz-io-proguard)

Branches

Lorenz makes use of the git-flow branching structure, briefly put:

master is the source for the latest released version
develop is the source of the latest developments

All releases will also be tagged, with further descriptions in their GitHub release. These descriptions will include information such as migration advice.

Usage

Lorenz is centred around the MappingSet, the root container of mappings. A provided implementation can be constructed through MappingSet.create().

Lorenz releases can be obtained through Maven Central:

Gradle

implementation 'org.cadixdev:lorenz:0.5.7'

Maven

<dependency>
    <groupId>org.cadixdev</groupId>
    <artifactId>lorenz</artifactId>
    <version>0.5.7</version>
</dependency>

You may also find snapshot artifacts on Sonatype's OSS repository.

Versions prior to 0.5.0 were made under the me.jamiemansfield group, and initial snapshot releases were made to my personal Maven (repo.jamiemansfield.me).

License

Lorenz is licensed under the MIT License, this was chosen for its permissive nature - giving developers the freedom to do as they please with it, with no assurances from myself.

The MIT License (MIT)

Copyright (c) Jamie Mansfield <https://www.jamierocks.uk/>, Bleach <https://bleach.dev/> and contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

Discuss

Found an issue with Lorenz? Make an issue! We'd rather close invalid reports than have bugs go unreported :)

We have an IRC channel on EsperNet, #cadix, which is available for all registered users to join and discuss Lorenz and other Cadix projects.