MSFS 2024는 조작 설정을 장치와 카테고리(Airplanes와 General)마다 하나씩 프로필로 보관하고, 장치와 기체마다 어떤 프로필을 쓰는지 기억합니다. JoyPro는 이 프로필들을 자체 프로필 하나로 읽어 오고, Steam 버전과 Microsoft Store 버전 모두에서 시뮬레이터가 쓰는 바로 그 프로필에 바인딩을 다시 씁니다. 시뮬레이터가 아직 장치에 대해 설정하지 않은 기체에는 JoyPro가 시뮬레이터의 Community2024 폴더에 작은 패키지로 자체 프리셋을 추가하며, 프로필을 쓸 수 없는 경우에는 시뮬레이터의 Controls 메뉴에서 가져올 파일을 남겨 둡니다.
Microsoft Flight Simulator 2024 기본(게임 자체 바인딩 파일)
- 지원
- 기본(게임 자체 바인딩 파일)
- 엔진 명령
engine msfs2024- 바인딩 파일
- 시뮬레이터가 장치와 범주별로 쓰는 내 프로필(Steam
remote\inputprofile_*XML 또는 Microsoft Store 저장 데이터,--user-profiles) + JoyPro의 Community 패키지(joypro-input-profiles, 장치마다 프리셋 XML 하나). 내 프로필에 쓸 수 없는 경우Documents\JoyPro2\MSFS 2024 import files에 가져오기 파일 - 게임이 읽는 입력
- 조이스틱 하나당 축 8개, 햇 1개(4방향)를 읽음(문서 기준)
- 명령 목록 출처
- Asobo의 프리셋 파일,
fs-base\en-US.locPak에 나오는 비행 이벤트, 설치된 기체 - 게임 내 테스트
- 26/26 단계 통과(2026-10-11)
- ✓ 가져오기
- ✓ 내보내기
- ✗ 키보드 바인딩
- ◐ 수정키MSFS: 수정키 버튼은 같은 장치의 버튼만 가능합니다.
- ✓ PC에서 만든 명령 목록
- ✓ 게임 감시
- ✓ 축 곡선과 데드존
- ✗ 게임 조작 설정
- ✗ 게임 내 포스 피드백 설정
- ✗ 텔레메트리 기반 포스 피드백
- ✓ 텔레메트리 기록
- ✓ 가상 조이스틱 (vJoy)
- ◐ 가상 Xbox 패드
- ✓ 가상 기능
- ✓ 설정 마법사 / 자동 할당
- ✓ 조종석
- ✓ 치트 시트
- ✓ 게임 내 테스트
엔진 코드에서 생성된 지원 매트릭스 기준: 모든 게임.
#3단계로 바로 사용하기
- 모두 알아서 설정
시작 페이지에서 - 이 버튼 사용
먼저 목록을 확인 - 내 게임에 쓰기
시뮬레이터는 닫아 둔 채로
먼저: 모든 장치를 한 번씩 연결하세요.
그다음: 내 MSFS 2024 프로필 상자를 읽어 보세요. 가져오기 파일이 나와 있나요? 그러면 시뮬레이터에서 그 파일을 가져오세요(아래 직접 해야 할 일 참조).
전에 MSFS 2024에서 버튼을 바인딩한 적이 있나요? 그러면 시작 페이지에 가져온 후 빈 곳 채우기가 나타납니다. 기존 바인딩은 그대로 두고, 비어 있는 버튼에만 새 역할이 주어집니다. 빠른 시작: 내 스틱 작동시키기를 참조하세요.
#JoyPro가 MSFS 2024에서 하는 일
- 가져오기: 시뮬레이터의 Controls 메뉴에서 만든 프로필(Steam 또는 Microsoft Store)이 프로필로 들어옵니다. 비행 바인딩과 General 바인딩(카메라, 시점, 액티브 일시 정지 등)이 Sensitivity 페이지의 축 설정과 함께 들어옵니다. 시뮬레이터에서 한 번도 바꾸지 않은 장치는, 시뮬레이터 자체 기록에 그 프리셋을 쓴다고 나와 있으면 시뮬레이터가 그 장치용으로 제공하는 프리셋을 가져옵니다.
- 관계: 관계 하나는 하나의 기능입니다. MSFS 2024에서는 DCS처럼 관계를 모든 기체용(기본값)으로 하거나 체크한 기체 전용으로 할 수 있습니다.
- 내보내기: JoyPro는 시뮬레이터가 장치와 카테고리마다 쓰는 프로필에 바인딩을 쓰고, 시뮬레이터가 아직 설정하지 않은 기체를 위해 프리셋 패키지를 쓰며, 프로필을 업데이트할 수 없는 곳에는 가져오기 파일을 씁니다.
#MSFS 2024 바인딩 가져오기
- 시작을 열고 Microsoft Flight Simulator 2024 카드에서 가져오기를 누르세요.
- MSFS에서는 두 가지 옵션이 중요하며, 체크하지 않으면 둘 다 꺼져 있습니다.
- 연결되지 않은 장치도 가져오기: MSFS는 지금까지 인식한 모든 장치의 바인딩을 보관합니다. 꺼짐: 지금 연결된 장치만.
- 시뮬레이터가 사용하지 않을 수도 있는 기본 프리셋도 가져오기: 시뮬레이터 기록에 제공 프리셋 사용 여부가 나오지 않는 장치용입니다. 시뮬레이터에 없는 바인딩이 추가될 수 있습니다.
- 지금 가져오기를 누르세요(또는 프로필을 바꾸지 않고 시뮬레이터에 있는 것을 보려면 먼저 확인).
가져온 관계는 모든 기체에 적용됩니다. 어떤 바인딩이 일부 기체의 프로필에만 있으면, 가져오기 후 관계 페이지에 관계마다 이 기체로 제한, 그리고 모두 제한과 모든 기체에 유지가 있는 안내가 표시됩니다.


