thexds / vivianne

Need For Speed 3/4 modding tool

Vivianne

Vivianne is a modern Need For Speed 3/4 All-in-one VIV and FSH/QFS editor that aims to provide you with tools to edit textures, car performance and fedata files inside VIVs, as well as serial number scan, FSH<->QFS conversion and Car re-classificator. Mod installer/manager planned as well.

WARNING: This is a very early, work in progress app. A lot of things will not work correctly.

Building

Vivianne can be built on any platform or CI environment supported by dotnet. although building on Windows is recommended.

Prerequisites

• .Net SDK 8.0.

Build Vivianne

dotnet build ./src/Vivianne.sln

The resulting binaries will be in the ./Build/bin directory.

Contribute

If Vivianne is useful to you, or if you're interested in donating to sponsor the project, feel free to to a donation via PayPal, BuyMeACoffee or just contact me directly.

Sadly, I cannot offer other means of sending donations as of right now due to my country (Honduras) not being supported by almost any platform.

vivianne's Issues

FSH Texture editor

As a modder, so I can edit FSH/QFS files, I want a view that allows me to edit the textures stored in FSH/QFS files.

Carp editor

As a user, so I can edit carp.txt files, I need a view where I can easily modify car performance data and it automatically saves the changes on the carp.txt file.

FCE renderer

As an user, so I can preview an FCE mesh, I want a view that can render FCE files, with options to hide/show particular parts, textures, reflections and shading.

FCE parsing

As a developer, so I can use FCE data throughout Vivianne, I want a FCE parser and entity model to hold FCE mesh data in memory.

Main VIV ViewModel does not refresh upon save

The main VIV ViewModel does not update either the data in memory nor the data in View.

FSH parsing

As a developer, so I can use FSH data throughout Vivianne, I want a FSH parser class and entity model that contains the FSH data in memory.

VIV read/write functionality

BNK parsing

As a developer, so I can use BNK audio data throughout Vivianne, I want a BNK parser and entity model to hold BNK audio data in memory.

VIV dashboard

As a modder, so I can glance at some important properties and general information about a viv file, I need a view that displays these fields and general properties about a VIV file and its contents.

Carp parsing

As a developer, so I can use car performance data throughout Vivianne, I want a carp parser and entity model that can hold car performance data in memory.

VIV extractor

As a modder, so I can extract files from a VIV, I want a button that allows me to extract all files from the currently open VIV.

Fedata editor

As a modder, so I can edit FeData files, I want a view that allows me to edit a fedata.* file with all of its fields.

Ongoing Documentation and cleanup tasks

As a developer, so I can understand and read through the code easily, I want documentation to be created and cleanup operations to be made when appropriate.

FeData Parsing

As a developer, so I can use FeData throughout Vivianne, I want a class that represents FeData in memory with support for all well-known fields.

Need For Speed 4 VIV support

As a developer, so I can read NFS4 VIV files, I want the VIV parser to be able to recognize and parse NFS4 VIV files, which may contain alignment bytes that break the current NFS3 VIV parser.

VIV content edition

As a modder, so I can edit the contents of a VIV file, I want that any available editors (FSH, QFS, FeData, Carp) can write changes to the VIV directory loaded in memory.

Texture viewer

As a modder, so I can preview car textures, I want a view that allows me to load TGA files.

FSH palette support

Some GIMX textures inside FSH files require the presence of a palette to represent the colors correctly.