openmohaa/README.md

93 lines
4.3 KiB
Markdown
Raw Normal View History

2023-02-03 18:48:42 +01:00
# OpenMoHAA
2024-10-28 19:05:16 +01:00
[![Build](https://github.com/openmoh/openmohaa/actions/workflows/branches-build.yml/badge.svg?branch=main)](https://github.com/openmoh/openmohaa/actions/workflows/branches-build.yml) [![Release](https://img.shields.io/github/v/release/openmoh/openmohaa)](https://github.com/openmoh/openmohaa/releases) [![Downloads](https://img.shields.io/github/downloads/openmoh/openmohaa/total)](https://github.com/openmoh/openmohaa/releases)
2023-07-06 18:32:14 +02:00
![License](https://img.shields.io/github/license/openmoh/openmohaa) ![Commits](https://img.shields.io/github/commit-activity/t/openmoh/openmohaa)
![Discord](https://img.shields.io/discord/596049712579215361?logo=discord&logoColor=white&color=5865F2)
![logo](misc/openmohaa-text-sm.png)
2019-07-03 22:10:46 +02:00
## Intro
2024-11-25 19:08:03 +01:00
The main goal of OpenMoHAA is to ensure the future and continuity of **Medal of Honor: Allied Assault** (including Spearhead and Breakthrough expansions) on all platforms/architectures by providing new patches/features. Thanks to the ioquake3 project and the F.A.K.K SDK, OpenMoHAA has already reached more than half of its goal: an open-source version of MoH:AA (based on version 2.40) that is fully compatible with both the original game and expansions, in terms of network protocol, assets, and scripts. OpenMoHAA is compatible with both MOH:AA servers and clients (Spearhead and Breakthrough included).
## Getting started
- [Downloading and installing OpenMoHAA](docs/getting_started_installation.md)
- [Running OpenMoHAA and using expansion assets](docs/getting_started_running.md)
2024-09-26 20:30:37 +02:00
- [Dedicated server configuration](docs/configuration/server.md)
2023-12-28 20:54:05 +01:00
## Current state
### Single-player
2024-11-21 22:01:40 +01:00
The entire single-player campaign should work (Allied Assault, Spearhead and Breakthrough). If you encounter any bug, please create a new [GitHub issue](https://github.com/openmoh/openmohaa/issues) describing them.
2023-12-26 12:14:38 +01:00
### Multiplayer
2024-12-09 18:55:36 +01:00
The Multiplayer part is almost fully stable, all game modes including `Tug-of-War` from Medal of Honor: Spearhead, and `Liberation` from Medal of Honor: Breakthrough are implemented and are working as intended. Mods like `Freeze-Tag` are working as well.
2023-12-26 12:14:38 +01:00
2024-12-09 18:55:36 +01:00
OpenMoHAA can be used to [host](docs/getting_started_installation.md#server) a mohaa/mohaas/mohaab server and players can use OpenMoHAA to [play](docs/getting_started_installation.md#client) on any server. Unfortunately, some bugs/strange behaviors and crashes can occur especially for servers hosting some specific mods. The best way to report bugs is by [creating a new issue](https://github.com/openmoh/openmohaa/issues) on the [OpenMoHAA GitHub](https://github.com/openmoh/openmohaa) project with the steps to reproduce (with eventually the problematic mods).
2023-12-26 12:14:38 +01:00
2023-12-28 20:54:05 +01:00
## Features
2023-05-18 20:54:12 +02:00
2024-09-26 19:27:11 +02:00
- [List of new features](docs/features.md)
- [Scripting commands](https://htmlpreview.github.io/?https://github.com/openmoh/openmohaa/blob/main/docs/features_g_allclasses.html)
2023-05-01 20:08:26 +02:00
2023-02-03 18:48:42 +01:00
## Compiling
2023-12-28 20:54:05 +01:00
- See [Compiling OpenMoHAA](docs/compiling.md)
2023-08-19 19:41:22 +02:00
2023-05-19 14:09:03 +02:00
## Screenshots
2023-11-13 23:29:21 +01:00
| | |
|-----------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| ![](docs/images/v0.60.0-x86_64/mohdm1_1.png) | ![](docs/images/v0.60.0-x86_64/training_1.png) |
| ![](docs/images/v0.60.0-x86_64/flughafen_1.png) | ![](docs/images/v0.60.0-x86_64/flughafen_2.png) |
| ![](docs/images/v0.60.0-x86_64/mohdm2_1.png "Playing Freeze-Tag mode with bots") | ![](docs/images/v0.60.0-x86_64/training_3.png "Single-Player training") |
2023-11-14 14:06:57 +01:00
*More screenshots [here](docs/images)*
2023-05-22 18:01:11 +02:00
2023-02-03 18:48:42 +01:00
## Third party
2023-02-03 18:48:42 +01:00
### SDL
2019-07-03 22:24:21 +02:00
http://www.libsdl.org/
2023-02-03 18:48:42 +01:00
### OpenAL
2019-07-03 22:24:21 +02:00
2023-08-15 16:02:02 +02:00
https://www.openal.org/
2023-02-03 18:48:42 +01:00
### LibMAD
2019-07-03 22:24:21 +02:00
http://www.underbit.com/products/mad/
2023-02-03 18:48:42 +01:00
### cURL
2016-03-27 11:49:47 +02:00
2023-02-03 18:48:42 +01:00
https://curl.se/
2023-02-03 18:48:42 +01:00
### Libogg
2016-03-27 11:49:47 +02:00
2023-02-03 18:48:42 +01:00
https://github.com/gcp/libogg
2023-02-03 18:48:42 +01:00
### Libvorbis
2023-02-03 18:48:42 +01:00
https://xiph.org/vorbis/
2023-02-03 18:48:42 +01:00
### Libopus
2016-03-27 11:49:47 +02:00
2023-02-03 18:48:42 +01:00
https://opus-codec.org/
2016-03-27 11:49:47 +02:00
2023-07-06 18:32:14 +02:00
## Communities
### URLs
2023-05-19 21:33:58 +02:00
- https://github.com/openmoh/openmohaa/
- https://mohaaaa.co.uk/AAAAMOHAA/index.php
2023-02-03 18:48:42 +01:00
- https://x-null.net/
2023-07-06 18:32:14 +02:00
### Discord
[![Discord Banner 1](https://discordapp.com/api/guilds/596049712579215361/widget.png?style=banner2)](https://discord.gg/NYtH58R)