JoyPro2 Discord GitHub
De belangrijkste stappen

Naar je games exporteren

Tonen:

Exporteren is de stap die je sticks in de game laat werken. JoyPro schrijft je relaties en toewijzingen in de bestanden met bedieningsinstellingen van elke game, dezelfde bestanden die het eigen menu Controls van de game opslaat. Er draait niets op de achtergrond terwijl je vliegt: na de export leest de game zijn eigen bestanden zoals altijd.

flowchart LR
  C["1 Controleren<br/>(optioneel)"] --> M["2 Kies hoe<br/>(4 keuzes)"]
  M --> G["3 Games aanvinken,<br/>Aangevinkte games exporteren"]
  G --> W["Eerst een back-up,<br/>dan worden de<br/>gamebestanden geschreven"]
Stap 1 kijkt alleen; hij stopt de export nooit. Laatste export ongedaan maken op de kaart van een game zet de bestanden terug. In games die alleen Xbox kennen wordt niets geschreven: die gebruiken Start op de pagina Virtuele joystick.
Voor beginners

#Exporteren in drie stappen

Open Exporteren in de balk onderaan. De pagina bestaat uit drie genummerde kaarten van boven naar beneden:

De pagina Exporteren: controle, hoe, gamesDe pagina Exporteren: controle, hoe, games
De pagina Exporteren: controle, hoe, games (De afbeeldingen tonen de app in het Engels.)
  1. Controleer je profiel. Druk op Nu controleren. JoyPro zoekt naar dingen die in de game mis zouden gaan, bijvoorbeeld een knop die twee dingen doet in hetzelfde toestel. Los op wat het vindt (één klik per probleem) of laat het; de controle blokkeert de export nooit. Zie de controle.
  2. Hoe JoyPro in de games schrijft. Kies een van de vier keuzes. Weet je het niet zeker, houd dan de eerste: Vervangen op mijn apparaten met Ook mijn andere apparaten wissen aangevinkt. Je sticks doen dan precies wat je profiel zegt, en niets anders.
  3. Naar games exporteren. Elke game waarvoor je profiel toewijzingen heeft, krijgt een kaart met zijn afbeelding. Vink de games aan en druk op Aangevinkte games exporteren, of druk op Nu exporteren op één kaart.

Sluit eerst de game. Games schrijven hun bedieningsbestanden bij het afsluiten, dus JoyPro weigert te exporteren naar een game die draait en zegt je dat.

#Welke keuze past bij mij?

Keuze Kies dit als Wat er met de eigen toewijzingen van de game gebeurt
Vervangen op mijn apparaten JoyPro de plek is waar je je sticks instelt Op de apparaten in je profiel blijven alleen jouw toewijzingen (voor de toestellen die je exporteert).
Bijwerken, toewijzingen van game behouden Je ook dingen in de game zelf toewijst en die wilt houden Jouw toewijzingen gaan erin; een gametoewijzing wordt alleen verwijderd waar hij op een knop zit die je voor iets anders gebruikt.
Bijwerken, mijn profiel wint Zoals hierboven, maar je hebt in JoyPro acties naar andere knoppen verplaatst Zoals hierboven, en elke actie die je toewijst verliest haar andere knoppen in de game, zodat verplaatsen echt verplaatsen is.
Alleen toevoegen Je JoyPro voor het eerst uitprobeert Er wordt niets verwijderd. Gebruikt de game een knop al voor iets anders, dan wordt je toewijzing weggelaten en zegt de controle het je.

Ook mijn andere apparaten wissen (een vinkje onder de keuzes): aangesloten apparaten die geen toewijzingen in je profiel hebben, verliezen hun toewijzingen in de geëxporteerde toestellen. Laat het aangevinkt als je schoon wilt beginnen, vink het uit als je een tweede apparaat alleen in de game zelf gebruikt.

