Vinifera-Developers / Vinifera

Vinifera is a C&C: Tiberian Sun engine extension implementing new logics and fixing bugs.
GNU General Public License v3.0
46 stars 10 forks source link
command-and-conquer open-source tiberian-sun westwood-studios

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

GitHub Workflow Status (develop) GitHub Workflow Status (develop) Documentation Status GitHub

Table of Contents

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

Every day, an automated build of the develop branch is uploaded. These builds contain all the latest merged features, but are not yet considered stable for release. These builds are to help provide an insight to what the next release will contain and should only be used for active playtesting purposes only.

There are two version of the Nightly builds available; "Standard" and "Comptability". The Standard build is as-is, where as the Comptability build has modifications to ensure compatability (where possible) with existing community patches. If you are unsure which version is best for you, you can ask a developer on the Discord server. You can find the latest Nightly builds here. Alternatively, you can find the latest build from the most recent commit here.

Release

All release builds are made from the master branch. Vinifera is currently working towards its first release so there are no releases available yet, but they will be uploaded to here.

Installing Vinifera

Download your desired version. Once the desired download is finished, extract the contents of the archive into to the Tiberian Sun directory. Run LaunchVinifera.exe to start the game with the Vinifera extension applied.

Installing Tiberian Sun

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

Tiberian Sun
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 Ultimate Collection on EA's Origin service.

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:

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 built executables from the build directory to the Tiberian Sun directory. Run LaunchVinifera.exe to start the game with the Vinifera project applied. For more information on how to use Vinifera, please read the documention or you can join the C&C Modding Haven Discord server and use the #vinifera-chat channel.

Contributing

If you are interested in contributing to this project, you will need some knowledge of C++ as a minimum requirement, but it is recommended you have experience with binary analysis and x86 assembly. All contributions towards this projects goals are welcome, provided they follow the contribution guidelines. Please join the Discord server to discuss these guidelines with the active developers. Any pull requests that do not fit within the project guidelines will be recommended to be developed as a downstream project.

Third-Party Libraries

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

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. This project has no direct affiliation with Electronic Arts Inc. and/or Command & Conquer. 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 provided in this repository is licenced under the GNU General Public License version 3. Please see the accompanying LICENSE file.

Some source code released by Electronic Arts Inc. for the C&C Remastered Collection is used in this project and is licenced under the GNU General Public License version 3. These source files are marked in the headers for easy identification and are applied with the following additional terms below, copied from the LICENSE file included in the C&C Remastered Collection source code repository.

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.