Configuring Joystick and Wingman Controllers:da

Introduktion

Aktiver brug af joystick eller gamepad ved at markere punktet under "Configuration/Controls/Advanced" menuen. Knapperne på joysticket og gamepadet kan så konfigureres ved hjælp af "Configuration/Controls" menuen.

Valve ønsker, i den forbindelse, at takke James Barnes hos "First-Person Gaming, Inc.", for tilladelse til at benytte hans fremragende dokumentation vedrørende joystick understøttelse.

Half-Life understøtter standard joystick, digitale joystick og avancerede kontrol-enheder som f.eks. "FPgaming Assassin 3D", "Logitech WingMan Warrior" og "SpaceTec IMC SpaceOrb".

For at aktivere "Half-Life"'s joystick-understøttelse, må du undersøge om dit joystick står optegnet under "Spilenheder" i Windows kontrolpanel, samt sørge for det er kalibreret og afprøvet. Start så "Half-Life", og marker brug af joystick i "Configuration/Controls/Advanced" i "Half-Life".

For mere avancerede spilenheder, er du også nødt til at have en konfigurations-fil kaldet "joystick.cfg". Typisk skal denne konfigurations-fil hentes fra joystick-producentens hjemmeside. Men du kan godt oprette en selv, og placere den i Half-Lifes underbibliotek "Valve". Half-Life vil så automatisk køre denne fil hver gang du starter spillet.

Konfigurations filer for almindelige spil-enheder er inkluderet herunder.

Half-Life Joystick funktioner

1. Proportional følsomhed (desto længere du flytter joystick fra center-positionen, desto hurtigere bevæger du dig)
2. Understøttelse af op til 32 knapper (JOY1-JOY4 og AUX5-AUX32)
3. Individuel indstilling af følsomheden for hver akse (tillader just‚ring og "omvende" oversættelsen af dine bevægelser)
4. En "død zone" for hver akse (et område hvor joysticket ikke reagerer, praktisk for akser der aldrig kan kalibreres 100%).
5. Understøttelse for alle seks akser (X, Y, Z, R, U og V)
6. Tildeling af en vilkårlig akse til en hvilken som helst handling (Frem, op, træd til siden og drej)
7. Understøttelse for absolutte enheder (som joysticks) og relative enheder (som trackballs og spinners)

Standard joystick indstillingerne er at højre-venstre svarer til at dreje, og frem-tilbage svarer til at gå frem-tilbage. For at ændre højre-venstre så det svarer til at træde til siden ("strafing"), tildeles en "Joystick look modifier" til en af dine knapper eller akser (dette gøres også ved hjælp af "Configuration/Controls" menuen).

"Reverse mouse" ændrer også frem-tilbage til, respektivt, at være "kig ned-op" (og ikke standard indstillingen "kig op-ned").

Følgende værdier kan anvendes i "joystick.cfg" filen.

VIGTIGE OPLYSNINGER, INDEN DU FORTSÆTTER

I den følgende vejledning, benyttes værdier i den engelske decimal-notation, hvor "." (punktum) benyttes til at adskille heltal fra decimaler! Hvis du har problemer med at dit joystick opfører sig helt hen i vejret, bør du gennemgå værdierne og lede efter kommaer, hvor der burde være punktummer!

Sørg også for, at dit joystick er ordentligt og tilfredsstillende kallibreret. Hvis du ikke gør dette, bliver resultatet et joystick der opfører sig uforudsigeligt, og at alle dine indstillinger er forgæves, hvis du senere vælger at kallibrere!

Følsomhed

Følgende værdier bestemmer følsomheden af dit joystick:

• Variabel: Joyforwardsensitivity
• Funktion: Bestemmer hvor meget joysticket skal bevæges, før du bevæger dig med fuld hastighed frem eller tilbage.
• Standard: -1.0
• Kommentar: Hvis dit joystick ikke reagerer hurtigt nok, så prøv at ændre denne værdi til -1.5, derved kommer du op på fuld hastighed med den halve bevægelse.

• Variabel: Joysidesensitivity
• Funktion: Bestemmer hvor meget joysticket skal bevæges, før du bevæger dig med fuld hastighed til siden.
• Standard: 1.0
• Kommentar: Hvis dit joystick ikke reagerer hurtigt nok, så prøv at ændre denne værdi til -1.5, derved kommer du op på fuld hastighed med den halve bevægelse.

