## I made this tutorial with <Ubuntu> 24.04.1

## I can only assume it also works with 22.04+

## I link to my sources but I do condense some commands and steps


dick@hardpillU:~$ uname -a
Linux hardpillu 6.8.0-52-generic #53-Ubuntu SMP PREEMPT_DYNAMIC Sat Jan 11 00:06:25 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux

## <lambertjamesd>
## <mwpenny>/<portal64-still-alive>
## <crashoveride95>/<ModernSDK>

## start by cloning the repo

dick@hardpillU:~$ git clone https://github.com/mwpenny/portal64-still-alive.git $HOME/portal64

## link your Portal folder to $HOME/portal64/vpk/

dick@hardpillU:~$ ln -s $HOME/Portal $HOME/portal64/vpk/

## run $HOME/portal64/tools/setup_ubuntu.sh

dick@hardpillU:~$ bash $HOME/portal64/tools/setup_ubuntu.sh

## in order to finish setting up your path you need to logout and back in or source $HOME/.profile

dick@hardpillU:~$ source $HOME/.profile

## we need to install ninja-build

dick@hardpillU:~$ sudo apt -y install ninja-build

## not sure what all this does but it creates $HOME/portal64/build and generates/moves build files into it

dick@hardpillU:~$ cmake -G "Ninja" -B $HOME/portal64/build -S $HOME/portal64 -DCMAKE_TOOLCHAIN_FILE=$HOME/portal64/cmake/Toolchain-N64.cmake

## if you are using the MacOS version of Portal you will need to rename valve.mov to valve.bik

dick@hardpillU:~$ mv $HOME/portal64/vpk/Portal/hl2/media/valve.mov $HOME/portal64/vpk/Portal/hl2/media/valve.bik

## and now we can build with cmake

dick@hardpillU:~$ cmake --build $HOME/portal64/build

## I like to copy my <ROM> to Portal_[date]_[build].z64

dick@hardpillU:~$ cp -v $HOME/portal64/build/portal.z64 $HOME/Portal_$(date +%Y%m%d)_$(git -C $HOME/portal64 rev-parse --short HEAD).z64