Dalamud 사용자 지정 플러그인 저장소: 무엇이며 어떻게 추가하나요?
제작자나 커뮤니티 프로젝트가 관리하는 추가 플러그인 배포 출처입니다. Dalamud가 기본 디렉터리와 함께 항목을 표시할 수 있지만, 출처마다 관리자와 검토 방식은 다릅니다.
Dalamud 플러그인 출처 안내
Dalamud 사용자 지정 플러그인 저장소를 안전하게 추가하는 방법
플러그인 제작자가 공개한 정확한 저장소 URL을 사용하고, 누가 출처를 관리하는지 확인한 다음 Dalamud 설정에서 추가하고 활성화하세요. 게임 내 설치 도구에 항목이 표시되어도 배포자, 플러그인 동작, 호환성이 인증되는 것은 아니며 Square Enix의 승인을 뜻하지도 않습니다.
먼저 할 일
XIVLauncher로 FFXIV를 실행하고 Dalamud가 로드될 때까지 기다립니다. 게임 채팅에 /xlsettings를 입력하고 Experimental 영역에서 Custom Plugin Repositories를 찾습니다. 배포자의 최신 문서에 있는 매니페스트 URL을 그대로 붙여 넣고 추가 기능을 누른 다음 출처가 활성화되어 있는지 확인하고 저장합니다. 이어서 /xlplugins를 열고 플러그인 이름으로 검색해 설명과 주의 사항을 읽은 뒤 그 화면에서 설치합니다.
URL 소유자가 누구인지 또는 왜 별도 출처가 필요한지 확인할 수 없다면 등록을 멈추세요. 게임 내 설치 절차를 내려받은 DLL 파일이나 관련 없는 댓글에서 복사한 URL로 바꾸지 마세요.
개념 일러스트
사용자 지정 출처에는 별도의 관리자가 있습니다
저장소는 관리자가 제공하는 플러그인과 버전 정보를 Dalamud가 확인하도록 하는 배포 출처입니다. 한 명의 플러그인 제작자나 커뮤니티 프로젝트가 운영할 수 있습니다. 같은 설치 도구 안에 표시되더라도 Dalamud 프로젝트가 관리하는 기본 디렉터리와는 별도입니다.
이 이미지는 설명을 위한 개념 그림이며 XIVLauncher의 공식 화면이 아닙니다. 실제로 확인할 것은 출처의 관리자가 누구인지, 현재 문서에 적힌 URL이 정확한지입니다. 익숙한 이름, 깔끔한 웹페이지, 목록에 보이는 항목만으로 안전성 검토가 이뤄졌다고 판단하지 마세요.
Dalamud 사용자 지정 플러그인 저장소: 기본 디렉터리와 테스트 빌드 비교
제작자가 안내한 설치 경로를 선택하세요. 대부분의 플레이어는 먼저 /xlplugins의 기본 디렉터리에서 플러그인을 검색하면 됩니다. 특정 제작자가 추가 출처를 문서로 안내할 때 사용자 지정 저장소를 고려하세요. Experimental 테스트 빌드는 다른 기능이며 저장소를 추가하는 것과 같지 않습니다. 로컬 빌드는 플러그인 개발을 위한 것이므로 일반적인 설치 방법으로 사용하지 않습니다.
설정을 바꾸기 전에 출처 구분하기
| 출처 | 의미 | 먼저 확인할 항목 |
|---|---|---|
| 기본 디렉터리 | Dalamud 프로젝트 절차에 따라 공개되는 일반적인 게임 내 목록입니다. | /xlplugins에서 검색하고 플러그인의 최신 설명을 읽으세요. |
| 사용자 지정 저장소 | 제작자나 커뮤니티 프로젝트가 관리하는 추가 출처입니다. | 현재 문서에서 관리자와 정확한 매니페스트 URL을 확인하세요. |
| Experimental 빌드 | 완성되지 않았거나 불안정할 수 있는 테스트 버전 또는 채널입니다. | 구체적인 이유가 있고 문서로 안내된 경우에만 테스트 옵션을 활성화하세요. |
| 다운로드한 플러그인 파일 | 일반적인 설치 도구 경로 밖에서 받은 파일입니다. | 알 수 없는 DLL 미러를 저장소 설정의 지름길로 사용하지 마세요. |
URL을 추가하기 전에 배포자 확인하기
Dalamud 사용자 지정 플러그인 저장소, 즉 제작자가 별도로 운영하는 출처의 URL은 다른 사람이 제공하는 입력값입니다. 설정 화면을 열기 전에 배포자의 문서를 보면서 출처를 확인하세요.
아래 확인은 불일치와 흔한 실수를 찾기 위한 절차입니다. 피할 수 있는 오류를 줄여 주지만 소프트웨어가 무해하다는 증명은 아닙니다.
- URL은 제작자의 최신 문서나 저장소 운영자의 공개 페이지에서 찾으세요. 출처 표시가 없는 재게시물에서 복사하지 마세요.
- 안내 문서와 출처 페이지에서 제작자, 프로젝트, 저장소 관리자 이름을 비교하세요. 이름이나 도메인이 맞지 않으면 등록하지 마세요.
- 전체 URL을 그대로 복사하세요. 잘못된 링크를 고치겠다며 파일명을 추측하거나 도메인을 바꾸거나 경로 일부를 지우지 마세요.
- 플러그인이 하는 일, 접근하는 데이터나 로컬 기능, 필요한 종속 항목, 제작자가 제공한 호환성 정보를 읽으세요.
- 프로젝트가 계속 관리되고 있는지, 문제를 어디에 보고하는지 확인하세요. URL이 열려도 저장소가 오래되었을 수 있습니다.
- 추가한 출처와 플러그인을 메모해 두세요. 나중에 목록이 복잡해져도 변경한 항목을 찾을 수 있습니다.
사용자 지정 저장소를 추가하고 플러그인 설치하기
- 1. Dalamud가 실행 중인지 확인합니다. 평소 사용하는 XIVLauncher 설정으로 FFXIV를 시작합니다. 게임에 들어간 뒤 Dalamud 인터페이스가 완전히 로드될 때까지 기다리고 /xlsettings를 입력하세요. 명령을 사용할 수 없다면 먼저 런처 또는 Dalamud의 시작 상태를 확인합니다.
- 2. 안내된 설정 영역을 엽니다. 채팅에 /xlsettings를 입력하고 Experimental을 선택합니다. Custom Plugin Repositories 입력란을 찾으세요. 표시 이름은 바뀔 수 있으므로 오래된 스크린샷보다 현재 화면과 배포자의 문서를 기준으로 삼으세요.
- 3. 배포자 URL을 추가하고 활성화합니다. 확인한 URL을 붙여 넣고 입력란 옆의 추가 기능을 사용한 뒤 새 출처가 활성화되었는지 확인합니다. 주소가 잘못되었다는 메시지나 이해하지 못한 경고가 나오면 다른 미러를 써서 우회하지 마세요.
- 4. 저장한 뒤 원하는 플러그인을 찾습니다. 설정을 저장하고 닫은 다음 /xlplugins를 엽니다. 제작자 문서에 나온 정확한 이름으로 검색하세요. Install을 선택하기 전에 배포자, 설명, 종속 항목, 호환성 주의 사항을 확인합니다.
- 5. 한 번에 하나씩 바꾸고 결과를 살펴봅니다. 의도한 플러그인 하나만 설치하고 Dalamud나 제작자가 재시작을 안내하면 따르세요. 바뀐 내용을 기록합니다. 다른 문제가 생겨도 어떤 출처와 플러그인이 관련되었는지 파악하기 쉽습니다.
설정 순서
짧고 되돌릴 수 있는 절차로 진행하기
권장 순서는 관리자 확인, 정확한 URL 입력, 출처 활성화, 플러그인 검토, 하나만 설치하기입니다. 각 단계는 서로 다른 질문에 답합니다. 누가 출처를 관리하는지, 주소가 맞는지, Dalamud가 읽을 수 있는지, 플러그인이 목적에 맞는지 차례로 확인할 수 있습니다.
저장 후 플러그인이 보이지 않아도 추측한 URL을 여러 개 추가하지 마세요. 먼저 출처 상태와 최신 안내를 확인한 뒤 아래 문제 해결 항목을 살펴보세요.
출처 비활성화와 플러그인 제거는 각각 진행하기
저장소를 더 이상 사용하지 않으려면 /xlsettings를 다시 열고 사용자 지정 출처 목록으로 이동합니다. 현재 인터페이스의 기능으로 출처를 비활성화하거나 제거한 뒤 저장하세요. 출처를 제거하면 Dalamud가 목록을 찾는 위치가 바뀌지만, 그곳에서 이미 설치한 플러그인이 자동으로 삭제되는 것은 아닙니다.
/xlplugins를 열어 설치된 플러그인을 별도로 확인하세요. 더 이상 필요하지 않은 플러그인은 설치 도구의 제거 또는 비활성화 기능을 사용합니다. 설정 데이터를 저장하거나 재시작을 요구하는 플러그인은 제작자의 최신 안내를 따르세요. 폴더를 추측으로 삭제하거나 관련 없는 플러그인 데이터를 먼저 지우지 마세요.
출처가 문제를 일으켰는지만 확인하려면 한 번에 출처 하나 또는 플러그인 하나만 비활성화하고 결과를 기록하세요. 작고 되돌릴 수 있는 변경이 모든 플러그인을 제거하거나 런처 전체를 초기화하는 것보다 원인을 파악하는 데 도움이 됩니다.
저장소나 플러그인이 표시되지 않을 때
| 보이는 상태 | 먼저 확인할 항목 | 다음 단계 |
|---|---|---|
| URL이 거부됨 | 배포자의 최신 안내와 문자 단위로 비교합니다. | 운영자에게 현재 주소를 확인하고 대체 URL을 추측하지 마세요. |
| 출처는 보이지만 비활성 상태 | /xlsettings에서 활성 상태를 확인합니다. | 검증한 출처만 활성화하고 저장한 뒤 /xlplugins를 다시 엽니다. |
| 출처는 활성인데 목록이 비어 있음 | 출처 상태, 네트워크 연결, 배포자의 최신 공지를 확인합니다. | 매니페스트나 서비스가 중지된 경우 기다리거나 운영자에게 문의합니다. |
| 특정 플러그인이 없음 | 정확한 이름으로 검색하고 제작자의 최신 릴리스 안내와 비교합니다. | 플러그인이 아직 이 저장소를 사용하며 현재 환경을 지원하는지 확인합니다. |
| 플러그인이 로드되지 않음 | 호환성, 종속 항목, 처음 보고된 오류를 확인합니다. | 플러그인을 비활성화하고 재설치 전에 관리자의 문제 해결 절차를 따릅니다. |
출처의 경계
같은 설치 도구를 쓴다고 관리자가 같은 것은 아닙니다
기본 디렉터리와 독립 저장소는 모두 게임 내 설치 도구에 항목을 제공할 수 있지만, 소유자, 검토 과정, 배포 방식, 지원을 공유할 필요는 없습니다. 평가 중인 출처의 관리자 이름을 기억해 두세요.
이 그림은 서로 다른 배포 경로가 하나의 설치 도구로 이어지는 모습을 나타냅니다. 순위나 추천이 아니며 보안 검토를 받았다는 뜻도 아닙니다. Dalamud 공식 디렉터리는 게임 안에서 플러그인을 설치하는 절차를 안내합니다. 저장소가 있다는 이유만으로 플러그인 파일을 직접 다운로드하지 마세요.
한계, 개인정보, 계정 관련 유의 사항
출처를 추가하면 공개된 항목을 찾을 수 있을 뿐입니다. 플러그인이 안전하거나 현재 게임 버전과 호환되거나 계속 관리되거나 게임 운영사의 승인을 받았다는 증거는 아닙니다. 설치 전에 프로젝트 관리자, 문서, 플러그인 동작, 제작자가 설명한 권한이나 데이터, 최신 호환성 정보를 확인하세요.
지원되는 설치 방식은 프로젝트 공식 안내를 따르고 게임과 서비스의 최신 규칙은 직접 확인하세요. 저장소 페이지, 오픈소스 표시, 설치 성공은 Square Enix의 허가가 아니며 계정에 미칠 영향을 보장하지 않습니다. 타사 플러그인 문제를 상담할 때 비밀번호, 일회용 코드, 개인정보를 가리지 않은 로그를 공유하지 마세요.
사용자 지정 저장소 URL은 어디에 추가하나요?
게임에서 /xlsettings를 열고 Experimental을 선택한 뒤 Custom Plugin Repositories를 사용합니다. 배포자의 정확한 주소를 추가하고 활성화해 저장한 다음 /xlplugins에서 플러그인을 검색하세요.
인터넷에서 찾은 저장소 URL을 아무거나 사용해도 되나요?
아니요. 프로젝트 관리자와 현재 URL을 배포자의 문서에서 확인하세요. 출처를 알 수 없는 링크를 붙여 넣거나 파일명으로 매니페스트 주소를 추측하지 마세요.
/xlplugins에 표시되면 안전하거나 공식이라는 뜻인가요?
아니요. 설치 도구가 해당 출처의 항목을 읽을 수 있다는 뜻입니다. 보안 감사, 호환성 보장, Dalamud 또는 Square Enix의 승인을 나타내지 않습니다.
저장소를 제거하면 그곳에서 설치한 플러그인도 삭제되나요?
항상 그런 것은 아닙니다. /xlsettings에서 출처를 비활성화하거나 제거한 뒤 /xlplugins에서 이미 설치한 플러그인을 따로 확인하고 필요하면 제거하거나 비활성화하세요.
사용자 지정 저장소가 비어 있거나 이용할 수 없는 이유는 무엇인가요?
URL이 오래되었거나 매니페스트와 서비스가 중단되었거나 출처가 비활성화되었거나 플러그인이 이동했을 수 있습니다. 주소를 바꾸기 전에 관리자의 최신 안내와 상태를 확인하세요.