# acmi/l2crypt architecture

> Architecture diagram of the GitHub repository acmi/l2crypt, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/acmi/l2crypt
- Repository: https://github.com/acmi/l2crypt

## Overview

L2crypt is a Java library for decrypting and encrypting Lineage 2 files. A caller supplies a file or stream; L2Crypt reads the file header, selects a version-specific stream, and exposes transformed bytes. The supported formats span XOR, Blowfish, RSA, and LameCrypt wrapping. Output streams provide the corresponding encryption path, with finishable streams handling formats that need finalization. The graph follows the dispatch and component references shown in the README and source index; unsampled implementations are represented by their exact tree paths, without inferring additional internal calls.

Main entry points: [`src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java) (Header and dispatch), [`src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xOutputStream.java`](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xOutputStream.java) (Blowfish output), [`src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xOutputStream.java`](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xOutputStream.java) (RSA output), [`src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120InputStream.java`](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120InputStream.java) (Version 120 input)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and utilities"]
  node_crypt["Header and dispatch<br/>[L2Crypt.java]"]
  node_exception["Crypto errors"]
  node_finish["Output finalization"]
end

subgraph group_xor["XOR formats"]
  node_xor120["Version 120 cipher<br/>[L2Ver120.java]"]
  node_xor120in["Version 120 input"]
  node_xor120out["Version 120 output"]
  node_xor1x1["Version 1x1 cipher<br/>[L2Ver1x1.java]"]
  node_xor1x1in["Version 1x1 input"]
  node_xor1x1out["Version 1x1 output"]
end

subgraph group_blowfish["Blowfish format"]
  node_bf["Blowfish cipher<br/>[L2Ver21x.java]"]
  node_bfengine["Blowfish engine"]
  node_bfin["Blowfish input"]
  node_bfout["Blowfish output"]
end

subgraph group_rsa["RSA and LameCrypt"]
  node_rsa["RSA keys<br/>[L2Ver41x.java]"]
  node_rsain["RSA input"]
  node_rsaout["RSA output"]
  node_lame["LameCrypt wrapper<br/>[LameCrypt.java]"]
end

node_caller(("Library caller"))

node_caller -->|"requests streams"| node_crypt
node_crypt -->|"dispatches decrypt"| node_xor1x1in
node_crypt -->|"dispatches encrypt"| node_xor1x1out
node_crypt -->|"dispatches decrypt"| node_xor120in
node_crypt -->|"dispatches encrypt"| node_xor120out
node_crypt -->|"dispatches decrypt"| node_bfin
node_crypt -->|"dispatches encrypt"| node_bfout
node_crypt -->|"dispatches decrypt"| node_rsain
node_crypt -->|"dispatches encrypt"| node_rsaout
node_crypt -->|"wraps streams"| node_lame
node_bfin -->|"decrypts blocks"| node_bfengine
node_bfout -->|"encrypts blocks"| node_bfengine
node_rsain -->|"uses key constants"| node_rsa
node_rsaout -->|"uses key constants"| node_rsa
node_bfout -->|"extends finalizer"| node_finish
node_rsaout -->|"extends finalizer"| node_finish
node_xor120in -->|"uses cipher logic"| node_xor120
node_xor120out -->|"uses cipher logic"| node_xor120

click node_crypt "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java"
click node_exception "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/CryptoException.java"
click node_finish "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/FinishableOutputStream.java"
click node_xor120 "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120.java"
click node_xor120in "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120InputStream.java"
click node_xor120out "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120OutputStream.java"
click node_xor1x1 "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver1x1.java"
click node_xor1x1in "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver1x1InputStream.java"
click node_xor1x1out "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver1x1OutputStream.java"
click node_bf "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21x.java"
click node_bfengine "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/blowfish/BlowfishEngine.java"
click node_bfin "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xInputStream.java"
click node_bfout "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xOutputStream.java"
click node_rsa "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41x.java"
click node_rsain "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xInputStream.java"
click node_rsaout "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xOutputStream.java"
click node_lame "https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/lame/LameCrypt.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_crypt,node_exception,node_finish toneBlue
class node_xor120,node_xor120in,node_xor120out,node_xor1x1,node_xor1x1in,node_xor1x1out toneAmber
class node_bf,node_bfengine,node_bfin,node_bfout toneMint
class node_rsa,node_rsain,node_rsaout,node_lame toneRose
class node_caller toneIndigo
```

## Components

### API and utilities

- [Header and dispatch](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java): `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`
- [Crypto errors](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/CryptoException.java): `src/main/java/acmi/l2/clientmod/crypt/CryptoException.java`
- [Output finalization](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/FinishableOutputStream.java): `src/main/java/acmi/l2/clientmod/crypt/FinishableOutputStream.java`

### XOR formats

- [Version 120 cipher](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120.java): `src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120.java`
- [Version 120 input](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120InputStream.java): `src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120InputStream.java`
- [Version 120 output](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120OutputStream.java): `src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120OutputStream.java`
- [Version 1x1 cipher](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver1x1.java): `src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver1x1.java`
- [Version 1x1 input](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver1x1InputStream.java): `src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver1x1InputStream.java`
- [Version 1x1 output](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver1x1OutputStream.java): `src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver1x1OutputStream.java`

### Blowfish format

- [Blowfish cipher](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21x.java): `src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21x.java`
- [Blowfish engine](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/blowfish/BlowfishEngine.java): `src/main/java/acmi/l2/clientmod/crypt/blowfish/BlowfishEngine.java`
- [Blowfish input](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xInputStream.java): `src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xInputStream.java`
- [Blowfish output](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xOutputStream.java): `src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xOutputStream.java`

### RSA and LameCrypt

- [RSA keys](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41x.java): `src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41x.java`
- [RSA input](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xInputStream.java): `src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xInputStream.java`
- [RSA output](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xOutputStream.java): `src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xOutputStream.java`
- [LameCrypt wrapper](https://github.com/acmi/l2crypt/blob/master/src/main/java/acmi/l2/clientmod/crypt/lame/LameCrypt.java): `src/main/java/acmi/l2/clientmod/crypt/lame/LameCrypt.java`

### Other components

- **Library caller**

## Connections

- Library caller → Header and dispatch: requests streams (evidence: `README.MD`)
- Header and dispatch → Version 1x1 input: dispatches decrypt (evidence: `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`)
- Header and dispatch → Version 1x1 output: dispatches encrypt (evidence: `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`)
- Header and dispatch → Version 120 input: dispatches decrypt (evidence: `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`)
- Header and dispatch → Version 120 output: dispatches encrypt (evidence: `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`)
- Header and dispatch → Blowfish input: dispatches decrypt (evidence: `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`)
- Header and dispatch → Blowfish output: dispatches encrypt (evidence: `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`)
- Header and dispatch → RSA input: dispatches decrypt (evidence: `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`)
- Header and dispatch → RSA output: dispatches encrypt (evidence: `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`)
- Header and dispatch → LameCrypt wrapper: wraps streams (evidence: `src/main/java/acmi/l2/clientmod/crypt/L2Crypt.java`)
- Blowfish input → Blowfish engine: decrypts blocks (evidence: `src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xInputStream.java`)
- Blowfish output → Blowfish engine: encrypts blocks (evidence: `src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xOutputStream.java`)
- RSA input → RSA keys: uses key constants (evidence: `src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xInputStream.java`)
- RSA output → RSA keys: uses key constants (evidence: `src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xOutputStream.java`)
- Blowfish output → Output finalization: extends finalizer (evidence: `src/main/java/acmi/l2/clientmod/crypt/blowfish/L2Ver21xOutputStream.java`)
- RSA output → Output finalization: extends finalizer (evidence: `src/main/java/acmi/l2/clientmod/crypt/rsa/L2Ver41xOutputStream.java`)
- Version 120 input → Version 120 cipher: uses cipher logic (evidence: `src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120InputStream.java`)
- Version 120 output → Version 120 cipher: uses cipher logic (evidence: `src/main/java/acmi/l2/clientmod/crypt/xor/L2Ver120OutputStream.java`)
