Vinifera is an open-source community collaboration project extending the Tiberian Sun engine.

Table of Contents

• Intro
• Community
• Downloading Vinifera
• Installing Tiberian Sun
• Building Vinifera
• Developers and Contributors
• Contributing
• Third Party Libraries
• Anti-virus Warning
• Legal
• License

Intro

Vinifera is an open source community project which aims to provide new features and bug-fixes fixes for Tiberian Sun.

Community

You can discuss the development and progress of this project on the C&C Modding Haven Discord server at the #vinifera-chat channel.

Downloading Vinifera

Nightly Builds

An automated build of the develop branch is uploaded daily.
These Nightly builds include the latest merged features and updates, but they are not considered stable and may contain unfinished or experimental functionality.
They are intended for active playtesting and for previewing upcoming changes — use them at your own risk.

There are two versions of the Nightly builds available: Standard and Compatibility.

• The Standard build is provided as-is, with no modifications for third-party integration.
• The Compatibility build includes changes to improve compatibility (where possible) with existing community patches. This version is also used for integration into the TS Client.

If you're unsure which version is right for you, feel free to ask a developer on the Discord server.

You can find the latest Nightly builds here.
Alternatively, the latest build from the most recent commit can be found here.

Releases

All official release builds are made from the master branch.
You can find all currently released versions of Vinifera here.

Installing Vinifera

With Freeware TS

1. Download the latest Vinifera nightly build
   Make sure to get the one not postfixed with ts_client
   → https://nightly.link/Vinifera-Developers/Vinifera/workflows/push/develop

2. Extract all files from the archive into the root directory of your Tiberian Sun installation (where Game.exe is located).

3. Run LaunchVinifera.exe to start the game with Vinifera.

With TS Client

Vinifera can be integrated into the latest TS Client.

You can use the Vinifera Beta version of the TS Client. To switch to it, go to Options → Updater tab → Update channel, and select Vinifera Beta.
After saving your settings and restarting the client, force an update to download the Vinifera build.

Alternatively, if you wish to install it manually, you can follow these steps:

1. Download the Vinifera nightly build postfixed with ts_client
   → https://nightly.link/Vinifera-Developers/Vinifera/workflows/push/develop

2. Extract the files into the TS Client directory.

3. Replace Game.exe with the version patched for Vinifera:

   • Go to the latest ts-patches GitHub release
   • Download ts-patches-TSCLIENT-master-#.zip
   • Extract GAME.EXE from the vinifera folder inside the archive
   • Replace the existing Game.exe in your TS Client directory

4. Create a file named VINIFERA.INI in the INI folder of the TS Client directory, and paste in the following contents:

    [General]
    ProjectName = Tiberian Sun          ; your project name here
    IconFile = Resources\tsicon.ico     ; your project's icon file here.
    CursorFile = Resources\arrow.cur    ; your project's cursor file here.
    SearchPaths = INI,MIX
    ; a blank line at the end is required for the game to parse the INI file correctly

5. Edit Resources\ClientDefinitions.ini:

   • Change GameExecutableNames=Game.exe to GameExecutableNames=LaunchVinifera.dat
   • Ensure ExtraCommandLineParams= includes -CD. (the dot is required) before any other flags.

Installing Tiberian Sun

NOTE: If you already have Tiberian Sun installed, you can skip this step;


Tiberian Sun was released as freeware by Electronic Arts in 2010 as a part of a promotional build-up to the release of Command & Conquer 4: Tiberian Twilight.

The original links to these downloads on the Electronic Arts servers are no longer active, but an unofficial mirror can be found at the C&C-Comm Center.
Below are direct links to the released disk images (English (US) only);
GDI Disk: Download.
NOD Disk: Download.
Firestorm Disk: Download.
_{Note: These disk images can be mounted as virtual drives using a variety of free programs.}

Otherwise, you can also purchase Tiberian Sun as part of the Command & Conquer The Ultimate Collection on Steam.

Updating the game to the latest version

This project currently only supports the latest English (US) version of Tiberian Sun due to technical limitations with patching the original binary.
GAME.EXE; v2.03[EN]; Monday 5th June, 2000 (21:26:42)
MD5: C2C58CBBF83AF0458DC44EF64A3C011F
You can download the v2.03 patch in English, French, German and Spanish.
Patch 2.03: Download.

Building Vinifera

NOTE: This section is only for people who wish to build the source code locally.

This project uses CMake (version 3.17 minimum) for its build system. You can use either CMake via the command line or using the CMake GUI.

The following components are needed to build this project:

• Microsoft Visual Studio 2022 for Windows
• MSVC v143 C++ x86/x64 build tools
• Windows 10 SDK

PLEASE NOTE: If you are using the CMake GUI, please make sure to set the output build directory to either outside the source tree or the ./build/ in the source tree root. This directory is ignored for your convenience in the main projects .gitignore file.

To run the built version, copy the compiled executables from the build directory into your Tiberian Sun game directory. Then, launch LaunchVinifera.exe to start the game with Vinifera enabled.

For more information on using Vinifera, refer to the documentation.
You’re also welcome to join the C&C Mod Haven Discord server and use the #vinifera-chat channel to ask questions or get support.

Developers and Contributors

Vinifera was originally concepted and created by CCHyper and tomsons26.

• ZivDero – Project Leader · Patreon
• Rampastring – Project Co-Leader · Patreon · Ko-fi

