![Scorched3D](.images/logo_overlay.png "Scorched3D")

Scorched3D incorporates lively, fully destructible 3D landscapes that include animated jets, naval vessels, water and even birds, with detailed tanks and projectiles and stunning visual effects.

<div align="center">
<a href='.images/Screenshot_20250303_44.2.jpeg'>
<img src='.images/Screenshot_20250303_44.2.jpeg' alt='Gameplay from version 44.2' width=640 height=400 />
</a>
</div>

<div align="center">
<a href='.images/6700.jpg'>
<img src='.images/6700.jpg' alt='Trees from version 36'            width=160 height=120 />
</a>
<a href='.images/6702.jpg'>
<img src='.images/6702.jpg' alt='Spectator view from version 37.2' width=160 height=120 />
</a>
<a href='.images/6704.jpg'>
<img src='.images/6704.jpg' alt='Some action from version 37.2'    width=160 height=120 />
</a>
<a href='.images/8943.jpg'>
<img src='.images/8943.jpg' alt='Lightning from version 38'        width=160 height=120 />
</a>
</div>

A simple turn-based artillery game and also a real-time strategy game in which players can counter each others' weapons with other creative accessories, shields and tactics. Test your skill in timing, aiming and judgement of distance, move around on the landscape, or outsmart your opponent economically.

## Features

-	Realisticly rendered 3D landscape environments
-	Real-time or turn-based artillery combat
-	Online or offline, single or multi-player play
-	Mod support for various gaming styles
-	Tournament and stats championships

## Gameplay

Learning how to play is easy, just point the turret, adjust power and trajectory, select a weapon – and shoot!

Manage your inventory of weapons with the prize money you win during each round of combat. Learn the basic controls using the tutorial mode, or set up your own game by customising dozens of economy and environmental conditions to your liking, or simply play online immediately at one of the various public servers.

You can play with up to twenty-four other players at a time, mixing computer players with humans on both randomly generated landscapes and user-designed maps. Scorched3D comes bundled with Apocalypse mod, which offers enhanced levels of weaponry.

## Get

Scorched3D is currently available for several Linux distribution from [Open Build Service (OBS)](https://build.opensuse.org/)

Develop: [![build result](https://build.opensuse.org/projects/home:bberberov:develop:Multi/packages/scorched3d/badge.svg?type=percent)](https://software.opensuse.org//download.html?project=home%3Abberberov%3Adevelop%3AMulti&package=scorched3d)  
Testing: [![build result](https://build.opensuse.org/projects/home:bberberov:testing:Multi/packages/scorched3d/badge.svg?type=percent)](https://software.opensuse.org//download.html?project=home%3Abberberov%3Atesting%3AMulti&package=scorched3d)  
Release: [![build result](https://build.opensuse.org/projects/home:bberberov:release:Multi/packages/scorched3d/badge.svg?type=percent)](https://software.opensuse.org//download.html?project=home%3Abberberov%3Arelease%3AMulti&package=scorched3d)

> [!NOTE]
> The percentage indicates the number of **successful builds** across all possible distributions, not the progress or quality of a specific build

:construction: Installers/Apps for Microsoft Windows and macOS operating systems may be available in the future

### From OBS

1.	**Click** on one of the _Build Service_ badges above, to go to the download page for the build quality you would like to install
2.	**Click** on your distribution under _Select Your Operating System_
3.	**Click** on _Add repository and install manually_ to see the instructions
4.	**Use** the instructions to add the repository to your distribution and install the package

## Building

### Dependencies

-	[pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/) >= 0.29 or [pkgconf](http://pkgconf.org/)
-	[OpenAL](https://www.openal-soft.org/) >= 1.17.2
-	[Freealut](https://github.com/vancegroup/freealut)
-	[FFTW3](https://www.fftw.org/)
-	[Freetype](https://freetype.org/) >= 2.1.5
-	OpenGL
-	GLU
-	GLEW
-	[OGG](https://www.xiph.org/ogg/)
-	[Vorbis](https://xiph.org/vorbis/)
-	SDL = 1.2.x
-	SDL_net = 1.2.x
-	[wxWidgets](https://www.wxwidgets.org/)
-	[expat](https://libexpat.github.io/)
-	[zlib](http://zlib.net/)
-	[libpng](http://www.libpng.org/)
-	[libjpeg](https://www.ijg.org/) or [libjpeg-turbo](https://www.libjpeg-turbo.org/) >= 8
-	Lua = 5.1.x, >= 5.1.2

### Optional Dependencies

-	`xdg-utils` for opening web links, or any browser configurable at compile-time
-	MySQL or PostgreSQL

### Compiling

Since version 44.3, Scorched3D requires a C++11 supporting compiler and libraries!

#### Linux

Scorched3D uses an [Autoconf](https://www.gnu.org/software/autoconf/autoconf.html) build process, derived from the Visual Studio project files

-	Run `createAMMakefile.pl` from its directory to create the necesary `Makefile.am` from the Visual Studio project files
	```bash
	cd scripts
	perl createAMMakefile.pl
	cd ..
	```
-	Reconfigure with `autoreconf -fiv`
-	Configure with `./configure ...`
-	Build with `make ...`
-	Install with `make install ...`

[![Linux Build](https://github.com/bberberov/scorched3d/actions/workflows/linux.yaml/badge.svg)](https://github.com/bberberov/scorched3d/actions/workflows/linux.yaml) A new [Meson](https://mesonbuild.com/) build process has been added.  It's under development, but it is able to build the Linux release.  Look in [.github/workflows/](.github/workflows/) to see examples of how to use it.

#### macOS :construction:

[![macOS Build](https://github.com/bberberov/scorched3d/actions/workflows/macos.yaml/badge.svg)](https://github.com/bberberov/scorched3d/actions/workflows/macos.yaml) The current plan is to try to build a macOS release using Meson.  See [#2](https://github.com/bberberov/scorched3d/issues/2).

#### Windows :construction:

The included Visual Studio project files have not been tested.

[![Windows Build](https://github.com/bberberov/scorched3d/actions/workflows/windows.yaml/badge.svg)](https://github.com/bberberov/scorched3d/actions/workflows/windows.yaml) The current plan is to try to build a Windows release using Meson.  See [#2](https://github.com/bberberov/scorched3d/issues/2).

## License

Licensed under the terms of the [GNU General Public License v2.0 or later](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html)
___

## Original README

Scorched3D : Copyright 2009 Gavin Camp

For Scorched3D updates and news visit http://www.scorched3d.co.uk

For Scorched3D documentation visit http://www.scorched3d.co.uk/wiki

For information on how to compile Scorched3D visit http://www.scorched3d.co.uk/wiki/index.php/Scorched3D_Development

For Scorched3D license information see the documentation directory.

For Apocalypse mod updates and news visit http://apochq.handwired.net