#Veilig door ontwerp

  • Voordat JoyPro een gamebestand wijzigt, kopieert het dat naar een back-up. Elke kaart heeft Laatste export ongedaan maken: dat zet de bestanden precies terug zoals ze waren, byte voor byte.
  • De eerste export naar een game die al eigen toewijzingen heeft, vraagt één keer: "Eerst importeren?". Kies Eerst importeren als je wilt houden wat je in de game hebt gemaakt, Toch exporteren om het te vervangen.
  • Apparaten die niet aangesloten zijn, houden hun toewijzingen. Je toewijzingen voor muis en gamepad worden nooit aangeraakt.

#Wat je in de game merkt

Start de game en open het bedieningsmenu: je toewijzingen staan daar, in de kolom van elk apparaat, onder de namen die de game gebruikt. In DCS staan ze per toestel; in Star Citizen per schipactie; in IL-2 in Key mapping. Het onderdeel In de game hieronder noemt elk soort game.

#Andere manieren waarop je toewijzingen de game bereiken

Manier Wat het doet
Naar mijn game schrijven (de snelle instelling) De export van de snelle instelling. Hij schrijft de games die hij heeft ingesteld, met dezelfde back-up. Zie Snelstart.
De nagebootste controller (virtuele Xbox-pad) In ACE COMBAT 8 en Hell Let Loose: Vietnam wordt niets geschreven. Hun export zegt dat. Je stick bestuurt een nagebootste controller zolang Start aan staat. Zie Games die alleen Xbox kennen.
De kneeboard van DCS Geen export van toewijzingen: een pagina per toestel die in de cockpit toont wat je knoppen doen. Zie de kneeboard.
Geavanceerd

#De modi in detail

"Dezelfde input" betekent hetzelfde apparaat, dezelfde knop of as en dezelfde modifiers, in hetzelfde toestel (of schip, voertuig) als de game toewijzingen per toestel bewaart. Elke modus werkt alleen in de toestellen van de export.

Alleen toevoegen Bijwerken, behouden Bijwerken, profiel wint Vervangen
Je toewijzingen geschreven waar de input vrij is beschreven beschreven beschreven
Een gametoewijzing op een input die je voor een andere actie gebruikt behouden; je toewijzing wordt niet geschreven en gemarkeerd verwijderd verwijderd verwijderd
Een gametoewijzing van dezelfde actie op een andere input (na een verplaatsing) behouden behouden (de actie staat op beide inputs) verwijderd verwijderd op de geschreven apparaten
Andere gametoewijzingen op je apparaten behouden behouden behouden verwijderd
Standaardwaarden van de game op je apparaten behouden behouden behouden, tenzij ze een van je acties bevatten verwijderd
Aangesloten apparaten zonder toewijzingen in het profiel behouden behouden je acties eruit verwijderd behouden, tenzij Ook mijn andere apparaten wissen
Apparaten die niet aangesloten zijn, muis, gamepad nooit aangeraakt nooit aangeraakt nooit aangeraakt nooit aangeraakt
Toetsenbord alleen met de toetsenbordoptie alleen met de toetsenbordoptie alleen met de toetsenbordoptie alleen met de toetsenbordoptie
Toestellen die niet in de export zitten nooit aangeraakt nooit aangeraakt nooit aangeraakt nooit aangeraakt (DCS: tenzij de optie "verliezen de standaardtoewijzingen van DCS ook in elk ander toestel")

Ook mijn andere apparaten wissen wordt niet gebruikt bij Alleen toevoegen. Bij de andere modi wist het de aangesloten apparaten die het profiel niet gebruikt, in de geëxporteerde toestellen (DCS: ook hun DCS-standaardwaarden). De apparaten die de import negeert en het vJoy-apparaat waar JoyPro naartoe doorstuurt, worden nooit gewist.

Sinds 2.5.0 is de standaard Vervangen op mijn apparaten + Ook mijn andere apparaten wissen (zoals in JoyPro 1). Een modus die je zelf kiest, wordt onthouden.

#Kort samengevat: één van je toewijzingen, vier modi

