README.md

Sims.Far

A library to extract and create The Sims 1 .far files.

Installation

You can install Sims.Far as a nupkg from nuget.org.

Usage

Extract everything from UIGraphics.far:

using Sims.Far;

static void Main(string[] args)
{
    var far = Far.Read(@"C:\Program Files (x86)\Maxis\The Sims\UIGraphics\UIGraphics.far");
    var outputFolder = "somedir";
    foreach (var file in far.Files)
    {
        var directories = Path.GetDirectoryName(file.Name);
        if (!string.IsNullOrWhiteSpace(directories))
        {
            var combined = Path.Join(outputFolder, directories);
            if (!Directory.Exists(combined))
            {
                Directory.CreateDirectory(combined);
            }
        }
        var outPath = Path.Join(outputFolder, file.Name);
        file.Extract(outPath);
    }
}

Create a new far file with some content and write it to newfar.far:

using Sims.Far;

static void Main(string[] args)
{
    var files = new List<FarFile> { new("Some file name", "Some content"u8.ToArray()) };
    var far = new Far(files);
    far.Write("newfar.far");
}

Credits

https://web.archive.org/web/20220410061532/https://simtech.sourceforge.net/tech/far.html