JoyPro2 Discord GitHub
게임

Star Citizen

표시:

Star Citizen은 모든 조작을 actionmaps.xml 파일 하나에 저장하고, 스틱에 조이스틱 슬롯 js1~js8 번호를 매깁니다. JoyPro는 이 파일의 함선 바인딩을 프로필로 읽어 오고 제자리에 다시 써넣습니다. 함선 동작과 그 축 설정만 바뀌고, 나머지 줄은 모두 게임이 쓴 그대로 남습니다. 장치는 게임이 이미 준 슬롯을 그대로 유지하므로, 바인딩이 한 스틱에서 다른 스틱으로 옮겨 가지 않습니다.

Star Citizen 기본(게임 자체 바인딩 파일)
지원
기본(게임 자체 바인딩 파일)
엔진 명령
engine starcitizen
바인딩 파일
LIVE\user\client\0\Profiles\default\actionmaps.xml + attributes.xml(XML)
명령 목록 출처
Data.p4k(defaultProfile.xml)와 내 프로필
게임 내 테스트
54/54 단계 통과(2026-10-10)
  • ✓ 가져오기
  • ✓ 내보내기
  • ✓ 키보드 바인딩
  • ✓ 수정키
  • ✓ PC에서 만든 명령 목록
  • ✓ 게임 감시
  • ✓ 축 곡선과 데드존
  • ✓ 게임 조작 설정
  • ✗ 게임 내 포스 피드백 설정
  • ✗ 텔레메트리 기반 포스 피드백
  • ✗ 텔레메트리 기록
  • ✓ 가상 조이스틱 (vJoy)
  • ◐ 가상 Xbox 패드
  • ✓ 가상 기능
  • ✓ 설정 마법사 / 자동 할당
  • ✓ 조종석
  • ✓ 치트 시트
  • ✓ 게임 내 테스트

엔진 코드에서 생성된 지원 매트릭스 기준: 모든 게임.

초보자용

#3단계로 바로 사용하기

  1. 모두 알아서 설정
    시작 페이지에서
  2. 이 버튼 사용
    먼저 목록을 확인
  3. 내 게임에 쓰기
    Star Citizen은 닫아 두세요

시작 전: 사용하는 모든 장치를 연결하세요.

그러면: 바인딩이 Options > Controls에 들어가 있습니다.

전에 Star Citizen에서 버튼을 바인딩했나요? 그렇다면 시작 페이지에서 가져온 후 빈 곳 채우기를 제안합니다. 기존 바인딩은 그대로 두고, 비어 있는 버튼에만 새 기능을 줍니다. 빠른 시작: 내 스틱 작동시키기를 참고하세요.

#JoyPro가 Star Citizen에 해 주는 일

  • 가져오기: 스틱, 스로틀, 페달의 함선 바인딩이 데드존, 곡선, 반전과 함께 프로필에 들어옵니다. js1에 있는 게임 자체의 기본 조이스틱 바인딩도 함께 들어오므로, 나중에 내보내도 사라지지 않습니다.
  • 관계: 관계 하나는 모든 게임에서 하나의 기능입니다. "Landing gear"를 Star Citizen, DCS, Elite Dangerous에서 같은 스위치로 만들 수 있습니다.
  • 내보내기: JoyPro가 actionmaps.xml을 제자리에서 수정합니다. 도보, 차량, 메뉴 바인딩과 마우스, 게임패드 바인딩은 그대로 남습니다.

#Star Citizen 바인딩 가져오기

  1. 시작을 여세요. Star Citizen 카드에서 명령 목록을 요청하면 목록 생성을 누르세요. JoyPro가 설치 파일(Data.p4k, 읽기 전용)에서 게임의 동작을 읽어 옵니다. 게임 패치 후에는 카드의 업데이트가 새 동작을 추가합니다.
  2. Star Citizen 카드에서 가져오기를 누르세요. 내 프로필에 추가를 그대로 두세요. 함선 키도 JoyPro에 넣고 싶을 때만 키보드 키도 가져오기를 체크하세요.
  3. 지금 가져오기를 누르세요. 내 관계 보기를 누르면 들어온 내용이 열립니다.
게임이 표시된 시작 페이지게임이 표시된 시작 페이지
게임이 표시된 시작 페이지 (그림은 영어로 된 앱을 보여 줍니다.)

#관계 만들기와 확인

함선 동작 하나는 관계의 항목 하나입니다. 관계 흐름으로 다른 게임의 같은 기능을 연결한 다음, 내보내기 페이지에서 확인을 누르세요. 게임보다 먼저, 함선에서 버튼 하나가 두 가지 일을 하는 경우를 찾아 줍니다.

#Star Citizen으로 내보내기

  1. Star Citizen을 닫으세요. 게임은 종료할 때 actionmaps.xml을 다시 쓰기 때문에, 실행 중에는 JoyPro가 써넣기를 거부합니다.
  2. 내보내기를 열고 Star Citizen 카드를 체크하세요.
  3. JoyPro에서 스틱을 설정한다면 내 장치에서 교체와 다른 장치도 지우기를 그대로 두세요. 카드의 지금 내보내기를 누르세요.
내보내기 페이지내보내기 페이지
내보내기 페이지
게임에서: Star Citizen에서 보이는 것

게임을 시작하고 메인 메뉴에서 Options > Controls를 여세요. 장치(Joystick / HOTAS 1, 2 ...)를 고르면 JoyPro에서 설정한 데드존과 포화도가 표시됩니다. Inversion Settings와 Joystick Sensitivity Curves(Flight > Flight Movement)에는 반전, 지수, 곡선이 표시됩니다. 함선 바인딩은 각 장치의 조이스틱 슬롯에 있습니다. JoyPro가 끈 게임 기본값은 비어 있는 것으로 표시됩니다. 메뉴에는 포화도가 파일 값보다 0.01 높게 표시되지만(0.87이 0.88로 표시), 게임은 정확한 값을 유지합니다.

#Star Citizen에서 직접 할 일

  • 바인딩에 관해서는 더 할 일이 없습니다. 내보내기 전에 사용하는 모든 장치를 연결하세요. 연결되지 않은 장치는 슬롯과 바인딩을 유지하지만, JoyPro가 새 바인딩을 줄 수는 없습니다.
  • 게임이 감지된 폴더가 아닌 다른 폴더에 있으면, 내보내기 페이지의 *옵션 및 경로 (전문가용)*에서 경로를 한 번 설정하거나 설정 > 게임에서 폴더를 연결하세요.

#자주 하는 실수

  • "Star Citizen 실행 중입니다": 게임을 종료하고(런처에서도) 다시 내보내세요.
  • 바인딩이 엉뚱한 스틱에 들어감: SC: 로컬 순서 우선을 켜 두세요(기본값). 끄면 슬롯이 Windows가 장치를 보고하는 순서를 따르므로, 한 장치의 모든 바인딩이 다른 js 번호로 옮겨 갈 수 있습니다.
  • 슬롯을 받지 못한 장치가 있음: 게임에는 조이스틱 슬롯이 8개 있습니다. JoyPro는 한 스틱의 중복 항목(게임의 이름과 JoyPro의 이름)을 슬롯 하나로 합치지만, 바인딩이 있는 장치가 8개보다 많이 연결되면 다 들어가지 않습니다.
  • js1에 기본 바인딩이 다시 생김: 내보낼 때 js1의 장치가 연결되어 있지 않으면 다시 생깁니다. 장치를 연결하고 '내 장치에서 교체'로 다시 내보내세요.
고급

#JoyPro가 읽고 쓰는 파일

파일 설명
<install>\LIVE\user\client\0\Profiles\default\actionmaps.xml 사용자의 재바인딩, 조이스틱 슬롯(<options type="joystick" instance="1..8" Product="...">), 슬롯마다 옵션 그룹(반전, 지수, 곡선, 감도), 장치 옵션(물리 축마다 데드존, 포화도)
...\Profiles\default\attributes.xml 게임 전체 설정(<Attr name="..." value="..."/>). 게임 기본값과 다른 값만
...\Profiles\default\actionmaps.jp 관계 이름을 주석으로 단, JoyPro가 쓴 파일의 사본. 다음 가져오기 때 다시 읽음
...\Profiles\default\actionmaps.xml.joypro.json JoyPro가 마지막으로 쓴 축 설정. 이것으로 "업데이트"가 게임에서 바꾼 값과 JoyPro가 쓴 값을 구별함
actionmaps.xml.jpbak, attributes.xml.jpbak 내보내기에서 처음 쓰기 전의 사본과 JoyPro의 버전별 백업 저장소