#관계 만들기와 확인
관계 페이지에서 MSFS 2024 동작은 시뮬레이터의 기체를 체크 표시와 함께 보여 줍니다. 모든 기체가 체크되어 있으면 모든 기체용입니다. 일부 애드온 기체에만 있는 동작에는 "다음 기체만:"과 함께 그 기체가 표시되며, 이 동작을 추가하면 그 기체만 체크됩니다. 관계 흐름을 참조한 다음, 내보내기 페이지에서 확인을 실행하세요. 시뮬레이터보다 먼저, 기능이 두 개인 버튼을 찾아냅니다.
#MSFS 2024로 내보내기
- MSFS 2024를 닫으세요. 시뮬레이터가 실행 중이면 JoyPro는 쓰기를 거부합니다(Microsoft Store 버전에서는 실행 도우미가 실행 중일 때도).
- 내보내기를 여세요. 게임으로 내보내기 아래에 MSFS 2024용 체크 항목이 두 개 있습니다.
- MSFS 2024: 내 MSFS 프로필에 기록(켜짐): 내보내기가 시뮬레이터가 장치와 카테고리마다 쓰는 프로필을 먼저 백업한 뒤 업데이트합니다.
- MSFS 2024: 모든 장치의 가져오기 파일(꺼짐): JoyPro가 프로필을 쓸 수 없었던 곳뿐만 아니라 모든 장치와 카테고리에 대해 가져오기 파일을 만듭니다.
- JoyPro에서 장치를 설정한다면 내 장치에서 교체와 다른 장치도 지우기를 그대로 두고, MSFS 2024 카드의 지금 내보내기를 누르세요.
내보낸 뒤 내 MSFS 2024 프로필 상자에 JoyPro가 쓴 모든 프로필이 기체와 바인딩 수와 함께 나옵니다. 가져오기 파일을 썼다면 두 번째 상자에 그 파일이 폴더 열기와 함께 나옵니다.


