dhewm/dhewm3-sdk
0
0
Fork 0
mirror of https://github.com/dhewm/dhewm3-sdk.git synced 2025-02-21 11:20:52 +00:00
Code Issues Projects Releases Packages Wiki Activity

Changes to CMakeLists.txt and README for Fitz Packerton

Browse source
This commit is contained in:
Daniel Gibson 2018-12-09 04:57:50 +01:00
parent 114a99cf83
commit 392bf10da3
2 changed files with 16 additions and 49 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
CMakeLists.txt
View file

@ -1,12 +1,12 @@
cmake_minimum_required(VERSION 3.0 FATAL_ERROR)
project(dhewm3sdk)
option(BASE "Build the base (game/) game code" ON)
option(BASE "Build the base (game/) game code" OFF)
set(BASE_NAME "base" CACHE STRING "Name of the mod built from game/ (will result in \${BASE_NAME}.dll)")
set(BASE_DEFS "GAME_DLL" CACHE STRING "Compiler definitions for the mod built from game/")
option(D3XP "Build the d3xp/ game code" ON)
set(D3XP_NAME "d3xp" CACHE STRING "Name of the mod built from d3xp/ (will result in \${D3XP_NAME}.dll)")
set(D3XP_NAME "fitz" CACHE STRING "Name of the mod built from d3xp/ (will result in \${D3XP_NAME}.dll)")
set(D3XP_DEFS "GAME_DLL;_D3XP;CTF" CACHE STRING "Compiler definitions for the mod built from d3xp/")
option(ONATIVE "Optimize for the host CPU" OFF)

61
README.md
View file

@ -1,26 +1,20 @@
# dhewm3 Mod SDK
# Fitz Packerton
This repository contains an SDK that can be used to create modifications ("mods")
for (or port Doom3 mods to) [dhewm3](https://dhewm3.org).
This is the source of the "Fitz Packerton" game by Brendon Chung, Teddy Dief,
Ryan Cousins and Sarah Elmaleh, ported to the dhewm3 SDK.
It contains (mostly) the same source files as the original Doom3 SDK, but these
are taken from dhewm3 and **are licensed under GPLv3, not the SDK license**.
Another small difference is that this is built using [CMake](https://cmake.org/)
instead of SCons + VS Project files.
This means that you need CMake to build it, but don't worry, on Windows it can
create a Visual Studio Solution for you so you can program and compile with
Visual Studio like you might be used to.
The original source can be downloaded at http://blendogames.com/older.htm
## Some ports of existing Mods
Fitz Packerton is "A theatrical game about a man and the things he carries.
Pack what you must. Pray you won't need it."
This repository also contains ports of existing mods whichs authors released
the source under GPL; you can find these in their own branches:
[Classic Doom 3](https://github.com/dhewm/dhewm3-sdk/tree/cdoom),
[Denton's Enhanced Doom3](https://github.com/dhewm/dhewm3-sdk/tree/dentonmod),
[HardQore2](https://github.com/dhewm/dhewm3-sdk/tree/hardqore2) and
[Scarlet **Rivensin**: The Ruiner](https://github.com/dhewm/dhewm3-sdk/tree/rivensin)
You can get the game at https://teddydief.itch.io/fitz
You can find Win32 DLLs of those mods that work with dhewm3 1.5.0RC1 (and newer) at https://github.com/dhewm/dhewm3/releases/download/1.5.0_RC1/dhewm3_1.5.0_RC1_win32.zip
Fitz Packerton is actually an (experimental, short) standalone game, so you
don't even need the Doom3 gamedata to run it, only the Fitz data linked above.
you could start it with
`./dhewm3 +set fs_basepath /path/to/fitzpackerton/ +set fs_game fitz`
## How to build
@ -34,9 +28,9 @@ On Linux and similar the following should work (if you have cmake, make and GCC/
5. switch to build directory: `cd build`
6. create Makefile with CMake: `cmake ..`
7. compile the mod .so: `make -j4`
8. it (e.g. `dentonmod.so`) should now be in the build/ directory,
8. it (e.g. `fitz.so`) should now be in the build/ directory,
copy it to your dhewm3 install, where base.so and d3xp.so are
9. start the game with that mod, like `dhewm3 +set fs_game dentonmod`
9. start the game with that mod, like `dhewm3 +set fs_game fitz`
(Make sure to actually have the mods game data in the right directory as well;
the directory name should be the same as the game lib name, but without .so/.dylib/.dll,
@ -45,30 +39,3 @@ for example dentonmod/ for dentonmod.so)
On Windows it should be kinda similar, but you have to tell CMake to create
a Visual Studio solution for the VS version you're using, or Makefiles for
MinGW-w64 or whatever.
## How to port a Mod to dhewm3
The usual (easiest) way to port a mod is to make a diff between the mod's source
and the Doom3 SDK and apply the resulting patch to the vanilla game source (from the master branch).
Afterwards usually some manual work must be done to resolve patching conflicts and get the mod to compile.
Also, the CMakeLists.txt file must be adjusted (see the dentonmod branch for examples).
Please note that currently I only accept mods that are released under the
GPL license - the one used by Open Source Doom3 (i.e. *not* only the Doom3 SDK license) -
because neither the GPL nor the SDK license allow merging code from both licenses.
So please get permission from the mod authors first.
Yes, this unfortunately means that unless you manage to contact Sikkpin and get
his permission, there will be no Sikkmod for dhewm3 (and neither other mods that
use Sikkmod code) :-(
*(If you are Sikkpin, please get in touch!)*
### Getting in touch
If you are a mod author and want to release your mod's sourcecode under GPL,
but don't want to port it yourself (or don't have time or are unsure how)
please contact me, I can probably help you :-)
The easiest way to contact me is by creating an issue in this Github repository,
or by sending a DM to *caedes* in the [id Tech Forums](http://idtechforums.fuzzylogicinc.com/)
or by pinging *caedes* in the #iodoom3 IRC channel on FreeNode.