L2 Modding MCP

MCP Server for Lineage 2 / Unreal Engine 2.5 asset modding — 25 tools. Extract, modify, repackage textures (.utx), generate procedural meshes (.usx), parse animations (.ukx), sounds (.uax), and maps (.unr).

Features

Textures

Extract/inspect/import textures from .utx packages
Codec: DXT1/DXT3/DXT5/P8/RGBA8/RGB8/G16 (decode + encode)
Batch process: grayscale, invert, brightness, contrast, resize, blur, sharpen
Batch import: folder of PNGs → .utx in one step
Normal map, AO map, specular map generation
Texture atlas builder (grid packing)
PBR channel packer (metallic/roughness/AO/height → RGBA)

3D Meshes

Procedural castle generator (towers, walls, battlements, gate, keep, floor)
StaticMesh serializer for .usx packages
Export to OBJ and FBX ASCII
Import from OBJ back into the pipeline
LOD generator (vertex decimation, LOD0–LOD3)
Collision mesh generator (box, cylinder)
Procedural heightmap terrain (hills, mountains, plains, island, noise)

Animations (.ukx)

Parse AnimationSequence data (frames, bones, tracks)
Export to BVH format (Blender/Maya compatible)

Sounds (.uax)

List sound assets
Extract sounds to WAV (PCM and embedded WAV)

Maps (.unr)

Parse level data: brushes, static meshes, lights, player starts

Package Management

Package browser: scan directories for mesh↔texture cross-references
Package optimizer: remove dead exports, reduce size
Package comparator: diff two packages

Installation

pip install -e .

Usage with opencode

Add to opencode.json:

{
  "mcp": {
    "l2-modding": {
      "type": "local",
      "command": ["python", "-m", "l2_mcp.server"],
      "enabled": true
    }
  }
}

MCP Tools (25)

Textures

Tool	Description
`l2_list_package`	List all assets in .utx/.usx/.ukx
`l2_list_names`	List name table entries
`l2_texture_info`	Detailed texture info (format, mips, palette)
`l2_extract_texture`	Extract single texture to PNG
`l2_extract_all_textures`	Extract all textures to directory
`l2_import_texture`	Replace texture with PNG (repacks .utx)
`l2_batch_process`	Batch transform (grayscale, invert, etc.)
`l2_batch_import_textures`	Folder of PNGs → .utx
`l2_gen_normal_map`	Generate normal/AO/specular map
`l2_build_atlas`	Pack textures into atlas grid
`l2_pack_pbr`	Pack metallic/roughness/AO/height → RGBA

Meshes & Level Design

Tool	Description
`l2_create_castle`	Generate procedural 3D castle
`l2_generate_textures`	Generate stone/roof/floor/gate textures
`l2_create_usx_package`	Export meshes to .usx
`l2_export_obj`	Export meshes to OBJ or FBX
`l2_import_obj`	Import OBJ → mesh pipeline
`l2_generate_lods`	Generate LOD0–LOD3 by decimation
`l2_gen_collision`	Generate collision mesh (box/cylinder)
`l2_gen_terrain`	Procedural heightmap terrain

Animations

Tool	Description
`l2_animation_info`	List animations in .ukx
`l2_export_animation`	Export animation to BVH

Sounds

Tool	Description
`l2_list_sounds`	List sounds in .uax
`l2_extract_sound`	Extract sound to WAV
`l2_extract_all_sounds`	Extract all sounds to WAV

Package Management

Tool	Description
`l2_compare_packages`	Diff two packages
`l2_scan_directory`	Scan L2 folder for mesh↔texture refs
`l2_optimize_package`	Strip dead exports, reduce size
`l2_parse_map`	Read .unr maps (brushes, actors, lights)

Supported Texture Formats

ID	Format	Description
0	P8	256-color paletted
1	RGBA8	32-bit RGBA
3	DXT1/BC1	4 bpp, optional 1-bit alpha
4	RGB8	24-bit RGB
5	DXT3/BC2	8 bpp, explicit alpha
6	DXT5/BC3	8 bpp, interpolated alpha
B	G16	16-bit grayscale

Project Structure

src/l2_mcp/
├── server.py          # MCP server (25 tools)
└── upk/
    ├── reader.py      # Binary reader (compact indices, GUIDs)
    ├── package.py     # UPK parser (.utx/.usx/.ukx) + serializer
    ├── texture.py     # DXT codec + texture decode/encode
    ├── writer.py      # Package rebuilder / repacker
    ├── mesh.py        # StaticMesh serializer + primitives
    ├── castle.py      # Procedural castle generator
    ├── obj_io.py      # OBJ/FBX export
    ├── obj_import.py  # OBJ import
    ├── animation.py   # .ukx parser + BVH export
    ├── normal_map.py  # Normal/AO/specular map generator
    ├── batch_builder.py # Batch import + heightmap terrain
    ├── lod.py         # LOD generator + collision mesh
    ├── browser.py     # Package scanner + optimizer
    ├── atlas.py       # Texture atlas + PBR packer
    ├── sound.py       # .uax sound extractor
    └── unr.py         # .unr map parser

License

MIT