L2 Modding MCP
This server provides 25 tools for modding Lineage 2 / Unreal Engine 2.5 assets, covering textures, 3D meshes, animations, sounds, maps, and package management.
Texture Operations
Inspect, extract (single or all to PNG), import/replace, and batch process textures in
.utxfiles (supports DXT1/3/5, P8, RGBA8, RGB8, G16)Batch operations: grayscale, invert, brightness, contrast, resize, blur, sharpen
Generate normal, height, AO, and specular maps from a diffuse texture
Build texture atlases and pack PBR channels (metallic/roughness/AO/height to RGBA)
Batch import a folder of PNG/BMP/TGA/JPG images into a new
.utxpackage
3D Mesh & Level Design
Generate procedural castles (configurable towers, walls, battlements, gates, keeps) and heightmap terrains (hills, mountains, plains, islands)
Export meshes to Unreal Engine
.usxpackages, OBJ, or FBXImport OBJ files for re-export to
.usxGenerate LOD0–LOD3 levels via vertex decimation and create box/cylinder collision meshes
Animations
List, inspect, and export animation sequences from
.ukxpackages to BVH format (Blender/Maya compatible)
Sounds
List and extract individual or all sounds from
.uaxpackages to WAV format
Maps
Parse
.unrlevel files to inspect brushes, static mesh actors, lights, and player starts
Package Management
Compare two packages to identify export differences
Scan directories for mesh↔texture cross-references
Optimize packages by removing dead exports
List all assets and name table entries in
.utx/.usx/.ukxfiles
Provides tools for modding Unreal Engine 2.5 assets, specifically Lineage 2, including extracting, modifying, and repackaging textures (.utx) and generating procedural 3D meshes (.usx).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@L2 Modding MCP extract all textures from armor.utx"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
.utxpackagesCodec: DXT1/DXT3/DXT5/P8/RGBA8/RGB8/G16 (decode + encode)
Batch process: grayscale, invert, brightness, contrast, resize, blur, sharpen
Batch import: folder of PNGs →
.utxin one stepNormal 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
.usxpackagesExport 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 |
| List all assets in .utx/.usx/.ukx |
| List name table entries |
| Detailed texture info (format, mips, palette) |
| Extract single texture to PNG |
| Extract all textures to directory |
| Replace texture with PNG (repacks .utx) |
| Batch transform (grayscale, invert, etc.) |
| Folder of PNGs → .utx |
| Generate normal/AO/specular map |
| Pack textures into atlas grid |
| Pack metallic/roughness/AO/height → RGBA |
Meshes & Level Design
Tool | Description |
| Generate procedural 3D castle |
| Generate stone/roof/floor/gate textures |
| Export meshes to .usx |
| Export meshes to OBJ or FBX |
| Import OBJ → mesh pipeline |
| Generate LOD0–LOD3 by decimation |
| Generate collision mesh (box/cylinder) |
| Procedural heightmap terrain |
Animations
Tool | Description |
| List animations in .ukx |
| Export animation to BVH |
Sounds
Tool | Description |
| List sounds in .uax |
| Extract sound to WAV |
| Extract all sounds to WAV |
Package Management
Tool | Description |
| Diff two packages |
| Scan L2 folder for mesh↔texture refs |
| Strip dead exports, reduce size |
| 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 parserLicense
MIT
Available Tools
18 toolsl2_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
Scored across 18 tools
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.
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.
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.
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
Related MCP Connectors
An MCP server that provides asset auto generator
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceOpen-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.19Apache 2.0
- AlicenseBqualityCmaintenanceAn MCP server that lets an AI agent drive Unreal Engine 5: create projects, import assets, build levels and Blueprints, configure replication, compile C++, run Play In Editor and package the game.100187 PyPI6MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for AI-driven Blender↔Unreal Engine bridge, providing 62 tools for 3D modeling, scene validation, and asset transfer across both engines.1MIT
- AlicenseAqualityDmaintenanceMCP server that enables natural language listing, unpacking, and exporting of Unreal Engine game resources via umodel, including AES-encrypted pak support.1316 npmMIT