# Script Search

This is a Godot 4 plugin that provides a quick and easy way to search for scripts.

![Preview Image](docs/img-00.png)

## How to Use

### Searching

Press `Ctrl+P` to open the Search Window. ([You can change this shortcut](#changing-the-shortcut))

Write part of the file name and the search results will be filtered.

![Search Window](docs/img-01.png)

Navigate with `Up` / `Down` Arrows and press `Enter` to select a file. The file will open in the script editor.

### Special Characters

- `:` - Use a colon as the first character to match only the file base name, ignoring the rest of the path.

  For example, searching `:weapon` would match `weapon.gd` but not `weapon/sword.gd`.

- `,` - Use a comma between terms to perform a multi-term search.

  For example, searching `test, weapon` would only match files containing both `test` and `weapon` in their names or paths.

### Changing the Configurations

You can easily edit the Configurations by clicking the config button on the Search Window:

![Config Button](docs/img-02.png)

This will open the Configuration Window, where you can change the parameters:

  - `Allowed Extensions`: What extensions should be included in the search. 
	
	Default: `["gd", "gdshader"]`
  
  - `Directory Blacklist`: What directories should not be included in the search. 
	
	Default: `["res://.godot", "res://addons"]`
  
  - `Case Sensitive`: When enabled, differentiates upper and lower case text.
	
	Default: `false`
  
![Configuration Menu](docs/img-03.png)

Click the `Save` button to apply the changes made to the configurations.

### Changing the shortcut

To modify the default shortcut, navigate to `Project > Project Settings`.

In the `Input Map` tab, add a new action called `addon_script_search_open` and assign an event to it, with the desired key combination:

![Changing default shortcut](docs/img-04.png)

Reload the plugin, and the new shortcut should take effect.

## Assets

Icons from [Onscreen Controls](https://kenney.nl/assets/onscreen-controls) by Kenney.