Modus De game gebruikt je knop voor iets anders Je actie heeft andere knoppen in de game Andere aangesloten apparaten
Vervangen op mijn apparaten Die toewijzing wordt verwijderd; de jouwe wordt geschreven Verwijderd op de geschreven apparaten Behouden, tenzij Ook mijn andere apparaten wissen
Bijwerken, mijn profiel wint Die toewijzing wordt verwijderd; de jouwe wordt geschreven Verwijderd Je acties worden eruit verwijderd
Bijwerken, toewijzingen van game behouden Die toewijzing wordt verwijderd; de jouwe wordt geschreven Behouden: de actie staat op beide Behouden
Alleen toevoegen Behouden; de jouwe wordt niet geschreven en gemarkeerd Behouden Behouden

#Opties per game

Onder Opties en paden (voor experts):

  • DCS: de lijst Toestellen... op de DCS-kaart (alleen aangevinkte toestellen worden geschreven); DCS: standaardtoetsen behouden (aan); mijn apparaten verliezen de standaardtoewijzingen van DCS ook in elk ander toestel (uit).
  • Star Citizen: SC: standaardtoetsen behouden, lokale volgorde verkiezen.
  • De andere games: een vakje Proefrun dat laat zien wat er zou veranderen zonder te schrijven.
  • Paden: een andere Saved Games- of configmap per game; Eigen paden en genegeerde apparaten voor dit profiel geeft het open profiel eigen paden in plaats van die van de pc.

#Markeringen: "Niet in de game geschreven"

Alleen toevoegen (en elke modus waarin een game geen vrije plek heeft voor nog een input, bijvoorbeeld Elite Dangerous met twee inputs per actie) laat sommige toewijzingen weg. Het profiel onthoudt elke toewijzing met de actie van de game die de input bezet en de datum; de controle toont per markering een kaart met Exporteren met 'Bijwerken' om het te vervangen, Naar een andere knop verplaatsen en Zo laten. Elke export vervangt de markeringen van zijn game en toestellen, dus een markering verdwijnt als een latere export de toewijzing schrijft.

#Onthouden instellingen

De modus, het vinkje Ook wissen, de opties per game en de paden worden bewaard in de instellingen van JoyPro; de games en DCS-toestellen die je zelf hebt aangevinkt, worden per profiel bewaard. Vervangen en Ook wissen vragen het voor elke export (Instellingen > Bevestigingen kan de vraag uitzetten).

#Na de export

  • Laatste export ongedaan maken op de kaart zet de nieuwste back-up van die game terug. De volledige lijst staat onder Back-ups van gameconfiguratie onderaan de pagina Exporteren.
  • De export legt de bestanden van de game vast voor de gamebewaking: na de eigen export van JoyPro wordt later nooit gevraagd "wijzigingen overnemen?"; na een wijziging die je daarna in de game maakt wel (de gamebewaking).
  • JoyPro bewaart zijn eigen gegevens naast het gamebestand, zodat een latere import relatienamen, groepen, modifiers en curves terugbrengt (opnieuw importeren).

#In de game

Wat de speler na een export ziet, hangt af van het soort game. Elke game hieronder volgt dezelfde regels: JoyPro schrijft alleen de acties uit zijn commandolijst, weigert te schrijven zolang de game draait, maakt eerst een back-up van de bestanden en gokt nooit naar een apparaat of actie die het niet kan koppelen (het slaat die over met een waarschuwing).

In de game: Vluchtsimulators: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Falcon BMS, X-Plane, MSFS, FSX, Prepar3D

JoyPro neemt de apparaten over die het schrijft. Met Vervangen verdwijnt elke andere toewijzing van die apparaten in de geëxporteerde toestellen, met Ook wissen worden de andere aangesloten apparaten ook gewist (DCS: ook hun DCS-standaardwaarden).

  • DCS World: kies in Options > Controls het toestel: je toewijzingen staan in de kolom van het apparaat, verwijderde standaardwaarden zijn lege cellen, je modifiers staan in de modifierlijst. Alleen de aangevinkte toestellen veranderen. JoyPro schrijft alleen de verschillen met de standaardwaarden van DCS, zoals DCS zelf ook doet.
  • IL-2 Great Battles: Settings > Key mapping toont je toewijzingen en asresponsen. Muisregels en regels die JoyPro niet kent, blijven.
  • IL-2 Korea: het key mapping-profiel "General".
  • Falcon BMS: de launcher maakt het toetsenbestand en de astoewijzing bij de volgende Launch, dus start BMS via de launcher.
  • MSFS 2024 / 2020: in Controls toont het apparaat de voorinstelling van JoyPro.
  • X-Plane 11 / 12: Settings > Joystick toont de toewijzingen.
