@@ -8,57 +8,55 @@ A Lua script for OBS Studio that instantly hides your map in Rust when pressing
88## Features
99
1010- Instantly shows/hides a cover image when holding G or Shift+G
11- - Zero delay on both press and release
11+ - ** FIXED: ** Includes a slight delay on release to prevent the map from flashing.
1212- Persists hotkey settings between OBS sessions
1313- Simple setup process
1414
1515## Requirements
1616
17- - OBS Studio ( version 27.0.0 or newer recommended)
17+ - ** OBS Studio version 27.0.0 or newer is required ** for the timer functionality.
1818- A cover image source set up in OBS
1919
2020## Installation
2121
22- 1 . Download the ` obs-map-hide.lua ` script
23- 2 . In OBS Studio, go to Tools -> Scripts
24- 3 . Click the + button and select the downloaded script
25- 4 . Configure the script settings (see Setup below)
22+ 1 . Download the ` rust- obs-map-hide.lua` script.
23+ 2 . In OBS Studio, go to Tools -> Scripts.
24+ 3 . Click the ` + ` button and select the downloaded script.
25+ 4 . Configure the script settings (see Setup below).
2626
2727## Setup
2828
29291 . In OBS, create an image source that will cover your map:
30- - Click the + under Sources
31- - Select "Image"
32- - Name it "Map Hidden" (or your preferred name)
33- - Choose any image
34- - Position it to cover your map area
35- - Make sure it's hidden by default
30+ - Click the ` + ` under Sources.
31+ - Select "Image".
32+ - Name it "Map Hidden" (or your preferred name).
33+ - Choose any image (a solid color is recommended).
34+ - Position it to cover your map area.
35+ - Make sure it's hidden by default.
3636
37372 . In the Scripts window:
38- - Enter the exact name of your image source
39- - Make sure the source name matches exactly (it's case-sensitive)
38+ - Enter the exact name of your image source.
39+ - ** Make sure the source name matches exactly (it's case-sensitive). **
4040
41413 . Configure hotkeys:
42- - Go to Settings -> Hotkeys
43- - Find "Show Map Cover (Hold G)"
44- - Set it to G
45- - Find "Show Map Cover (Hold Shift+G)"
46- - Set it to Shift+G
47- - Click Apply
42+ - Go to Settings -> Hotkeys.
43+ - Find "Show Map Cover (Hold G)" and set it to ` G ` .
44+ - Find "Show Map Cover (Hold Shift+G)" and set it to ` Shift+G ` .
45+ - Click Apply.
4846
4947## Usage
5048
51- - Hold G or Shift+G to show the cover image
52- - Release the key to hide it
53- - The cover will appear and disappear instantly
49+ - Hold ` G ` or ` Shift+G ` to show the cover image.
50+ - Release the key to hide it.
51+ - The cover will appear instantly and disappear after a brief delay to prevent flickering.
5452
5553## Troubleshooting
5654
5755If the script isn't working:
58- 1 . Make sure the image source name matches exactly what you entered in the script settings
59- 2 . Verify the hotkeys are properly set in OBS Settings -> Hotkeys
60- 3 . Check the Scripts log window for any error messages
61- 4 . Try restarting OBS if the source isn't being found
56+ 1 . Make sure the image source name in the script settings ** perfectly matches ** the source name in your OBS scene.
57+ 2 . Verify the hotkeys are properly set in OBS Settings -> Hotkeys.
58+ 3 . Check the Scripts log window for any error messages ( ` Tools -> Scripts -> Log ` ).
59+ 4 . Ensure you are running OBS Studio version 27.0.0 or newer.
6260
6361## License
6462
0 commit comments