내보내기는 actionmaps.xml을 제자리에서 수정합니다. 우주선 재바인딩과, JoyPro가 쓰는 축 재바인딩의 축 설정만 바뀝니다. 다른 액션 맵, 마우스와 게임패드 재바인딩, 활성화 모드, 수정키, 다른 옵션 그룹, 장치 옵션은 바이트 하나까지 그대로 남습니다. Star Citizen 바인딩이 없는 프로필은 파일을 그대로 둡니다.

#조이스틱 슬롯

Star Citizen은 모든 조이스틱 바인딩을 슬롯으로 부릅니다: js1_button3, js2_x. 파일에는 어떤 장치가 어떤 슬롯을 차지하는지가 장치의 DirectInput 제품 이름과 제품 GUID로 나열되어 있습니다.

  • 로컬 순서 우선(기본으로 켜짐): 파일에 이미 이름이 있는 연결된 장치는 그 슬롯을 유지합니다. 다른 장치는 Windows가 알려 주는 순서대로 빈 슬롯을 채웁니다.
  • 장치 하나에 슬롯 하나: 두 번 나열된 같은 스틱(게임의 이름과 JoyPro의 인스턴스 이름으로, 또는 오래된 두 번째 항목)은 슬롯 하나만 차지합니다. 내보내기는 중복 항목을 지우고 그 바인딩을 장치가 유지하는 슬롯으로 옮깁니다. 연결되지 않은 장치의 항목은 그대로 남습니다.
  • 같은 모델의 연결된 장치 두 개는 따로 구별됩니다.
  • 슬롯이 바뀐 장치는 옵션 그룹(반전, 곡선)을 함께 가져갑니다. 슬롯을 받지 못한 장치는 이전 슬롯의 그룹을 잃으며, 경고가 표시됩니다.

#Star Citizen의 내보내기 모드

모든 모드는 우주선 동작만 바꿉니다. 도보, 차량, 메뉴 맵은 바이트 하나까지 그대로 남습니다.

모드 게임에서 일어나는 일
추가만 게임 바인딩은 바뀌지 않습니다. 조이스틱 슬롯에 이미 재바인딩이나 활성 기본값이 있는 동작은 그것을 유지합니다. 다른 우주선 동작이 쓰는 입력에 대한 바인딩은 쓰지 않으며 "게임에 기록되지 않음" 표시가 붙습니다.
업데이트, 게임의 바인딩 유지 입력이 동작의 조이스틱 슬롯에 들어갑니다(Star Citizen에는 동작과 입력 종류마다 슬롯이 하나 있습니다). 다른 우주선 동작에 준 입력에 있던 게임 바인딩은 해제됩니다. 그 재바인딩이 지워지거나, 동작에 기본값이 있으면 빈 js1_ 이 되어 기본값이 되살아나지 않습니다.
업데이트, 내 프로필 우선 위와 같으며, 키보드 옵션을 켜면 바인딩하는 동작이 키보드 재바인딩도 잃습니다.
내 장치에서 교체 쓴 장치에는 사용자의 우주선 바인딩만 남습니다. js1에 장치가 있으면, 프로필에 없는 게임의 js1 기본값이 꺼집니다.
+ 다른 장치도 지우기 프로필에 바인딩이 없는 연결된 장치는 우주선 바인딩을 잃습니다. js1을 쓰지 않으면 js1의 기본값이 꺼집니다.

내보내기 페이지의 옵션(옵션 및 경로 (전문가용) 아래):

  • SC: 키보드 기본값 유지(켜짐): 키보드는 게임의 기본 키를 유지합니다. 꺼짐: 키보드 바인딩을 쓰고, 그 바인딩이 차지하는 기본 키는 해제됩니다.
  • SC: 로컬 순서 우선(켜짐): 위의 조이스틱 슬롯을 참고하세요.
내보내기 페이지의 옵션과 경로(전문가용)내보내기 페이지의 옵션과 경로(전문가용)
내보내기 페이지의 옵션과 경로(전문가용)

#게임의 기본 조이스틱 바인딩