In de game: Games met infanterie, voertuigen of menu's: Star Citizen, War Thunder, Arma 3 / 2, Arma Reforger, WARDOGS, Nuclear Option, Hell Let Loose, Battlefield

JoyPro raakt alleen de vliegacties aan (vliegtuig, helikopter, ruimteschip). Je toewijzingen te voet, voor voertuigen en menu's blijven byte voor byte. Vervangen en Ook wissen maken alleen de vliegacties vrij die JoyPro kent.

  • Star Citizen: Options > Keybindings toont de schipacties op je joysticks (js1, js2, ...). Met Vervangen of Ook wissen worden de eigen joystickstandaarden van de game op js1 uitgezet als js1 wordt geschreven of ongebruikt is.
  • War Thunder: Controls toont de vliegtuigtoewijzingen; de bediening van tanks en schepen blijft ongewijzigd.
  • Arma 3 / Arma 2: de toetsinstellingen van het profiel; alleen acties voor vliegtuigen en helikopters veranderen.
In de game: Ruimtegames: Elite Dangerous, X4: Foundations
  • Elite Dangerous houdt twee inputs per actie (Primary en Secondary). Een toewijzing zonder vrije plek krijgt een markering "Niet geschreven" met "Naar een andere knop verplaatsen" of "Zo laten". Toewijzingen te voet en voor de SRV blijven.
  • X4: de inputinstellingen van de game; alleen de gecatalogiseerde schipacties veranderen.
In de game: Games die één apparaat of alleen een Xbox-controller lezen
  • Games die op vJoy staan (games die maar een paar apparaten lezen): de export schrijft de toewijzingen op het vJoy-apparaat. JoyPro kopieert je sticks erop terwijl je speelt, en HidHide verbergt je echte apparaten alleen voor die game. De game ziet één apparaat met alles erop. Zie Virtuele joystick.
  • Games die alleen Xbox kennen (ACE COMBAT 8, Hell Let Loose: Vietnam): er wordt niets geschreven, en de export zegt dat. Je stick bestuurt een nagebootste controller (virtuele Xbox-pad) zolang Start aan staat. HidHide is niet nodig. Zie Een game die alleen Xbox kent spelen met een HOTAS.
Technische details

#Zo werkt het van binnen

Eén export, van de klik tot de geschreven bestanden:

# Wie Wat er gebeurt
1 Jij Druk op Aangevinkte games exporteren op de pagina Exporteren.
2 JoyPro Vraagt de engine naar de game (profile game-state --game <id>): geïmporteerd, geëxporteerd, heeft toewijzingen.
3 JoyPro Vraagt het jou als dat nodig is: een eerste export ("Eerst importeren?") of een modus die toewijzingen verwijdert (Instellingen > Bevestigingen).
4 Engine Voert <game> export --mode <m> --nuke-untouched-devices <b> ... uit: weigert zolang de game draait, maakt een back-up van elk bestand (GameBackups en .jpbak) en schrijft alleen gecatalogiseerde acties.
5 Engine Slaat het sync-record (vingerafdruk en basislijn) en de exportmarkeringen op en antwoordt dan: geschreven, overgeslagen, SkippedTakenInputs.
6 JoyPro De kaart van de game toont "Geëxporteerd 14:02", en Laatste export ongedaan maken staat klaar.
  1. GUI. ExportSelectedGamesAsync / ExportGameNowAsync (MainWindowViewModel.ExportGames.cs) vragen AskAboutFirstExportAsync (engine profile game-state) en ConfirmRiskyExportAsync, daarna kiest ExportGameAsync de exporter van de kaart: dcs, il2, starcitizen of een game uit het register. Het commando wordt opgebouwd uit de instellingen van de pagina, bijvoorbeeld RunDcsExportAsync: engine dcs export --mode clean --keep-keyboard-defaults true --nuke-untouched-devices true --clean-all-aircraft false --ignore-device <d> --planes F-16C_50|FA-18C_hornet. Elke engine-aanroep gaat via één plek, RunEngineAsync, met --profile en --status true (de voortgang en Annuleren in het bezig-gebied), na elkaar uitgevoerd zodat nooit twee commando's tegelijk schrijven.
  2. Engine. engine\Program.cs stuurt dcs / il2 / starcitizen naar hun exporters en elke andere game naar Games.GameRegistry (één GameIntegration per game). DCS: EngineDcsExport.Modes.cs berekent per apparaatbestand welke toewijzingen DCS actief heeft (schoon profiel min removed, plus added en changed), beslist welke actief moeten zijn en schrijft alleen echte verschillen met de standaardwaarden.
  3. Veiligheid. GameExportSafety.BackupBeforeOverwrite kopieert elk bestand naar <file>.jpbak en naar de back-upopslag met versies (%LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\ met manifest.json; de nieuwste 30 sets per game blijven bewaard). Registergames (Nuclear Option) krijgen een momentopname van de waarden die ze kunnen wijzigen. Een bestand dat de export aanmaakt, wordt vastgelegd als "bestond niet", zodat terugzetten het weer verwijdert.
  4. Daarna. Het sync-record (<data>\Sync\<game>.json: grootte, tijd en SHA-256 per bestand en een hash van elke toewijzing) houdt de gamebewaking stil bij de eigen wijziging van JoyPro. ExportSkippedBinds.cs vult SkippedTakenInputs; het exportcommando maakt daar de markeringen van het profiel van. De profielgeschiedenis houdt een controlepunt vóór elke export.

#De bestanden die elke game krijgt

Game Bestanden
DCS World per toestel en apparaat Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, een .jp ernaast, de modifiers.lua van het toestel
IL-2 Great Battles data\input\global.actions (nieuwe regels aan het eind, de volgorde behouden), de asresponsen, jp.actions
IL-2 Korea data\input\general.actions
Falcon BMS de User\Config\Setup.v100.* {GUID}.xml van de launcher per apparaat
MSFS 2024 / 2020 inputprofielen (2024: het presetpakket joypro-input-profiles in de Community-map en de Steam-profielen)
X-Plane 11 / 12 de joystickvoorkeuren in Output\preferences
Star Citizen LIVE\user\client\0\Profiles\default\actionmaps.xml en actionmaps.jp
War Thunder Documents\My Games\WarThunder\Saves\<id>\production\machine.blk
Registergames hun configbestand en <config>.joypro-meta.json

Markeringen van niet geschreven toewijzingen: engine export-marks list, engine export-marks dismiss. Instellingen: export-settings.json (ModeChosenByUser); de standaard van de engine zonder --mode is merge-overwrite.

#Elke modus op de opdrachtregel

Keuze in de GUI Engine-opties
Vervangen op mijn apparaten + Ook mijn andere apparaten wissen (standaard) --mode clean --nuke-untouched-devices true
Vervangen op mijn apparaten --mode clean --nuke-untouched-devices false
Bijwerken, mijn profiel wint (+ Ook wissen) --mode merge-overwrite --nuke-untouched-devices true|false
Bijwerken, toewijzingen van game behouden (+ Ook wissen) --mode merge --nuke-untouched-devices true|false
Alleen toevoegen --mode add (nuke wordt niet gebruikt)

Per game: engine dcs export, engine il2 export, engine starcitizen export, en engine <game> export voor elke game uit het register (bijvoorbeeld engine warthunder export, engine msfs2024 export, engine xplane12 export; elk neemt --mode, --dry-run, --include-keyboard en --nuke-untouched-devices). Ongedaan maken: engine backups restore. Tests: engine\tests\smoke\dcsexportmodes.ps1 (elke modus, heen en terug, ongedaan maken byte voor byte) en engine\tests\smoke\roundtrip.ps1 (importeren, clean + nuke, opnieuw importeren laat de game zoals hij was).