Greyscale Auto-Generated Sprites (GAGS)
If you're wanting to add easy recolors for your sprite then this is the system for you. Features include:
There are three main parts to GAGS that you'll need to be aware of when adding a new greyscale sprite:
All configuration files can be found in code/datums/greyscale/json_configs and is where you control how your icons are combined together along with the colors specified from in code.
It contains the sprites that will be used as the basis for the rest of the generation process. You can only have one dmi file specified per configuration but if you want to split up your sprites you can reference other configurations instead.
This is simply some pointers in the code linking together your dmi and the json configuration.
Json Configuration File
The json is made up of some metadata and a list of layers used while creating the sprite. Inner lists are processed as their own chunk before being applied elsewhere, this is useful when you start using more advanced blend modes. Most of the time though you're just going to want a list of icons overlaid on top of eachother.
In this example, we start off by creating a sprite specified by a different configuration. The "type" key is required to specify the kind of layer you defining. Once that is done, the next two layers are grouped together, so they will be generated into one sprite before being applied to any sprites outside their group. You can think of it as an order of operations.
The first of the two in the inner group is an "icon_state", this means that the icon will be retrieved from the associated dmi file using the "icon_state" key.
The last layer is another reference type. Note that you don't need to give colors to every layer if the layer does not need any colors applied to it.
"blend_mode" and "color_ids" are special, all layer types have them. The blend mode is what controls how that layer's finished product gets merged together with the rest of the sprite. The color ids control what colors are passed in to the layer.
Once it is done generating it will be placed in an icon file with the icon state of "icon_state_name". You can use any name you like here.
There are no special requirements from the dmi file to work with this system. You just need to specify the icon file in code and the icon_state in the json configuration.
While the amount of dm code required to make a greyscale sprite was minimized as much as possible, some small amount is required anyway if you want anything to use it.
As an example:
And that's all you need to make it usable by other code:
More configurations can be found in code/datums/greyscale/greyscale_configs.dm
If you want your item to be colorable in a vending machine (or other places if there's ever any support added for that), you should do it like this:
However, be extremely careful, as this requires that you put all of the object's
If you're making a new greyscale sprite you sometimes want to be able to see how layers got generated or maybe you're just tweaking some colors. Rather than rebooting the server with every change there is a greyscale modification menu that can be found in the vv dropdown menu for the greyscale object. Here you can change colors, preview the results, and reload everything from their files.