Star Citizen에는 동작이 js1에서 재바인딩을 받기 전까지 js1에 작용하는 기본 조이스틱 바인딩이 있습니다(Y에 피치, X에 요, Z 회전에 롤, 버튼 몇 개). 가져오기는 활성 기본값을 모두 js1 장치의 바인딩으로 받아들이므로, 프로필에 게임이 실제로 하는 일이 담깁니다. 내보내기는 기본값과 같은 바인딩에 대해서는 재바인딩을 쓰지 않습니다(실제 차이만 씀). 교체와 다른 장치도 지우기는 프로필에 없는 기본값을 빈 재바인딩 js1_ 으로 끄며(게임 메뉴가 지운 바인딩을 쓰는 방식과 같음), js1의 장치가 연결되어 있을 때만 그렇게 합니다. 따라서 가져오기 후 교체 + 다른 장치도 지우기를 하면 actionmaps.xml은 원래대로 남습니다.

#절대 건드리지 않는 것

  • 도보, 지상 차량, 메뉴 바인딩(Star Citizen의 지상 차량은 별도의 차량 클래스로 취급됩니다).
  • 연결되지 않은 장치: 슬롯과 재바인딩을 유지합니다.
  • 가져오기에서 무시한 장치와 JoyPro가 입력을 보내는 vJoy 장치.
  • 마우스와 게임패드 바인딩. 키보드 바인딩을 내보내지 않는 한 키보드도.
  • 활성화 모드, 수정키, 다른 옵션 그룹, 장치 옵션.

#함선, 곡선, 게임 설정

  • 적용 범위: 모든 우주선에 우주선 바인딩 한 세트(게임에 우주선별 바인딩이 없음).
  • 축 곡선은 게임이 보관하는 대로 두 곳에 있습니다: 장치와 물리 축마다 데드존과 포화도, 슬롯과 옵션 그룹마다 반전, 지수(1~3), 11점 곡선, 감도. 게임 메뉴처럼 지수와 곡선은 함께 쓸 수 없습니다. Star Citizen 값이 없는 관계는 JoyPro 곡선을 맞춰 변환합니다: 데드존과 포화도는 장치 축으로 가고, 굴곡은 가장 가까운 지수가 되며, 맞는 지수가 없으면 곡선이 됩니다. 한쪽 방향 축은 없습니다. 게임의 절대 스로틀과 상대 스로틀은 별도의 동작입니다.
  • 업데이트는 게임에서 바꾼 축 값을 유지합니다(경고 표시). 교체와 내 프로필 우선은 프로필의 값을 적용합니다. 중립 관계는 게임 자체 값을 그대로 둡니다(자유 시점은 기본 지수 2.5를 유지).
  • 게임 전체 설정(attributes.xml): HOTAS 추력 반전 토글, 상대 스로틀 트랩 시간과 임계값, IFCS 감도 수정값, ESP 켜기·강도·감쇠, 포탑 ESP, 비행 기본값(sticky throttle, 속도 제한기, coupled, G-safe, 자동 정밀, 우주 브레이크), 비행 컨트롤러 반전, Vibration. 설정 > 게임의 포스 피드백 설정(Star Citizen 선택)이나 engine ffb set으로 설정하세요. JoyPro는 설정한 줄만 제자리에서 바꾸며, 파일을 새로 만들지 않습니다. ESP 강도 슬라이더는 1.00에서 끝나므로 JoyPro는 0~1을 제공합니다.
  • 포스 피드백: 없음. Vibration이 게임의 유일한 관련 설정입니다.
  • 감시 기능: 게임 메뉴에서 바꾼 바인딩이나 축 값은 게임이 종료된 뒤 감지되며, JoyPro가 이를 가져올지 묻습니다. actionmaps.xml(우주선 액션 맵만)과 JoyPro가 attributes.xml에서 관리하는 설정을 비교합니다.
  • HUD: HUD는 프로세스로 게임을 찾아 Star Citizen 바인딩을 보여 줍니다.
기술 정보

#Star Citizen 연동의 내부

flowchart LR
  A[("actionmaps.xml")] --> S["장치별 슬롯"]
  D["연결된 장치"] --> S
  P["내 프로필"] --> E["engine starcitizen export"]
  S --> E
  E --> X["actionmaps.xml"]
  E --> T["attributes.xml"]
  X --> G["Options ><br/>Controls"]
