Khaos Folder Icons
On this page
Icons and colours for Content Browser folders, shared with the team through Config/DefaultEditor.ini.
Using it
One folder: right-click it, Set Team Style, pick an icon and/or a colour. The search box filters the icons by name and by keyword, so sound finds Audio, Music and Waveform. Clear Team Style removes the folder's own rule again.
Many folders: Project Settings > Plugins > Folder Icons (or Edit Rules... in the same menu). Each rule is a pattern plus an icon and/or a colour.
| Pattern | Styles |
|---|---|
/Game/Creatures |
that folder |
/Game/Creatures/* |
the folders directly inside it |
/Game/Creatures/** |
Creatures and everything below it |
Textures |
every folder called Textures, at any depth |
/Game/Maps/L_* |
folders in Maps whose name starts with L_ |
Paths are the ones Copy Path gives (/Game/..., /PluginName/...).
Icon and colour are decided separately, each by the most specific rule that sets it:
- a rule for the exact folder (what the right-click menu writes),
- then the pattern that spells out the most folder names without wildcards,
- then, between equals, the rule lower in the list,
- and only where no rule of the project's decides, the default rules below.
The engine's own Set Color is per user and still wins over the team colour on that user's machine.
Default rules
The plugin ships icons for conventional folder names (Blueprints, Maps, Materials, Textures, Meshes, Audio, UI, ...) in its own Config/DefaultKhaosFolderIcons.ini. Project Settings lists them, read-only, under Defaults.
Every rule of the project's outranks them, so to restyle one, add a rule for the same pattern: Maps with another icon, or with the icon ticked and left on Plain folder to switch it off.
To change the list itself for one project, give the project a Config/DefaultKhaosFolderIcons.ini with the same section. The engine layers it over the plugin's file:
[/Script/KhaosFolderIcons.KhaosFolderIconsSettings]
-DefaultRules=(Pattern="Props",bOverrideIcon=True,Icon="Crate")
+DefaultRules=(Pattern="Biomes",bOverrideIcon=True,Icon="Environment")
A - line has to match the plugin's line exactly; !DefaultRules=ClearArray drops them all. This only works in a file named after the plugin: the engine never reads a DefaultEditor.ini or DefaultGame.ini from a plugin's Config folder.
Adding icons
An icon is the engine's folder with a glyph on it. A glyph is one SVG file named after the icon:
- shipped ones live in
Resources/Glyphs, - a project's own go in
<Project>/Config/FolderIconsand replace a shipped glyph of the same name.
Any single-colour SVG with a viewBox works (filled or stroked). Its colours are ignored: a folder is tinted as one image, so the glyph is always drawn as a darker shade of the folder. Keep shapes bold, and overlapping shapes merged into one path: in the folder tree a glyph is about 8 pixels across, and each shape is darkened on its own.
Search keywords go in a data-tags attribute on the <svg> tag, separated by spaces: <svg viewBox="0 0 16 16" data-tags="fish creature sea">. The file name is always searchable.
Reload Icons in the Set Team Style menu picks up new or edited files without restarting.
How it works
The Content Browser's folder widgets ask every item on a folder for a custom brush and colour before falling back to their defaults, and the built-in asset data source never answers. UKhaosFolderIconsDataSource adds a second item to folders that does. It reuses the asset source's folder filter, so a folder is listed exactly when it would be without the plugin, and it supports no operations of its own: rename, move and delete still go through the asset source.
The composed icons are written to Intermediate/KhaosFolderIcons and registered as brushes in the editor's app style, the only place those widgets look a brush name up.
Limits
- The column view and List rows below Medium thumbnails draw the plain folder in the team colour. The breadcrumb drop-down shows the icon without the team colour.
- Mount roots (
/Game, a plugin's root) and the Developers folders keep the engine's own art while unstyled; give one its first icon and its tile only changes once that folder view is rebuilt.