Special thanks to:

• Bittah Commander – author of the Dawn of the Tiberian Age mod, for extensive testing, design discussions, and providing the mod as a major testing platform.
• Crimsonum – author of the Rubicon mod, for dedicated testing and valuable feedback.
• E1 Elite – for consistent testing and thoughtful input on feature behavior and usability.
• OmniBlade – for early testing and contributions to the codebase; the injector is based on his foundational work.
• MarkJFox – for sidebar graphics and testing support.
• Kerbiter – for help with setting up and maintaining the project documentation.

We also appreciate the support and engagement of the C&C Mod Haven and Dawn of the Tiberium Age communities, as well as all the other testers and community members who provide feedback, report bugs, and help shape the project.

Some of the fixes and features present in Vinifera are based on previous work by the ts-patches contributors.

You can view the full list of contributors here.

Contributing

If you're interested in contributing to this project, basic knowledge of C++ is required. Experience with binary analysis and x86 assembly is highly recommended.

All contributions that align with the project's goals are welcome, as long as they follow our contribution guidelines. We encourage you to join the Discord server to discuss these guidelines with the active developers.

Pull requests that fall outside the scope of the project may still receive feedback and suggestions for alternative approaches or directions.

Third-Party Libraries

Vinifera makes use of third-party libraries to help implement features. Below is a list of libraries used by the project;

• LodePNG
• Image-Resampler
• XZip

Anti-virus Warning

Anti-virus software like Windows Defender could mark the binaries built from the DLL configuration in this project as a virus. We would like to assure that this is a false-positive and that these is completely safe to use. If you are still unsure about running these binaries on your system, your are welcome to join our Discord server where one of the developers can explain the process used by this project in detail.

Legal

This project is an unofficial open-source community collaboration project for preservation, modding and compatibility purposes. EA has not endorsed and does not support this product. Command & Conquer is an Electronic Arts Inc. brand. All Rights Reserved.

No assets, texts, artwork or other media from the original game(s) is included in this repository. We do not condone piracy in any way, shape or form and encourgage users to legally own the original game(s).

The video game "Command & Conquer: Tiberian Sun" is copyright © 1999 Westwood Studios. All Rights Reserved.
Westwood Studios is a trademark or registered trademark of Electronic Arts in the U.S. and/or other countries. All rights reserved.

License

The source code in this repository is licensed under the GNU General Public License version 3.
Please refer to the accompanying LICENSE file for full details.

This project also incorporates source code released by Electronic Arts Inc. under the same GNU GPL v3 license.
These contributions originate from the following official repositories:

• C&C Remastered Collection
• C&C Red Alert
• C&C Tiberian Dawn
• C&C Renegade
• C&C Generals: Zero Hour

They are used in accordance with the original license terms and include additional terms as permitted under Section 7 of the GNU GPL v3:

_{Code within this repository can not be used for commercial or financial software as dictated by the license released by Electronic Arts Inc. (see ADDITIONAL TERMS - SECTION 7 of LICENSE)}

_{No trademark or publicity rights are granted. This license does NOT give you any right, title or interest in "Command & Conquer" or any other Electronic Arts Inc. trademark. You may not distribute any modification of this program using any Electronic Arts trademark or claim any affiliation or association with Electronic Arts Inc. or its affiliates or their employees.}

_{Any propagation or conveyance of this program must include this copyright notice and these terms.}

_{If you convey this program (or any modifications of it) and assume contractual liability for the program to recipients of it, you agree to indemnify Electronic Arts for any liability that those contractual assumptions impose on Electronic Arts.}

_{You may not misrepresent the origins of this program; modified versions of the program must be marked as such and not identified as the original program. This disclaimer supplements the one included in the General Public License.}

_{TO THE FULLEST EXTENT PERMISSIBLE UNDER APPLICABLE LAW, THIS PROGRAM IS PROVIDED TO YOU "AS IS," WITH ALL FAULTS, WITHOUT WARRANTY OF ANY KIND, AND YOUR USE IS AT YOUR SOLE RISK. THE ENTIRE RISK OF SATISFACTORY QUALITY AND PERFORMANCE RESIDES WITH YOU. ELECTRONIC ARTS DISCLAIMS ANY AND ALL EXPRESS, IMPLIED OR STATUTORY WARRANTIES, INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT OF THIRD PARTY RIGHTS, AND WARRANTIES (IF ANY) ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. ELECTRONIC ARTS DOES NOT WARRANT AGAINST INTERFERENCE WITH YOUR ENJOYMENT OF THE PROGRAM; THAT THE PROGRAM WILL MEET YOUR REQUIREMENTS; THAT OPERATION OF THE PROGRAM WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT THE PROGRAM WILL BE COMPATIBLE WITH THIRD PARTY SOFTWARE OR THAT ANY ERRORS IN THE PROGRAM WILL BE CORRECTED. NO ORAL OR WRITTEN ADVICE PROVIDED BY ELECTRONIC ARTS OR ANY AUTHORIZED REPRESENTATIVE SHALL CREATE A WARRANTY. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF OR LIMITATIONS ON IMPLIED WARRANTIES OR THE LIMITATIONS ON THE APPLICABLE STATUTORY RIGHTS OF A CONSUMER, SO SOME OR ALL OF THE ABOVE EXCLUSIONS AND LIMITATIONS MAY NOT APPLY TO YOU.}