241 lines
6.5 KiB
Markdown
241 lines
6.5 KiB
Markdown
# Portal64
|
|
|
|
|
|
A demake *(remake for an older platform)* of Portal for the Nintendo 64.
|
|
|
|
|
|
|
|
Latest current progress video on Youtube:
|
|
|
|
[](https://www.youtube.com/watch?v=sAkSHzR-P7M)
|
|
|
|
## Overview
|
|
|
|
This project aims to reproduce Valve's original Portal, playable on the N64. [Releases](https://github.com/lambertjamesd/portal64/releases) of this game are fully playable N64 ROM's that can either be played through an emulator or on a physical N64 game cartridge. Please follow specific release instructions to get ROM running on your target hardware. Because this demake has been in development for many years, it has made significant progress in both gameplay systems and fidelity including:
|
|
- Twelve+ test chambers completed
|
|
- Fully functioning portals, and gun
|
|
- Fully functioning physics engine
|
|
- Lighting system
|
|
- Main/pause menus
|
|
- Sound effects/dialogue
|
|
- Cutscenes
|
|
- Multi-language subtitles and audio dialogue
|
|
- Eye-Candy (Reflections, ...)
|
|
- Much more!
|
|
|
|
This is a community driven project that welcomes any and all game testers and or [Contributors](./CONTRIBUTING.md).
|
|
|
|
Updates are constantly being made to the game, so we recommend checking out the author's [YouTube Channel](https://www.youtube.com/@happycoder1989) for the latest updates.
|
|
|
|
## How to build
|
|
|
|
First, you will need to setup [Modern SDK](https://crashoveride95.github.io/n64hbrew/modernsdk/startoff.html).
|
|
|
|
After installing modern sdk you will want to also install
|
|
|
|
```sh
|
|
sudo apt install libnustd
|
|
```
|
|
|
|
Next, you will need to download Blender 3.6.1 or higher. Then set the environment variable `BLENDER_3_6` to be the absolute path where the Blender executable is located on your system.
|
|
|
|
```sh
|
|
sudo apt install blender
|
|
```
|
|
|
|
e.g. add this to your ~/.bashrc
|
|
|
|
```bash
|
|
export BLENDER_3_6="/usr/bin/blender"
|
|
```
|
|
|
|
<br />
|
|
|
|
You will need to install Python `vpk`
|
|
|
|
```sh
|
|
pip install vpk
|
|
```
|
|
|
|
<br />
|
|
|
|
Setup and install dependencies for `skeletool64`
|
|
|
|
```sh
|
|
echo "deb [trusted=yes] https://lambertjamesd.github.io/apt/ ./" \
|
|
| sudo tee /etc/apt/sources.list.d/lambertjamesd.list
|
|
sudo apt update
|
|
sudo apt install vtf2png sfz2n64 mpg123 sox imagemagick unzip ffmpeg
|
|
```
|
|
|
|
<br />
|
|
|
|
Install lua5.4 (remove other perhaps installed versions first, skelatool64 needs to be build with luac 5.4!)
|
|
|
|
```sh
|
|
sudo apt install lua5.4 liblua5.4-dev liblua5.4-0
|
|
```
|
|
|
|
<br />
|
|
|
|
Setup and build skelatool64 (the version included in this portal64 repo!)
|
|
|
|
```sh
|
|
cd skelatool64
|
|
./setup_dependencies.sh
|
|
make
|
|
```
|
|
|
|
<br />
|
|
|
|
You will need to install nodejs. You can use apt for this
|
|
|
|
```sh
|
|
sudo apt install nodejs
|
|
```
|
|
|
|
<br />
|
|
|
|
You then need to add the following files from where Portal is installed to the folder `vpk/` OR create a symbolic link to the `Portal` folder there (see [vpk/add_vpk_here.md](./vpk/add_vpk_here.md) for more details!).
|
|
You can add multiple languages if desired.
|
|
|
|
```
|
|
Portal/portal/portal_pak_000.vpk
|
|
Portal/portal/portal_pak_001.vpk
|
|
Portal/portal/portal_pak_002.vpk
|
|
Portal/portal/portal_pak_003.vpk
|
|
Portal/portal/portal_pak_004.vpk
|
|
Portal/portal/portal_pak_005.vpk
|
|
Portal/portal/portal_pak_dir.vpk
|
|
|
|
Portal/hl2/hl2_sound_misc_000.vpk
|
|
Portal/hl2/hl2_sound_misc_001.vpk
|
|
Portal/hl2/hl2_sound_misc_002.vpk
|
|
Portal/hl2/hl2_sound_misc_dir.vpk
|
|
|
|
Portal/hl2/hl2_misc_000.vpk
|
|
Portal/hl2/hl2_misc_001.vpk
|
|
Portal/hl2/hl2_misc_002.vpk
|
|
Portal/hl2/hl2_misc_003.vpk
|
|
Portal/hl2/hl2_misc_dir.vpk
|
|
|
|
Portal/hl2/media/valve.bik
|
|
|
|
Portal/hl2/resource/gameui_english.txt
|
|
Portal/hl2/resource/gameui_<your desired language 1>.txt
|
|
Portal/hl2/resource/gameui_<your desired language 2>.txt
|
|
|
|
Portal/portal/resource/closecaption_english.txt
|
|
Portal/portal/resource/closecaption_<your desired language 1>.txt
|
|
Portal/portal/resource/closecaption_<your desired language 2>.txt
|
|
```
|
|
|
|
Finally, run `make` to build the project.
|
|
|
|
```sh
|
|
# Clean out any previous build files
|
|
make clean
|
|
|
|
# Build (default build with english audio)
|
|
make
|
|
|
|
# In case you have any trouble with ROM running on hardware try
|
|
# wine install required to run properly
|
|
sudo apt install wine
|
|
make fix
|
|
```
|
|
|
|
Alternatively, you can also prepare to build with additional audio languages, like this (multiple commands per build possible):
|
|
|
|
```
|
|
make french_audio
|
|
make german_audio
|
|
make russian_audio
|
|
make spanish_audio
|
|
```
|
|
You still have run `make` after this.
|
|
|
|
Also you can build with all audio languages integrated with this shortcut:
|
|
|
|
```
|
|
make all_languages
|
|
```
|
|
|
|
This requires additional *.vpk files copied to the root of folder `vpk/` (since the original Portal keeps only one language at the same time, you have to copy these files!):
|
|
|
|
- German:
|
|
```
|
|
portal/portal_sound_vo_german_000.vpk
|
|
portal/portal_sound_vo_german_dir.vpk
|
|
```
|
|
|
|
- French:
|
|
```
|
|
portal/portal_sound_vo_french_000.vpk
|
|
portal/portal_sound_vo_french_dir.vpk
|
|
```
|
|
|
|
- Russian:
|
|
```
|
|
portal/portal_sound_vo_russian_000.vpk
|
|
portal/portal_sound_vo_russian_dir.vpk
|
|
```
|
|
|
|
- Spanish:
|
|
```
|
|
portal/portal_sound_vo_spanish_000.vpk
|
|
portal/portal_sound_vo_spanish_dir.vpk
|
|
```
|
|
|
|
<br/>
|
|
|
|
## Build with Docker
|
|
|
|
Using the docker image the only setup step you need is to populating the vpk folder. After that you can build the docker image using
|
|
|
|
Build the Docker image.
|
|
|
|
```sh
|
|
make -f Makefile.docker image
|
|
```
|
|
|
|
<br />
|
|
|
|
Then build the rom using
|
|
|
|
```sh
|
|
make -f Makefile.docker
|
|
```
|
|
|
|
That will generate the rom at `/build/portal64.z64`
|
|
|
|
<br />
|
|
|
|
## Current New Feature TODO List
|
|
- [ ] add translations to menus
|
|
- [ ] check if display list is long enough
|
|
- [ ] pausing while glados is speaking can end her speech early
|
|
- [x] jump animation
|
|
- [x] optimize static culling
|
|
- [x] figure out why portals sometimes are in front of window
|
|
- [x] portal hole cutting problems
|
|
- [x] crashed when dying in test chamber 05 when hit by pellet in mid air while touching a portal
|
|
- [x] rumble pak support
|
|
- [x] valve intro
|
|
- [x] polish up subtitles
|
|
- [x] more sound settings
|
|
- [x] add desk chairs and monitors
|
|
- [x] Add auto save checkpoints
|
|
- [x] Correct elevator timing
|
|
|
|
## Current New Sounds TODO List
|
|
- [ ] Box collision sounds
|
|
- [x] Ambient background loop
|
|
- [x] Unstationary scaffolding moving sound
|
|
|
|
## Current Bug TODO List (Hardware Verified) (High->Low priority)
|
|
----------------------- v8
|
|
- [ ] Two wall portals next to eachother can be used to clip any object out of any level by pushing it into corner, then dropping.
|
|
- [ ] Passing into a ceiling portal can sometimes mess with the player rotation
|
|
- [x] player can clip through back of elevator by jumping and strafeing at the back corners while inside.
|