forked from mupen64plus/mupen64plus-input-sdl
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
193 lines (155 loc) · 8.33 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
===============================================================================
-------------------------------------------------------------------------------
Mupen64plus-input-sdl README v2.0
-------------------------------------------------------------------------------
===============================================================================
The latest documentation for this plugin can be found in wiki format at:
https://code.google.com/p/mupen64plus/wiki/KeyboardSetup
https://code.google.com/p/mupen64plus/wiki/ControllerSetup
The format and usage of this plugin's "mupen64plus.cfg" configuration options
can be found at:
http://mupen64plus.retrouprising.com/mediawiki/index.php?title=Mupen64Plus_Plugin_Parameters#Input-SDL
-------------------------------------------------------------------------------
Notes about usage of SDL input plugin:
-------------------------------------------------------------------------------
- If one of the enabled controllers has the "mouse" general-purpose config parameters set
to True, the plugin will hide the mouse cursor and 'grab' the mouse pointer. The user
may press the Left Control and Alt keys together to toggle the mouse cursor on and off.
- If X/Y analog axes are mapped to keys, a plain keypress will simulate the joystick
being pressed all the way to the edge. To decrease the amount of simulated joystick
deflection, the user may press Right Control, Right Shift, or Right Ctrl+Right Shift.
-------------------------------------------------------------------------------
Notes for supported joysticks for auto-configuration:
-------------------------------------------------------------------------------
1. Jess Tech Rumble Pad (Saitek Rumble)
The left D-pad is mapped to the D-pad; The joystick is mapped to the left joystick of the gamepad; the C buttons are mapped to the gampad's right joystick. Start button is mapped to start; the A-button is mapped to the lowest button on the gamepad's right front; the B-button to the left button (buttons marked 3 and 1 on my gamepad). The L and R buttons are mapped to the lower left and right rear triggers; the Z button is mapped to the left upper rear trigger. All other buttons are unused.
2. Logitech Dual Action gamepad, Logitech Cordless Rumblepad 2:
The digital pad maps to the N64 d-pad. The left analog stick maps to the N64 analog stick.
The right analog stick maps to the C-buttons, and the buttons 2 and 1 map to A and B.
Button 4 is the Z trigger, and the top shoulder buttons map to the left and right N64 triggers.
Button 10 is the start button.
The bottom shoulder buttons select the memory pack or rumble pak.
3. Logitech Logitech(R) Precision(TM) Gamepad, Gravis GamePad Pro USB
I came up with what I see as one of the few decent configurations (SSB aside) since it allows access to everything but the dpad.
A is L1, B is R1, Z is L2, R is R2, L is select. C buttons are the four buttons, and the dpad acts as the joystick. Not the most orthodox, but it works well.
4. Microsoft Xbox 360 controller and clones:
N64 -> Xbox 360:
analog stick -> left stick
digital pad -> directional pad
R -> right bumper, right trigger
L -> left bumper
Z -> left trigger
A -> A
B -> X
start -> start
C buttons -> right stick
C left -> Y (additionally to right stick)
C down -> B (additionally to right stick)
mempak -> none for now
rumblepak -> none for now
As discussed in issue #478 Xbox 360 controllers should follow the above
mapping convention. If you want to add a Xbox 360 controller clone please
stick to it. As your clone might has different button naming, you can find
Xbox 360 controller button names at
https://en.wikipedia.org/wiki/File:360_controller.svg
Keys that are still unbound are back (aka. select) and left/right stick button
clicks. Those might be used for mempack and rumblepak toggles.
5. MP-8866 Dual USB Joypad:
This is a USB adapter for PlayStation controllers (2).
D-Pad: hat(0)
L-Stick: x:0, y:1
R-Stick: x:2, y:3
Triangle: button(0)
Circle: button(1)
Cross: button(2)
Square: button(3)
L2: button(4)
R2: button(5)
L1: button(6)
R1: button(7)
Start: button(8)
Select: button(9)
L3: button(10)
R3: button(11)
Note: This is when analog mode is selected. If analog is off then D-Pad becomes axes 0/1 and both sticks are disabled (including L3/R3).
6. Nintendo Wiimote Classic
I am on a Mac and used https://code.google.com/p/wjoy/ successfully to connect my Wiimote + Classic Controller.
This is my working Wiimote + Class Controller configuration. You use the Classic Controller for all play, the Wiimote serves only as a host for the Classic Controller. I have swapped the left analog stick set as the C-Buttons and the right analog stick set as the N64 Analog (Y-Axis / X-Axis). This makes playing FPS titles like Perfect Dark a bit more reasonable for me. You can easily switch them by swapping 2 with 4 and 3 with 5 in the axis() sections below.
N64 -> Classic Controller
Z -> L
R -> R
L -> ZL
A -> A
B -> B
Start -> Start (+)
DPad -> DPad
CButtons -> Left Analog
Analog -> Right Analog
Mempak switch -> Home
Rumblepak switch -> Select (-)
7. N64 controller:
All controls are mapped to their proper place on the N64 controller with an Adaptoid or custom hardware with Gamecon driver.
Rumble and Memory packs can be selected with the 'r' and 'm' keys, respectively.
8. Playstation 3 Controller:
Left analog stick - analog stick
Right analog stick - C-pad
D-Pad - D-Pad
Cross - A
Square - B
L1 / R1 - L / R
L2 - Z
Start - Start
9. SAITEK P880:
The gamepad doesnt have enough keys to real assign all buttons. The second
analog stick can be used as button by pushing him insight.
General Configuration:
Digital Pad was used as N64 digital pad, First analog stick was used as N64
Analog stick. The red button was used as N64 Start button. L and R was used
for N64 L and R. Second analog stick axes was used for N64 C buttons and
second "analog stick button" was used for C-down. The first column of keys was
used for A and B and the second and third row was used for C-Buttons - except
for the Button next to the A button which would be C-Down but got the Z
button.
10. Xbox Gamepad (userspace driver)
I created an Input Config for a Xbox 360 controller running with
xboxdrv on a Linux system (http://pingus.seul.org/~grumbel/xboxdrv/).
Z = Left shoulder button
L = Left shoulder trigger
A = A Button
B = X Button
everything else should be obvious.
Unfortunately, you will also have to make some configuration to
xboxdrv to make this work properly. xboxdrv has to be started with the
following config file. The "-as-button" options make sure that the D-
Pad and Trigger are emulated as buttons and the deadzone options make
the C buttons work much better.
The guide=KEY_ESC allows you to quit the emulator by pressing the
guide key on the controller. This is obviously just nice-to-have and
not actually neccessary for the config to work.
[xboxdrv]
silent=true
trigger-as-button=true
dpad-as-button=true
[ui-buttonmap]
guide=KEY_ESC
[axismap]
x2^deadzone:27000
y2^deadzone:27000
11. Saitek Cyborg V.3 Rumble Pad (aka Saitek PS2700)
Honestly, it's one of the best pads that I've used in a long time, so thought I'd contribute this quick config. Basically, Dpad and Analog sticks are unchanged, C-buttons are mapped to the right analog stick, L-R triggers are L1 and R1, Z is mapped to R2, A + B are mapped to X and Square, respectively, start is mapped to the Home button, and Triangle, Square, L2, Start, Select, and the Analog triggers are unused, since it's not intuitive to use them for what's left.
12. Default Keyboard interface:
Analog Pad is "Arrow Keys"
C Up/Left/Down/Right are "I", "J", "K", "L"
DPad Up/Left/Down/Right are "W", "A", "S", "D"
Z trig is "z" key
L and R trigs are "x" and "c"
Start is "Enter" ("Return")
A is "left shift"
B is "left control"
Select Mempack = ","
Select Rumblepack = "."
13. Special modifier keys
- Right-shift key: reduce amplitude of analog joystick X/Y axes by 25%
- Right-control key: reduce amplitude of analog joystick X/Y axes by 50%
- Left-Control + Left-Alt keys: grab or un-grab the mouse cursor (only if mouse control is enabled)
- Left-Windows key: do not auto-center joystick X/Y axes (only when mouse control is enabled)