FFXIV 런타임 모드 가이드

ff14 penumbra 가이드: 설치, 설정, 문제 해결

Penumbra는 Dalamud 플러그인으로, 원본 게임 파일을 교체하지 않고 지원되는 FFXIV 모드 파일을 런타임에 불러옵니다. 더 안전한 구성은 릴리스 ZIP을 수동으로 푸는 방식이 아니라, 프로젝트에서 안내하는 커스텀 플러그인 리포지토리 방식입니다.

빠른 답변: ZIP 파일이 아니라 Dalamud로 설치하세요

XIVLauncher를 실행해 게임에 접속한 뒤 /xlsettings를 입력하고, Experimental custom plugin repositories 영역에 공식 Penumbra repo.json URL을 추가하세요. 그다음 /xlplugins에서 Penumbra를 설치하면 Dalamud가 업데이트를 관리합니다.

공식 README에서도 릴리스 ZIP을 devPlugins에 수동으로 풀지 말라고 분명히 안내합니다. 수동 복사본은 업데이트 알림을 놓치기 쉽고, 리포지토리 기반 설치와 충돌할 수 있습니다.

2026년 7월 22일 기준 최신 확인: GitHub 최신 릴리스는 testing_1.7.0.2이며, 게시일은 2026년 7월 20일입니다. 이 가이드가 ZIP 다운로드를 CTA로 제공하지 않는 이유도, 유지 관리 중인 README가 리포지토리 방식을 권장하기 때문입니다.

xivdev GitHub 리포지토리에 있는 공식 Penumbra 프로젝트 아이콘
GitHub의 xivdev/Penumbra에 등록된 공식 프로젝트 자산입니다.

FFXIV 런타임 모드 가이드

공식 Penumbra 프로젝트 식별 방법

이 아이콘은 xivdev/Penumbra 리포지토리에 저장된 공식 자산입니다. 비슷한 이름의 파일 호스트만 믿지 말고, 리포지토리 소유자, README, 이슈 트래커, repo.json 주소를 함께 확인해 프로젝트 진위를 검증하세요.

Penumbra는 커뮤니티 제작 소프트웨어이며 Square Enix의 공식 기능이 아닙니다. 런타임 방식이라 게임 아카이브를 영구적으로 덮어쓰지는 않지만, 계정 정책, 개인정보, 호환성, 모드 출처에 대한 위험까지 없애 주는 것은 아닙니다.

FFXIV에서 Penumbra 설치하는 방법

  1. 공식 XIVLauncher와 Dalamud부터 준비하세요. Goatcorp 릴리스 페이지에서 XIVLauncher를 설치하고 FFXIV를 실행한 뒤, /xlplugins가 Dalamud Plugin Installer를 여는지 확인하세요.
  2. Dalamud 설정을 엽니다. /xlsettings를 실행하고 Experimental 탭을 여세요. 관련 없는 실험 옵션은 건드리지 않는 편이 좋습니다.
  3. 공식 리포지토리 URL을 추가합니다. https://raw.githubusercontent.com/xivdev/Penumbra/master/repo.json 을 custom plugin repositories 목록에 붙여넣고, 플러스 버튼을 누른 다음 저장하고 닫으세요.
  4. Available Plugins에서 설치합니다. /xlplugins를 열고 Available Plugins에서 Penumbra를 찾은 뒤, 목록 정보를 확인하고 플러그인 관리자에서 설치하세요.
  5. 전용 모드 폴더를 지정합니다. Windows 보호 폴더나 FFXIV 프로그램 디렉터리 바깥의 폴더를 사용하세요. 여유 공간도 충분히 확보하고, Penumbra 경로를 게임 설치 폴더로 지정하지 마세요.
  6. 모드는 한 번에 하나씩 테스트합니다. 신뢰할 수 있는 모드 하나만 가져와 제한된 collection에 활성화한 뒤, 지역을 이동하거나 영향을 받는 창을 다시 열어 결과를 확인하고 나서 다음 모드를 추가하세요.

지원되는 설치 흐름

리포지토리 방식은 플러그인 폴더를 수동 복사하는 것보다 출처 확인, 업데이트 관리, 롤백 판단이 훨씬 명확합니다.

공식 출처 확인

xivdev/Penumbra와 README를 검증합니다.

Dalamud 리포지토리 추가

/xlsettings에 공식 repo.json을 추가합니다.

플러그인 관리자 사용

/xlplugins에서 설치하고 업데이트합니다.

통제된 테스트

신뢰 가능한 모드 하나만 켜고 충돌 여부를 확인합니다.

Dalamud와 Penumbra가 로드되기 전에 사용되는 런처 계층을 보여 주는 공식 XIVLauncher 인터페이스
공식 Goatcorp XIVLauncher 이미지이며, Penumbra는 이후 Dalamud 내부에서 관리됩니다.

XIVLauncher + Dalamud + Penumbra

런처 구성에서 Penumbra가 들어가는 위치

XIVLauncher가 FFXIV를 시작하고 Dalamud를 초기화하면, 그다음 Penumbra가 Dalamud 플러그인으로 설치되고 관리됩니다. 지원되는 Penumbra 구성을 쓰기 위해 별도 런처, 인젝터 번들, 수정된 게임 실행 파일이 필요한 것은 아닙니다.

