Clarify vpk directory structure in add_vpk_here.md

This commit is contained in:
Matt Penny 2024-08-13 00:07:48 -04:00
parent d6af2ebb46
commit 21a120846a

View file

@ -1,114 +1,124 @@
# Source Portal Files # Source Portal Files
Copy the entire Portal folder, or create a symbolic link, in this folder Copy the entire Portal folder, or create a symbolic link, in this folder (`vpk/`).
``` ```sh
ln -s SteamLibrary\steamapps\common\Portal\ Portal ln -s SteamLibrary\steamapps\common\Portal\ Portal
``` ```
- If you want multi-language support, copy `portal_sound_vo_*.vpk` files commonly found in `SteamLibrary\steamapps\common\Portal\` to this directory. At a minimum, the following directory structure is required:
(these files need to be copied, because the original Portal keeps only the files of ONE language at a time)
Change the current language for Portal in Steam to the desired language after Portal updates to the new language, copy the new language files and paste them in portal64/vpk.
Do this for each one of the languages you want to add to the ROM.
- German:
```
portal/portal_sound_vo_german_000.vpk
portal/portal_sound_vo_german_dir.vpk
```
```
make german_audio # Set up the files to add German audio to the ROM.
```
- French:
```
portal/portal_sound_vo_french_000.vpk
portal/portal_sound_vo_french_dir.vpk
```
```
make french_audio # Set up the files to add French audio to the ROM.
```
- Russian:
```
portal/portal_sound_vo_russian_000.vpk
portal/portal_sound_vo_russian_dir.vpk
```
```
make russian_audio # Set up the files to add Russian audio to the ROM.
```
- Spanish:
```
portal/portal_sound_vo_spanish_000.vpk
portal/portal_sound_vo_spanish_dir.vpk
```
```
make spanish_audio # Set up the files to add Spanish audio to the ROM.
```
The end results should be a folder structure like this
``` ```
vpk/ vpk/
Portal/ -- symbolic link to Portal └── Portal/
portal_sound_vo_german_000.vpk ├── hl2/
portal_sound_vo_german_dir.vpk │ ├── media/
portal_sound_vo_french_000.vpk │ │ └── valve.bik
portal_sound_vo_french_dir.vpk │ |── resource/
portal_sound_vo_russian_000.vpk │ | ├── gameui_english.txt
portal_sound_vo_russian_dir.vpk │ | └── valve_english.txt
portal_sound_vo_spanish_000.vpk | ├── hl2_misc_000.vpk
portal_sound_vo_spanish_dir.vpk | ├── hl2_misc_001.vpk
| ├── hl2_misc_002.vpk
| ├── hl2_misc_003.vpk
| ├── hl2_misc_dir.vpk
| ├── hl2_sound_misc_000.vpk
| ├── hl2_sound_misc_001.vpk
| ├── hl2_sound_misc_002.vpk
| └── hl2_sound_misc_dir.vpk
└── portal/
├── resource/
| ├── closecaption_english.txt
| └── portal_english.txt
├── portal_pak_000.vpk
├── portal_pak_001.vpk
├── portal_pak_002.vpk
├── portal_pak_003.vpk
├── portal_pak_004.vpk
├── portal_pak_005.vpk
└── portal_pak_dir.vpk
``` ```
## Add multiple audio languages
Only English is audio included by default. If you want multi-language support,
copy the `portal_sound_vo_*.vpk` files found in `SteamLibrary/steamapps/common/Portal/portal`
to `vpk/`. These files need to be copied, because the original Portal keeps only
the files of ONE language at a time.
Change the current language for Portal in Steam to the desired language. After
Portal updates to the new language, copy the new language files and paste them
in `vpk/`.
Do this for each one of the languages you want to add to the ROM.
* German:
``` ```
make all_languages # This command runs `make` for you after the language files are set up. portal/portal_sound_vo_german_000.vpk -> vpk/
portal/portal_sound_vo_german_dir.vpk -> vpk/
``` ```
## Add multipal subtile languages. ```sh
make german_audio
If desired place the following files in portal64/vpk.
``` ```
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 * French:
Portal/hl2/hl2_sound_misc_001.vpk ```
Portal/hl2/hl2_sound_misc_002.vpk portal/portal_sound_vo_french_000.vpk -> vpk/
Portal/hl2/hl2_sound_misc_dir.vpk portal/portal_sound_vo_french_dir.vpk -> vpk/
```
```
make french_audio
```
Portal/hl2/hl2_misc_000.vpk * Russian:
Portal/hl2/hl2_misc_001.vpk ```
Portal/hl2/hl2_misc_002.vpk portal/portal_sound_vo_russian_000.vpk -> vpk/
Portal/hl2/hl2_misc_003.vpk portal/portal_sound_vo_russian_dir.vpk -> vpk/
Portal/hl2/hl2_misc_dir.vpk ```
```
make russian_audio
```
Portal/hl2/media/valve.bik * Spanish:
```
portal/portal_sound_vo_spanish_000.vpk -> vpk/
portal/portal_sound_vo_spanish_dir.vpk -> vpk/
```
```
make spanish_audio
```
Portal/hl2/resource/gameui_english.txt * All languages:
Portal/hl2/resource/gameui_<your desired language 1>.txt ```
Portal/hl2/resource/gameui_<your desired language 2>.txt portal_sound_vo_german_000.vpk -> vpk/
portal_sound_vo_german_dir.vpk -> vpk/
portal_sound_vo_french_000.vpk -> vpk/
portal_sound_vo_french_dir.vpk -> vpk/
portal_sound_vo_russian_000.vpk -> vpk/
portal_sound_vo_russian_dir.vpk -> vpk/
portal_sound_vo_spanish_000.vpk -> vpk/
portal_sound_vo_spanish_dir.vpk -> vpk/
```
```sh
# This will also build the ROM
make all_languages
```
Portal/hl2/resource/valve_english.txt After setting up your desired languages, you can run `make` to build the ROM as
Portal/hl2/resource/valve_<your desired language 1>.txt normal.
Portal/hl2/resource/valve_<your desired language 2>.txt
Portal/portal/resource/closecaption_english.txt ## Add multiple subtile languages
Portal/portal/resource/closecaption_<your desired language 1>.txt
Portal/portal/resource/closecaption_<your desired language 2>.txt
Portal/portal/resource/portal_english.txt To include additional subtitle languages, copy the following files from the
Portal/portal/resource/portal_<your desired language 1>.txt original Portal game directory into the corresponding locations under `vpk/Portal/`
Portal/portal/resource/portal_<your desired language 2>.txt (see above).
``` ```
hl2/resource/gameui_<language>.txt
hl2/resource/valve_<language>.txt
portal/resource/closecaption_<language>.txt
portal/resource/portal_<language>.txt
```
If copying or symlinking the entire Portal game directory to `vpk/`, these are
picked up automatically.