JoyPro2 Discord GitHub
주요 흐름

게임으로 내보내기

표시:

내보내기는 스틱이 게임에서 작동하게 만드는 단계입니다. JoyPro가 관계와 바인딩을 각 게임의 조작 설정 파일, 즉 게임 자체의 조작 메뉴가 저장하는 바로 그 파일에 써넣습니다. 비행하는 동안 백그라운드에서 실행되는 것은 없습니다. 한 번 내보내면 게임은 평소처럼 자기 파일을 읽습니다.

flowchart LR
  C["1 확인<br/>(선택 사항)"] --> M["2 방식 선택<br/>(4가지)"]
  M --> G["3 게임 체크,<br/>체크한 게임 내보내기"]
  G --> W["먼저 백업한 뒤<br/>게임 파일을<br/>써넣음"]
1단계는 살펴보기만 하며, 내보내기를 막지 않습니다. 게임 카드의 '마지막 내보내기 취소'를 누르면 파일이 원래대로 돌아옵니다. Xbox 전용 게임에는 아무것도 써넣지 않으며, 가상 조이스틱 페이지의 '시작'을 사용합니다.
초보자용

#세 단계로 내보내기

아래쪽 막대에서 내보내기를 여세요. 페이지는 위에서 아래로 번호가 붙은 카드 세 개로 되어 있습니다:

내보내기 페이지: 확인, 방식, 게임내보내기 페이지: 확인, 방식, 게임
내보내기 페이지: 확인, 방식, 게임 (그림은 영어로 된 앱을 보여 줍니다.)
  1. 프로필 확인하기. 지금 확인을 누르세요. JoyPro가 게임에서 잘못될 수 있는 부분을 찾습니다. 예를 들어 같은 기체에서 두 가지 일을 하는 버튼 하나 같은 것입니다. 찾은 문제를 고치거나(문제마다 클릭 한 번) 그대로 두세요. 확인은 내보내기를 막지 않습니다. 확인을 참고하세요.
  2. JoyPro가 게임에 써넣는 방식. 네 가지 중 하나를 고르세요. 잘 모르겠다면 첫 번째를 그대로 두세요: 다른 장치도 지우기를 체크한 내 장치에서 교체. 그러면 스틱이 프로필에 적힌 대로만 동작하고, 다른 일은 하지 않습니다.
  3. 게임으로 내보내기. 프로필에 바인딩이 있는 모든 게임은 이미지가 있는 카드를 받습니다. 게임을 체크하고 체크한 게임 내보내기를 누르거나, 카드 하나에서 지금 내보내기를 누르세요.

먼저 게임을 닫으세요. 게임은 종료할 때 조작 파일을 쓰기 때문에, JoyPro는 실행 중인 게임으로 내보내기를 거부하고 그 사실을 알려 줍니다.

#어떤 방식이 나에게 맞을까요?

선택 항목 이럴 때 선택 게임 자체 바인딩은 어떻게 되나요
내 장치에서 교체 JoyPro에서 스틱을 설정하는 경우 프로필에 있는 장치에는 내 바인딩만 남습니다(내보내는 기체에서).
업데이트, 게임의 바인딩 유지 게임 안에서도 바인딩하고 그것을 유지하고 싶은 경우 내 바인딩이 들어가고, 게임 바인딩은 내가 다른 용도로 쓰는 버튼에 있는 경우에만 제거됩니다.
업데이트, 내 프로필 우선 위와 같지만, JoyPro에서 동작을 다른 버튼으로 옮긴 경우 위와 같고, 바인딩한 모든 동작은 게임에서 다른 버튼을 잃으므로 옮기면 정말로 옮겨집니다.
추가만 JoyPro를 처음 써 보는 경우 아무것도 제거되지 않습니다. 게임이 이미 어떤 버튼을 다른 용도로 쓰고 있으면 내 바인딩은 빠지고, 확인 기능이 알려 줍니다.

다른 장치도 지우기(선택지 아래의 체크 상자): 프로필에 바인딩이 없는 연결된 장치는 내보내는 기체에서 바인딩을 잃습니다. 깨끗하게 시작하고 싶다면 체크한 채로 두고, 게임 안에서만 쓰는 두 번째 장치가 있다면 체크를 해제하세요.

