srconfigs

A simple-to-use set of configuration files for speedrunning Portal 2 and its mods with SAR.

Installation

Place all these config files within the Portal 2/portal2/cfg directory, as is; they should automatically be run by the game as necessary. Ensure SAR is installed. Refer to the Speedrun Setup Guide for a video tutorial.

Binds

You must set the following binds for the configs to function correctly:

bind mwheelup +scrollup
bind mwheeldown +scrolldown

When used in Portal Reloaded, the commands to shoot portals are +att1, +att2, and +att3. Therefore you should set these binds:

bind mouse1 +att1; bind mouse2 +att2; bind mouse3 +att3

It is recommended to change your chat bind (say) to the more general chat provided by srconfigs.

bind <key> chat

You can bind the following commands:

dialogue_toggle - toggle the dialogue from glados, wheatley, and the announcer
funneling_toggle - toggle portal funneling
fullbright_toggle - toggle fullbright
customsens_toggle <sensitivity> - toggle custom sensitivity
useswap_toggle - toggle scrollup being use
supershoot_toggle - toggle scroll being shoot
30fps_toggle - toggle 30fps mode (for coop button glitches and certain SLA tricks)
contimes_toggle - toggle seeing contimes text (e.g. for double dialogue skip)
slowwalk_toggle <speed> - toggle walking speed
toggleduck - toggle being crouched
togglesprint - (for INFRA) toggle sprinting
swapsplit - switch between the blue and orange robots when playing solocoop
do_load <save name> - load a save only if in non-CM singleplayer. (Deprecated - see cm_only and non_cm_only below)
do_reset - reset your run
viewsnap_next - go to the next viewsnap setting. Refer to viewsnap.cfg for routes.
reset_sens - resets sensitivity after doing viewsnaps.

All of the _toggle binds also have +/- versions; e.g. +supershoot can be bound to enable supershoot only while a key is held.

The aliases cm_only, non_cm_only, cat_only, and non_cat_only can be used to make a bind only effective in certain cases, e.g. bind r "cm_only do_reset; cat_only amc stopvideos"

HUD text

Every toggle has a piece of associated HUD text which can be shown or hidden at will.

The text visibility can be changed using sar_hud_show_text and sar_hud_hide_text; for instance, sar_hud_show_text 2 will show the text corresponding to fullbright. The text IDs are below.

0: dialogue
1: funneling
2: fullbright
3: customsens
4: useswap
5: supershoot
6: 30fps
7: contimes
8: slowwalk

Customisation svars

You can customise the behaviour of srconfigs by setting the following svars using the svar_set command.

For instance, svar_set no_dialogue_toasts 1 will disable dialogue fade toasts.

Name	Default	Description
`sp_use_save`	2	Selects which save to use for Portal 2 Fullgame, Any%, and Chapter 1 runs. 0 - no save, 1 - containerridesave, 2 - vault save.
`mel_use_save`	0	Selects which save to use for Portal Stories: Mel runs. 0 - no save, 1 - tram save.
`aptag_use_save`	0	Selects which save to use for Aperture Tag runs. 0 - no save, 1 - intro save.
`afterhours_use_save`	0	Selects which save to use for After Hours runs. 0 - no save, 1 - after hours vault save.
`ireland_use_save`	0	Selects which save to use for Aperture Ireland runs. 0 - no save, 1 - ireland vault save.
`mindescape_use_save`	0	Selects which save to use for Mind Escape runs. 0 - no save, 1 - mind escape vault save.
`p1dp2_use_save`	0	Selects which save to use for P1 Done P2 runs. 0 - no save, 1 - p1dp2 vault save.
`welcomeback_use_save`	0	Selects which save to use for Welcome Back runs. 0 - no save, 1 - welcome back vault save.
`no_dialogue_toasts`	0	When 1, disable all dialogue fade toasts.
`no_dialogue_toasts_sp`	0	When 1, disable dialogue fade toasts in singleplayer.
`no_dialogue_toasts_coop`	0	When 1, disable dialogue fade toasts in coop.
`no_taunt_toasts_coop`	0	When 1, disable `[taunt]` toasts in coop.
`show_map_name_coop`	1	When 1, show the current map name in coop.
`show_blank_fades`	1	When 1, show `[no fade]` for maps that don't have a dialogue fade.
`cm_hud_behavior`	1	Changes the behavior of `sar_disable_challenge_stats_hud`. -1 - Closes instantly, 0 - Doesn't automatically close, 1 - Closes after flashing.
`coop_cm_enable_hud`	1	When 1, don't disable the CM stats HUD in coop. Otherwise, stats hud reflects behavior of `cm_hud_behavior`.
`coop_no_stopvideos`	0	When 1, don't run `stopvideos` on every coop load.
`coop_no_remoteview`	0	When 1, don't enable remote view on every coop load.
`coop_no_remoteview_lobby`	0	When 1, don't enable remote view on coop loads into the Lobby. Turn this on if you experience lag in the Lobby.
`mel_fps_config`	1	FPS config to use for Portal Stories: Mel. 0 - none, 1 - max fps, 2 - viewmodel enabled.
`solocoop_fullscreen`	0	When 1, have one fullscreen view in Solo Coop instead of splitscreen.
`cm_attempt_counter`	1	When 1, show an attempt counter on the SAR HUD in CM.
`cm_ghost_server`	-1	When 1, connect to a world-wide ghost server when playing CM.
`chapter_il_betsrighter`	1	When 1, give [Betsrighter] in relevant Chapter IL runs. (i.e. chapter 2-9 in Portal 2)
`chapter_il_fly`	1	When 1, give [Crouch Fly] in relevant Chapter IL runs. (i.e. chapter 9 in Portal 2)
`useswap_invert`	0	When 1, invert the useswap toggle so that `+useswap` makes both scrolls jump.
`useswap_both`	0	When 1, make the useswap toggle affect `+scrolldown` as well as `+scrollup`.
`supershoot_use_orange`	0	When 1, make the supershoot toggle shoot the orange portal instead of blue.
`cm_keep_pb_only`	0	When 1, only store PB demos in CM. Requires [CM board autosubmission] to be set up!
`fullbright_amount`	0.1	The value to use for `mat_ambient_light` when toggling fullbright.
`anypc_transition_time`	0	`ui_loadingscreen_transition_time` for the `anypc` category.
`enable_menu_transitions`	0	Re-enables the transition effects in menus.
`viewsnap_dpi_scale`	500	The value to use for `sar_dpi_scale` when doing viewsnaps.
`viewsnap_enable_on_load`	0	Whether to activate certain viewsnaps ([in CM only]) upon loading the map.
`viewsnap_crazy_box`	easy	Viewsnap route for Crazy Box in Fullgame. Can be changed to `hard`.
`demo_folder_name`	demos	Name of the folder for demos. e.g. `.../steamapps/common/Portal 2/portal2/demos/...`

