https://mupen64plus.org/wiki/index.php?action=history&feed=atom&title=InputPluginUsageInputPluginUsage - Revision history2026-10-18T14:35:06ZRevision history for this page on the wikiMediaWiki 1.35.14https://mupen64plus.org/wiki/index.php?title=InputPluginUsage&diff=35&oldid=prevRichard42: Supported use cases for Autoconfiguration with Mupen64Plus-Input-SDL plugin2015-07-26T17:45:34Z<p>Supported use cases for Autoconfiguration with Mupen64Plus-Input-SDL plugin</p>
<p><b>New page</b></p><div><br />
=== Use Cases ===<br />
<br />
* '''Use case #1 scenario''': First-time user of Mupen64Plus, has no configuration file.<br />
** '''Desired Behavior''':<br />
*** Automatically detect and configure any supported joysticks, assigning them in sequence to controllers.<br />
*** Skip any unsupported joysticks without leaving unconfigured controllers.<br />
*** If no SDL joysticks are found, configure the keyboard/mouse.<br />
*** Fill in (blank) settings for all 4 controllers (for GUI front-ends)<br />
** '''How to configure''': Automatic.<br />
*** If no configuration is found for a controller (or version is out of date), it will automatically be set to mode 2 (fully automatic), and saved.<br />
<br /><br />
* '''Use case #2 scenario''': User changes controllers often (configuration file is present)<br />
** '''Desired Behavior''':'''<br />
*** Automatically detect and configure any joysticks plugged in<br />
*** Skip any unsupported joysticks without leaving unconfigured controllers.<br />
*** If no SDL joysticks are found, configure the keyboard/mouse.<br />
*** Don't stick to old input settings in configuration file when a different joystick is used<br />
*** User should be able to modify the auto-configured settings (edit InputAutoConfig.ini)<br />
** '''How to configure''': Automatic<br />
*** User should set all controllers to mode 2 (fully auto) in this scenario, and edit his controller preferences in the InputAutoConfig.ini file.<br />
<br /><br />
* '''Use case #3 scenario''': User switches between keyboard and joystick<br />
** '''Desired Behavior''':<br />
*** If joystick is plugged in, then set up according to configuration file (if it matches), or auto-config<br />
*** If no SDL joysticks are found, configure the keyboard/mouse.<br />
** '''How to configure''':<br />
*** User should set all controllers to mode 2 (fully auto) in this scenario, and edit his controller preferences in the InputAutoConfig.ini file.<br />
<br /><br />
* '''Use case #4 scenario''': Developer wants to create a specific input configuration for testing purposes: no controllers, only a controller in port 2, etc.<br />
** '''How to configure''': Set all controller '''<code>mode</code>''' parameters to 0, set other configuration parameters as necessary.<br />
<br /><br />
* '''Use case #5 scenario''': A user wants has several different controllers plugged in, and wants to set a specific one (which may not be SDL joystick 0) to be N64 controller 0. The user also wants the configuration to be automatic (doesn't want to have to set up the joystick manually).<br />
** '''How to configure''': Set controller #1 '''<code>mode</code>''' parameter to 1, and set the SDL joystick name of your desired main controller in to the '''<code>name</code>''' parameter.<br />
<br />
=== Design Changes ===<br />
* changes relative to Hg rev 173:725bc6d288ae<br />
* Changes to <code>[Input-SDL-Control*]</code> sections<br />
** '''<code>version</code>''' changes from 1 to 2<br />
*** Add parameter '''<code>mode</code>''': 0 = Fully Manual, 1 = Automatic with named SDL device, 2 = Fully Automatic. GUI front-ends should make all of the controller's other parameters read-only when the mode is set to 2, and should make all parameters except '''<code>name</code>''' read-only when the mode is set to 1.<br />
*** For the '''<code>device</code>''' parameter, remove the <code>-2</code> option (keyboard input should automatically work for any N64 controller which maps keys), and change the semantic of the <code>-1</code> option to mean "No SDL joystick" instead of "Auto-config". For modes 1 and 2, this parameter will be set by the input plugin. The user can only set this parameter for mode 0.<br />
*** For the '''<code>name</code>''' parameter: Similar to previous usage, but mode-dependent: For mode 0, name of joystick/keyboard which was last used (set by plugin). For mode 1, name of desired joystick/keyboard to use for this controller (set by user). For mode 2, ignored.</div>Richard42