Zhlt 34.0.3

Zhlt

.NET wrapper voor Vluzacn's ZHLT v34 — de Half-Life map compiler toolchain.

Bundelt hlcsg, hlbsp, hlvis en hlrad (Windows x64) in één NuGet-pakket en biedt een async .NET API om .map bestanden te compileren naar .bsp.

Installatie

dotnet add package Zhlt

De vier native executables worden automatisch naar de output-map gekopieerd via het meegeleverde MSBuild .targets bestand.

Snel voorbeeld

using Zhlt;

var compiler = new ZhltCompiler();

var result = await compiler.CompileAsync(
    @"C:\maps\mijnkaart.map",
    progress: new Progress<CompileProgress>(p =>
        Console.WriteLine($"[{p.Step}] {p.Message}")));

if (result.Success)
    Console.WriteLine($"BSP gereed: {result.BspFile}");
else
    Console.WriteLine("Compilatie mislukt.");

Uitgebreid voorbeeld

using Zhlt;
using Zhlt.Options;

var compiler = new ZhltCompiler(binDir: @"C:\tools\zhlt");

var options = new CompileOptions
{
    Steps = CompileSteps.All,

    Csg = new CsgOptions
    {
        WadAutoDetect = true,
        ClipType      = ClipType.Precise,
        Threads       = 4,
    },

    Bsp = new BspOptions(),

    Vis = new VisOptions
    {
        Mode = VisMode.Full,
    },

    Rad = new RadOptions
    {
        Extra      = true,
        Bounce     = 8,
        Scale      = 1.0f,
        Gamma      = 0.5f,
        VisMatrix  = VisMatrixMode.Sparse,
    },
};

using var cts = new CancellationTokenSource(TimeSpan.FromMinutes(30));

var result = await compiler.CompileAsync(
    @"C:\maps\mijnkaart.map",
    options,
    progress: new Progress<CompileProgress>(p =>
        Console.WriteLine($"[{p.Step}] {p.Message}")),
    ct: cts.Token);

foreach (var step in result.Steps)
    Console.WriteLine($"{step.Step}: exitcode {step.ExitCode}, succes={step.Success}");

if (!result.Success)
{
    var mislukt = result.Steps.Last();
    Console.Error.WriteLine($"Gestopt bij stap {mislukt.Step}:\n{mislukt.Output}");
}

Alleen bepaalde stappen uitvoeren

// Alleen CSG + BSP (geen vis/rad — bruikbaar voor snelle geometrie-check)
var options = new CompileOptions
{
    Steps = CompileSteps.Csg | CompileSteps.Bsp,
};

await compiler.CompileAsync(@"C:\maps\test.map", options);

API-overzicht

ZhltCompiler

CompileOptions

CompileResult

ToolResult

Annuleren

Geef een CancellationToken mee. Als het token geannuleerd wordt, stopt het actieve child-process en gooit CompileAsync een OperationCanceledException.

Vereisten

• .NET 10.0 of hoger
• Windows x64

Licentie

De ZHLT-tools zijn het werk van Vluzacn. Raadpleeg de originele ZHLT-licentie voor gebruiksvoorwaarden.