Name	Default
`fullgame_demo_name`	`%Y-%m-%d_%H-%M-%S/fullgame`
`anypc_demo_name`	`%Y-%m-%d_%H-%M-%S/anypc`
`sp_cm_demo_name`	`chapter$chapter/$map/$map`
`amc_demo_name`	`$role/%Y-%m-%d_%H-%M-%S/amc`
`ac_demo_name`	`$role/%Y-%m-%d_%H-%M-%S/ac`
`solocoop_demo_name`	`%Y-%m-%d_%H-%M-%S/solocoop`
`coop_cm_demo_name`	`$role/course$course/$map/$map`
`il_demo_name`	`chapter$chapter/$map/$map`
`chapter_il_demo_name`	`$role/$chapter_course/%Y-%m-%d_%H-%M-%S/$chapter_course`
`celeste_demo_name`	`%Y-%m-%d_%H-%M-%S/celeste`
`reverse_demo_name`	`%Y-%m-%d_%H-%M-%S/reverse`
`workshop_demo_name`	`%Y-%m-%d_%H-%M-%S/workshop`

Demo names may use the following strings:

$chapter / $course - interchangeable. The number of the chapter (e.g. 8)
$chapter_name / $course_name - interchangeable. The name of the chapter (e.g. the-itch)
$chapter_course - e.g. chapter1 in SP or course1 in coop
$map - the human-readable map name (e.g. triple-laser)
$formatted_map - the human-readable map name in title case and spaced (e.g. Triple Laser)
$role - in coop, either blue or orange
$partner - in coop, the name of the other player. Must first be added with partner_add "<name>"
Other strftime timestamp syntax

Chapter ILs

Chapter ILs have an extra command you should use in order to set which chapter you're running.

The command run_cur_chapter will set up chapter ILs to run the chapter for the map you're currently in; or alternatively, you can use the command run_chapter 5 (for instance) to set it up to run chapter 5.

This will automatically force the chapter_il category (so you should use auto to later switch to other categories). Once you've set the chapter to run, you can use your reset bind etc as normal.

CM Autoreset

Included in srconfigs is a feature that automatically resets CM (Challenge Mode) runs if you don't reach splits by certain times.

To use this functionality, make a folder in the uppercase Portal 2 directory called autoreset. In this folder, make a file called <map>.txt where <map> is what you get from svar_get map while on the map, e.g. portal-gun.txt.

Then, on each line in this file you can add the tick number at which the run should be reset. For example, with the following portal-gun.txt:

The run would be automatically reset if you didn't reach the Door Trigger in 5.267 seconds (316 ticks), the Drop Trigger in 11.433 seconds (686 ticks), etc.

The sar_speedrun_result command will output these tick values at the end of each split line.

If a certain split doesn't matter, you can set its cutoff time to that of the next split, as shown above on the fourth split.

Extra configuration

Rather than modifying this autoexec.cfg directly, it is highly recommended you put any "personal" configuration (e.g. setting svars, performing HUD customisation) in extra.cfg. This file will be run once by the autoexec. This file should be used in order to make updating this set of config files easier; as long as the autoexec is never modified, updates should be a simple drag-and-drop process.

In this file you can define extra categories if you wish, using the add_cat and detect_cat commands. For instance, to add a category named "tournament" and automatically switch to it when on a specific map, simply add this to extra.cfg:

add_cat tournament
detect_cat tournament "map=workshop/123456/map_name"

When this category is activated, as well as every map load in which it is enabled, the file cats/tournament.cfg will be execd; this file should therefore contain the necessary configuration for the category. Look at the built-in category files for an example.

For more information about Portal 2 mods and their speedruns, check out the p2mod-speedrun-utils repository!

p2sr / srconfigs

readme