Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/cdc-sys/statuses-mod/llms.txt

Use this file to discover all available pages before exploring further.

The Statuses mod lets you update your presence directly from inside Geometry Dash without leaving the game. This page walks through every step of the status-change flow — from opening the picker to setting a custom status with an expiration time.
You must be authenticated before you can change your status. If you have not completed authentication yet, tapping the status icon starts the authentication flow instead of opening the status picker. See Authentication for details.

Changing your status

1

Open your profile

Tap your username in the main menu, or navigate to your profile through the Friends list. Your profile page is the only place where the status icon is interactive — it is displayed as a tappable button next to your username.
2

Tap the status icon

Tap the status icon next to your username. This opens the StatusChangeLayer popup, which lists every status type you can set: Online, Idle, Do Not Disturb, Invisible, and Custom.
3

Choose a status

Select any status from the list. For all statuses except Custom, your status updates immediately and the popup closes. Your new status is broadcast live to anyone viewing your profile or a leaderboard you appear on.If you previously had a custom status, you can also tap Clear custom status to remove it and return to a standard status type.
4

Enter a custom status (optional)

If you select Custom, the CustomStatusLayer opens. This is a two-page interface:
  • Page 1 — Status text: Type your custom status in the text input. A character counter shows how many characters you have remaining.
  • Page 2 — Expiration: Use the arrow controls to pick an expiration time from the available options. When the expiration time passes, the mod clears your custom status automatically. You can skip this page if you want the custom status to persist indefinitely.
Switch between pages using the navigation controls inside the layer.
5

Confirm

Confirm your selection. Your status — including any custom text — is sent to the Statuses server and immediately visible to other players.

Clearing a custom status

Inside the StatusChangeLayer popup, the Clear custom status button removes your custom status text and resets your status to the default. Use this when you no longer want a custom message displayed.

Automatic idle

The Statuses mod switches your status to Idle automatically when Geometry Dash is sent to the background — for example, when you switch to another app on Android. When you return to the game, your status reverts to Online automatically.
Automatic idle only triggers when your current status is Online. If you are already set to Idle, Do Not Disturb, Invisible, or Custom, backgrounding the app does not change your status.

Status persistence

Your status is stored server-side and tied to your authenticated account. This means:
  • Your status survives game restarts — you do not need to set it again each session.
  • Your status is tied to your Geometry Dash account token, so it cannot be spoofed by other players.
  • Changes made from any device running the mod are reflected immediately everywhere your status appears.

Build docs developers (and LLMs) love