ExileCore2TexturesHandler 1.0.0

PoeTextureExtractor

A utility library designed specifically for ExileCore2 plugins to extract and convert Path of Exile texture files. This library handles both GGPK and Bundle file formats, converting DDS textures to PNG format. This is not a standalone application and requires ExileCore2 environment to function.

Features

• Supports both GGPK and Bundle file formats
• Automatic detection of POE installation type
• DDS to PNG conversion
• Texture archive creation for plugin distribution
• Configurable texture path filtering
• Progress and error logging support
• Thread-safe operations
• Memory-efficient processing

Requirements

• .NET 8.0
• LibGGPK3 (2.6.9 or higher)
• SixLabors.ImageSharp (3.1.6 or higher)
• Pfim (0.11.3 or higher)
• Path of Exile installation (Steam or Standalone)

Installation

1. Add the project as a reference to your ExileCore2 plugin
2. Or install via NuGet (if published)

Basic Usage

// Configure extraction options
var options = new ExtractionOptions
{
    PoePath = "C:/Program Files/Path of Exile",
    OutputPath = "Output/Textures",
    ArchivePath = "Output/textures.zip",
    NodePath = "Art/2DItems",  // Filter specific texture paths
    LogInfo = (msg) => Console.WriteLine(msg),
    LogError = (msg) => Console.WriteLine($"Error: {msg}"),
    LogDebug = (msg) => Console.WriteLine($"Debug: {msg}")
};

// Create and run the extractor
var extractor = new TextureExtractor(options);
extractor.Extract();

Configuration

The extractor can be configured with various options:

public class ExtractionOptions
{
    public string PoePath { get; set; }        // Path to POE installation
    public string OutputPath { get; set; }     // Where to save converted textures
    public string ArchivePath { get; set; }    // Where to save the final zip
    public string NodePath { get; set; }       // Filter for specific texture paths
    public Action<string>? LogInfo { get; set; }
    public Action<string>? LogError { get; set; }
    public Action<string>? LogDebug { get; set; }
}

License

MIT License

Credits

Created for use with ExileCore2 plugins.

Notes

• The library automatically handles both Steam and Standalone POE installations
• Processes only DDS files by default
• Creates a compressed archive suitable for plugin distribution
• Memory-efficient processing of large texture files