MapBase/source-sdk-2013-mapbase
1
0
Fork 0
mirror of https://github.com/mapbase-source/source-sdk-2013.git synced 2025-01-12 23:07:55 +03:00
Code Issues Packages Projects Releases Wiki Activity

Updated Setting up Mapbase (markdown)

Blixibon 2020-07-04 11:56:02 -05:00
parent 78ea35b557
commit 94b9bec5c5
1 changed files with 20 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
Setting-up-Mapbase.md

@ -8,7 +8,7 @@ First off, get the latest version by downloading [the latest build](https://www.
* Extract `mapbase_episodic`, `mapbase_hl2`, and `mapbase_shared` from the .zip archive downloaded earlier to your “SteamApps/sourcemods” directory.
* Restart Steam.
You should now have “Mapbase - Episodic” and “Mapbase - HL2” in your Steam library. If not, make sure you're using the same drive Steam is installed on and ensure that you extracted the folders correctly. (e.g. "SteamApps/sourcemods/mapbase_shared")
You should now have “Mapbase - Episodic” and “Mapbase - HL2” in your Steam library. If not, make sure you're using the same drive Steam is installed on and ensure that you extracted the folders correctly. (e.g. `SteamApps/sourcemods/mapbase_shared`)
If you have followed all instructions correctly, Mapbase should be fully playable at this point. `mapbase_episodic` is for the HL2 episodes, `mapbase_hl2` is for the original HL2, and `mapbase_shared` just contains miscellaneous content not unique to Half-Life 2.
@ -16,19 +16,29 @@ If you have followed all instructions correctly, Mapbase should be fully playabl
### <img src="https://developer.valvesoftware.com/w/images/c/cb/Warning.png" width="20"/><img src="https://developer.valvesoftware.com/w/images/c/cb/Warning.png" width="20"/><img src="https://developer.valvesoftware.com/w/images/c/cb/Warning.png" width="20"/> Setting up Mapbase for Hammer has two extra steps compared to setting up Hammer for other mods! <img src="https://developer.valvesoftware.com/w/images/c/cb/Warning.png" width="20"/><img src="https://developer.valvesoftware.com/w/images/c/cb/Warning.png" width="20"/><img src="https://developer.valvesoftware.com/w/images/c/cb/Warning.png" width="20"/>
---
After installing Mapbase itself, you must have three things to use it with Hammer and other SDK tools:
1. A custom game configuration. All that should be different from the original configurations are the FGD directory, the game directory, and the BSP directory.
2. A shortcut to hammer.exe that has the `-game` launch parameter followed by the absolute path to your mod (e.g. `hammer.exe -game "C:\Program Files (x86)\Steam\SteamApps\sourcemods\mapbase_episodic"`). The [Mapbase Multi-Tool](Mapbase-Multi-Tool) can create these shortcuts automatically.
1. A custom game configuration which gets the assets and directories of the mod of your choice.
2. A shortcut to `hammer.exe` that has the `-game` launch parameter followed by the absolute path to your mod (e.g. `hammer.exe -game "C:\Program Files (x86)\Steam\SteamApps\sourcemods\mapbase_episodic"`). The [Mapbase Multi-Tool](Mapbase-Multi-Tool) can create these shortcuts automatically.
3. Map compilation tools that support custom shaders. Slartibarty's Slammin' Source or [Mapbase's custom compilers](https://www.moddb.com/mods/mapbase/downloads/mapbase-compile-tools) can be used. These tools should be placed in the same `bin` directory as `hammer.exe`. See [this article](https://github.com/mapbase-source/source-sdk-2013/wiki/Map-Compilers) for more information on Mapbase's compilers.
Mapbase's default FGDs are located in `mapbase_shared/shared_misc/bin`. You should only have to include `halflife2.fgd`. **Do not** include `base.fgd`.
---
For setting up the game configuration in Hammer, the game and BSP directories depend on which mod you want to map for. If you are mapping for the original Mapbase mods, you must choose between Episodic or HL2. Episodic is based on EP1/EP2 and HL2 is based on the original HL2. Episodic contains newer features and entities introduced in Episode One and Two, which means Episodic is normally more preferable. Since Source SDK Base 2013 Singleplayer comes with Episodic content automatically, neither you nor your players should need to have either episode installed in order to use Mapbase's episodic version.
The custom game config tells Hammer what game/mod you're mapping for. For example, this is what a custom game config for `mapbase_episodic` looks like:
Depending on which version you'll be using, the game directory should be either `mapbase_episodic` or `mapbase_hl2` and the BSP directory should be either "mapbase_episodic/maps" or "mapbase_hl2/maps".
![image](https://user-images.githubusercontent.com/19228257/86517032-3d33f180-bdeb-11ea-9e7f-09335821ee23.png)
Once you’ve set up your new configuration(s), select your configuration of choice and restart Hammer. You should be good to go at that point.
If you are only setting up for Mapbase itself and not a mod using Mapbase, the custom game config would point to `mapbase_episodic` or `mapbase_hl2`. If you are setting up for a separate mod using Mapbase, the custom game config would point to that mod's name instead.
Mapbase's default FGDs are located in `mapbase_shared/shared_misc/bin`. You should only have to include `halflife2.fgd`. **Do NOT** include `base.fgd`. Some derivative mods (e.g. Map Labs) may also have their own FGD which should be used instead.
Once you’ve set up your new configuration(s), select your configuration of choice and restart Hammer. Once you've set up the shortcut and installed compatible compile tools, you should be good to go for mapping with Mapbase.
### Raw configs
Instead of creating a game config in Hammer, you could also modify `bin/GameConfig.txt` directly and insert configs into it.
These are the game configurations I use for both versions of Mapbase respectively:
@ -39,7 +49,7 @@ These are the game configurations I use for both versions of Mapbase respectivel
{
"GameData0" "C:\Program Files (x86)\Steam\SteamApps\sourcemods\mapbase_shared\shared_misc\bin\halflife2.fgd"
"DefaultTextureScale" "0.250000"
"DefaultLightmapScale" "32"
"DefaultLightmapScale" "16"
"GameExe" "C:\Program Files (x86)\Steam\SteamApps\common\Half-Life 2\hl2.exe"
"DefaultSolidEntity" "func_detail"
"DefaultPointEntity" "info_player_start"
@ -61,7 +71,7 @@ These are the game configurations I use for both versions of Mapbase respectivel
{
"GameData0" "C:\Program Files (x86)\Steam\SteamApps\sourcemods\mapbase_shared\shared_misc\bin\halflife2.fgd"
"DefaultTextureScale" "0.250000"
"DefaultLightmapScale" "32"
"DefaultLightmapScale" "16"
"GameExe" "C:\Program Files (x86)\Steam\SteamApps\common\Half-Life 2\hl2.exe"
"DefaultSolidEntity" "func_detail"
"DefaultPointEntity" "info_player_start"
@ -74,6 +84,4 @@ These are the game configurations I use for both versions of Mapbase respectivel
"CordonTexture" "tools\toolsskybox"
"MaterialExcludeCount" "0"
}
}
You can use this as a reference for which paths you need to use and/or adjust the paths to your computer and just stick the configurations in `bin/GameConfig.txt`.
}