• Variabel: Joypitchsensitivity
• Funktion: Bestemmer hastigheden hvormed du kigger opad eller nedad.
• Standard: -0.25
• Kommentar: Denne indstilling giver dig mulighed for at kigge op eller ned i en 45 graders vinkel, uden at flytte hånden

• Variabel: Joyyawsensitivity
• Funktion: Bestemmer hastigheden hvormed du kigger fra højre mod venstre, og omvendt.
• Standard: -0.5
• Kommentar: Denne indstilling giver dig mulighed for at kigge 90 grader til venstre eller højre uden at flytte hånden.

Du kan sætte disse variabler til negative værdier, og derved omvende computerens forståelse af dine bevægelser. Standard-indstillingerne er enten 1 eller -1.

Grænse-værdier eller "Døde zone"

Disse variabler bestemmer grænseværdierne for, hvor meget joysticket skal bevæges, før computeren reagerer på dine bevægelser.

• Variabel: Joyforwardthreshold
• Funktion: Bestemmer hvor meget joysticket skal bevæges før spilleren faktisk bevæger sig frem eller tilbage.
• Standard: 0.15
• Kommentar: Hvis du har problemer med at spilleren enten bevæger sig frem eller tilbage, når du faktisk prøver at stoppe eller gå fra side til side, så prøv at øge denne værdi til 0.20

• Variabel: Joysidethreshold
• Funktion: Bestemmer hvor meget joysticket skal bevæges før spilleren faktisk bevæger sig til en af siderne.
• Standard: 0.15
• Kommentar: Hvis du har problemer med at spilleren enten bevæger sig til højre eller venstre, når du faktisk prøver at stoppe eller vil gå fremad eller tilbage, så prøv at øge denne værdi til 0.20

• Variabel: Joypitchthreshold
• Funktion: Bestemmer hvor meget joysticket skal bevæges før spilleren begynder at kigge opad eller nedad.
• Standard: 0.15
• Kommentar: Hvis du har problemer med at spilleren har tendens til at pludselig at kigge opad eller nedad bør du ændre denne værdi til en højere værdi.

• Variabel: Joyyawthreshold
• Funktion: Bestemmer hvor meget joysticket skal bevæges før spilleren begynder at kigge mod venstre eller højre.
• Standard: 0.15
• Kommentar: Hvis du har problemer med at spilleren (uønsket), enten trækker mod venstre eller højre, så prøv at øge denne værdi til 0.20

Disse grænseværdier giver dig mulighed for at bestemme hvor langt, i en given retning du kan bevæge joysticket, inden computeren reagerer. Standard-indstillingen er 0.15 (hvilket svarer til 15% af afstanden fra center-positionen og til det mest ekstreme). Gyldige værdier, er mellem 0.00 og 1.00. Med problematiske joystick kan det måske være nødvendigt med en relativt høj værdi (som f.eks. 0.20), hvorimod joystick af højere kvalitet klarer det fint med en lavere værdi (som f.eks. 1.00).

Hvis dit joystick har en "POV hat" (kort for Point Of View, der gør at du hurtigt kan kigge i en anden retningen), er disse tildelt AUX29-AUX32. Så du har otte knapper med "Logitech WingMan Extreme", 12 knapper med "Microsoft SideWinder 3D Pro", osv.

Tildeling af handlinger, til akserne

Disse seks variabler, bestemmer hvorledes akserne er tildelt:

• Variabel: Joyadvaxisx
• Funktion: Bestemmer hvilken handling DirectInputs X-akse er tildelt (typisk at dreje højre og venstre om)
• Standard: 3
• Kommentar: Giver aksen betydningen af, at dreje (højre-venstre).

• Variabel: Joyadvaxisy
• Funktion: Bestemmer hvilken handling DirectInputs Y-akse er tildelt (typisk at bevæge sig frem og tilbage)
• Standard: 1
• Kommentar: Giver aksen betydning af, at bevæge sig frem eller tilbage.

