EarthTool

A comprehensive suite of tools for working with Earth 2150 game data files.

Mesh artists: Start with the Mesh Artist Quick Start and Cheat Sheet for Blender export settings, canonical import, animation-track setup, and every supported attachment identifier.

• WD Archives - Extract, create, and modify WD archive files
• TEX Textures - Convert TEX format to PNG and other image formats
• MSH Models - Safely read, validate, write, and author framed MSH assets
• glTF Interchange - Export static MSH and supported Group, sprite, ribbon, attached-particle, procedural, and resource-backed ScalableObject dynamic MSH to GLB or glTF
• PAR Parameters - Parse and edit game parameter files
• GUI Applications - User-friendly graphical interfaces for archive and parameter management

Command-line tool for batch processing and automation.

Requirements: .NET Runtime 8.0 x64

Usage:

EarthTool.CLI.exe --help

Download the latest release or build from source.

Desktop application with visual interface for managing WD archives.

Features:

• Browse archive contents
• Extract files (single or batch)
• Add files to archives
• Create new archives
• View file information and statistics

See EarthTool.WD.GUI/README.md for detailed documentation.

Desktop application for viewing and editing Earth 2150 parameter files.

Features:

• Browse and search parameter entities
• Edit entity properties with validation
• View entity relationships and dependencies
• Save modified parameter files
• Type-safe editing with real-time validation

git clone https://github.com/Arkezar/EarthTool.git
cd EarthTool
dotnet build

Build CLI:

cd EarthTool.CLI
dotnet publish -c Release

Build WD GUI:

cd EarthTool.WD.GUI
dotnet publish -c Release

Build PAR GUI:

cd EarthTool.PAR.GUI
dotnet publish -c Release

• EarthTool.Common - Shared interfaces and utilities
• EarthTool.Common.GUI - Shared GUI components and services (Avalonia UI)
• EarthTool.WD - WD archive format support
• EarthTool.TEX - TEX texture format support
• EarthTool.MSH - MSH 3D model format support
• EarthTool.GLTF - GLB and glTF artist interchange
• EarthTool.PAR - Parameter file support
• EarthTool.CLI - Command-line interface
• EarthTool.WD.GUI - Archive manager GUI (Avalonia UI)
• EarthTool.PAR.GUI - Parameter editor GUI (Avalonia UI)

The current MSH CLI is msh export and msh import. Import canonically regenerates a new immutable MSH asset from GLB or separate glTF; it never restores an embedded source MSH or has an edit mode. Graphics artists should use the Mesh Artist Quick Start and Cheat Sheet. Users of the removed COLLADA workflow should read the migration guide.

The project includes comprehensive test suites:

dotnet test

Contributions are welcome! Please feel free to submit pull requests or open issues.

Special thanks to members of Inside Earth discord:

• Guardian#2935 - information on mount points, part offsets, model build templates
• Ninetailed#9436 - information on lights data

This project is licensed under the MIT License - see the LICENSE file for details.