알려진 장치는 자기 조이스틱 슬롯(actionmaps.xml의 js1 ... js8)을 유지합니다. 새 장치는 첫 번째 빈 슬롯을 받고, 오래된 중복은 제거됩니다. 함선의 바인딩 변경은 그 자리에서 편집되고, 게임 전체 설정은 attributes.xml로 갑니다.

코드: engine\EngineStarCitizen.cs, engine\EngineStarCitizenTuning.cs, 축 모델 engine\AxisModels\StarCitizen.cs, 설정 모델 engine\FfbModels\StarCitizen.cs.

  • 장치 이름: 슬롯의 Product는 DirectInput 제품 이름과 제품 GUID를 공백 두 칸으로 띄운 것입니다(vJoy Device {BEAD1234-0000-0000-0000-504944564944}). 다른 이름(인스턴스 GUID)으로 쓰인 슬롯이나 deviceoptions 블록은 게임이 인식하지 못합니다. 게임은 그 슬롯을 제품 이름으로 다시 쓰고 슬롯의 옵션 그룹을 버립니다. 그래서 JoyPro는 연결된 장치의 제품 이름을 씁니다.
  • 명령 목록: engine db refresh-starcitizen은 Data.p4k(또는 --source로 지정한 압축 해제 사본)에서 Data\Libs\Config\defaultProfile.xml을 읽어 DB\StarCitizen\AllBinds.xml에 씁니다: 옵션 그룹이 붙은 모든 동작, 조이스틱 옵션 트리(부모와 기본값, 곡선을 보여 주는 그룹), 동작의 기본 조이스틱 입력. engine starcitizen labels는 global.ini에서 게임의 조작 이름을 가져옵니다.
  • 가져오기: engine starcitizen import(--include-keyboard, --device, --ignore-device). 모든 축 재바인딩은 게임이 쓰는 값(슬롯의 말단 그룹, 없으면 설정된 가장 가까운 부모, 없으면 게임 기본값)과 그 축의 장치 옵션을 game:StarCitizen 튜닝으로 받습니다. engine starcitizen scan은 프로필을 바꾸지 않고 같은 내용을 보여 줍니다. engine starcitizen list-devices는 파일의 조이스틱 슬롯을 나열합니다.
  • 내보내기: engine starcitizen export --mode clean|add|merge|merge-overwrite --nuke-untouched-devices true|false --keep-keyboard-defaults true|false --prefer-local-order true|false --include-keyboard true|false --ignore-device <d>. 새 deviceoptions 블록은 첫 번째 <options> 앞에 들어갑니다. 한 옵션 그룹이나 한 물리 축에 서로 다른 값을 가진 관계가 여러 개 있으면 경고가 표시되고, 이름순으로 첫 번째 관계가 적용됩니다.
  • 게임 설정: engine ffb set --device * --game StarCitizen --param <Attr name>=<value>. 이미 있는 줄은 값을 받고, 새 줄은 정렬된 위치에 들어갑니다.
  • 백업: engine backups list가 사본을 나열합니다. 카드의 마지막 내보내기 취소는 가장 최근 사본을 복원합니다.

#알려진 한계

  • 조이스틱 슬롯은 8개입니다. 장치당 버튼 한도는 알려져 있지 않습니다(자료마다 다름).
  • 게임이 새 deviceoptions 블록을 어디에 두기를 원하는지, 곡선 보간 방식(메뉴는 점들을 지나는 부드러운 스플라인을 그림), 지수 범위, 감도가 조이스틱에 적용되는지는 아직 확인되지 않았습니다. 게임 전체 설정의 범위는 게임의 읽을 수 있는 파일에 없습니다.
  • Vibration이 DirectInput 포스 피드백 스틱을 구동하는지는 아직 확인되지 않았습니다.
  • 테스트: engine\tests\smoke\starcitizen.ps1(카탈로그 새로 고침, 옵션 그룹과 곡선 가져오기, 바이트 단위로 동일한 가져오기 + 내보내기, 모든 축 설정, 충돌, 슬롯 변경, attributes.xml 제자리 수정); 게임 안에서는 tools\e2e\games\StarCitizenSettings.ps1(메인 메뉴 Options: 설정, 바인딩, 곡선)과 tools\e2e\games\StarCitizen.ps1(내보내기와 가져오기 모드 조합).

이 게임에 대한 모든 기술 메모(저장소에서 생성됨): starcitizen.md.