JoyPro2 Discord GitHub
De belangrijkste stappen

Een game importeren

Tonen:

Importeren leest de bedieningsinstellingen die een game heeft opgeslagen en maakt er een JoyPro-profiel van: één relatie per functie met haar knop of as. Het is de snelste start: alles wat je al in je games hebt ingesteld komt binnen, en vanaf dan houdt JoyPro het op één plek bij.

flowchart LR
  G["De bedieningsbestanden<br/>van je game"] --> I["Importeren"]
  D["Je aangesloten<br/>apparaten"] --> I
  I --> P["Je profiel:<br/>relaties, toewijzingen,<br/>modifiers, curves"]
Importeren leest alleen. De game houdt zijn toewijzingen precies zoals ze zijn.
Voor beginners

#Importeren in drie klikken

  1. Open Start (de eerste knop in de onderste balk). Onder Je games heeft elke game die JoyPro op je pc vond een kaart met zijn afbeelding. Druk op Importeren bij de game die je het meest speelt.
  2. JoyPro vraagt hoe:
    • Aan mijn profiel toevoegen (aanbevolen) houdt wat je hebt en voegt de toewijzingen van de game toe.
    • Opnieuw beginnen vanuit deze game vervangt je relaties door wat de game heeft (JoyPro bewaart eerst een kopie van je profiel).
    • Neem ook de toetsenbordtoetsen over neemt ook vluchtcommando's op het toetsenbord mee. Apparaattoewijzingen worden altijd overgenomen.
    • Voor DCS: Al mijn DCS-toestellen, of vink het uit en kies toestellen.
  3. Druk op Nu importeren. Even later zegt de kaart "Klaar: je profiel heeft nu 214 relaties (180 toegewezen)" en Mijn relaties bekijken opent ze. Eerst bekijken toont in plaats daarvan wat de game heeft, zonder iets te wijzigen.
De Startpagina met je games en apparatenDe Startpagina met je games en apparaten
De Startpagina met je games en apparaten (De afbeeldingen tonen de app in het Engels.)

Geen profiel open? JoyPro maakt er een voor je en bewaart het vanaf dan automatisch (er is geen knop Opslaan: elke wijziging wordt opgeslagen en kan ongedaan worden gemaakt, ook na een herstart).

#Wat verandert er in de game?

Niets. Importeren leest alleen de bestanden van de game. De game houdt zijn toewijzingen precies zoals ze zijn, of je later exporteert of niet.

#Importeren en JoyPro dan de gaten laten vullen

Op de Startpagina toont de kaart "Stel je apparaten in" games waarin je zelf toewijzingen hebt gemaakt. Importeren, dan gaten vullen importeert zo'n game eerst. Daarna zet Nu gaten vullen... de belangrijke functies op de knoppen die nog vrij zijn. Je eigen toewijzingen blijven. Voor games die al in je profiel staan, biedt de kaart Gaten vullen... aan.

#Voor je eerste import: de commandolijst

JoyPro moet de commando's van elke game kennen (hun namen en id's). Het maakt deze lijst één keer uit je eigen installatie. Ontbreekt een lijst, dan toont de Startpagina Lijst maken (of Alle ontbrekende lijsten maken); een gamekaart biedt na een game-update Bijwerken aan. Dit duurt van een paar seconden tot een paar minuten (DCS leest elke module).

Geavanceerd

#Opties en wat ze doen

Optie Standaard Effect
Aan mijn profiel toevoegen / Opnieuw beginnen Toevoegen Toevoegen voegt samen met het open profiel; Opnieuw beginnen vervangt de relaties ervan na een bevestiging en een kopie van het profiel.
Neem ook de toetsenbordtoetsen over je laatste keuze Vluchtcommando's die aan toetsen zijn toegewezen, komen ook mee.
Ook apparaten importeren die niet aangesloten zijn aan Apparaten die nu niet aangesloten zijn, worden ook geïmporteerd (handig voor een stick die je later aansluit). Uit: ze worden overgeslagen en geteld.
Apparaten met dezelfde naam als één apparaat behandelen aan Windows geeft een apparaat af en toe een nieuw ID; de oude en nieuwe bestanden ervan worden gelezen als één apparaat op het aangesloten ID. Twee identieke apparaten die tegelijk aangesloten zijn, blijven gescheiden.
Standaarden opnemen (DCS, expertformulier) aan Elke standaardtoewijzing die DCS actief heeft voor een geïmporteerd apparaat, komt mee, zodat importeren gevolgd door een export met Vervangen + Ook wissen DCS laat zoals het was. Je eigen toewijzingen winnen van een standaard op dezelfde input.
Omgekeerd / schuif / kromming / dode zone / saturatie importeren (expertformulier) uit Neemt waarden over die in de game zijn ingesteld voor toewijzingen die JoyPro niet zelf heeft geëxporteerd. Een toewijzing die JoyPro heeft geëxporteerd, krijgt haar afstelling ook zonder deze opties terug.
DCS: *_easy-toestellen negeren uit De kopieën van toestellen voor de makkelijke modus worden weggelaten.

De expertimport (Startpagina, onder de kaarten, en de pagina Geavanceerd) biedt per game elke engine-optie met Scannen (voorbeeld), Importeren en Exporteren. Elke keuze wordt onthouden voor de volgende import.

#Namen, groepen en modifiers komen terug

Een gamebestand bevat alleen apparaat, input en misschien een curve. De export van JoyPro bewaart zijn eigen gegevens ernaast, en een import leest die terug:

Game Gegevens van JoyPro Teruggezet
DCS <aircraft>\joystick\<device>.jp, modifiers.lua relatienaam, groepen (in volgorde), modifiers met namen, omkeren, schuif, dode zone, saturatie, curve
IL-2 Great Battles data\input\jp.actions naam, groepen, alias, modifiers, de exacte afstelling
Registergames (X-Plane, Elite, X4, Arma, MSFS, War Thunder, BMS ...) <config>.joypro-meta.json naam, groepen, alias, modifiers, afstelling
Star Citizen actionmaps.jp namen

De huidige toestand van de game wint: een curve die je na de export in DCS hebt gewijzigd, blijft. Toewijzingen die JoyPro nooit heeft geëxporteerd, krijgen een naam die is opgebouwd uit de actie van de game en de groepen DCS, IL2 of GENERATED + game.

#Twee beveiligingen

  • Wijzigingen nog niet geëxporteerd. Als je toewijzingen in JoyPro hebt gewijzigd en ze nog niet naar deze game hebt geëxporteerd, zou een import de oude toewijzingen terugbrengen. JoyPro vraagt het eerst.
  • Al geïmporteerd? Als het profiel de game al heeft, komen wijzigingen die je later in de game maakt binnen via de gamebewaking (die vraagt het nadat de game is gesloten); opnieuw importeren blijft één klik.
In de game: Wat de import leest, per soort game

Importeren schrijft nooit in een gamemap. Wat hij leest:

  • DCS: de toewijzingen van elk toestel en apparaat, je modifiers, en met "Standaarden opnemen" de standaardtoewijzingen die DCS voor elk apparaat heeft.
  • IL-2 Great Battles / Korea: de key mapping en de asresponsen.
  • Star Citizen: de keybindings van de branch (LIVE, PTU ...), met de joystickstandaarden van de game op js1.
  • Games met infanterie of voertuigen (War Thunder, Arma, Reforger, WARDOGS ...): alleen de vliegacties; al het andere wordt genegeerd, niet verwijderd.
  • MSFS: de inputprofielen van de sim (Steam of de Microsoft Store-versie) en, op verzoek, de standaardvoorinstellingen van de sim.

Apparaten die de game niet uit elkaar kan houden (in sommige games twee apparaten van één model) en toewijzingen op een halve as (Elite) worden overgeslagen en in het resultaat genoemd.

Technische details

#Zo werkt het van binnen

  1. GUI. StartImportWizard → RunImportWizardAsync (MainWindowViewModel.GameHub.cs). Het vraagt AskAboutUnexportedChangesAsync (engine sync pending), bevestigt Opnieuw beginnen en bewaart een kopie van het profiel (BackupProfileBeforeChange("before-import")), en roept dan de import van de game aan: ImportDcsAsync, ImportIl2Async, ImportStarCitizenAsync of ImportRegistryGameAsync. Eerst bekijken voert hetzelfde uit met scan (PreviewImportWizardAsync) en opent het paneel Uitvoer.
  2. Engine. Voor DCS: engine dcs import [--path <Saved Games\DCS>] --merge --include-defaults [--plane <a> --plane <b>] --include-keyboard true|false --ignore-easy-planes false --only-connected false --merge-same-name true. De importer leest elk apparaatbestand, koppelt het apparaat aan zijn DirectInput-instance-GUID en naam, koppelt elk commando-id aan de commandolijst van de game (DB\<game> in %LOCALAPPDATA%\JoyPro2\GameData) en bouwt één relatie per functie en input. Correcties bij het laden (--load-corrections, --correction-mode) koppelen hernoemde commando-id's opnieuw, met een zekerheidsscore.
  3. Profiel. De relaties worden samengevoegd op naam en op dezelfde input; modifiers worden gemaakt uit modifiers.lua (DCS) of de shift-instellingen van de game. Het profiel wordt atomair opgeslagen en elke opslag is een versie in <data>\ProfileHistory (ongedaan maken werkt ook na een herstart).
  4. Gamebewaking. Een import van een game zonder sync-record legt de bestanden van de game vast, zodat wijzigingen die je later in de game maakt, worden opgemerkt (<data>\Sync\<game>.json).

#De bestanden die het leest

Game Bestanden
DCS Saved Games\DCS\Config\Input\<aircraft>\{joystick,keyboard}\*.diff.lua en modifiers.lua, plus de schone profielen die JoyPro uit je DCS-installatie heeft gebouwd
IL-2 Great Battles / Korea data\input\*.actions en de asresponsen
Star Citizen actionmaps.xml van de branch
MSFS de externe Steam-map of de opslag van de Microsoft Store

De opties van de GUI als engine-opties: Toevoegen --merge, toetsenbord --include-keyboard true, apparaten niet aangesloten --only-connected false, dezelfde naam --merge-same-name true, makkelijke toestellen --ignore-easy-planes true. De beveiliging voor nog niet geëxporteerde wijzigingen is engine sync pending.

Engine-commando's: engine dcs import, engine dcs scan, engine il2 import, engine starcitizen import en engine <game> import voor elke game uit het register (bijvoorbeeld engine warthunder import, engine msfs2024 import). Regels voor opnieuw importeren: opnieuw importeren. Tests: engine\tests\smoke\dcsincludedefaults.ps1, engine\tests\smoke\roundtrip.ps1, gui\JoyPro.Gui.Tests\ImportSettingsPersistTests.cs.