시뮬레이터를 시작하고 Settings > Controls를 연 다음 장치와 카테고리(Airplanes 또는 General)를 고르세요. 바인딩이 내 프로필의 시뮬레이터 동작 이름 아래에 들어가 있습니다. 장치 페이지(장치의 톱니바퀴에 있는 Hardware Settings)에는 JoyPro가 쓴 축 곡선이 표시됩니다. 시뮬레이터가 아직 그 장치에 대해 설정하지 않은 기체에서는 장치가 JoyPro의 프리셋으로 시작합니다.
#MSFS 2024에서 직접 해야 할 일
- 내 MSFS 2024 프로필에 업데이트됨으로 표시된 모든 프로필은 할 일이 없습니다.
- 가져오기 파일: 내보내기에 가져오기 파일이 나오면 Settings > Controls를 열고, 장치와 카테고리(Airplanes 또는 General)를 고른 다음, 프로필의 톱니바퀴(프리셋의 톱니바퀴가 아님)를 클릭하고 Import를 고른 뒤 JoyPro가 그 장치와 카테고리용으로 쓴 파일을 선택하세요. 시뮬레이터는 같은 장치와 카테고리의 파일만 받아들입니다. 파일에 내 프로필 이름이 들어 있으면 시뮬레이터가 덮어쓸지 묻습니다. 확인하면 프로필에 JoyPro의 바인딩이 들어갑니다. 파일은 내보내기에서 새 파일이거나 바뀌었다고 할 때만 다시 가져오세요.
- 첫 내보내기 전에 모든 장치를 한 번씩 연결하세요. JoyPro가 프리셋에 장치의 제품 ID를 써야 하기 때문입니다.
- 한 기체만 다른 바인딩이 필요함: 시뮬레이터에서 그 기체 전용 프로필을 만드세요(그 기체를 불러온 상태에서 Controls에서 프로필 복제). 그런 다음 다시 내보내세요. 내보내기는 배치하지 못한 관계를 모두 알려 줍니다.
- Xbox 클라우드 질문: 시뮬레이터나 Xbox 앱이 어느 저장 데이터를 유지할지 물으면 이 PC의 것을 유지하세요. 다른 쪽을 고르면 JoyPro의 바인딩이 사라집니다(그때는 다시 내보내세요).
#자주 하는 실수
- "MSFS 2024 실행 중입니다": 시뮬레이터를 닫으세요. Microsoft Store 버전에서는 시뮬레이터의 실행 도우미(
gamelaunchhelper.exe)도 종료되어야 합니다. - 한 기체에서 바인딩이 빠짐: 그 기체는 내 프로필 중 다른 것을 씁니다. 내 MSFS 2024 프로필 목록을 확인하세요. "가져오기 파일"이라고 적힌 줄은 시뮬레이터에서 그 파일을 가져오라는 뜻입니다.
- 관계가 기록되지 않음: 관계가 일부 기체로 제한되어 있는데, 시뮬레이터가 그 기체에 쓰는 프로필을 다른 기체와 함께 씁니다. 경고에 프로필과 기체 이름이 나옵니다.
- 장치에 프로필이 여러 개 있음: 가져오기는 시뮬레이터 기록에 나온 프로필을, 없으면 가장 최근 프로필을 사용하고 나머지 이름을 알려 줍니다. 시작 페이지의 다른 게임 양식에 있는 게임 프로필에서 다른 프로필을 고르세요.
- 시뮬레이터에서 바인딩할 때 "WRONG DEVICE": 계속 값을 보내는 장치(일부 포스 피드백 스틱)가 시뮬레이터의 입력 감지를 가로챕니다. 이는 JoyPro가 아니라 시뮬레이터 자체 바인딩에서 일어나는 일입니다.
- 시뮬레이터의 Reset to Defaults는 모든 장치와 기체의 프리셋을 초기화합니다. JoyPro는 이를 대신 실행하지 않습니다.
#JoyPro가 읽고 쓰는 파일
| 파일 | 설명 |
|---|---|
<Steam>\userdata\<id>\2537590\remote\inputprofile_<n> |
사용자 자신의 프로필(Steam). 확장자 없는 일반 XML. 제자리에 쓰며, 다음 동기화 때 Steam Cloud가 업로드함 |
%LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\SystemAppData\wgs\<user>\ |
Microsoft Store판 세이브(containers.index, container.<n>, 프로필마다 blob 하나). JoyPro는 새 blob, 새 컨테이너 파일, 색인을 씀 |
remote\profile_00(Store판: 컨테이너 profile_00) |
시뮬레이터의 장치 기록: 각 장치가 기체마다 어떤 프로필이나 프리셋을 쓰는지. 읽기만 함, 절대 쓰지 않음 |
<packages>\Community2024\joypro-input-profiles\InputProfiles\Categories\Airplane\JoyPro_<device>_<guid8>_2024_Planes.xml |
장치의 JoyPro 프리셋(비행 동작), layout.json과 manifest.json 포함 |
...\Categories\Transversal\JoyPro_<device>_<guid8>_2024_Transversal.xml |
장치의 General 바인딩용 JoyPro 프리셋 |
%USERPROFILE%\Documents\JoyPro2\MSFS 2024 import files\<device>_<guid8>_Airplanes.xml / _General.xml |
시뮬레이터 자체 프로필 형식의 가져오기 파일 |
<install>\Packages\fs-input-profiles, asobo-input-profiles-pc, fs-base\en-US.locPak |
Asobo가 제공하는 프리셋과 메뉴 이름: 명령 목록과 기본 프리셋을 위해 읽기만 함 |
%LOCALAPPDATA%\JoyPro2\Ownership\MSFS, ...\Backups\MSFS |
JoyPro의 소유 데이터와 백업. 동기화되는 폴더에는 절대 두지 않음 |
<packages>는 %APPDATA%\Microsoft Flight Simulator 2024\UserCfg.opt의 InstalledPackagesPath입니다(Store판: %LOCALAPPDATA%\Packages\Microsoft.Limitless_8wekyb3d8bbwe\LocalCache\UserCfg.opt). 쓰기 전마다 Store판 세이브 폴더 전체나 Steam 파일이 백업 세트에 들어가므로, 마지막 내보내기 취소로 세이브를 되돌릴 수 있습니다.
#MSFS 2024의 내보내기 모드
모드는 프로필마다(즉 기체 그룹마다), 그리고 관리 대상 컨텍스트에서만 작동합니다.
| 모드 | 사용자의 MSFS 2024 프로필에서 일어나는 일 |
|---|---|
| 추가만 | 바인딩은 그 프로필의 다른 동작이 그 입력 조합을 쓰지 않는 곳에만 쓰입니다. 그렇지 않으면 쓰이지 않은 것으로 표시됩니다. 아무것도 제거되지 않습니다. |
| 업데이트, 게임의 바인딩 유지 | 사용자의 입력 조합에 있던 다른 동작은 그 조합을 잃습니다. 나머지는 모두 남으며, 동작의 예전 조합도 남습니다(동작에는 Primary와 Secondary 두 개가 있습니다). |
| 업데이트, 내 프로필 우선 | 위와 같고, 바인딩한 모든 동작은 다른 조합을 잃습니다. 연결된 다른 장치의 프로필에서도 마찬가지입니다(그 프로필도 쓰입니다). |
| 내 장치에서 교체 | JoyPro가 쓰는 연결된 장치의 프로필에는 사용자의 바인딩만 남습니다. |
| + 다른 장치도 지우기 | 사용자 자신의 MSFS 2024 프로필은 절대 비우지 않습니다. |
모든 기체용 관계(릴레이션)는 시뮬레이터의 기록에 나오는 모든 프로필에 들어갑니다. 기체가 제한된 관계(릴레이션)는 그 기체가 모두 체크된 프로필에만 들어갑니다. 제한된 관계(릴레이션)는 프리셋 패키지나 가져오기 파일에는 절대 들어가지 않습니다. 그것들은 모든 기체에 적용되기 때문입니다.
#절대 건드리지 않는 것
- 메뉴, 월드 맵, 개발자 컨텍스트(
MENU,MENU_*,WORLDMAP_*,DEBUG,DEVMODE*,EDITOR_*,MISSION_FLOW_TOOLS). 모든 모드에서. - 키보드, 마우스, 게임패드 프로필(
GUID="{0}"): MSFS에서는 키보드 바인딩을 쓰지 않습니다. profile_00, Asobo가 제공하는 프리셋, 기체 전용 프리셋 슬롯, 그리고 Store판 세이브의 다른 모든 컨테이너(로그북, 다른 타이틀).- 연결되지 않은 장치, 가져오기에서 무시한 장치, JoyPro가 입력을 보내는 vJoy 장치.
#기체, 곡선, 그 밖의 것
- 단위: 장치와 범주(Airplanes, General)마다, 그리고 프로필마다. 시뮬레이터가 장치와 기체마다 프로필을 고르며, JoyPro는 그 선택을 따릅니다.
- 축 곡선: 장치의 Sensitivity 페이지. 물리 축마다 한 세트: Sensitivity +와 -, Neutral, Dead zone, Extremity dead zone, Reactivity, 곡선 없음 플래그, 반전. 관계(릴레이션)는 동작 하나에 따로 값을 줄 수 있습니다(MSFS 2024의 동작별 재정의). 같은 장치 축에 걸린 관계들은 그 페이지를 공유하므로, 내보내기는 첫 번째 관계(릴레이션)의 값을 쓰고 경고합니다. axis-curves를 참고하세요.
- 포스 피드백: MSFS에는 자체 포스 피드백이 없습니다.
- 텔레메트리 기록: SimConnect를 통해 읽기만 하며, 직접 구한
SimConnect.dll을 씁니다(JoyPro에는 들어 있지 않음). Steam판 MSFS 2024에는 이 파일이 없으므로, MSFS 2024 SDK를 설치하거나 MSFS 2020을 설치해 두세요(그 사본도 작동합니다). - HUD: HUD는 프로세스로 시뮬레이터를 찾아 바인딩을 보여 줍니다.
- 감시 기능: JoyPro는 자체 패키지, Steam 프로필, Store판 세이브의
containers.index를 감시합니다. 시뮬레이터가 닫힌 뒤(Store판 세이브는 마지막 쓰기 후 10초를 기다림) 게임에서 바꾼 내용을 가져올지 묻습니다(감시 기능). - 다시 가져오기: 관계(릴레이션) 이름, 그룹, 튜닝은 파일 옆에 둔 JoyPro의 메타데이터로 돌아옵니다(다시 가져오기).
- 전문가 옵션(시작 페이지의 다른 게임): 게임 프로필(장치에 프로필이 여러 개일 때 하나를 고름), 내보낼 기체(기체 하나로 제한된 관계(릴레이션)도 모든 기체에 내보냄), 내 MSFS 프로필에 기록, 모든 장치의 MSFS 가져오기 파일도 기록, 시험 실행.
#MSFS 2024 연동의 내부
flowchart LR P["내 프로필"] --> E["engine msfs2024 export"] E --> U["사용자 자신의<br/>프로필"] E --> K["JoyPro의<br/>프리셋"] E --> F["가져오기 파일"] F --> I["사용자: 톱니바퀴,<br/>Import"] U --> S["Settings ><br/>Controls"] K --> S I --> S
코드: engine\Games\MsfsIntegration.cs(두 시뮬레이터에 클래스 하나), MsfsIntegration.UserProfiles.cs(직접 쓰기), MsfsIntegration.ImportFiles.cs, MsfsCommunityPackage.cs, MsfsUserProfiles.cs(Steam과 Store 읽기), WgsContainers.cs(Store판 세이브), MsfsSimProfile.cs(profile_00의 기록), MsfsSimDefaults.cs, MsfsProfileFile.cs(줄 단위 편집기), MsfsGameData.cs, MsfsAircraft.cs, engine\AxisModels\Msfs.cs.
- 형식: XML 조각(최상위 요소 여러 개):
<Version>,<FriendlyName>,<Axes>와<Context ContextName>/<Action ActionName Flag>/<Primary>/<Secondary>/<KEY Information>code</KEY>가 있는<Device DeviceName GUID ProductID CompositeID HWVer>. 2024 프로필은 컨텍스트의 모든 동작을 나열하며, 바인딩되지 않은 동작은 빈<Action/>입니다. 코드: 버튼 N = N-1, 햇 256-259, L축 X/Y/Z 1026/1042/1058, R축 770/786/802, 슬라이더 514/530. 플래그: 2 디지털, 4 축, 128 반전, 1024 감도 곡선 없음, 4096 동작별 축 재정의. 바뀐<Action>요소만 다시 렌더링합니다. - 장치: 프로필은 장치를 DirectInput 인스턴스 GUID(
GUID)로 지정하므로, 프로필을 읽을 때 장치가 연결되어 있을 필요가 없습니다. 시뮬레이터는 USB 제품 ID(16진수)로 프리셋을 맞춥니다. JoyPro는 시뮬레이터가profile_00에 기록해 둔 ID를 쓰고, 없으면 USB PID를 씁니다(vJoy는 제품 ID 0으로 표시됩니다). - 어떤 프로필이 활성인지: 장치와 기체마다
profile_00의 레코드에는 General 슬롯과 카테고리 슬롯이 있습니다. 그곳에 있는 사용자 프로필은inputprofile_<n>이며, 이것이 Steam 파일 이름이자 Store 컨테이너 이름입니다. - Store 저장 데이터: 인덱스가 알려진 구조(버전 14, 충돌 플래그 없음, 컨테이너가 알려진 상태로 한 번만 등록됨)일 때만 씁니다. 이때 새 blob
container.<n+1>을 쓰고, 마지막으로 인덱스를 쓴 다음(임시 파일 후 교체) 다시 읽어 확인하고, 이전 세대를 지웁니다. 하나라도 실패하면 모두 원래대로 되돌립니다. 알 수 없는 것이 있으면 아무것도 쓰지 않고, 가져오기 파일이 바인딩을 전달합니다. - 명령 목록:
engine msfs2024 refresh-db는 Asobo의 프리셋,en-US.locPak에 이름이 있는 모든 비행 이벤트, 사용자의 General 프로필, 압축되지 않은 애드온 패키지(Community, Marketplace)와 그 기체를 읽습니다. 기체 목록은 시뮬레이터의 콘텐츠 목록에서 가져옵니다. 새로 설치한 경우 첫 가져오기 때 목록을 만듭니다. - 명령:
engine msfs2024 paths,engine msfs2024 catalog,engine msfs2024 scan,engine msfs2024 import(--game-profile,--include-disconnected,--include-sim-defaults,--limit-to-profile-aircraft,--replace),engine msfs2024 export(--mode,--nuke-untouched-devices,--dry-run,--aircraft <key>;--user-profiles false와--import-files는 내보내기 페이지의 두 체크 상자에 해당); 기체별 관계는engine relations aircraft set; 실행 취소는engine backups restore; 감시 기능은engine sync status와engine sync diff. 예전 CLI 이름engine msfs ...도 여전히 MSFS 2024를 뜻합니다.
#알려진 한계
- 기체 전용 프리셋 슬롯은 쓰지 않습니다(기체 자체 패키지에만 들어 있습니다). JoyPro는
profile_00을 절대 쓰지 않습니다(파일 끝에 체크섬이 있습니다). - JoyPro의 프리셋은 시뮬레이터가 아직 해당 장치를 설정하지 않은 기체에만 적용됩니다. 그 밖의 기체에서는 사용자 프로필이나 가져오기 파일이 바인딩을 전달합니다.
- 동작마다 입력 조합은 최대 두 개이며, 세 번째는 보고됩니다. 반축, 햇 대각선, 두 번째 햇은 읽거나 쓰지 않습니다. 수정키: 같은 장치의 버튼만 가능합니다.
- 압축된 애드온 패키지(
.fsarchive)는 건너뜁니다. 260자를 넘는 Store 저장 경로는 읽지 않습니다. - 다른 PC에서 나중에 저장했다면 클라우드 사본(Steam Cloud, Xbox 클라우드)이 JoyPro가 쓴 내용보다 우선할 수 있습니다.
- 테스트:
engine\tests\smoke\msfs.ps1,smoke\msfsuserprofiles.ps1,gui\JoyPro.Gui.Tests\MsfsProfileImportTests.cs(Steam 및 Store 저장 데이터, 기체별 프로필, 롤백),MsfsStoreWatcherEndToEndTests; 시뮬레이터 안에서는tools\e2e\games\Msfs2024Settings.ps1(프리셋, 축, 버튼, Controls의 동작별 곡선).
이 게임에 대한 모든 기술 메모(저장소에서 생성됨): msfs.md.