설치 세부 사항

1. 빠른 설치

복사하기 전에

아래 요구 사항을 충족하는 서버 아티팩트를 사용하고, OneSync를 켜고, 게임 빌드 2699 이상을 사용하세요. 일반적인 롤플레이 서버라면 framework, 인벤토리, oxmysql, 보이스 리소스, screenshot-basic이 먼저 작동해야 합니다. standalone은 framework 없이도 작동하며, 이때 인벤토리 아이템은 선택 사항입니다.

구매를 수령한 뒤 Cfx.re 계정에서 리소스를 다운로드하세요. 에셋을 소유한 계정의 서버 키를 사용하세요. Cfx.re가 권한(entitlement) 오류를 보고하면 계정과 키 연결을 바로잡으세요. 휴대폰 설정을 바꿔서는 권한이 생기지 않습니다.

1단계 — 서버에 리소스 넣기

패키지 압축을 풀고 phone 리소스 폴더(fxmanifest.lua가 들어 있는 폴더)를 서버의 resources 디렉터리에 복사하세요. 이름을 바꾸지 말고, 바깥쪽 ZIP/패키지 폴더를 대신 넣지 마세요.

호스팅 서버에서는 Binary 모드로 업로드하거나, zip을 업로드해 서버에서 압축을 해제하세요(이유). 빠른 시작(2단계)에 이 빌드의 폴더별 파일 수와 크기가 나와 있으며, 빠졌거나 크기가 다른 파일은 시작 점검이 알려 줍니다.

Pulse를 테스트하기 전에 이전 휴대폰 리소스를 중지해, 두 휴대폰이 같은 키와 아이템을 두고 충돌하지 않게 하세요. 나중에 가져올 계획이라면 그 데이터를 백업하세요.

2단계 — 인벤토리 아이템 추가

기존 인벤토리를 고르세요. 교체할 필요는 없습니다.

시작 점검이 빠진 항목을 찾아내고 아직 필요한 정의만 출력합니다. ox_inventory처럼 시작 시 아이템 정의를 불러오는 인벤토리에는 위 항목이 필요합니다. Pulse는 다른 리소스의 파일을 덮어쓰지 않습니다.

3단계 — 기본 설정 확인

config/config.lua를 여세요. 기본값이 기존 구성을 감지합니다:

Config.Framework = 'auto'

inventory = 'auto'는 기존 Config.Providers 테이블에 그대로 두세요. 인벤토리 리소스를 여러 개 실행한다면 그 값을 사용할 인벤토리로 지정하세요(예: 'ox_inventory'). 파일 맨 아래에 두 번째 Config.Providers나 Config.Item 테이블을 추가하지 마세요.

기존 Config.Item 테이블에서 휴대폰 방식을 고르세요:

고유 휴대폰은 선택된 인벤토리 브리지를 따릅니다. Config.Item.inventory = 'auto'는 그대로 두세요. 이 예전 재정의 설정은 기존 고급 설치용입니다. Config.Providers.inventory를 명시적으로 설정하면 그것이 우선합니다.

Config.IdentityScope는 운영 중인 서버에서 바꾸지 마세요. 기본값 'character'는 캐릭터별 휴대폰을 서로 분리합니다.

선택 사항: 인벤토리 휴대폰과 유료 서비스

휴대폰마다 별도의 휴대폰 아이템을 요구하려면, 인벤토리 항목을 추가한 뒤 required = true와 unique = true를 Config.Item 기존 테이블(config/config.lua) 안에 설정하세요. 위에 나열된 고유 휴대폰 지원 인벤토리 중 하나를 사용하세요.

휴대폰 서비스를 판매하려면 같은 파일에서 Config.Carrier.enabled = true로 설정하세요. 플레이어가 요금제를 구매하는 Carrier 앱이 활성화됩니다. 새 휴대폰은 요금제가 있어야 일반 통화, 메시지, 모바일 데이터 앱을 쓸 수 있습니다. App Hub는 플레이어가 앱을 설치하는 곳이며, 서비스 상점이 아닙니다. 커버리지 구역도 원하면 Config.Coverage.enabled = true로 설정하세요. 커버리지와 유료 요금제는 별개 옵션이므로, 원하지 않는 기능은 꺼 두세요.

테이블을 중복으로 추가하지 말고 기존 설정을 수정하세요. 저장한 뒤 서버를 재시작하세요. 게임 안에서 이전에 저장한 설정이 있다면, 파일 값이 적용되도록 Settings → Server에서 그 설정을 초기화하세요.

4단계 — Pulse보다 의존성을 먼저 시작

기존 데이터베이스 연결과 framework 설정은 그대로 두세요. 빠진 줄만 추가하고, 어떤 의존성도 두 번 시작하지 마세요.

서버에 이미 설치된 리소스로 다음 순서를 지키세요:

1. 데이터베이스 리소스와 기존 연결 설정.
2. framework와 그에 필요한 라이브러리, 신원 및 캐릭터 리소스.
3. 인벤토리(내 framework에 맞는 해당 인벤토리 설정 사용).
4. 지원하는 보이스 리소스 하나와 screenshot-basic.
5. ensure phone.

Pulse만을 위해 ESX, QBCore, 다른 인벤토리를 설치하지 마세요. 구성별 시작 순서 예시는 내 framework에서 기존 구성을 골라 확인하세요. 다른 리소스가 Qbox의 QBCore 호환 export를 사용해도 Qbox는 Qbox로 감지됩니다.

Pulse 관리자 권한을 주려면 add_ace group.admin phone.admin allow를 추가하세요. 이 권한이 적용되려면 관리자 계정이 이미 group.admin에 속해 있어야 합니다.

5단계 — 첫 시작 점검 읽기

서버를 재시작하세요. SQL 연결이 가능하면 Pulse가 시작 보고서를 출력하고 데이터베이스 테이블을 자동으로 만듭니다.

• FIX / FAIL: 필수 요소가 작동할 수 없습니다. 플레이어가 사용하기 전에 수정 안내를 따르세요.
• NOTE / WARN: 어떤 기능이 영향을 받는지 읽어 보세요. 일부 경고는 설정하지 않은 선택 기능에 관한 것입니다.
• 점검을 다시 하려면 서버 콘솔에서 phone:health를 실행하세요.
• 선택된 framework/인벤토리/제공자를 보려면 phone:diag를 실행하세요.
• 관리자로 접속해 F8을 열고 phone:setup을 실행하면 안내형 설정이 열립니다.

게임 내 관리자 설정에서 저장한 값은 파일의 해당 설정보다 우선합니다. 파일 변경이 무시되는 것 같다면, 파일을 더 바꾸기 전에 Settings → Server를 확인하고 저장된 설정을 초기화하세요.

6단계 — 플레이어로 테스트

1. 캐릭터를 불러오고 F1을 눌러 휴대폰 설정을 완료하세요. 아이템 요구가 켜져 있다면 먼저 매장에서 휴대폰을 사거나 캐릭터에게 설정된 휴대폰 아이템을 주세요.
2. 밀봉된 박스를 구매했다면 인벤토리에서 박스를 사용해 언박싱한 뒤 설정을 마치세요. 휴대폰은 켜진 상태로 도착합니다. Config.Device.arrivesOn = false라면 먼저 End나 O를 길게 누르세요.
3. Messages, Contacts, Phone을 열어 보세요. 홈으로 돌아가 앱 전환기를 열고 앱을 하나씩 닫아 보세요.
4. 사진과 짧은 동영상을 찍으세요. 둘 다 Photos에서 열어 보고, 휴대폰을 닫았다 다시 열어 남아 있는지 확인하세요.
5. 재접속해서 같은 캐릭터가 여전히 같은 휴대폰을 가지고 있는지 확인하세요. 설치된 보이스 리소스로 두 번째 플레이어와 통화를 테스트하세요.

어디서 바꾸는지

아래 섹션은 자세한 참고 자료입니다. 첫 설치를 마치려고 모든 기능 설정을 읽을 필요는 없습니다.