실험용 플러그인은 커스텀 저장소 플러그인과 같은 것인가요?
아닙니다. 테스트 설정은 지원되는 흐름에서 표시되는 빌드를 바꾸고, 커스텀 저장소는 별도 소스를 추가합니다. 각각을 따로 확인하고 커스텀 저장소를 Dalamud 공식 인프라라고 설명하지 마세요.
Dalamud 테스트 빌드 가이드
Dalamud 실험용 플러그인 설치 방법
Dalamud 실험용 플러그인 설치 방법: 런처 설정에서 테스트 빌드를 활성화한 뒤 게임 안의 플러그인 창에서 설치하세요. 검색 결과에 ‘실험용’이라고 적혀 있다는 이유만으로 모르는 DLL이나 저장소 URL을 사용하면 안 됩니다.
먼저 결론
XIVLauncher를 실행하고 FFXIV 채팅에 /xlsettings를 입력합니다. 테스트 빌드 항목에서 플러그인 테스트 빌드를 가져오는 설정을 켜고 저장한 다음 /xlplugins를 다시 엽니다. 개발자가 테스트 빌드를 공개한 경우 일반 플러그인 목록과 함께 표시됩니다.
이 설정은 Dalamud가 표시할 수 있는 빌드 범위만 바꿉니다. 플러그인이 공식 제품이 되거나 안전성·패치 호환성이 보장되는 것은 아닙니다. 공식 플러그인 목록을 대신하는 기능이 아니라 관리 가능한 테스트 경로로 사용하세요.
개념 이미지
실험용은 다른 빌드 채널이지 다른 런처가 아닙니다
런처, Dalamud, 플러그인 빌드를 구분해서 이해하는 것이 중요합니다. XIVLauncher는 지원되는 FFXIV 실행 흐름을 담당하고, Dalamud는 플러그인 프레임워크를 제공합니다. 일반 빌드·테스트 빌드·별도 저장소 배포 중 무엇을 제공할지는 개발자가 결정합니다.
일반 플러그인을 찾는 것이라면 먼저 기본 플러그인 창을 사용하세요. 이 글은 개발자나 공식 지원 안내에서 테스트 빌드가 필요하다고 알려 준 경우를 위한 안내입니다.
어떤 플러그인 경로를 사용하려는지 확인하세요
| 의미 | 권장 경로 | 주의할 점 |
|---|---|---|
| 일반 플러그인 | /xlplugins에서 검색 | 현재 목록과 개발자 안내를 읽습니다. |
| 실험용·테스트 빌드 | /xlsettings에서 테스트 빌드 활성화 | 버그와 패치 후 중단을 예상해야 합니다. |
| 커스텀 저장소 | 개발자의 최신 문서에 나온 절차 | 소유자를 확인하고 모르는 URL은 추가하지 않습니다. |
| 로컬 개발 빌드 | Dalamud 개발자 문서 | 플레이어용 지름길이 아니라 개발 절차입니다. |
실험용 빌드를 켜기 전에
먼저 사용 이유를 확인하세요. 테스트 빌드는 수정 사항 검증, FFXIV 최신 패치 대응, 소수 테스터 모집을 위해 공개될 수 있습니다. 모르는 미러의 다운로드 링크만 찾았다면 프로젝트 소유자를 확인할 때까지 멈추세요.
한 번에 하나만 바꾸세요. 플러그인 이름, 빌드 채널, 확인하려는 증상을 기록하면 나중에 올바른 항목만 끌 수 있습니다. 무작정 재설치해서 원인을 숨기는 일도 줄어듭니다.
복구 경로를 미리 준비하세요. /xlsettings를 다시 열고, 테스트 빌드를 끄고, /xlplugins에서 플러그인을 비활성화하거나 삭제할 수 있어야 합니다. 원인을 모른 채 FFXIV 폴더를 지우지 마세요.
Dalamud 실험용 플러그인 설치 방법
- 지원되는 실행 흐름을 시작합니다. 평소처럼 XIVLauncher를 열고 Dalamud가 로드될 때까지 기다립니다. 별도의 Injector나 DLL을 먼저 내려받지 마세요.
- Dalamud 설정을 엽니다. 채팅에 /xlsettings를 입력합니다. 반응이 없으면 Dalamud가 로드되었는지, 플러그인을 지원하는 런처인지 확인합니다.
- 실험용 항목을 찾습니다. 플러그인 테스트 빌드를 가져오는 설정을 찾습니다. UI 업데이트로 이름이 달라질 수 있으므로 오래된 스크린샷만 믿지 마세요.
- 활성화하고 저장합니다. 구체적인 플러그인과 문서화된 이유가 있을 때만 켭니다. 저장한 뒤 목록이 새로 고쳐질 때까지 기다립니다.
- 하나만 설치합니다. /xlplugins를 열고 플러그인을 검색한 뒤 개발자 안내를 읽습니다. 처음에는 테스트 빌드 하나만 설치하고, 플러그인이나 런처가 요청할 때만 재시작합니다.
통제된 테스트
첫 테스트는 작고 되돌릴 수 있게 진행하세요
좋은 테스트는 이 빌드가 문제를 해결하는지, 현재 패치에서 동작하는지, 특정 기능을 되돌리는지처럼 하나의 질문에 답합니다. 모든 실험용 소스를 한 번에 켜는 이유가 되어서는 안 됩니다.
설치 후 짧게 평소처럼 플레이하세요. 시작 실패, UI 누락, 반복 오류, 갑작스러운 성능 변화, 업데이트 후 사라지는 플러그인을 확인합니다. 지울 파일을 추측하기보다 처음 발생한 증상을 기록하세요.
실험용 빌드와 커스텀 저장소는 다릅니다
테스트 빌드 설정과 커스텀 저장소는 서로 다른 문제를 해결합니다. 전자는 지원되는 플러그인 흐름에서 가져올 수 있는 빌드를 바꾸고, 후자는 개발자나 프로젝트가 관리하는 별도 소스를 추가합니다. 로컬 빌드는 개발과 디버깅을 위한 별도 방식입니다.
저장소를 추가하라는 안내를 받았다면 URL이 개발자의 최신 문서나 저장소에서 온 것인지 확인하세요. 소유자, 프로젝트 상태, 실제 배포 내용을 살펴봅니다. 검색 결과 일부, 복사한 Discord 메시지, 단순 파일 호스팅 페이지만으로는 충분하지 않습니다.
커스텀 저장소를 Dalamud 공식 인프라처럼 설명하지 마세요. 먼저 공식 목록을 사용하고, 다른 소스가 필요한 이유를 개발자가 명확히 설명한 경우에만 추가하세요.
Dalamud 실험용 플러그인 안전 체크리스트
첫 테스트 전후에 다음 항목을 확인하세요.
- 플러그인 이름, 개발자, 저장소 소유자, 테스트 빌드를 쓰는 이유를 확인합니다.
- 단독 DLL 다운로드보다 현재 Dalamud와 XIVLauncher의 플러그인 흐름을 우선합니다.
- 원인을 추적할 수 있도록 테스트 소스나 플러그인은 한 번에 하나만 켭니다.
- 일반 플러그인 목록과 런처 복구 절차를 남겨 둡니다.
- FFXIV 패치 후 업데이트 안내를 읽고 호환성을 판단합니다.
- 도움을 요청할 때 비밀번호, OTP, 가공하지 않은 런처 로그를 공유하지 않습니다.
- 서드파티 도구와 플러그인은 계정 및 이용약관 관련 판단이 필요합니다.
설정이나 플러그인이 보이지 않을 때
먼저 Dalamud 로드가 끝났는지, FFXIV 패치 직후인지 확인합니다. 유지보수 중이거나 개발자가 빌드를 갱신하는 동안 목록이 바뀔 수 있습니다. 목록에 없다는 사실만으로 미러가 필요하다고 볼 수 없습니다.
설정은 보이는데 플러그인이 없으면 개발자의 최신 문서에서 이름, 지원 게임 버전, 소스를 확인하세요. 설정 자체가 없다면 포럼에서 오래된 구성 파일을 복사하지 말고 공식 지원 경로를 이용합니다.
Steam Deck이나 데스크톱 Linux에서는 먼저 Steam Deck 및 데스크톱 Linux 런처 가이드를 사용하세요. 일반 플러그인 흐름이 동작한 뒤에만 같은 테스트 빌드 원칙을 적용합니다.
복구
먼저 끄고, 첫 오류를 기록한 다음 결정하세요
FFXIV나 Dalamud가 불안정해지면 마지막으로 추가한 실험용 플러그인을 끄고, 더 이상 필요하지 않다면 테스트 빌드 설정도 되돌립니다. 일반 플러그인 창을 다시 열고 변수를 더 추가하지 않은 상태에서 확인하세요.
문제가 계속되면 런처, 게임 클라이언트, 패치, 플러그인 증상을 분리합니다. 기존 troubleshooting 가이드는 충돌, 부트 버전 오류, 패치 파일 실패를 각각 다룹니다. 첫 번째로 실패한 지점에 맞는 페이지를 선택하세요.
FFXIV 이용약관과 계정 관련 주의
테스트 목록에 표시된다고 해서 실험용 또는 서드파티 플러그인이 공식이 되거나 위험이 없어지는 것은 아닙니다. Square Enix 규정, 계정에 미치는 영향, 플러그인의 동작은 별개의 문제입니다. 동작을 자동화하거나 계정 데이터를 노출하거나 보안 통제를 우회하라고 요구하는 도구는 피하세요.
이 가이드는 설정 경로와 신중한 진단 방법을 설명합니다. 특정 플러그인이 허용되는지, 안정적인지, 개인정보를 보호하는지, 특정 패치와 호환되는지를 보장하지 않습니다.
실험용 플러그인 설정은 어디에 있나요?
Dalamud가 로드된 뒤 /xlsettings를 열고 실험용 항목 또는 테스트 빌드 가져오기 설정을 찾습니다. UI 이름은 바뀔 수 있으므로 현재 화면을 확인하세요.
실험용 DLL을 직접 다운로드해도 되나요?
안전한 기본 선택이 아닙니다. 현재 플러그인 흐름과 개발자가 문서화한 소스를 우선하고, 모르는 미러의 파일은 실행하지 마세요.
실험용 플러그인이 목록에 없는 이유는 무엇인가요?
개발자가 빌드를 내렸거나, 현재 패치를 지원하지 않거나, Dalamud 목록이 아직 갱신되지 않았을 수 있습니다. 파일을 바꾸기 전에 최신 안내를 확인하세요.
실험용 플러그인을 끄려면 어떻게 하나요?
/xlsettings에서 설정을 끄고 저장한 다음 /xlplugins에서 플러그인을 비활성화하거나 삭제합니다. 이후 일반 흐름을 테스트하세요.
테스트 설정을 켜면 플러그인이 안전하거나 허용되나요?
아닙니다. 표시되는 빌드 채널만 바뀝니다. 안정성, 개인정보, 계정 위험, 이용약관은 별도로 판단해야 합니다.