Skip to main content
Glama

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

Related MCP server: Unreal Engine MCP

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

Available Tools

18 tools
l2_animation_infoB

List and inspect animations in a .ukx package.

Inputs: filepath (required).

l2_batch_import_texturesB

Import all PNG/BMP images from a directory into a new .utx package.

Inputs: input_dir (required), output, package_name, generate_mips, +1 more.

l2_batch_processB

Apply a batch operation to all textures in a package (grayscale, invert, brightness, contrast, resize, blur, sharpen).

Inputs: filepath (required), operation (required), output, params.

l2_compare_packagesB

Compare two package files and report differences in exports.

Inputs: filepath1 (required), filepath2 (required).

l2_create_castleA

Generate a procedural 3D castle mesh for Lineage 2 (.usx). Creates towers, walls, battlements, gate, keep, and floor. Configurable dimensions.

Inputs: gate, keep, depth, width, +15 more.

l2_create_usx_packageB

Export generated castle meshes to a .usx package file for Lineage 2.

Inputs: output, mesh_index.

l2_export_animationB

Export an animation from .ukx to BVH format (Blender/Maya compatible).

Inputs: filepath (required), name, index, output.

l2_export_objB

Export generated/imported meshes to OBJ or FBX format for editing in Blender/Maya.

Inputs: format, output, filepath, mesh_index.

l2_extract_all_texturesA

Extract all textures from a package to a directory as PNG files.

Inputs: filepath (required), output_dir, class_filter.

l2_extract_textureB

Extract a single texture from a .utx package and save as PNG.

Inputs: filepath (required), name, index, output.

l2_generate_texturesB

Generate procedural stone/wall/roof/floor texture images for the castle.

Inputs: size, output_dir.

l2_gen_normal_mapB

Generate normal/height/AO/specular maps from a diffuse texture.

Inputs: image_path (required), blur, mode, output, +2 more.

l2_gen_terrainB

Generate procedural heightmap terrain (hills, mountains, plains, island, noise).

Inputs: seed, size, output, terrain_type.

l2_import_objA

Import an OBJ file into the mesh pipeline. Can be exported to .usx afterwards with l2_create_usx_package.

Inputs: filepath (required).

l2_import_textureB

Replace a texture in a .utx file with a PNG image. Generates a new package file.

Inputs: filepath (required), image_path (required), name, index, +1 more.

l2_list_namesA

List all names in the package's name table. Optionally filter by substring.

Inputs: filepath (required), filter.

l2_list_packageA

List all assets in a Lineage 2 / UE2.5 package file (.utx, .usx, .ukx). Shows exports with their class, size, and offset.

Inputs: filepath (required).

l2_texture_infoA

Get detailed information about a texture in a package (format, size, mip levels, palette).

Inputs: filepath (required), name, index.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 18 tools

    Disambiguation5/5

    Each tool targets a distinct operation on L2 package assets (listing, extracting, importing, generating, comparing). No overlapping purposes; even similar tools like l2_extract_texture and l2_extract_all_textures are clearly differentiated by scope.

    Naming Consistency5/5

    All tools follow the 'l2_verb_noun' pattern consistently, using snake_case. Verbs like list, compare, extract, import, generate, create are predictably placed, making the set easy to navigate.

    Tool Count5/5

    With 18 tools covering textures, meshes, animations, packages, and procedural generation, the count fits the modding domain well. Each tool serves a clear purpose without redundancy.

    Completeness4/5

    The toolset covers most modding workflows: texture and package management, mesh import/export, animation export, procedural generation. Minor gaps exist (e.g., no animation import/creation, no generic package creation for non-castle assets), but core operations are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Open-source, engine-agnostic MCP server shared by Unity-MCP, Godot-MCP, and Unreal-MCP. Additionally you can use AI Game Dev app (https://ai-game.dev) to generate images, video, audio, 3D, rig, animation and much more.
      19
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for AI-driven Blender↔Unreal Engine bridge, providing 62 tools for 3D modeling, scene validation, and asset transfer across both engines.
      1
      MIT

    Appeared in Searches