-
Notifications
You must be signed in to change notification settings - Fork 60
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Updating readme #871
base: develop
Are you sure you want to change the base?
Updating readme #871
Changes from 3 commits
c4cbf04
d518d91
241d0be
9307629
42d0887
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,132 @@ | ||
[![windows](https://github.com/TheAssemblyArmada/Thyme/workflows/windows/badge.svg)](https://github.com/TheAssemblyArmarda/Thyme/actions) | ||
[![linux](https://github.com/TheAssemblyArmada/Thyme/workflows/linux/badge.svg)](https://github.com/TheAssemblyArmarda/Thyme/actions) | ||
[![codecov](https://codecov.io/gh/TheAssemblyArmada/Thyme/branch/develop/graph/badge.svg)](https://codecov.io/gh/TheAssemblyArmada/Thyme) | ||
|
||
[![en-GB](https://img.shields.io/badge/lang-en--GB-green.svg)](https://github.com/TheAssemblyArmada/Thyme/README.md) | ||
[![de-DE](https://img.shields.io/badge/lang-de--DE-green.svg)](https://github.com/TheAssemblyArmada/Thyme/README.de-DE.md) | ||
|
||
**Thyme** ist eine Open-Source re-implementation des Spiels Command & Conquer Generals: Zero Hour. | ||
Zero Hour ist die Erweiterung des Spiels Command & Conquer Generals, welches 2003 veröffentlicht wurde. | ||
|
||
Dieses Projekt ist eine vollständige Neuprogrammierung von Command & Conquer Generals: Zero Hour, welche die original | ||
Dateien nutzt, um Funktionen zu unterstützen, welche noch nicht implementiert werden konnten. | ||
Unsere Intention ist es das Beheben von Fehlern zu ermöglichen, neue Funktionen zu implementieren und Plattformen zu | ||
unterstützen, welche vom Original nicht unterstützt werden. | ||
|
||
Bitte beachten Sie, dass wir in keiner Weise für EA arbeiten. | ||
EA hat dieses Project in keiner Weise befürwortet und unterstützt dieses Projekt nicht. | ||
|
||
|
||
## Chat | ||
|
||
Sie können sich mit uns auf unserem [Discord Kanal](https://discord.gg/UnWK2Tw) über das Projekt mit uns unterhalten | ||
und diskutieren. | ||
|
||
|
||
## Thyme ausführen | ||
|
||
**Stand heute (Feb. 2023) läuft Thyme ausschließlich unter Windows und muss selbst kompiliert werden.** | ||
|
||
Um Thyme ausführen zu können muss eine der folgenden Voraussetzungen erfüllt sein: | ||
|
||
1. Sie sind im Besitz einer Installation von einer Original-CD des Spiels in englischer Fassung | ||
(**NICHT** "Die ersten 10 Jahre", "The Ultimate Collection" oder ähnliche Sammlungen / Bundles), welche auf die Version | ||
1.04 aktualisiert sein **muss**. | ||
2. Sie kommen an die Datei `game.dat` von einer unter 1. genannten Installation heran und haben diese in Ihr | ||
Installationsverzeichnis von C&C Generals ZH kopiert | ||
|
||
Wenn Sie eine der genannten Möglichkeiten bereit haben können Sie beginnen die `thyme.dll` und die `avifil32.dll` zu | ||
kompilieren, wie [hier](#thyme-selbst-kompilieren) beschrieben. | ||
|
||
Wenn Sie die DLLs erfolgreich erstellt haben, kopieren Sie diese in das Installationsverzeichnis von C&C Generals ZH. | ||
|
||
Nun benennen Sie die `game.dat` im Installationsverzeichnis zu `game.exe` um (der Name spielt keine Rolle, | ||
solange die Datei die Endung .exe hat). | ||
|
||
Herzlichen Glückwunsch, Sie sollten nun Thyme durch das Ausführen der `game.exe` starten können! | ||
|
||
Um zu überprüfen, ob Thyme korrekt geladen wurde können Sie das Spiel von der Konsole / PowerShell aus starten. | ||
Klicken Sie hierzu in dem Installationsverzeichnis mit der rechten Maustaste, während sie die Shift-Taste gedrückt halten | ||
und wählen Sie "PowerShell-Fenster hier öffnen". | ||
Geben Sie nun folgendes ein und bestätigen Sie mit Enter: | ||
|
||
`.\game.exe -win` | ||
|
||
Dies sollte das Spiel im Fenster-Modus starten, so dass Sie den Fenstertitel sehen können, welcher den Begriff "Thyme" | ||
enthalten sollte. | ||
|
||
Wenn Sie irgendwelche Probleme haben sollten, wenn Sie dieser Anleitung folgen, können Sie uns jederzeit auf unserem | ||
[Discord Kanal](#chat) erreichen (in Englisch). | ||
|
||
|
||
### Haftungsausschluss | ||
Thyme wird stetig weiterentwickelt, sodass infolgedessen die Entwicklungsversionen sich möglicherweise nicht wie | ||
erwartet verhalten. | ||
Wir bemühen uns stets nummerierte "Releases" zu veröffentlichen, welche so frei von Fehlern wie möglich sind, jedoch | ||
können selbst diese sich unvorhergesehen verhalten. | ||
|
||
### Virenscanner-Warnungen | ||
Anti-Viren-Software wie der "Windows Defender" können Thyme fälschlicherweise als gefährlich einstufen. | ||
Hierbei handelt es sich um eine falsch-positive Meldung. Wir können versichern, dass es vollständig sicher ist Thyme zu | ||
nutzen. Wenn Sie immer noch unsicher bezüglich der Sicherheit sind, steht es Ihenen frei Thyme | ||
[selbst zu kompilieren](#thyme-selbst-kompilieren). | ||
|
||
### Häufige Probleme | ||
|
||
Ein schwarzer Bildschirm beim Start ist normalerweise ein zeichen das Sie ein "gentool" installiert haben. | ||
Aufgrund dessen wie Thyme aktuell funktioniert müssen Sie temporär die "gentool"-Datei `d3d8.dll` umbenennen oder entfernen. | ||
|
||
## Thyme selbst kompilieren | ||
|
||
Um eine funktionierende Datei zu erzeugen, müssen Sie das Projekt derzeit selbst mithilfe von Microsoft Visual Studio | ||
(2017 oder neuer) kompilieren. | ||
Das Kompilieren mit Clang gegen ein Windows SDK ist theoretisch für eine "Cross-compile" Lösung möglich aber zurzeit | ||
nicht getestet. | ||
|
||
Es ist ebenfalls möglich eine "Standalone Binary" zu kompilieren, wenn Sie das Kompilieren für andere Platformen testen wollen. | ||
|
||
Für [nähere Information](https://github.com/TheAssemblyArmada/Thyme/wiki/Compiling-Thyme) schauen Sie ins | ||
[Thyme Wiki](https://github.com/TheAssemblyArmada/Thyme/wiki). | ||
|
||
### Linux und MacOS | ||
|
||
Ein nativer Support für Linux und MacOS ist für die Zukunft geplant, wird jedoch aufgrund dessen, wie das Projekt entwickelt | ||
wird, für einige Zeit nicht möglich sein. | ||
Währenddessen sollte es möglich sein "Wine" unter Linux und MacOS zu nutzen. Dies ist jedoch nicht getestet worden. | ||
|
||
Wenn Sie an der Entwicklung des "Cross-Plattform" Aspekts des Projekts interessiert sind, ist es nun möglich ein | ||
"standalone" kompilat durch das Übergeben von ```-DSTANDALONE=TRUE``` an die CMake Konfiguration zu erzeugen. | ||
Die erzeugte "Binary" hat aktuell jedoch eine sehr eingeschränkte Funktionalität. | ||
|
||
|
||
## Etwas beitragen | ||
|
||
Wenn Sie daran interessiert sind etwas zu Thyme beizutragen benötigen Sie mindestens C++ Kenntnisse. | ||
Treten Sie dem Entwickler-Chat, welcher [oben](#chat) aufgeführt ist, bei um mehr Informationen zu erhalten, was Sie | ||
sonst noch brauchen und um die idc-Dateien für die aktuelle "Binary" zu erhalten. | ||
|
||
Für mehr Informationen können Sie ebenfalls einen Blick ins [Wiki](https://github.com/TheAssemblyArmada/Thyme/wiki) werfen. | ||
|
||
## Lizenz | ||
|
||
Der Quellcode, welcher in diesem "Repository" für Thyme zur Verfügung gestellt wird, ist unter der | ||
[GNU General Public License version 2](https://www.gnu.de/documents/gpl-2.0.de.html) oder neuer mit einer Ausnahme, | ||
welche es erlaubt den resultierenden Quellcode gegen eine geschlossene ("closed source") "Binary" zu verlinken, bis Thyme | ||
diese nicht länger benötigt, um lauffähig zu sein, lizenziert. | ||
|
||
## Andere Open-Source Projekte | ||
|
||
Unten ist eine Liste mit ähnlichen Projekten und den entsprechenden Originalspielen | ||
|
||
* [Alive](https://github.com/AliveTeam/alive_reversing) - Abe's Exodus | ||
* [dethrace](https://github.com/jeff-1amstudios/dethrace) - Carmageddon | ||
* [Devilution](https://github.com/diasurgical/devilution) - Diablo | ||
* [OpenDUNE](https://github.com/OpenDUNE/OpenDUNE) - Dune 2 | ||
* [OpenFodder](https://github.com/OpenFodder/openfodder) - Cannon Fodder | ||
* [OpenLoco](https://github.com/OpenLoco/OpenLoco) - Locomotion | ||
* [OpenMC2](https://github.com/LRFLEW/OpenMC2) - Midnight Club 2 | ||
* [OpenRCT2](https://github.com/OpenRCT2/OpenRCT2) - RollerCoaster Tycoon 2 | ||
* [OpenTTD](https://www.openttd.org) - Transport Tycoon Deluxe | ||
* [Vanilla Conquer](https://github.com/TheAssemblyArmada/Vanilla-Conquer) - Tiberian Dawn & Red Alert | ||
|
||
Es gibt ebenfalls eine [Wikipedia Seite für Open-Source Spiele](https://de.wikipedia.org/wiki/Liste_quelloffener_Computerspiele). |
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -2,6 +2,9 @@ | |
[![linux](https://github.com/TheAssemblyArmada/Thyme/workflows/linux/badge.svg)](https://github.com/TheAssemblyArmarda/Thyme/actions) | ||
[![codecov](https://codecov.io/gh/TheAssemblyArmada/Thyme/branch/develop/graph/badge.svg)](https://codecov.io/gh/TheAssemblyArmada/Thyme) | ||
|
||
[![en-GB](https://img.shields.io/badge/lang-en--GB-green.svg)](https://github.com/TheAssemblyArmada/Thyme/README.md) | ||
[![de-DE](https://img.shields.io/badge/lang-de--DE-green.svg)](https://github.com/TheAssemblyArmada/Thyme/README.de-DE.md) | ||
|
||
**Thyme** is an open source re-implementation of Command & Conquer Generals: Zero Hour. | ||
Zero Hour is the expansion pack of Command & Conquer Generals, released in 2003. | ||
|
||
|
@@ -19,17 +22,35 @@ You can chat and discuss the development of Thyme on our [Discord channel](https | |
|
||
## Running Thyme | ||
|
||
Currently Thyme can only be run on Windows. | ||
|
||
To run Thyme, you first need to have Command & Conquer Generals: Zero Hour installed. If you don't have the original game disc, Generals: Zero Hour can currently be bought most easily as a downloadable version that is part of the Command & Conquer The Ultimate Collection from [Origin](https://www.origin.com/en-us/store/command-and-conquer/command-and-conquer-the-ultimate-collection/ultimate-collection) or a third-party like [Amazon](https://www.amazon.com/Command-Conquer-Ultimate-Collection-PC/dp/B0095C0I4W). | ||
**As of now (Feb. 2023) Thyme only runs on Windows and must be compiled by yourself.** | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. There actually is a pre-compiled thyme, which another contributor has attempted to highlight with change #815. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. An this does work as expected? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Well if it's working and wanted I can include this in the readme, just let me know |
||
|
||
In order to run Thyme, you must meet one of the following prerequisites: | ||
|
||
1. You have an installation from the original English version on disc (**NOT** "The First Decade", | ||
"The Ultimate Collection" or any other bundled version) which **must** be patched to version 1.04 | ||
2. You have got hold of the game.dat from the installation referred to in point 1, and copied it to the root directory | ||
of the C6C General ZH installation | ||
Jan-NiklasB marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
||
If you have either of these options ready, you can proceed with building and compiling the `thyme.dll` and | ||
`avifil32.dll` as described [here](#building-thyme-yourself). | ||
|
||
Once you have successfully created these DLLs, copy them to the C&C Generals ZH root directory. | ||
|
||
Next, rename the game.dat in your ZH root directory to `game.exe` (the name doesn't matter as long as it has the .exe | ||
extension). | ||
|
||
Congratulations, you should now be able to start Thyme by running `game.exe`! | ||
|
||
To check if Thyme is loaded successfully, you can start the game from CMD or PowerShell | ||
(right click in the folder while holding down the Shift key and select "Open PowerShell") with the following command: | ||
|
||
If you wish to use our custom launcher without messing with patches or anything, only an install original Windows disc based English language version of Generals: Zero Hour (patched to version 1.04) is supported. That 1.04 patch can be downloaded [here](https://web.archive.org/web/20170130195007/http://ftp.ea.com/pub/eapacific/generals/generalszh/DownloadablePatches/GeneralsZH-104-english.exe) if your installation hasn't been updated yet. | ||
`.\game.exe -win` | ||
|
||
If you don't have the disc version or just want to run an executable directly, you will need to generate `thyme.exe` using the exe patching guide on the [Thyme Wiki](https://github.com/TheAssemblyArmada/Thyme/wiki). | ||
This should start the game in windowed mode, so you can see if the window has a name that includes "Thyme". | ||
|
||
Now you have the Generals: Zero Hour installation ready, you can [download the latest version](https://github.com/TheAssemblyArmada/Thyme/releases). You will have to expand the assets to download the latest thyme_x86_dll.zip. You could also [build Thyme yourself](#building-thyme-yourself). | ||
|
||
The easiest way to get Thyme to actually run is to place `thymelauncher.exe` together with `thyme.dll` in the Generals: Zero Hour installation folder. You can then launch `thymelauncher.exe` from that directory or create a shortcut to them. | ||
If you have any problems getting Thyme to work following this guide, feel free to contact us on our [Discord](#Chat). | ||
|
||
### Disclaimer | ||
|
||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do we really need German page for this? Adds maintenance overhead. I would expect that anyone tech savvy will be able to read English, after all source code is English too.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Well, was simply an idea as the translation isn't a big deal for me and I can tell you that there're way too much germans not abled to understand english in a acceptable way....
We could integrate the last change date in the top, so one will see if it's outdated