• Variabel: Joyadvaxisz
• Funktion: Bestemmer hvilken handling DirectInputs Z-akse er tildelt (typisk det samme som gas-pedalen i en bil)
• Standard: 0
• Kommentar: Som standard ubrugt.

• Variabel: Joyadvaxisr
• Funktion: Bestemmer hvilken handling DirectInputs R-akse er tildelt (typisk fly-ror)
• Standard: 0
• Kommentar: Som standard ubrugt.

• Variabel: Joyadvaxisu
• Funktion: Bestemmer hvilken handling DirectInputs U-akse er tildelt (Bruger-defineret akse; "Assassin 3D Trackball" tildelt "drej venstre og højre om". Med "WingMan Warrior SpinControl" og "SpaceOrb" er den tildelt "rul")
• Standard: 20
• Kommentar: Sætter "Assassin 3D" til at dreje højre og venstre om (uden automatisk at rette op)

• Variabel: Joyadvaxisv
• Funktion: Bestemmer hvilken handling DirectInputs V-akse er tildelt (Bruger-defineret akse; "Assassin 3D trackball" tildelt "frem og tilbage". På "SpaceOrb" er den tildelt yaw)
• Standard: 18
• Kommentar: Sætter "Assassin 3D" til relativ uhindret op-ned (uden automatisk at rette op).

Hver af de ovennævnte variabler kan sættes til de følgende værdier, med de angivne betydninger:

• 0 = Ubrugt akse
• 1 = Betyder at aksen anvendes til bevægelse frem og tilbage.
• 2 = Betyder at aksen anvendes til at kigge opad og nedad med.
• 3 = Betyder at aksen anvendes til bevægelse fra side til side.
• 4 = Betyder at aksen anvendes til at dreje højre og venstre om.

Relative eller absolutte akser

Derudover kan defineres om aksen er sat til at være "absolut" (som et joystick) eller "relativ" (som "FPgaming trackball" eller "WingMan Warrior SpinControl"). Absolutte akser er defineret til at have en "stop-position" eller en begrænsning på hvor langt det kan bevæges, hvorimod relative akser bare bliver ved med at køre, som f.eks. din mus du kan hvor du kan dreje rundt og rundt i en retning, indtil du ikke har mere plads på bordet eller musemåtten.

For at sætte en akse til at være en relativ akse skal du lægge 16 til værdierne herover (1-4 bliver henholdsvis til 17-20). For eksempel, for at få "Assassin 3D"s U-akse til at dreje højre og venstre om, så skriv joyadvaxisu 20. Et andet eksempel; For at få ror-pedaler til at styre det samme, så skriver du joyadvaxisr 4. Det er lidt indviklet, men skal kun gøres én gang.

Disse avancerede akse-variabler virker ikke, før du har sat joyadvanced 1.0. Ydermere vil alle dine ændringer først træde i kraft, efter du har kørt kommandoen joyadvancedupdate. Så proceduren for at udføre en avancert tildeling er:

1. Sæt "joyadvanced 1".
2. Ændr de ønskede handliger, til de respektive akser.
3. Ændr de pågældende aksers følsomhed.
4. Ændr de pågældende aksers grænseværdier.
5. Sidst udfør "joyadvancedupdate"

Eksempler

Her er hvordan konfigurations-filen for "FPgaming Assassin 3D" kunne se ud:

 // Revision 1.0
 joyname "FPgaming Assassin 3D"
 joyadvanced 1
 joyadvaxisx 3
 joyadvaxisy 1
 joyadvaxisz 0
 joyadvaxisr 0
 joyadvaxisu 20
 joyadvaxisv 18
 joyforwardsensitivity -1.0
 joysidesensitivity 1.0
 joypitchsensitivity -0.25
 joyyawsensitivity -0.5
 joyforwardthreshold 0.15
 joysidethreshold 0.15
 joyyawthreshold 0.0
 joypitchthreshold 0.0
 +mlook
 joyadvancedupdate

