mirror of
https://github.com/alexbatalov/fallout1-ce.git
synced 2024-09-04 13:59:08 +00:00
96 lines
6.3 KiB
Markdown
96 lines
6.3 KiB
Markdown
# Fallout Community Edition
|
|
|
|
Fallout Community Edition is a fully working re-implementation of Fallout, with the same original gameplay, engine bugfixes, and some quality of life improvements, that works (mostly) hassle-free on multiple platforms.
|
|
|
|
There is also [Fallout 2 Community Edition](https://github.com/alexbatalov/fallout2-ce).
|
|
|
|
## Installation
|
|
|
|
You must own the game to play. Purchase your copy on [GOG](https://www.gog.com/game/fallout) or [Steam](https://store.steampowered.com/app/38400). Download latest [release](https://github.com/alexbatalov/fallout1-ce/releases) or build from source. You can also check latest [debug](https://github.com/alexbatalov/fallout1-ce/actions) build intended for testers.
|
|
|
|
### Windows
|
|
|
|
Download and copy `fallout-ce.exe` to your `Fallout` folder. It serves as a drop-in replacement for `falloutw.exe`.
|
|
|
|
### Linux
|
|
|
|
- Use Windows installation as a base - it contains data assets needed to play. Copy `Fallout` folder somewhere, for example `/home/john/Desktop/Fallout`.
|
|
|
|
- Download and copy `fallout-ce` to this folder.
|
|
|
|
- Install [SDL2](https://libsdl.org/download-2.0.php):
|
|
|
|
```console
|
|
$ sudo apt install libsdl2-2.0-0
|
|
```
|
|
|
|
- Run `./fallout-ce`.
|
|
|
|
### macOS
|
|
|
|
> **NOTE**: macOS 10.11 (El Capitan) or higher is required. Runs natively on Intel-based Macs and Apple Silicon.
|
|
|
|
- Use Windows installation as a base - it contains data assets needed to play. Copy `Fallout` folder somewhere, for example `/Applications/Fallout`.
|
|
|
|
- Alternatively you can use Fallout from MacPlay/The Omni Group as a base - you need to extract game assets from the original bundle. Mount CD/DMG, right click `Fallout` -> `Show Package Contents`, navigate to `Contents/Resources`. Copy `GameData` folder somewhere, for example `/Applications/Fallout`.
|
|
|
|
- Download and copy `fallout-ce.app` to this folder.
|
|
|
|
- Run `fallout-ce.app`.
|
|
|
|
### Android
|
|
|
|
> **NOTE**: Fallout was designed with mouse in mind. There are many controls that require precise cursor positioning, which is not possible with fingers. When playing on Android you'll use fingers to move mouse cursor, not a character, or a map. Double tap to "click" left mouse button in the current cursor position, triple tap to "click" right mouse button. It might feel awkward at first, but it's super handy - you can play with just a thumb. This is not set in stone and might change in the future.
|
|
|
|
> **NOTE**: From Android standpoint release and debug builds are different apps. Both apps require their own copy of game assets and have their own savegames. This is intentional. As a gamer just stick with release version and check for updates.
|
|
|
|
- Use Windows installation as a base - it contains data assets needed to play. Copy `Fallout` folder to your device, for example to `Downloads`. You need `master.dat`, `critter.dat`, and `data` folder. Watch for file names - keep (or make) them lowercased (see [Configuration](#configuration)).
|
|
|
|
- Download `fallout-ce.apk` and copy it to your device. Open it with file explorer, follow instructions (install from unknown source).
|
|
|
|
- When you run the game for the first time it will immediately present file picker. Select the folder from the first step. Wait until this data is copied. A loading dialog will appear, just wait for about 30 seconds. The game will start automatically.
|
|
|
|
### iOS
|
|
|
|
> **NOTE**: See Android note on controls.
|
|
|
|
- Download `fallout-ce.ipa`. Use sideloading applications ([AltStore](https://altstore.io/) or [Sideloadly](https://sideloadly.io/)) to install it to your device. Alternatively you can always build from source with your own signing certificate.
|
|
|
|
- Run the game once. You'll see error message saying "Could not find the master datafile...". This step is needed for iOS to expose the game via File Sharing feature.
|
|
|
|
- Use Finder (macOS Catalina and later) or iTunes (Windows and macOS Mojave or earlier) to copy `master.dat`, `critter.dat`, and `data` folder to "Fallout" app ([how-to](https://support.apple.com/HT210598)). Watch for file names - keep (or make) them lowercased (see [Configuration](#configuration)).
|
|
|
|
## Configuration
|
|
|
|
The main configuration file is `fallout.cfg`. There are several important settings you might need to adjust for your installation. Depending on your Fallout distribution main game assets `master.dat`, `critter.dat`, and `data` folder might be either all lowercased, or all uppercased. You can either update `master_dat`, `critter_dat`, `master_patches` and `critter_patches` settings to match your file names, or rename files to match entries in your `fallout.cfg`.
|
|
|
|
The `sound` folder (with `music` folder inside) might be located either in `data` folder, or be in the Fallout folder. Update `music_path1` setting to match your hierarchy, usually it's `data/sound/music/` or `sound/music/`. Make sure it match your path exactly (so it might be `SOUND/MUSIC/` if you've installed Fallout from CD). Music files themselves (with `ACM` extension) should be all uppercased, regardless of `sound` and `music` folders.
|
|
|
|
The second configuration file is `f1_res.ini`. Use it to change game window size and enable/disable fullscreen mode.
|
|
|
|
```ini
|
|
[MAIN]
|
|
SCR_WIDTH=1280
|
|
SCR_HEIGHT=720
|
|
WINDOWED=1
|
|
```
|
|
|
|
Recommendations:
|
|
- **Desktops**: Use any size you see fit.
|
|
- **Tablets**: Set these values to logical resolution of your device, for example iPad Pro 11 is 1668x2388 (pixels), but it's logical resolution is 834x1194 (points).
|
|
- **Mobile phones**: Set height to 480, calculate width according to your device screen (aspect) ratio, for example Samsung S21 is 20:9 device, so the width should be 480 * 20 / 9 = 1067.
|
|
|
|
In time this stuff will receive in-game interface, right now you have to do it manually.
|
|
|
|
## Contributing
|
|
|
|
Here is a couple of current goals. Open up an issue if you have suggestion or feature request.
|
|
|
|
- **Update to v1.2**. This project is based on Reference Edition which implements v1.1 released in November 1997. There is a newer v1.2 released in March 1998 which at least contains important multilingual support.
|
|
|
|
- **Backport some Fallout 2 features**. Fallout 2 (with some Sfall additions) added many great improvements and quality of life enhancements to the original Fallout engine. Many deserve to be backported to Fallout 1. Keep in mind this is a different game, with slightly different gameplay balance (which is a fragile thing on its own).
|
|
|
|
## License
|
|
|
|
The source code is this repository is available under the [Sustainable Use License](LICENSE.md).
|