Skip to content

Latest commit

 

History

History
493 lines (400 loc) · 19.1 KB

README.md

File metadata and controls

493 lines (400 loc) · 19.1 KB

Serious Sam Classic

Build status License: GPL v2 GitHub release (latest by date) Github downloads

This is the source code for Serious Engine v.1.10, including the following projects:

  • DedicatedServer
  • Ecc The Entity Class Compiler, a custom build tool used to compile *.es files
  • Engine Serious Engine 1.10
  • EngineGUI Common GUI things for game tools
  • EntitiesMP All the entity logic
  • GameGUIMP Common GUI things for game tools
  • GameMP All the game logic
  • Modeler Serious Modeler
  • RCon Used to connect to servers using an admin password
  • SeriousSam The main game executable
  • SeriousSkaStudio Serious Ska Studio
  • WorldEditor Serious Editor
  • DecodeReport Used to decode crash *.rpt files
  • Depend Used to build a list of dependency files based on a list of root files
  • LWSkaExporter Exporter for use in LightWave
  • MakeFONT Used for generating *.fnt files
  • TexConv Used for converting *.tex files to *.tga images
  • Shaders Compiled shaders
  • GameAgent The serverlist masterserver written in Python
  • libogg, libvorbis Third party libraries used for playing OGG-encoded ingame music (see http://www.vorbis.com/ for more information)

Building

More detailed information about building the game for different operating systems and different platforms can be found on the SeriousSamClassic wiki.

There are still many asserts in the engine. Most of them are irrelevant and should be removed, but while it's not done, the asserts will effectively kill the engine when triggered in the Debug build. Use Release or RelWithDebInfo build if you intend to play (automatically set as RelWithDebInfo in the build scripts).

Linux

Setting up the repository

Type this in your terminal:

git clone https://github.com/tx00100xt/SeriousSamClassic.git

Copy official game data (optional)

If you have access to a copy of the game (either by CD or through Steam), you can copy the *.gro files from the game directory to the repository. (SeriousSamClassic/SamTFE is the directory of the game Serious Sam Classic The First Encounter, SeriousSamClassic/SamTSE is the directory of the game Serious Sam Classic The Second Encounter)

Building (for SS:TFE and SS:TSE)

Type this in your terminal:

cd SeriousSamClassic
mkdir build
cd build
cmake ..
make -j4
make install

If you prefer ninja, then add key -GNinja to the cmake. And replace the make command with ninja.

Ubuntu

Instead of building you can install packages from ppa by adding ppa:tx00100xt/serioussam to your system's Software Sources.

sudo add-apt-repository ppa:tx00100xt/serioussam
sudo apt update

This PPA can be added to your system manually by copying the lines below and adding them to your system's software sources.

deb https://ppa.launchpadcontent.net/tx00100xt/serioussam/ubuntu YOUR_UBUNTU_VERSION_HERE main 
deb-src https://ppa.launchpadcontent.net/tx00100xt/serioussam/ubuntu YOUR_UBUNTU_VERSION_HERE main 

After adding ppa, run the commands:

sudo apt install serioussamclassic serioussamclassic-xplus

Gentoo

To build the game, use the ebuild included in the official Gentoo repository.
https://packages.gentoo.org/packages/games-fps/serioussam
This ebuild uses the repo https://github.com/tx00100xt/SeriousSamClassic-VK which
additionally contains the Vulkan render. Everything else is identical to this repository.

You will also need CD images of the games Serious Sam Classic The First Encounter and
Serious Sam Classic The First Encounter.

Type this in your terminal:

echo "games-fps/serioussam -vulkan" >> /etc/portage/package.use/serioussam
emerge -av serioussam --autounmask=y

For game add-ons, use a serioussam-overlay containing ready-made ebuilds for building the add-ons.

Type this in your terminal:

emerge eselect-repository
eselect repository enable serioussam
emaint sync --repo serioussam

The list of add-ons can be found in README

Arch Linux

To build a game under Arch Linux you can use the package from AUR: https://aur.archlinux.org/packages/serioussam

Raspberry Pi

The build for raspberry pi is similar to the build for Linux, you just need to add an additional build key.

cd SeriousSamClassic
mkdir build
cd build
cmake -DRPI4=TRUE ..
make -j4
make install

FreeBSD

Setting up the repository

Type this in your terminal:

git clone https://github.com/tx00100xt/SeriousSamClassic.git

Copy official game data (optional)

If you have access to a copy of the game (either by CD or through Steam), you can copy the *.gro files from the game directory to the repository. (SeriousSamClassic/SamTFE is the directory of the game Serious Sam Classic The First Encounter, SeriousSamClassic/SamTSE is the directory of the game Serious Sam Classic The Second Encounter)

Building (for SS:TFE and SS:TSE)

Type this in your terminal:

cd SeriousSamClassic
mkdir build
cd build
cmake ..
make -j4
make install

If you prefer ninja, then add key -GNinja to the cmake. And replace the make command with ninja. For i386 architecture, add key -DUSE_ASM=OFF to cmake. To build a binary package for installation on the system, you can use the template: https://github.com/tx00100xt/SeriousSamClassic/tree/main/templates

OpenBSD

Install the required packages

doas pkg_add bison cmake ninja git sdl2 libogg libvorbis

Setting up the repository

git clone https://github.com/jasperla/openbsd-wip.git

Add the path to openbsd-wip to PORTSDIR_PATH in /etc/mk.conf Type this in your terminal:

cd openbsd-wip/games/serioussam
make install

Copy official game data

Copy all content of the original game to the appropriate directories:

~/.local/share/Serious-Engine/serioussam/ - for Serious Sam Classic The First Encounter
~/.local/share/Serious-Engine/serioussamse/ - for Serious Sam Classic The Second Encounter

To start the game type in console: serioussam or serioussamse. You can also use the launch of the game through the menu. For more information, type in the console: man serioussam

NetBSD

Install required dependencies:

sudo pkgin install cmake nasm bison SDL2 libogg libvorbis

Copy official game data

If you have access to a copy of the game (either by CD or through Steam), you can copy the *.gro files from the game directory to the repository. (SeriousSamClassic/SamTFE is the directory of the game Serious Sam Classic The First Encounter, SeriousSamClassic/SamTSE is the directory of the game Serious Sam Classic The Second Encounter)

Type this in your terminal:

cd SeriousSamClassic
mkdir build
cd build
cmake ..
make -j4
make install

For i386 use cmake .. -DUSE_ASM=OFF To build a binary package for installation on the system, you can use the template: https://github.com/tx00100xt/SeriousSamClassic/tree/main/templates

macOS

Install dependes

brew install bison flex sdl2 libogg libvorbis zlib-ng cmake git

Setting up the repository

Type this in your terminal:

git clone https://github.com/tx00100xt/SeriousSamClassic.git

Copy official game data (optional)

If you have access to a copy of the game (either by CD or through Steam), you can copy the *.gro files from the game directory to the repository. (SeriousSamClassic/SamTFE is the directory of the game Serious Sam Classic The First Encounter, SeriousSamClassic/SamTSE is the directory of the game Serious Sam Classic The Second Encounter)

Building (for SS:TFE and SS:TSE)

Type this in your terminal:

cd SeriousSamClassic
mkdir build
cd build
cmake ..
make -j4
make install

Flatpak

Serious Sam Classic on flathub
You can also install the game using flatpak from the flathub repository. When you first start the game,
you will be asked to place your game data along the following paths:

~/.var/app/io.itch.tx00100xt.SeriousSamClassic/data/Serious-Engine/serioussam
~/.var/app/io.itch.tx00100xt.SeriousSamClassic/data/Serious-Engine/serioussamse

You can place game data in these paths before starting the game. Then the game will start immediately.
To start the game, use the application menu. More detailed information about flatpak on the SeriousSamClassic Flatpak wiki.

Snap

Get it from the Snap Store
You can also install the game using snap from the snapcraft. When you first start the game,
you will be asked to place your game data along the following paths:

~/snap/serioussam/current/.local/share/Serious-Engine/serioussam
~/snap/serioussam/current/.local/share/Serious-Engine/serioussamse

You can place game data in these paths before starting the game. Then the game will start immediately.
To start the game, use the application menu. More detailed information about snap on the SeriousSamClassic Snap wiki.

AppImage

Get Appimage

You can also run the game using AppImage. When you first start the game,
you will be asked to place your game data along the following paths:

~/.local/share/Serious-Engine/serioussam
~/.local/share/Serious-Engine/serioussamse

You can place game data in these paths before starting the game. Then the game will start immediately.
You can also place your game data anywhere in your home directory. The first time you start the game, it will find it itself. AppImage also contains libraries for the modification of XPLUS. Download:

wget https://archive.org/download/sam-tfe-xplus/SamTFE-XPLUS.tar.xz
wget https://archive.org/download/sam-tse-xplus/SamTSE-XPLUS.tar.xz

And unpack it to the root directory of game resources. After unpacking the archives for the XPLUS mod, simply select this mod in the game menu. You can build your AppImage using the build script. Type this in your terminal:

./build-appimage.sh

Running

You can buy the original games on Steam, as a part of a bundle with Serious Sam Revolution ( http://store.steampowered.com/app/227780 )

Serious Sam Classic The First Encounter

Running the game

  1. Locate the game directory for "Serious Sam Classic The First Encounter" (steam)
  2. Build game from source code or Download latest release and copy the latest files from the game directory to SamTFE/Bin
  3. Copy all *.gro files, Help folder and Levels folder from the game directory to SamTFE directory. At the current time the files are:
    • Help (folder)
    • Levels (folder)
    • 1_00_ExtraTools.gro
    • 1_00_music.gro
    • 1_00c.gro
    • 1_00c_Logo.gro
    • 1_00c_scripts.gro
    • 1_04_patch.gro
  4. Start the game
    • ./run_game.sh or ./run_game_hud.sh (for start game with MangoHUD)

Serious Sam Classic The Second Encounter

Running the game

  1. Locate the game directory for "Serious Sam Classic The Second Encounter" (steam)
  2. Build game from source code or Download latest release and copy the latest files from the game directory to SamTSE/Bin
  3. Copy all *.gro files and Help folder from the game directory to SamTSE directory. At the current time the files are:
    • Help (folder)
    • SE1_00.gro
    • SE1_00_Extra.gro
    • SE1_00_ExtraTools.gro
    • SE1_00_Levels.gro
    • SE1_00_Logo.gro
    • SE1_00_Music.gro
    • 1_04_patch.gro
    • 1_07_tools.gro
  4. Start the game
    • ./run_game.sh or ./run_game_hud.sh (for start game with MangoHUD)

Install the game in system (/usr/bin;/usr/lib/;/usr/share)

  1. Just add string for cmake command:
cmake -DCMAKE_INSTALL_PREFIX:PATH=/usr 
  1. Build game from source code.
  2. Install the game:
cd build
sudo make install
  1. Put game data in (Recommended):
/usr/share/serioussam/ - for TFE
/usr/share/serioussamse/ - for TSE

or

~/.local/share/Serious-Engine/serioussam/ - for TFE
~/.local/share/Serious-Engine/serioussamse/ - for TSE
  1. Type in console:
serioussam       	# for run Serious Sam Classic The First Encounter

or

serioussamse       	# for run Serious Sam Classic The Second Encounter

Note: If the game does not find the data on the recommended paths, then it will independently perform a search. Please note that when installing the game on a system, all content of the original game is required (including directories: Controls, Data, Demos, Help, and so on) in directories /usr/share/serioussam(se) or ~/.local/share/Serious-Engine/serioussam(se), depending on the directory you select. You can see a more detailed description in the Wiki.

Serious Sam Classic XPLUS

What is XPLUS? XPLUS is a global modification that changes effects, models, weapons, textures to high definition. XPLUS was created by fans of the game Serious Sam and is distributed for free. Remark: -JD- and VITEK is author this mod for windows.

XPLUS Oasis

XPLUS Dunes

XPLUS Sacred Yards

Linux, FreeBSD, macOS, Raspberry PI OS

Building XPLUS (for SS:TFE and SS:TSE)

Type this in your terminal:

cd SeriousSamClassic
mkdir build-xplus
cd build-xplus
cmake -DXPLUS=TRUE ..
make -j4
make install

Note: for Raspberry Pi4 just add -DRPI4=TRUE for cmake command.

Download: Xplus TFE from Google Drive or Xplus TFE from pCloud, and unpack to SeriousSamClassic/SamTFE/Mods directory. Xplus TSE from Google Drive or Xplus TSE from pCloud,, and unpack to SeriousSamClassic/SamTSE/Mods directory. You can also download the archive using curl or wget:

cd SeriousSamClassic
wget https://archive.org/download/sam-tfe-xplus/SamTFE-XPLUS.tar.xz
wget https://archive.org/download/sam-tse-xplus/SamTSE-XPLUS.tar.xz
tar -xJvpf SamTFE-XPLUS.tar.xz -C SamTFE
tar -xJvpf SamTSE-XPLUS.tar.xz -C SamTSE

or

cd SeriousSamClassic
for var in a b c; do wget https://github.com/tx00100xt/serioussam-mods/raw/main/SamTFE-XPLUS/SamTFE-XPLUS.tar.xz.parta$var; done; cat SamTFE-XPLUS.tar.xz.part* > SamTFE-XPLUS.tar.xz
for var in a b c; do wget https://github.com/tx00100xt/serioussam-mods/raw/main/SamTSE-XPLUS/SamTSE-XPLUS.tar.xz.parta$var; done; cat SamTSE-XPLUS.tar.xz.part* > SamTSE-XPLUS.tar.xz
tar -xJvpf SamTFE-XPLUS.tar.xz -C SamTFE
tar -xJvpf SamTSE-XPLUS.tar.xz -C SamTSE

To start the modification, use the game menu - item Modification.

Building demo version of the game

To build the demo version of the game, official demo files for Windows and official patches for the game from Croteam are used. These files are automatically downloaded and unpacked in demo build scripts.

Type this in your terminal:

git clone https://github.com/tx00100xt/SeriousSamClassic.git SeriousSamClassic
cd SeriousSamClassic
./build-linux64demo.sh        	    # use build-linux32demo.sh for 32-bits

Windows

  • This project can be compiled starting from Windows 7 and higher.
  1. Download and Install Visual Studio 2015 Community Edition or higher.
  2. Download and Install Windows 10 SDK 10.0.14393.795 or other.
  3. Open the solution in the Sources folder, select Release x64 or Release Win32 and compile it.

Supported Architectures

  • x86
  • aarch64
  • e2k (elbrus)

Supported OS

  • Linux
  • FreeBSD
  • OpenBSD
  • NetBSD
  • Windows
  • Raspberry PI OS
  • macOS

Build status

CI Platform Compiler Configurations Platforms Status
GitHub Actions Windows, Ubuntu, FreeBSD, Alpine, Raspberry PI OS Lite, macOS MSVC, GCC, Clang Release x86, x64, armv7l, aarch64, riscv64, ppc64le, s390x, mipsel, loongarch64 GitHub Actions Build Status

You can download a the automatically build based on the latest commit.
To do this, go to the Actions tab, select the top workflows, and then Artifacts.

License

  • Serious Engine is licensed under the GNU GPL v2 (see LICENSE file).
  • amp11lib is licensed under the GNU GPL v2 (see amp11lib/COPYING file).

Note:

The following applies only to the for Windows build. Because none of the following is used when building under (Linux, *BSD, macOS) systems.

Some of the code included with the engine sources is not licensed under the GNU GPL v2:
  • zlib (located in Sources/Engine/zlib) by Jean-loup Gailly and Mark Adler
  • LightWave SDK (located in Sources/LWSkaExporter/SDK) by NewTek Inc.
  • libogg/libvorbis (located in Sources/libogg and Sources/libvorbis) by Xiph.Org Foundation