Her er hvordan konfigurations-filen for "Logitech WingMan Warrior" kunne se ud:

 // Revision 0.1 -- Find eventuelt opdateringer på www.logitech.com
 joyname "Logitech WingMan Warrior"
 joyadvanced 1.0
 joywwhack1 1.0
 joywwhack2 1.0
 joyadvaxisx 3
 joyadvaxisy 1
 joyadvaxisz 0
 joyadvaxisr 0
 joyadvaxisu 20
 joyadvaxisv 0
 joyforwardsensitivity -1.0
 joysidesensitivity 1.0
 joypitchsensitivity 0.0
 joyyawsensitivity -0.6
 joyforwardthreshold 0.15
 joysidethreshold 0.15
 joypitchthreshold 0.0
 joyyawthreshold 0.0
 joyadvancedupdate

Her er hvordan konfigurations-filen for "SpaceTec IMC SpaceOrb" kunne se ud:

 // Revision 0.1
 joyname "SpaceTec IMC SpaceOrb"
 joyadvanced 1.0
 joyadvaxisx 3
 joyadvaxisy 1
 joyadvaxisz 0
 joyadvaxisr 2
 joyadvaxisu 0
 joyadvaxisv 4
 joyforwardsensitivity -1.0
 joysidesensitivity 1.0
 joypitchsensitivity -0.5
 joyyawsensitivity 1
 joyforwardthreshold 0.1
 joysidethreshold 0.1
 joypitchthreshold 0.1
 joyyawthreshold 0.1
 +mlook
 joyadvancedupdate

Her er så til sidst en konfigurations-fil, for at få dit joystick til at kigge op og ned, samt at gå fra side til side, dine ror-pedaler styrer at dreje venstre og højre om, og "gas-håndtaget" bestemmer hastigheden du bevæger dig med, frem og tilbage:

 joyname "Joystick, Rudder & Throttle"
 joyadvanced 1.0
 joyadvaxisx 3
 joyadvaxisy 2
 joyadvaxisz 1
 joyadvaxisr 4
 joyadvaxisu 0
 joyadvaxisv 0
 joyforwardsensitivity -1.0
 joysidesensitivity -1.0
 joypitchsensitivity 1.0
 joyyawsensitivity -1.0
 joyforwardthreshold 0.15
 joysidethreshold 0.15
 joyyawthreshold 0.15
 joypitchthreshold 0.15
 joyadvancedupdate

Der er til sidst, to ekstra variabler, men er kun beregnet til "Wingman Warrior":

Der er to variabler der styrer specielle respons-kurver, specielt for "Logitech Wingman Warrior" joysticket. "joywwhack1" retter et problem med at rette op, og "joywwhack2" retter et problem med et "vanvittigt" spin, når joysticket bruges til at dreje eller kigge til højre og venstre.

Følg Wingman Warrior konfigurationen herover for et eksempel på hvordan du bruger disse i din "joystick.cfg".

Enable use of joysticks or gamepads by checking the joystick box in the Configuration/Controls/Advanced controls menu. Joystick and gamepad buttons can then be configured through the Configuration/Controls menu.

Valve thanks James Barnes at First-Person Gaming, Inc. for permission to use his excellent documentation on joystick support.

Half-Life supports standard joysticks, digital joysticks and advanced controllers like the FPgaming Assassin 3D, the Logitech WingMan Warrior and the SpaceTec IMC SpaceOrb.

To enable Half-Life joystick support, verify that your joystick or game controller is selected in the Joystick control panel applet and has been calibrated and tested, then launch Half-Life. Check the joystick box in the Configuration/Controls/Advanced controls menu of Half-Life.

For advanced controllers, you will also need to have a configuration file called joystick.cfg. Typically this configuration file should be obtained from your game controller company. However you can create your own and place this file in the Valve subdirectory of your Half-Life directory. Half-Life will automatically execute this configuration file each time you start the game.

The configuration files for common game controllers are included below.

Half-Life Joystick functionality

1. Proportional movement (the farther you move the stick, the faster you move)
2. Support for up to 32 buttons (JOY1-JOY4 and AUX5-AUX32)
3. Sensitivity setting for each control (allows tuning and inverting the control direction)
4. Dead-zone setting for each control
5. Support for all 6 axes (X, Y, Z, R, U, V)
6. Mapping of any axis to any control (Forward, Look, Side, Turn)
7. Support for absolute controls (like joysticks) and relative controls (like trackballs and spinners)