#안전한 설계

  • JoyPro는 게임 파일을 바꾸기 전에 백업으로 복사합니다. 각 카드에는 마지막 내보내기 취소가 있어서, 파일을 바이트 하나까지 원래 상태 그대로 되돌립니다.
  • 이미 자체 바인딩이 있는 게임으로 처음 내보낼 때는 "먼저 가져올까요?"라고 한 번 묻습니다. 게임에서 만든 것을 유지하려면 먼저 가져오기를, 교체하려면 그래도 내보내기를 고르세요.
  • 연결되어 있지 않은 장치는 바인딩을 유지합니다. 마우스와 게임패드 바인딩은 절대 건드리지 않습니다.

#게임에서 달라지는 점

게임을 시작하고 조작 메뉴를 열면, 게임이 쓰는 이름으로 각 장치 열에 바인딩이 들어 있습니다. DCS에서는 기체별로, Star Citizen에서는 함선 동작별로, IL-2에서는 Key mapping에 표시됩니다. 아래 게임에서 섹션에 모든 종류의 게임이 나와 있습니다.

#바인딩이 게임에 전달되는 다른 방법

방법 하는 일
내 게임에 쓰기(빠른 설정) 빠른 설정의 내보내기입니다. 설정한 게임에 같은 백업과 함께 써넣습니다. 빠른 시작을 참고하세요.
가상의 컨트롤러(가상 Xbox 패드) ACE COMBAT 8과 Hell Let Loose: Vietnam에는 아무것도 써넣지 않으며, 내보내기에서도 그렇게 알려 줍니다. 시작이 켜져 있는 동안 스틱이 가상의 컨트롤러를 움직입니다. Xbox 전용 게임을 참고하세요.
DCS 니보드 바인딩을 내보내는 것이 아니라, 조종석에서 버튼이 하는 일을 보여 주는 기체별 페이지입니다. 니보드를 참고하세요.
고급

#모드 자세히 보기

"같은 입력"이란 같은 장치, 같은 버튼이나 축, 같은 수정키를 뜻하며, 게임이 기체별로 바인딩을 저장하면 같은 기체(또는 함선, 차량)여야 합니다. 모든 모드는 내보내는 기체 안에서만 작용합니다.

추가만 업데이트, 유지 업데이트, 프로필 우선 바꾸기
사용자의 바인딩 입력이 비어 있는 곳에 기록 작성됨 작성됨 작성됨
다른 동작에 쓰는 입력에 있는 게임 바인딩 유지됨. 사용자의 바인딩은 기록되지 않고 표시됨 제거됨 제거됨 제거됨
같은 동작의 다른 입력에 있는 게임 바인딩(이동 후) 유지됨 유지됨(동작이 두 입력 모두에 있음) 제거됨 기록하는 장치에서 제거됨
사용자 장치의 다른 게임 바인딩 유지됨 유지됨 유지됨 제거됨
사용자 장치의 게임 기본값 유지됨 유지됨 사용자의 동작을 가지고 있지 않으면 유지됨 제거됨
프로필에 바인딩이 없는 연결된 장치 유지됨 유지됨 사용자의 동작이 제거됨 유지됨. 단, 다른 장치도 지우기를 켜면 제외
연결되지 않은 장치, 마우스, 게임패드 건드리지 않음 건드리지 않음 건드리지 않음 건드리지 않음
키보드 키보드 옵션을 켰을 때만 키보드 옵션을 켰을 때만 키보드 옵션을 켰을 때만 키보드 옵션을 켰을 때만
내보내기에 포함되지 않은 기체 건드리지 않음 건드리지 않음 건드리지 않음 건드리지 않음(DCS: "다른 모든 기체에서도 DCS 기본 바인딩 제거" 옵션을 켜면 제외)

다른 장치도 지우기는 추가만에서는 쓰이지 않습니다. 다른 모드에서는 내보내는 기체에서 프로필이 쓰지 않는 연결된 장치를 비웁니다(DCS: 그 장치의 DCS 기본값도). 가져오기에서 무시하는 장치와 JoyPro가 터널링하는 vJoy 장치는 지우지 않습니다.

2.5.0부터 기본값은 내 장치에서 교체 + 다른 장치도 지우기입니다(JoyPro 1과 같음). 직접 고른 모드는 기억됩니다.

#요약: 사용자의 바인딩 하나, 모드 네 가지

