al_reconfigure_joysticks(3alleg5)

💅 al_reconfigure_joysticks — the Allegro 5 API, but make it make sense ✨

okay bestie, so we're in the 3alleg5 section of the Allegro reference manual, and today's main character is al_reconfigure_joysticks. she's a lil function, she's lowkey iconic, and she's about to fix ur whole joystick situation 🎮💖

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

bool al_reconfigure_joysticks(void)

that's it. that's the whole vibe. no args, no drama, just a bool coming back at u 🫶

---

🌸 DESCRIPTION 🌸

so Allegro is highkey able to cope with users plugging in and unplugging joystick devices on-the-fly — like, mid-game, no restart, no nothing. so slay of her 💅

On existing platforms, the joystick event source will generate an event of type ALLEGRO_EVENT_JOYSTICK_CONFIGURATION when a device is plugged in or unplugged. and when that happens? that's ur cue, bestie. u should call al_reconfigure_joysticks(3alleg5) in response. she's literally the answer to that event, no cap ✨

Afterwards, a few things may have shifted:

• the number returned by al_get_num_joysticks(3alleg5) may be different
• the handles returned by al_get_joystick(3alleg5) may be different, or they may be ordered differently

and ngl, that's just how it is. not me being dramatic, that's literally what the docs say 😭

Here's the part u need to remember tho, fr fr:

All ALLEGRO_JOYSTICK(3alleg5) handles remain valid, but handles for disconnected devices become inactive:

• their states will no longer update
• al_get_joystick(3alleg5) will not return the handle

Handles for devices which remain connected will continue to represent the same devices. and here's the glow-up moment — previously inactive handles may become active again, being reused to represent newly connected devices. recycling queen 👑

She returns true if the joystick configuration changed, otherwise she returns false. that's the whole return value, babes, no surprises 💜

🎀 heads up: it is possible that on some systems, Allegro won't be able to generate ALLEGRO_EVENT_JOYSTICK_CONFIGURATION events. if that's ur situation, don't panic — if ur game has an input configuration screen or something similar, u may wish to call al_reconfigure_joysticks(3alleg5) when entering that screen. little manual refresh moment, iykyk ✨

---

🦋 SEE ALSO 🦋

• al_get_joystick_event_source(3alleg5)
• ALLEGRO_EVENT(3alleg5)

---

and that's the tea, bestie 🍓 this was al_reconfigure_joysticks(3alleg5) from the Allegro reference manual — go forth, reconfigure ur joysticks, and stay iconic 👑💖