Device APIsUpdated 2026-07-24

LED and rumble functions

Provide visible or haptic status feedback while respecting controller support and current Zen function details.

Overview

Controller LED functions set, inspect, blink, and reset supported controller lights. PS4 lightbar helpers are Zen-only according to the official table.

Rumble functions inspect, set, block, and restore motor output. set_rgb and set_hsb belong to the separate Zen device LED API.

Key facts

Core LED and rumble helpers are listed for Zen and Plus.
get_ps4_lbar and set_ps4_lbar are Zen-only.
set_rgb and set_hsb control the Zen device LED, not a controller light.
block_rumble remains active until reset_rumble or script unload.

GPC syntax examples

Examples are intentionally small. Replace identifiers only with values documented for your target.

Block rumble on a button edgeexample.gpc

main {
    if (event_press(XB1_A)) {
        block_rumble();
    }
}

Functions, commands, and terms

Names below are catalog entries, not guessed signatures. Open the official sources for current parameter and return-value details.

NameKindPurpose

set_ledfunction · Zen and Plus

Sets a controller LED state.

get_ledfunction · Zen and Plus

Gets a controller LED state.

set_ledxfunction · Zen and Plus

Blinks a controller LED a selected number of times.

get_ledxfunction · Zen and Plus

Reports whether set_ledx is blinking an LED.

reset_ledsfunction · Zen and Plus

Returns LED control to the console.

get_ps4_lbarfunction · Zen only

Gets a PS4 lightbar color channel.

set_ps4_lbarfunction · Zen only

Sets the PS4 controller lightbar color.

get_rumblefunction · Zen and Plus

Returns a rumble motor's current value.

set_rumblefunction · Zen and Plus

Sets a rumble motor speed.

block_rumblefunction · Zen and Plus

Blocks rumble signals from the console until reset.

reset_rumblefunction · Zen and Plus

Returns rumble control to the console and clears a block.

set_rgbfunction · Zen only

Sets the Cronus Zen device LED with RGB values.

set_hsbfunction · Zen only

Sets the Cronus Zen device LED with HSB values.

Common mistakes

Treating set_rgb as a controller lightbar function.

Forgetting to reset blocked rumble.

Passing undocumented LED or rumble channel numbers.

Official GPC sources

Use these first-party references to confirm exact syntax and runtime behavior for your installed firmware and Studio version.

Official documentationOfficial LED functionsgpc.cronusmax.com/functions-and-commands/controller-functions/leds ↗Official documentationOfficial rumble functionsgpc.cronusmax.com/functions-and-commands/controller-functions/rumble ↗Official documentationOfficial device functionsgpc.cronusmax.com/functions-and-commands/internal-functions/device-functions ↗