모드 게임이 사용자의 버튼을 다른 데 씀 사용자의 동작에 게임 안의 다른 버튼이 있음 연결된 다른 장치
내 장치에서 교체 그 바인딩이 제거되고 사용자의 바인딩이 기록됨 기록하는 장치에서 제거됨 유지됨. 단, 다른 장치도 지우기를 켜면 제외
업데이트, 내 프로필 우선 그 바인딩이 제거되고 사용자의 바인딩이 기록됨 제거됨 사용자의 동작이 그 장치에서 제거됨
업데이트, 게임의 바인딩 유지 그 바인딩이 제거되고 사용자의 바인딩이 기록됨 유지됨: 동작이 두 버튼 모두에 있음 유지됨
추가만 유지됨. 사용자의 바인딩은 기록되지 않고 표시됨 유지됨 유지됨

#게임별 옵션

옵션 및 경로 (전문가용) 아래에:

  • DCS: DCS 카드의 기체... 목록(체크한 기체만 기록됨), DCS: 키보드 기본값 유지(켜짐), 다른 모든 기체에서도 내 장치의 DCS 기본 바인딩 제거(꺼짐).
  • Star Citizen: SC: 키보드 기본값 유지, 로컬 순서 우선.
  • 다른 게임: 기록하지 않고 무엇이 바뀔지 보여 주는 시험 실행 상자.
  • 경로: 게임마다 다른 Saved Games 또는 설정 폴더. 이 프로필 전용 경로와 무시할 장치는 PC의 설정 대신 열린 프로필만의 설정을 줍니다.

#표시: "게임에 기록되지 않음"

추가만(그리고 게임에 다른 입력을 위한 빈자리가 없는 모든 모드, 예를 들어 동작마다 입력이 두 개인 Elite Dangerous)은 일부 바인딩을 빼놓습니다. 프로필은 그 입력을 차지한 게임의 동작과 날짜와 함께 각각을 기억합니다. 확인은 표시마다 '업데이트'로 내보내 교체하기, 다른 버튼으로 이동, 그대로 두기가 있는 카드를 보여 줍니다. 내보낼 때마다 해당 게임과 기체의 표시가 교체되므로, 나중의 내보내기가 그 바인딩을 기록하면 표시가 사라집니다.

#기억되는 설정

모드, 다른 장치도 지우기 체크, 게임별 옵션, 경로는 JoyPro 설정에 저장됩니다. 직접 체크한 게임과 DCS 기체는 프로필마다 저장됩니다. 교체와 지우기는 내보낼 때마다 묻습니다(설정 > 확인에서 이 질문을 끌 수 있음).

#내보낸 후

  • 카드의 마지막 내보내기 취소는 그 게임의 가장 최근 백업을 복원합니다. 전체 목록은 내보내기 페이지 아래쪽의 게임 설정 백업에 있습니다.
  • 내보내기는 게임 감시 기능을 위해 게임 파일을 기록해 둡니다. JoyPro 자신의 내보내기에 대해서는 나중에 "변경 사항을 가져올까요?"라고 묻지 않지만, 그 뒤에 게임에서 직접 바꾼 것은 묻습니다(감시 기능).
  • JoyPro는 게임 파일 옆에 자체 데이터를 저장하므로, 나중에 가져오면 관계 이름, 그룹, 수정키, 곡선이 되돌아옵니다(다시 가져오기).

#게임에서

내보낸 뒤 플레이어가 보는 모습은 게임 종류에 따라 다릅니다. 아래의 모든 게임은 같은 규칙을 따릅니다. JoyPro는 명령 목록에 있는 동작만 써넣고, 게임이 실행 중이면 써넣기를 거부하며, 먼저 파일을 백업하고, 일치시킬 수 없는 장치나 동작은 추측하지 않습니다(경고와 함께 건너뜁니다).

게임에서: 비행 시뮬레이터: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Falcon BMS, X-Plane, MSFS, FSX, Prepar3D

JoyPro는 써넣는 장치를 넘겨받습니다. 교체를 쓰면 내보내는 기체에서 그 장치들의 다른 바인딩이 모두 사라지고, 다른 장치도 지우기를 쓰면 연결된 다른 장치도 지워집니다(DCS: DCS 기본값도 포함).

  • DCS World: Options > Controls에서 기체를 고르세요. 바인딩은 장치 열에 있고, 제거된 기본값은 빈 칸으로 표시되며, 수정키는 수정키 목록에 있습니다. 체크한 기체만 바뀝니다. JoyPro는 DCS 자체와 마찬가지로 DCS 기본값과 다른 부분만 써넣습니다.
  • IL-2 Great Battles: Settings > Key mapping에 바인딩과 축 응답이 표시됩니다. 마우스 줄과 JoyPro가 모르는 줄은 그대로 남습니다.
  • IL-2 Korea: 키 매핑 프로필 "General".
  • Falcon BMS: 런처가 다음 Launch 때 키 파일과 축 매핑을 만드므로, BMS는 런처를 통해 시작하세요.
  • MSFS 2024 / 2020: Controls에서 장치에 JoyPro의 프리셋이 표시됩니다.
  • X-Plane 11 / 12: Settings > Joystick에 할당 내용이 표시됩니다.
게임에서: 보병, 차량, 메뉴가 있는 게임: Star Citizen, War Thunder, Arma 3 / 2, Arma Reforger, WARDOGS, Nuclear Option, Hell Let Loose, Battlefield

JoyPro는 비행 동작만 건드립니다(항공기, 헬리콥터, 우주선). 도보, 차량, 메뉴 바인딩은 바이트 하나까지 그대로 남습니다. 교체와 다른 장치도 지우기는 JoyPro가 아는 비행 동작만 비웁니다.

  • Star Citizen: Options > Keybindings에 조이스틱(js1, js2, ...)의 함선 동작이 표시됩니다. 교체나 다른 장치도 지우기를 쓰면, js1에 써넣거나 js1을 쓰지 않을 때 js1에 있는 게임 자체의 조이스틱 기본값이 꺼집니다.
  • War Thunder: Controls에 항공기 바인딩이 표시되며, 전차와 함선 조작은 바뀌지 않습니다.
  • Arma 3 / Arma 2: 프로필의 키 설정. 항공기와 헬리콥터 동작만 바뀝니다.
게임에서: 우주 게임: Elite Dangerous, X4: Foundations
  • Elite Dangerous는 동작마다 입력을 두 개(Primary와 Secondary) 둡니다. 빈자리가 없는 바인딩에는 "Not written" 표시가 붙고 "다른 버튼으로 이동" 또는 "그대로 두기"를 고를 수 있습니다. 도보 및 SRV 바인딩은 그대로 남습니다.
  • X4: 게임의 입력 설정. 목록에 있는 함선 동작만 바뀝니다.
게임에서: 장치 하나만 읽거나 Xbox 컨트롤러만 읽는 게임
  • vJoy로 설정한 게임(장치를 몇 개만 읽는 게임): 내보내기가 바인딩을 vJoy 장치에 써넣습니다. 플레이하는 동안 JoyPro가 스틱 입력을 vJoy 장치로 복사하고, HidHide가 그 게임에서만 실제 장치를 숨깁니다. 게임에는 모든 것이 들어 있는 장치 하나만 보입니다. 가상 조이스틱을 참고하세요.
  • Xbox 전용 게임(ACE COMBAT 8, Hell Let Loose: Vietnam): 아무것도 써넣지 않으며, 내보내기에서도 그렇게 알려 줍니다. 시작이 켜져 있는 동안 스틱이 가상의 컨트롤러(가상 Xbox 패드)를 움직입니다. HidHide는 필요 없습니다. HOTAS로 Xbox 전용 게임 하기를 참고하세요.
기술 정보

#내부 작동 방식

클릭부터 파일 기록까지, 내보내기 한 번:

# 누가 일어나는 일
1 사용자 내보내기 페이지에서 체크한 게임 내보내기를 누릅니다.
2 JoyPro 엔진에 게임 상태를 묻습니다(profile game-state --game <id>): 가져왔는지, 내보냈는지, 바인딩이 있는지.
3 JoyPro 필요할 때 묻습니다: 첫 내보내기("먼저 가져올까요?") 또는 바인딩을 지우는 모드(설정 > 확인).
4 엔진 <game> export --mode <m> --nuke-untouched-devices <b> ...을 실행합니다: 게임이 실행 중이면 거부하고, 모든 파일을 백업하며(GameBackups와 .jpbak), 카탈로그에 있는 동작만 씁니다.
5 엔진 동기화 기록(지문과 기준선)과 내보내기 표시를 저장한 뒤 답합니다: 기록됨, 건너뜀, SkippedTakenInputs.
6 JoyPro 게임의 카드에 "14:02에 내보냄"이 표시되고 마지막 내보내기 취소를 쓸 수 있습니다.
  1. GUI. ExportSelectedGamesAsync / ExportGameNowAsync(MainWindowViewModel.ExportGames.cs)가 AskAboutFirstExportAsync(engine profile game-state)와 ConfirmRiskyExportAsync로 묻고, 그다음 ExportGameAsync가 카드의 내보내기 모듈을 고릅니다: dcs, il2, starcitizen 또는 레지스트리 게임. 명령은 페이지의 설정으로 만들어집니다. 예: 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. 모든 엔진 호출은 --profile과 --status true(작업 영역의 진행률과 취소)를 붙여 한 곳, RunEngineAsync를 거치며, 두 명령이 동시에 기록하지 않도록 순서대로 실행됩니다.
  2. 엔진. engine\Program.cs는 dcs / il2 / starcitizen을 각 내보내기 모듈로, 나머지 모든 게임을 Games.GameRegistry(게임마다 GameIntegration 하나)로 보냅니다. DCS: EngineDcsExport.Modes.cs가 장치 파일마다 DCS에서 활성인 바인딩(기본 프로필에서 removed를 빼고 added와 changed를 더함)을 계산하고, 어떤 바인딩을 활성으로 할지 정한 뒤, 기본값과 실제로 다른 것만 기록합니다.
  3. 안전. GameExportSafety.BackupBeforeOverwrite는 각 파일을 <file>.jpbak과 버전별 백업 저장소(manifest.json이 있는 %LOCALAPPDATA%\JoyPro2\GameBackups\<date-time>_<game>\, 게임마다 최신 30세트 보관)에 복사합니다. 레지스트리 게임(Nuclear Option)은 바뀔 수 있는 값의 스냅샷을 받습니다. 내보내기가 새로 만든 파일은 "존재하지 않았음"으로 기록되므로 복원하면 다시 지워집니다.
  4. 그 후. 동기화 기록(<data>\Sync\<game>.json: 파일마다 크기, 시간, SHA-256과 모든 바인딩의 해시)이 JoyPro 자신의 변경에 대해 감시 기능을 조용히 시킵니다. ExportSkippedBinds.cs가 SkippedTakenInputs를 채우고, 내보내기 명령이 이를 프로필의 표시로 바꿉니다. 프로필 기록 내역은 내보내기 전마다 체크포인트를 남깁니다.

#게임별로 기록되는 파일

게임 파일
DCS World 기체와 장치마다 Saved Games\DCS\Config\Input\<aircraft>\joystick\<device>.diff.lua, 그 옆의 .jp, 기체의 modifiers.lua
IL-2 Great Battles data\input\global.actions(새 줄은 끝에, 순서 유지), 축 응답, jp.actions
IL-2 Korea data\input\general.actions
Falcon BMS 장치마다 런처의 User\Config\Setup.v100.* {GUID}.xml
MSFS 2024 / 2020 입력 프로필(2024: Community 폴더의 프리셋 패키지 joypro-input-profiles와 Steam 프로필)
X-Plane 11 / 12 Output\preferences의 조이스틱 환경 설정
Star Citizen LIVE\user\client\0\Profiles\default\actionmaps.xml과 actionmaps.jp
War Thunder Documents\My Games\WarThunder\Saves\<id>\production\machine.blk
레지스트리 게임 설정 파일과 <config>.joypro-meta.json

기록되지 않은 바인딩의 표시: engine export-marks list, engine export-marks dismiss. 설정: export-settings.json(ModeChosenByUser). --mode가 없을 때 엔진의 기본값은 merge-overwrite입니다.

#명령줄의 모든 모드

GUI 선택 엔진 옵션
내 장치에서 교체 + 다른 장치도 지우기(기본값) --mode clean --nuke-untouched-devices true
내 장치에서 교체 --mode clean --nuke-untouched-devices false
업데이트, 내 프로필 우선(+ 지우기) --mode merge-overwrite --nuke-untouched-devices true|false
업데이트, 게임의 바인딩 유지(+ 지우기) --mode merge --nuke-untouched-devices true|false
추가만 --mode add(nuke는 쓰이지 않음)

게임별: engine dcs export, engine il2 export, engine starcitizen export, 그리고 모든 레지스트리 게임의 engine <game> export(예: engine warthunder export, engine msfs2024 export, engine xplane12 export; 모두 --mode, --dry-run, --include-keyboard, --nuke-untouched-devices를 받음). 실행 취소: engine backups restore. 테스트: engine\tests\smoke\dcsexportmodes.ps1(모든 모드, 왕복, 바이트 단위 실행 취소)와 engine\tests\smoke\roundtrip.ps1(가져오기, clean + nuke, 다시 가져오기를 하면 게임이 원래대로 남음).