The default joystick setting is for joystick left/right movement to control turning and for joystick forward/backward movement to control moving forward/backward. To control strafing, assign the 'strafe modifier' to one of your joystick buttons (via the Configuration/Controls menu). To control joystick looking, assign the 'Joystick look modifier' to one of your joystick buttons (also via the Configuration/Controls menu).

'Reverse mouse' in the Configuration/Controls/Advanced controls menu also changes the direction the joystick has to move when looking up and down.

The following variables can be set in your joystick.cfg.

These variables control your sensitivity settings:

• Variable: Joyforwardsensitivity
• Function: Controls the ramp-up speed or how much joystick movement is required for moving "full speed" forward and backward
• Default: -1.0
• Comments: If your joystick is not as fast as you think it should be try a setting of -1.5, you will reach full speed with only half of the movement.

• Variable: Joysidesensitivity
• Function: Controls the ramp-up speed or how much joystick movement is required for moving "full speed" side to side
• Default: 1.0
• Comments: If your joystick is not as fast as you think it should be try a setting of 1.5, you will reach full speed with only half of the movement.

• Variable: Joypitchsensitivity
• Function: Controls the speed or ratio used when you look up and down using the Assassin 3D
• Default: -0.25
• Comments: This setting will allow you to look Up and Down at a 45 degree angle without repositioning your hand.

• Variable: Joyyawsensitivity
• Function: Controls the speed that or ratio used when you look left to right using the Assassin 3D
• Default: -0.5
• Comments: This setting will allow you to look left and right at a 90 degree angle without repositioning your hand.

You can set the sensitivity settings to negative numbers. This inverts the direction of movement for the control. The default sensitivity settings are 1 (or -1).

These variables control your threshold settings:

• Variable: Joyforwardthreshold
• Function: Controls the dead-zone for moving forward and backward
• Default: 0.15
• Comments: If you have problems with your character moving forward or back when trying to stop or strafe, increase this number to .20

• Variable: Joysidethreshold
• Function: Controls the dead-zone for moving side to side
• Default: 0.15
• Comments: If you have problems with your character moving left or right when trying to stop or walk a ledge, increase this number to .20

• Variable: Joypitchthreshold
• Function: Controls the dead-zone for looking up and down
• Default: 0.15

• Variable: Joyyawthreshold
• Function: Controls the dead-zone for looking left and right
• Default: 0.15

The threshold settings allow you to control your dead-zone (or no-movement zone). The default threshold settings are .15 (meaning 15% of the full-range). The range of the threshold settings is from 0 to 1. Troublesome analog joysticks may need a larger number (like .2). Premium joysticks can use a smaller number (like .1).

If your joystick has a POV hat, the buttons are mapped to AUX29-AUX32. So, you get 8 buttons with the Logitech WingMan Extreme, 12 buttons with the Microsoft SideWinder 3D Pro, etc.

These six variables control axis mapping:

• Variable: Joyadvaxisx
• Function: Controls mapping of DirectInput axis X (typically joystick left and right)
• Default: 3
• Comments: Allows the joystick to turn.

• Variable: Joyadvaxisy
• Function: Controls mapping of DirectInput axis Y (typically joystick forward and backward)
• Default: 1
• Comments: Allows the joystick to move forward and backward.

• Variable: Joyadvaxisz
• Function: Controls mapping of DirectInput axis Z (typically joystick throttle)
• Default: 0
• Comments: Not used.

• Variable: Joyadvaxisr
• Function: Controls mapping of DirectInput axis R (typically joystick rudder)
• Default: 0
• Comments: Not used.

• Variable: Joyadvaxisu
• Function: Controls mapping of DirectInput axis U (custom axis - Assassin 3D trackball left and right, WingMan Warrior SpinControl and SpaceOrb roll)
• Default: 20
• Comments: Sets the Assassin 3D to relative turning left and right. (Not self centering)

• Variable: Joyadvaxisv
• Function: Controls mapping of DirectInput axis V (custom axis - Assassin 3D trackball forward and backward and SpaceOrb yaw)
• Default: 18
• Comments: Sets the Assassin 3D to relative free-look up and down. (Not self centering)

Each joyadvaxis variable can be set to the following controls:

• 0 = Axis not used
• 1 = Axis is for forward and backward movement
• 2 = Axis is for looking up and down (pitch)
• 3 = Axis is for side to side movement
• 4 = Axis is for turning left and right (yaw)