이 스크린샷은 Penumbra 설정 화면이 아니라 XIVLauncher용 공식 Goatcorp 이미지입니다. 사용자가 먼저 보게 되는 런처 계층을 보여 주기 위한 자료로, Penumbra를 독립 실행형 게임 클라이언트로 오해하지 않도록 돕습니다.

자주 생기는 Penumbra 문제와 가장 먼저 확인할 항목

문제 가능성 높은 원인 첫 확인 항목
/xlplugins에 Penumbra가 보이지 않음 리포지토리 URL이 저장되지 않았거나 Dalamud 목록이 아직 새로고침되지 않음 /xlsettings를 다시 열어 정확한 repo.json URL을 확인하고 저장한 뒤 플러그인 목록을 새로고침하세요
게임 업데이트 후 플러그인을 사용할 수 없음 새 FFXIV 빌드에 대해 Dalamud 호환성이 일시적으로 제한됨 유지 관리 중인 업데이트를 기다리세요. 예전 플러그인 바이너리를 게임에 강제로 넣지 마세요
모드가 적용되지 않음 collection 지정, 우선순위, 파일 경로가 현재 캐릭터와 맞지 않음 다시 설치하기 전에 활성 collection을 확인하고 Penumbra 충돌 도구를 먼저 사용하세요
텍스처나 모델이 섞여 보임 활성화된 모드 두 개가 같은 파일을 교체함 충돌을 확인하고 원하는 모드를 더 높은 우선순위로 올리세요
로딩이 길거나 디스크 사용량이 큼 모드 라이브러리가 너무 크거나 캐시가 커졌거나 저장 장치가 느림 최근 추가한 항목을 비활성화하고, 캐시 경로를 점검하며, 모드 디렉터리는 상태가 좋은 로컬 저장소에 두세요
플러그인이 중복 동작함 수동 devPlugins 복사본이 리포지토리 설치본과 충돌함 수동 복사본을 제거하고 플러그인 관리자 설치본만 남기세요

게임 설치를 건드리지 않고 문제 해결하기

가장 최근에 추가한 모드부터 비활성화한 뒤, 같은 캐릭터, 같은 collection, 같은 지역, 같은 장비 상태에서 다시 테스트하세요. 변수를 여러 개 한꺼번에 바꾸면 Penumbra 충돌 원인을 분리하기가 더 어려워집니다.

FFXIV 아카이브를 삭제하거나, 게임 실행 파일을 교체하거나, 백신을 전역 비활성화하거나, 재패키징된 플러그인 번들을 내려받지 마세요. Penumbra는 모드 파일을 원본 설치와 분리해 두도록 설계된 만큼, 그 경계를 유지하는 것이 중요합니다.

대형 FFXIV 패치 직후에는 호환성 작업이 끝날 때까지 Dalamud와 플러그인을 사용할 수 없는 기간이 생길 수 있습니다. 일시적인 사용 불가 메시지가 곧 설치 실패를 뜻하는 것은 아닙니다. 관리 중인 프로젝트 채널을 확인하고, 오래된 빌드를 강제로 적용하지 말고 기다리세요.

계정, 콘텐츠, 개인정보 경계

XIVLauncher, Dalamud, Penumbra, 그리고 각종 모드는 모두 서드파티 도구입니다. Square Enix는 이에 대한 지원을 제공하지 않으며, 어떤 가이드도 계정 안전을 보장할 수 없습니다. 가장 낮은 위험 경로가 필요하다면 공식 게임 클라이언트를 사용하세요.

출처를 이해할 수 있는 모드 파일만 가져오세요. 실행 파일이 포함된 압축물, 계정 정보를 요구하는 파일, 과도한 보안 예외 설정을 요구하는 자료, 소유권이 불분명한 배포물은 피해야 합니다. 제작자 권한을 존중하고, 시각적 변경으로 공식 콘텐츠를 사칭하는 용도로 사용하지 마세요.

Penumbra는 Dalamud와 같은 건가요?

아닙니다. Dalamud는 XIVLauncher를 통해 로드되는 플러그인 프레임워크이고, Penumbra는 런타임 모드 교체를 관리하는 그중 하나의 플러그인입니다.

GitHub Releases의 Penumbra.zip을 받아도 되나요?

일반적인 설정이라면 권장되지 않습니다. 공식 README는 repo.json URL을 추가한 뒤 Dalamud를 통해 설치해 업데이트를 자동 관리하라고 안내합니다.

게임 업데이트 후 왜 FFXIV 플러그인을 쓸 수 없나요?

호환성 점검 중에는 Dalamud가 플러그인을 일시적으로 비활성화할 수 있습니다. 유지 관리 중인 업데이트를 기다리고, 구버전 바이너리를 강제로 쓰지 마세요.

Penumbra 모드 폴더는 어디에 두는 게 좋나요?

FFXIV 설치 폴더와 보호된 시스템 폴더 바깥에, 쓰기 가능한 전용 폴더를 사용하세요. 여유 공간이 충분한 로컬 저장소가 적합합니다.

같은 파일을 바꾸는 모드 두 개는 어떻게 해결하나요?

Penumbra 충돌 정보와 collection 우선순위를 확인하세요. 의도한 교체본만 활성화하거나, 경쟁하는 모드보다 위로 올리면 됩니다.

Penumbra는 안전한가요?

공식 리포지토리가 있는 공개 커뮤니티 소프트웨어이지만, 여전히 서드파티 도구이며 모드 파일 자체에도 출처, 개인정보, 호환성, 계정 정책 측면의 별도 위험이 있습니다.