RGB

Desktop-Only Content: This information applies only to the Desktop version of Terraria.

Load video

Local File

Local File might collect personal data.

ContinueDismiss

The video shown in the announcement post of Razer Chroma support.

Terraria features built-in RGB lighting effects for supported Razer, Logitech, Corsair and SteelSeries peripherals.

The vendor's respective lighting software must be installed for these effects to function (e.g. Razer Synapse, Logitech G Hub, Corsair iCUE or SteelSeries Engine).

List of effects

Backgrounds

Most background effects have two versions; one for "high detail" peripherals such as keyboards, and one for "low detail" peripherals such as mice, headphones and keypads.

Effects listed lower on the following table will take priority. While multiple effects can be active at any time, those that are not transparent will block out any previous effects. For example, the Rain effect will display on top of most effects due to it being transparent, but the Blizzard effect (which is listed lower and is not transparent) will override it.

Identifier	Display condition	Transparent	Demonstration
Base layer
Sky	Player is in the Space layer or it is nighttime in the world	❌
Surface	Player is in the Surface layer without a Dirt Wall, Cave Wall or Rocks Wall (any type; natural or player-placed) behind them	❌
Vines	Player is in the Surface layer with a Dirt Wall, Cave Wall or Rocks Wall (any type; natural or player-placed) behind them	❌
Underground	Player is in the Underground layer	❌
Caverns	Player is in the Cavern layer	❌
Magma	Player is in the Cavern layer and within 400 tiles of the bottom of the world	❌
Underworld	Player is in the Underworld	❌
Biomes layer
Surface Desert	Player is in the Desert	❌
Surface Jungle	Player is in the Jungle	❌
Surface Ocean	Player is in the Ocean	❌
Surface Snow	Player is in the Snow biome	❌
Surface Mushroom	Player is in a Glowing Mushroom biome	❌
Underground Mushroom	Player is in an Underground Glowing Mushroom biome	❌
Underground Corruption	Player is in the Underground Corruption	❌
Underground Crimson	Player is in the Underground Crimson	❌
Underground Hallow	Player is in the Underground Hallow	❌
Underground Jungle	Player is in the Underground Jungle	❌
Underground Ice	Player is in the Ice biome	❌
Underground Desert	Player is in the Underground Desert	❌
Surface Hallow	Player is in the Hallow	❌
Surface Crimson	Player is in the Crimson	❌
Surface Corruption	Player is in the Corruption	❌
Hive	Player is in front of any Hive Wall	❌
Meteorite	Player is in a Meteorite biome	❌
Temple	Player is in front of a natural Lihzahrd Brick Wall	❌
Dungeon	Player is in the Dungeon	❌
Granite	Player is in front of any Granite Wall	❌
Marble	Player is in front of any Marble Wall	❌
Gem Cave	Player is in front of a natural Gemstone Wall	❌
Shimmer	Player is in the Aether	❌
Corrupt Ice	Player is in a corrupt Ice biome	❌
Crimson Ice	Player is in a crimson Ice biome	❌
Hallow Ice	Player is in a hallow Ice biome	❌
Corrupt Desert	Player is in a corrupt Desert	❌
Crimson Desert	Player is in a crimson Desert	❌
Hallow Desert	Player is in a hallow Desert	❌
Events and bosses layer
Pumpkin Moon	Pumpkin Moon is active	❌
Blood Moon	Blood Moon is active and the Pumpkin Moon/Frost Moon is not active	❌
Frost Moon	Frost Moon is active	❌
Solar Eclipse	Solar Eclipse is active	❌
Solar Pillar	Player is within 4000 pixels (250 tiles) of the Solar Pillar's center	❌
Nebula Pillar	Player is within 4000 pixels (250 tiles) of the Nebula Pillar's center	❌
Vortex Pillar	Player is within 4000 pixels (250 tiles) of the Vortex Pillar's center	❌
Stardust Pillar	Player is within 4000 pixels (250 tiles) of the Stardust Pillar's center	❌
Eye of Cthulhu	Eye of Cthulhu is alive	❌
King Slime	King Slime is alive	❌
Goblin Army	Goblin Army is active	❌
Eater of Worlds	Eater of Worlds is alive	❌
Brain of Cthulhu	Brain of Cthulhu is alive	❌
Queen Bee	Queen Bee is alive	❌
Skeletron	Skeletron is alive	❌
Wall of Flesh	Wall of Flesh is alive	❌
Frost Legion	Frost Legion is active	❌
Queen Slime	Queen Slime is alive	❌
The Twins	Retinazer or Spazmatism is alive	❌
Destroyer	The Destroyer is alive	❌
Skeletron Prime	Skeletron Prime is alive	❌
Pirate Invasion	Pirate Invasion is active	❌
Plantera	Plantera is alive	❌
Golem	Golem is alive	❌
Empress of Light	Empress of Light is alive	❌
Old One's Army	Old One's Army is active	❌
Martian Madness	Martian Madness is active	❌
Lunatic Cultist	Lunatic Cultist is alive	❌
Duke Fishron	Duke Fishron is alive	❌
Deerclops	Deerclops is alive	❌
Moon Lord	Moon Lord is alive	❌
Weather layer
Rain	Rain	✔️
Blizzard	Blizzard	❌
Sandstorm	Sandstorm	❌
Slime Rain	Slime Rain	✔️
Alerts layer
Drowning	Player's breath is below its maximum	✔️
Keybinds	Keybindings menu open	✔️
Lava Indicator	Player is in lava	❌
Moon Lord Spawn	Moon Lord countdown active	❌
Critical alerts layer
Low Life	Player is alive, at 50% or less health, has a healing potion in their inventory and does not have Potion Sickness. The key bound to Quick Heal will flash every half-second.	✔️
Death	Player is dead	❌
Menu layer
Base	Title screen	❌
Surface Mushroom	Title screen, while generating a drunk world	❌

SteelSeries Engine events

Terraria also features integration with SteelSeries Engine, adding events for the player's life, mana and breath percentage.

Hidden settings

Config.json contains a few hidden RGB-related settings:

• UseRazerRGB, UseLogitechRGB, UseCorsairRGB and UseSteelSeriesRGB can be used to enable/disable support for a specific vendor's peripherals.
• RGBUpdatesPerSecond determines how many times per second a device will be sent new lighting information. Defaults to 45.

History

 Desktop version

• Desktop 1.4.4: Added background effects for Deerclops and the Aether.

• Desktop 1.4.2.2: Fixed an issue where SteelSeries support was following the UseLogitechRGB setting instead of UseSteelSeriesRGB.

• Desktop 1.4.1: Added support for SteelSeries peripherals and SteelSeries Engine events.

• Desktop 1.4.0.5: RGB-related error log entries now properly indicate that they are normal messages, and not errors. They also include a message indicating that RGB can be disabled.

• Desktop 1.4.0.1: Introduced.

v · d · e This article has open info requests.
The following is a list of requests for additions or changes to this article. See Category:Article info requests for all current requests across Terraria Wiki.
Config.json's hidden color profiles Specific key highlight effects/colors
When a request is fulfilled, edit this page and remove it. When all requests are fulfilled, remove the {{info request}} template from this page.