Pulse Phone — 빠른 시작

PhoneHub + Pulse는 별도 라이선스와 자체 휴대폰 사본을 갖춘 별도 에디션입니다. 그 에디션을 구매했다면 대신 해당 설치 가이드를 따르세요. 서버는 휴대폰 리소스를 하나만 실행합니다.

1. 서버 확인

데이터베이스, framework, 인벤토리, 보이스 리소스, screenshot-basic을 Pulse보다 먼저 시작하세요. 올바른 순서는 요구 사항과 내 framework를 참고하세요.

첫 시작 전에 데이터베이스를 백업하세요. Pulse는 자체 테이블을 만듭니다. 다른 휴대폰이 같은 이름의 테이블을 남겨 두었다면 old_<name>으로 이름이 바뀌며(아무것도 삭제되지 않습니다), 자세한 내용은 요구 사항에 있습니다.

2. phone 폴더 복사

Cfx.re 계정에서 구매한 파일을 다운로드하세요. phone 폴더(fxmanifest.lua가 들어 있는 폴더)를 서버의 resources에 복사합니다. 이름은 바꾸지 마세요. 서버 키는 에셋을 소유한 계정에 속해 있어야 합니다.

FTP로 업로드하는 경우(호스팅 서버): Binary 모드를 사용하세요(FileZilla: Transfer > Transfer Type > Binary). 또는 zip을 업로드해 서버에서 압축을 해제하세요. Auto 모드는 잠긴 파일을 변경해 휴대폰이 시작되지 않습니다. 증상과 해결 방법은 문제 해결에 있습니다. 업로드한 폴더는 이 표와 일치해야 하며, 빠졌거나 크기가 다른 파일은 시작 점검이 알려 줍니다.

Pulse Phone 1.4.2 다운로드 구성:

기존 설치를 업데이트하시나요? 설정과 플레이어 미디어를 보존하려면 먼저 업데이트를 따르세요. Pulse로 바꾸기 전에 이전 휴대폰 리소스를 중지하세요.

3. 인벤토리 아이템 추가

인벤토리를 열고 이미 사용 중인 인벤토리의 안내를 따르세요. 제공되는 정의와 이미지는 config/items/에 있습니다. 항목을 인벤토리에 병합하고, 아이템 파일 전체를 교체하지 마세요.

ESX 기본 인벤토리와 QBCore는 빠진 정의를 자동으로 등록할 수 있습니다. 다른 인벤토리는 제공된 항목이 필요할 수 있습니다. 아이템 이미지는 인벤토리가 요구하는 위치에 복사하세요. 인벤토리 없는 standalone은 아이템이 필요 없습니다.

4. Pulse 시작

config/config.lua에서 자동 감지를 그대로 두세요. 첫 번째 섹션에는 framework, 언어, 인벤토리 선택, 휴대폰 아이템, 키가 있습니다. 선택 설정은 설정에 정리되어 있습니다.

server.cfg의 기존 의존성 뒤에 다음을 추가하세요:

ensure phone
add_ace group.admin phone.admin allow

서버를 재시작하세요. SQL 연결이 가능하면 Pulse가 데이터베이스 테이블을 만듭니다. 콘솔 점검 결과를 읽고 수정 안내가 있으면 따르세요. 다시 실행하려면 phone:health를 입력하세요.

5. 휴대폰 열기

관리자로 접속해 F8을 열고 phone:setup을 입력하세요. 감지된 framework와 인벤토리를 확인한 뒤 안내형 설정을 완료합니다. 휴대폰을 열려면 F1을 누르거나 /phone을 사용하세요. 설정상 아이템이 필요하다면 먼저 휴대폰을 구매하고 인벤토리에서 박스를 사용하세요.

Settings → Server에서 저장한 설정은 파일의 같은 설정보다 우선합니다. 파일 값을 다시 적용하려면 그곳에서 저장된 설정을 초기화하세요.

6. 선택 사항: 더 가벼운 screenshot-basic

다운로드에는 screenshot-basic 폴더도 들어 있습니다. CitizenFX screenshot-basic(MIT 라이선스)에서 한 가지만 바꾼 것입니다. 원본은 아무도 사진을 찍지 않을 때도 캡처 레이어용 게임 이미지를 매 프레임 다시 그리지만, 이 사본은 사진을 찍는 동안에만 그립니다. 리소스 이름, export(requestScreenshot, requestScreenshotUpload, requestClientScreenshot), 이벤트는 그대로이며, 이미 빌드된 상태로 제공되므로 첫 시작 시 직접 빌드할 필요가 없습니다. 변경된 파일 목록은 screenshot-basic/ZERODEV-CHANGES.md에 있습니다.

Pulse는 어느 쪽으로도 작동하므로 이 단계는 선택 사항입니다. 서버의 다른 스크립트도 screenshot-basic을 사용하므로, 테스트 서버가 있다면 먼저 그곳에서 바꿔 보세요:

1. 현재 screenshot-basic 폴더의 이름을 바꾸고(예: screenshot-basic.bak) resources 밖으로 옮겨, 나중에 되돌릴 수 있게 하세요.
2. 저희 사본을 resources에 같은 이름 screenshot-basic으로 복사하고, ensure screenshot-basic 줄도 그대로 두세요.
3. 서버를 재시작하고 스크린샷을 찍는 모든 스크립트를 시험해 보세요. 휴대폰 카메라, 그리고 사용 중인 신고, 증거, 바디캠 도구 등입니다.
4. 동작이 달라진 것이 있으면 저희 사본을 삭제하고, 기존 폴더를 screenshot-basic으로 되돌린 뒤 재시작하세요.

사용하는 기능 설정

• 통화, 영상, Live: 지원하는 보이스 리소스, 통화 조작, 실서버용 영상 연결 설정.
• 사진과 동영상: 내장 저장소, FiveManage 및 그 밖의 업로드 옵션. 비공개 서비스 키는 서버 설정에만 보관됩니다. 웹 포트에 접근할 수 없는 호스팅 서버에서는 사진에 FiveManage가 필요하며, server.cfg에 두 줄(set phone_media_provider "fivemanage"와 set phone_fivemanage_token "<token>")을 추가하면 됩니다.
• 설정: 매장, 앱, 액세서리, 언어, 선택 기능.
• 문제 해결: 증상을 찾아 해결 방법을 따르세요.
• 개발자 연동: 커스텀 스크립트와 고급 연결 설정.

일반 설치에서는 bridge/, ui/, stream/을 수정할 필요가 없습니다. 모델과 맵 에셋을 포함한 리소스 전체를 함께 유지하세요.