Additionally, each axis can be designated as an absolute axis (like a joystick) or a relative axis (like the FPgaming trackball or the WingMan Warrior SpinControl). Absolute axes are defined as having a stopping position whereas relative axes don't have a stopping position and just go around and around. To designate an axis as a relative axis, add 16 to the above control number. For example, to set the Assassin 3D's axis U to be looking left and right, type 'joyadvaxisu 20'. As another example, to make your rudder pedals control turning left and right, type 'joyadvaxisr 4'. It's a bit complicated, but only needs to be done once.

The advanced axes variables will not have any effect until joyadvanced is set to 1.0. Additionally, any changes to the axes will not take effect until the joyadvancedupdate command is executed. So, the procedure for creating an advanced mapping is:

1. Set 'joyadvanced 1'
2. Make any desired mapping changes
3. Make any desired sensitivity changes
4. Make any desired threshold changes
5. Call 'joyadvancedupdate'

Here is the configuration file for the FPgaming Assassin 3D:

 // Revision 1.0
 joyname "FPgaming Assassin 3D"
 joyadvanced 1
 joyadvaxisx 3
 joyadvaxisy 1
 joyadvaxisz 0
 joyadvaxisr 0
 joyadvaxisu 20
 joyadvaxisv 18
 joyforwardsensitivity -1.0
 joysidesensitivity 1.0
 joypitchsensitivity -0.25
 joyyawsensitivity -0.5
 joyforwardthreshold 0.15
 joysidethreshold 0.15
 joyyawthreshold 0.0
 joypitchthreshold 0.0
 +mlook
 joyadvancedupdate

Here is a configuration file for the Logitech WingMan Warrior:

 // Revision 0.1 -- refer to www.logitech.com for updates
 joyname "Logitech WingMan Warrior"
 joyadvanced 1.0
 joywwhack1 1.0
 joywwhack2 1.0
 joyadvaxisx 3
 joyadvaxisy 1
 joyadvaxisz 0
 joyadvaxisr 0
 joyadvaxisu 20
 joyadvaxisv 0
 joyforwardsensitivity -1.0
 joysidesensitivity 1.0
 joypitchsensitivity 0.0
 joyyawsensitivity -0.6
 joyforwardthreshold 0.15
 joysidethreshold 0.15
 joypitchthreshold 0.0
 joyyawthreshold 0.0
 joyadvancedupdate

Here is a config file for the SpaceTec IMC SpaceOrb:

 // Revision 0.1
 joyname "SpaceTec IMC SpaceOrb"
 joyadvanced 1.0
 joyadvaxisx 3
 joyadvaxisy 1
 joyadvaxisz 0
 joyadvaxisr 2
 joyadvaxisu 0
 joyadvaxisv 4
 joyforwardsensitivity -1.0
 joysidesensitivity 1.0
 joypitchsensitivity -0.5
 joyyawsensitivity 1
 joyforwardthreshold 0.1
 joysidethreshold 0.1
 joypitchthreshold 0.1
 joyyawthreshold 0.1
 +mlook
 joyadvancedupdate

Here is a config file for making your joystick operate looking around and strafing, your rudder pedals control turning left and right and throttle control moving forward and backward:

 joyname "Joystick, Rudder & Throttle"
 joyadvanced 1.0
 joyadvaxisx 3
 joyadvaxisy 2
 joyadvaxisz 1
 joyadvaxisr 4
 joyadvaxisu 0
 joyadvaxisv 0
 joyforwardsensitivity -1.0
 joysidesensitivity -1.0
 joypitchsensitivity 1.0
 joyyawsensitivity -1.0
 joyforwardthreshold 0.15
 joysidethreshold 0.15
 joyyawthreshold 0.15
 joypitchthreshold 0.15
 joyadvancedupdate

Two additional values you can set specifically for the Wingman Warrior:

There are two variables which enable special response curves tuned for the Logitech Wingman Warrior joystick. "joywwhack1" fixes a centering problem. "joywwhack2" fixes an "out of control" spin problem when using the joystick to turn or look left/right.

See the Wingman Warrior configuration above for an example of how to use these in your joystick.cfg.