SDL_HINT_JOYSTICK_BLACKLIST_DEVICES_EXCLUDED(3)

✨ NAME ✨

SDL_HINT_JOYSTICK_BLACKLIST_DEVICES_EXCLUDED — okay bestie, this is a variable holding a whole list of devices that should be considered joysticks. That's the whole vibe. It's a hint, it lives in SDL3's functions crew (iykyk), and it's here to tell SDL who's actually a controller. 🎮💖

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_JOYSTICK_BLACKLIST_DEVICES_EXCLUDED "SDL_JOYSTICK_BLACKLIST_DEVICES_EXCLUDED"

No cap, that's literally the entire synopsis. One include, one define, we move. ✨

---

💅 DESCRIPTION 💅

So here's the tea, bestie: setting this hint overrides both SDL_HINT_JOYSTICK_BLACKLIST_DEVICES and the built in device list. Like, it doesn't play nice and merge with them — it just takes over. Main character energy fr fr. 👑

The format of the string is a comma separated list of USB VID/PID pairs in hexadecimal form, e.g.

0xAAAA/0xBBBB,0xCCCC/0xDDDD

The variable can also take the form of "@file", in which case the named file will be loaded and interpreted as the value of the variable. So instead of cramming your whole list into the string, you just point at a file and it slurps the contents like it's reading your notes app. 🎀

This hint can be set anytime. Not a "before init only" situation — anytime. Slay. 🦋

---

⭐ AVAILABILITY ⭐

This hint has been available since SDL 3.2.0. Baby but iconic. 🍼✨

---

Okay that's the whole page, you ate that. 💅 This little gem comes to you from Simple Directmedia Layer, version SDL 3.4.18 — so like, go forth and classify your devices correctly. 🫶🌈 No notes. Periodt. 💖