BspTexRemap
version 0.3 pre-release 2
About
The suite of programs in this package patches a BSP file, replacing names of embedded textures to those in a given materials.txt, to try and eliminate the need to edit or ship a modified materials.txt, thus increasing map portability.
The match and replacement textures are defined in a
info_texture_remap
entity placed in the map, or in a "_custommat.txt" file alongside the map file, or supplied in an external file.
There are two programs in this package: BspTexRemap.exe (CLI program) and BspTexRemap_GUI.exe (GUI program). I recommend the GUI program to assign the custom materials and export the custom materials file, and the CLI program for the compilation step.
The programs are intended to be used both as standalone and as a compile tool that mappers can use in their mapping workflow.
See the provided HOWTOs for step-by-step instructions.
Features
BspTexRemap.exe (CLI)
- Rewrites embedded texture names to a texture entry in materials.txt with with desired material type.
- Exports texture names to a list file for the purpose of assigning materials.
- Reads configuration from a custom entity placed in map or from external file.
- Use standalone or as part of compile workflow.
BspTexRemap_GUI.exe (GUI)
- Loads and views textures in BSP files, including from external WADs
- Loads materials.txt and display summary on how many suitable entries are in each material type
- Assigns custom materials using the graphical interface, and lists the entries of the custom material remap list
- Exports and loads the custom materials list, for use by the CLI program
- Commit changes to BSP, with optional summary view
- In-program how-to's
Incompatibilities
The game code of the feature that makes this possible was changed in Counter Strike 1.6, Day of Defeat, and possibly Condition Zero and its Deleted Scenes. Thus this tool is incompatible with maps for those games. (you can run them, it just wouldn't work in game)
License
THE MIT LICENSE
see BspTexRemap_license.txt in the zip file.
The About window on BspTexRemap_GUI.exe lists additional attributions and the license information of third party libraries.
F.A.Q. (Fairly Anticipated Questions)
See FAQ.txt in the zip file.
Links
I want to smooth out the GUI program in terms of readability - how intuitive the design is, and how helpful the included how-to's are.
Test it on your map project, or on the maps you got lying around in the _downloads folder.
I got somebody reaching out with a bug but I can't ask for a test file because he's compiling for DoD and I don't have DoD.
Discord id:
youdontmatter.giveup.
(don't ask why)run gui.sh
(name not important) and type these commands: