Dusklight용 커스텀 Link 모델 모드 만드는 방법

Link 모델 변경에 맞는 방식을 고르세요

Dusklight용 커스텀 Link 모델 모드를 만들 때는 텍스처 색상 수정, 문서화된 리소스 교체, 렌더링 변경, 게임 데이터 복사본 패치처럼 서로 다른 작업을 구분하세요. 현재 문서가 지원하는 범위를 고르고 필요한 도구와 파일을 적어 두세요.

공식 Mod API에는 세 종류가 있습니다. 리소스 전용 모드는 지원되는 텍스처와 디스크 오버레이를 바꿀 수 있습니다. 네이티브 C++ 모드는 게임 코드와 연동할 수 있지만 지원 플랫폼별 빌드가 필요합니다. Luau 스크립트는 공개된 서비스만 사용합니다. 이것만으로 임의의 Link 메시, 리그, 애니메이션을 .dusk에 넣어 불러올 수 있다고 볼 수는 없습니다.

오래된 튜토리얼보다 최신 Mod API를 먼저 확인하세요

2026년 9월 30일 공개된 공식 v2.0.3에는 커스텀 모델 렌더링에 쓰이는 보간 기능 InterpService가 추가됐습니다. 렌더링 지원이 발전 중이라는 뜻이지 Link 자동 가져오기, 공개 변환기, 모든 커뮤니티 메시의 호환성을 보장하지는 않습니다. 오래된 설명을 따르기 전에 릴리스 노트와 Mod API를 다시 확인하세요.

.dusk는 mod.json과 선택적인 res, overlay, textures 폴더를 담은 ZIP을 .dusk 확장자로 바꾼 형식입니다. 공식 예시에 나온 경로와 메타데이터를 사용하세요. 문서에 없는 models/ 폴더를 만들어도 자동으로 읽힌다고 가정해서는 안 됩니다.

깨끗한 테스트 복사본을 만들고 기준 상태를 지키세요

Dusklight 버전, 운영체제와 CPU 구조, 그래픽 백엔드, 활성 모드, 비교할 장면이나 세이브를 기록하세요. 세이브와 설정은 따로 백업합니다. 커뮤니티 절차가 게임 데이터를 수정한다면 직접 만든 지원 덤프의 복사본만 사용하고, 원본은 보존하며 모드 패키지에 넣지 마세요.

수정하지 않은 환경을 먼저 실행해 장면이 열리는지 확인하고 같은 카메라 위치에서 기본 모델을 기록하세요. 파일을 옮기기 전에 게임을 종료하고, 한 번에 한 가지 변경만 시험해야 실패 원인을 찾기 쉽습니다.

1. 환경 기록버전, 플랫폼, 모드 목록, 그래픽 설정, 세이브와 테스트 장면을 적습니다.
2. 사용자 데이터 백업세이브와 설정을 별도 위치에 복사한 뒤 열어 봅니다.
3. 작업 복사본 준비원본은 그대로 두고 사용할 권한이 있는 데이터만 씁니다.
4. 기준 상태 확인실험 패키지를 넣기 전에 같은 실행과 장면을 재현합니다.

모델 출처, 리그와 사용 허가를 확인하세요

뷰어에서 잘 보여도 게임 안에서는 호환되지 않을 수 있습니다. 형식, 리그와 본 이름, 재질, 텍스처 크기, 애니메이션 조건, 프로젝트 전용 변환 절차를 최신 문서나 재현 가능한 안내로 확인하세요. 정보가 부족하면 경로를 추측하거나 호환된다고 단정하지 말고 제작자나 유지 담당자에게 문의하세요.

파일과 함께 제작자, 출처 URL, 라이선스나 서면 허가, 변경 내용, 재배포 조건을 기록하세요. 캐릭터를 참고한 모델에도 타인의 자료가 들어갈 수 있습니다. 게임 덤프, 저작권이 있는 전체 데이터, 공유 권한이 없는 파일은 포함하지 마세요.

• 직접 만든 리소스나 수정과 재배포 허가를 받은 파일을 사용하세요.
• 원본, 내보낸 파일, 최종 패키지를 나눠 두면 각 단계를 되돌릴 수 있습니다.
• 라이선스가 요구하는 저작자 표시와 고지를 유지하세요.
• 형식, 리그, 권리가 확인되지 않았다면 공개를 미루세요.

변경 하나만 패키징하고 따로 시험하세요

Dusklight용 커스텀 Link 모델 모드도 리소스 전용 .dusk 방식이 맞는지 먼저 확인하세요. 공식 템플릿에서 시작하고 현재 API가 읽는 파일만 넣습니다. mod.json에는 안정된 id가 필요하며 이름, 버전, 제작자와 설명도 패키지 식별에 도움이 됩니다.

최소한의 아카이브를 만든 뒤 문서화된 설치 경로나 최신 매니저 흐름으로 시험하세요. 추가 텍스처나 다른 모드는 결과를 확인한 다음 넣습니다. 네이티브 C++은 플랫폼별 빌드 관리가 필요하고, Luau는 공개되지 않은 API를 대신 제공하지 않습니다.

1. 지원되는 예제로 시작선택한 종류와 버전의 공식 API 또는 템플릿을 사용합니다.
2. 패키지를 작게 유지문서화된 교체 하나와 안정된 id만 먼저 넣습니다.
3. 현재 설치 방식 준수추측한 폴더가 아니라 공식 위치를 확인합니다.
4. 기준과 비교같은 세이브와 장면을 반복하고 차이를 기록합니다.

반복 가능한 게임 장면에서 결과를 확인하세요

게임이 켜진 것만으로 모델 검증이 끝나지 않습니다. 같은 세이브, 카메라, 조명과 움직임을 재현하세요. 윤곽, 재질, 관통, 누락된 텍스처, 애니메이션 전환, 메뉴와 영상 장면을 확인합니다. 한 형태만 바꿨다면 다른 형태도 기준 상태와 비교하세요.

변경 전후 이미지와 패키지 버전, 활성 모드 목록을 남기세요. 아래 이미지는 별도의 변신 형태를 보여 줍니다. 전환을 확인할 때 참고할 수 있지만 커스텀 모델 예시나 이 안내서의 배포 파일은 아닙니다.

호환성을 기록하고 안전하게 공개하거나 되돌리세요

Dusklight용 커스텀 Link 모델 모드를 공개할 때는 시험한 버전, 플랫폼, 모드 종류, 도구, 충돌과 재현 절차를 적으세요. 출처와 허가, 정확한 미리보기, 실험 단계 같은 한계도 밝히고 한 장면의 결과를 전체 호환성으로 설명하지 마세요.

배포 허가가 있는 파일과 설명만 공유하세요. 게임 덤프, 보호된 아카이브, 키, 전체 게임 리소스는 올리지 않습니다. 공식 릴리스와 Mod API를 안내하고, 업데이트 뒤 문제가 생기면 지원 버전을 표시한 뒤 다시 시험하세요.

1. 패키지 비활성화게임을 닫고 문서화된 방법으로 모드를 끄거나 옮깁니다.
2. 기준 상태 복원깨끗한 복사본과 백업 설정을 되돌리고 원본은 보존합니다.
3. 같은 시험 반복장면이 실행되고 증상이 사라졌는지 확인합니다.
4. 근거와 함께 보고버전, 플랫폼, id, 절차와 비교 결과를 공유하고 게임 데이터는 제외합니다.

커스텀 Link 모델 모드 자주 묻는 질문