NS2 Bluetooth Gamepad (Mapper virtuel Xbox 360)

Veuillez vérifier la version v1.8

La version actuelle du ns2-ble-cgamepad.py ne fonctionne pas le "fix" ne fonctionne pas en ce moment utiliser la version précédente (chargée sous ns2-bleak-022.2-vgamepad) avant de corriger le commit avec la version 22.2

Un outil Python pour scanner, connecter et surveiller les contrôleurs compatibles Nintendo Switch (Pro Controller, Joy-Con, GameCube Controller) via Bluetooth, et mapper leur entrée sur un gamepad virtuel Xbox 360 (en utilisant Vgamepad et ViGEmBus sous Windows). Conçu pour la cartographie en temps réel de contrôleur-à-Xbox, la surveillance des bâtons et des boutons, et l'exploration des fonctionnalités sombre Bibliothèque Bluetooth.
Plateforme : Windows uniquement (pour le support virtuel du gamepad).

Certaines fonctions notées ici ne fonctionnent peut-être pas en ce moment si désolé

Remarque: Ce dépôt est une base universelle pour tous les futurs outils et programmes liés à Nintendo Switch et contrôleurs Bluetooth compatibles. Les contributions et les prolongations sont les bienvenues.

Ce dépôt contient des parties de code ou d'information provenant de sources autorisées comme suit :
Droit d'auteur (c) 2025, Jacques Gagnon
SPDX-License-Identificateur : Apache-2.0

Caractéristiques

• Numérisation des périphériques Bluetooth: Découvrez les contrôleurs compatibles Nintendo Switch.
• Cartographie du contrôleur à la boîte X: Les boutons presses et les bâtons analogiques sont cartographiés en direct sur un contrôleur Xbox 360 virtuel (via ViGEmBus).
• Surveillance en temps réel: Voir le bouton presse et le mouvement de bâton en entrée Xbox360.
• Utilisation simple: Aucune configuration nécessaire pour les contrôleurs pris en charge.
• Déboguer la sortie: Sortie de débogage/verbose en option pour le dépannage.
• Ouvrir pour les extensions: Conçu comme base pour d'autres outils Python pour Nintendo et contrôleurs Bluetooth compatibles.

Contrôleurs soutenus

• Contrôleur Nintendo Switch Pro (non testé)
• Nintendo Switch Joy-Con (L/R, seulement séparément, non testé)
• Contrôleur Nintendo GameCube

Démarrer rapidement

Exigences

• Windows 10/11
• Python 3.7+ (essai en 3.12)
• sombre (pip install bleak éprouvé au 0,22.2)
• Vgamepad (pip install vgamepad testé en 0,1.0)
• VIGEMBus conducteur installé

Utilisation

python3 ns2-ble-cgamepad.py [options]

Options:

• -d, --debugActiver la sortie de débogage
• -v, --verboseActiver la sortie de verbe

Contrôles

• Ctrl+CSortie

Remarque: Les commandes interactives (rumble, LED, données brutes, etc.) ne sont pas disponibles dans cette version. Cet outil se concentre sur la cartographie de gamepad et l'entrée Xbox 360 en direct.

Instructions de couplage

1. Mettez le contrôleur en mode appariement:
   • Pro Controller : maintenez le petit bouton d'appariement en haut
   • Joy-Con : maintenez le bouton d'appariement sur le côté
   • Contrôleur GameCube : maintenez le bouton d'appariement sur l'adaptateur
2. Assurez-vous que le contrôleur n'est pas déjà connecté à un autre appareil.
3. Exécutez le programme et suivez les instructions à l'écran.

Feuille de route et contribution

• Ajout du support pour le mode Joy-Con combiné
• Optionnel: Caractéristiques plus interactives (LED)
• Support multiplateforme si des alternatives de pilote virtuel existent

Les contributions, les enjeux et les demandes de fonctionnalités sont les bienvenus!

Licence

Licence MIT
Certaines parties de ce dépôt proviennent de sources autorisées sous Apache-2.0 (voir les avis ci-dessus).

Ce dépôt est destiné à l'expérimentation, à l'apprentissage et à l'interface des contrôleurs. Il n'est pas affilié à Nintendo ni soutenu par lui.

Contributeurs GitHub

flibitijibibo

1 contributions

Nohzockt

39 contributions