Dusklight 모드 매니저: 모드와 로드 순서 이해하기

Dusklight 모드 매니저가 실제로 하는 일

매니저라는 이름을 보면 거대한 외부 카탈로그를 떠올릴 수 있지만 핵심은 통제입니다. 공식 Mod API는 리소스 전용 모드, C++ 네이티브 모드, Luau 스크립트 모드를 구분합니다. 리소스 패키지는 디스크 오버레이나 텍스처를 바꿀 수 있고, 네이티브 패키지는 게임 코드와 hook에 연결될 수 있으며, 스크립트 패키지는 더 제한된 범위에서 Luau runtime을 사용합니다. 종류가 다르면 발생하는 문제도 다릅니다.

먼저 패키지가 무엇을 건드리는지 파악하세요. 텍스처 교체는 누락된 화면이나 메모리 부담을 만들 수 있고, 스크립트는 특정 runtime 서비스에 의존할 수 있으며, 네이티브 라이브러리는 사용하는 플랫폼용 빌드가 필요할 수 있습니다. 활성화하기 전에 설명, 제작자, 버전, 의존성을 기록하세요. 화면에 보이는 항목은 안전 인증서가 아니라 확인을 시작하는 단서입니다.

1. 패키지 식별매니저 항목과 mod.json을 읽고 이름, id, 버전, 제작자를 기록합니다.
2. 범위 분류다른 패키지와 비교하기 전에 리소스, 네이티브, 스크립트 중 무엇인지 판단합니다.
3. 기준 환경 유지첫 패키지를 켜기 전에 깨끗한 실행 결과와 백업을 저장합니다.

활성화 전에 .dusk 패키지 읽기

.dusk 파일은 보통 zip과 비슷한 구조를 가진 번들로, 여러 종류의 내용을 담을 수 있습니다. 파일명이나 미리보기만 보고 판단하지 마세요. 메타데이터를 찾고 설명을 읽은 다음, 표시된 버전을 현재 사용 중인 Dusklight 버전과 비교하세요. 공식 템플릿은 안정적인 id와 설명 필드를 사용하며, 공식 데모 패키지는 그래픽, 오디오, runtime 서비스 등을 시험하는 예를 보여 줍니다.

id는 비슷한 이름을 구분하고, version은 테스트한 개정판을 나타내며, author는 지원 문서를 찾는 단서가 됩니다. description은 그래픽, 사운드, 스크립트, 메뉴 또는 다른 서비스가 영향을 받는지 알려 줍니다. 메타데이터가 부족하다고 악성이라고 단정할 수는 없지만, 출처가 분명해질 때까지 활성 테스트에서 제외할 이유가 됩니다. 원본 아카이브는 활성 데이터 폴더 밖에 보관하고 출처와 테스트 날짜를 기록하세요.

보수적인 모드 로드 순서 만들기

로드 순서는 여러 모드가 같은 영역을 건드릴 때 어떤 패키지가 리소스를 제공하거나 교체할 기회를 갖는지 설명하는 방법입니다. 정확한 규칙은 현재 Dusklight 구현과 패키지 유형에 따라 달라지므로 포럼의 숫자로 보편적인 우선순위를 만들지 마세요. 제작자가 문서화한 의존성과 순서 조건을 먼저 읽고, 매니저에 표시된 순서와 공식 메모를 작업 근거로 사용하세요.

첫 테스트에서는 역할이 겹치는 패키지를 분리하세요. 두 텍스처 교체, 같은 이벤트에 연결되는 두 스크립트, 실험적인 렌더러와 시각 모드의 조합은 각각 단독으로 작동해도 원인을 알기 어려운 결과를 만들 수 있습니다. 백업, 가장 작은 변경, 반복 테스트, 다음 추가라는 단순한 순서를 지키는 것이 좋습니다.

1. 0에서 시작깨끗한 빌드를 실행하고 메뉴, 게임플레이, 저장, 다시 로드 결과를 기록합니다.
2. 가장 작은 변경 활성화출처가 분명하고 목적이 좁게 문서화된 패키지 하나를 선택합니다.
3. 순서 기록다음 패키지를 추가하기 전에 매니저 순서와 의존성을 적습니다.
4. 마지막 변경 되돌리기첫 문제가 나타나면 직전에 추가한 패키지를 비활성화합니다.

한 번에 한 가지 변경만 테스트하기

게임이 시작된 것만으로는 완전한 호환성을 확인할 수 없습니다. 타이틀 화면과 메뉴에서 시작한 뒤, 모드가 바꾸는 콘텐츠가 있는 반복 가능한 장면을 방문하세요. 해당 패키지가 영향을 준다고 설명하는 경우 화면, 소리, 입력, 저장, 다시 로드를 확인합니다. 목표는 모든 환경에서 작동한다고 증명하는 것이 아니라 현재 패키지, 빌드, 플랫폼 조합에서 결과가 일관적인지 확인하는 것입니다.

변경 전후에 그래픽 backend, 해상도, 컨트롤러, 게임 데이터, 장면을 동일하게 유지하세요. 드라이버, 입력 설정, 데이터, 모드 목록을 동시에 바꾸면 매니저가 원인을 가리킬 수 없습니다. id, 버전, 활성 순서, 앱 버전, 플랫폼, 처음 보인 증상을 짧게 기록하세요.

• 타이틀 화면과 메뉴에서 인터페이스 요소가 빠지지 않았는지 확인합니다.
• 같은 장면을 불러와 모드 전후에 동일한 동작을 수행합니다.
• 다른 패키지를 추가하기 전에 한 번 저장하고 다시 로드합니다.
• 전체 환경을 초기화하기 전에 첫 오류와 마지막 변경을 기록합니다.

기준 환경을 잃지 않고 충돌 해결하기

매니저에 오류, 아이콘 누락, 충돌, 검은 화면 또는 아무 효과가 없는 패키지가 나타나도 여러 설정을 한꺼번에 바꾸지 마세요. 가장 최근 모드를 먼저 비활성화하고 같은 테스트를 반복합니다. 깨끗한 빌드가 작동하면 패키지, 순서, 호환성이 첫 번째 원인 후보입니다. 깨끗한 빌드도 실패하면 앱 버전, 게임 데이터, 드라이버, 입력 계층, 권한을 확인하세요.

한 버전에서 작동한 패키지가 업데이트 뒤 실패할 수 있습니다. 공식 v1.4.1 릴리스 노트에는 v1.4.0 시기의 텍스처 교체 로드 순서와 누락된 인터페이스 텍스처 수정, 플랫폼과 backend 수정이 기록되어 있습니다. 매니저 문제라고 판단하기 전에 앱 버전과 패키지의 지원 범위를 비교하세요.

모드를 제거하고 재현 가능한 결과 보고하기

패키지를 제거하려면 먼저 Dusklight를 종료하세요. 현재 버전이 지원한다면 매니저에서 비활성화한 뒤, 아카이브나 문서화된 패키지 폴더를 날짜가 붙은 격리 장소로 이동합니다. 이동하면 실제로 테스트한 증거를 보존할 수 있습니다. 깨끗한 설정으로 시작해 같은 장면과 저장 테스트를 반복하고 증상이 사라졌는지 확인하세요.

유용한 보고서에는 공식 버전, 플랫폼과 아키텍처, 패키지 id와 버전, 매니저 상태, 로드 순서, 실패한 장면, 깨끗한 기준 결과가 들어가야 합니다. 민감하지 않은 로그와 정식 출처 링크를 첨부하세요. 권한이 없는 게임 데이터나 재배포할 수 없는 아카이브를 업로드하지 마세요.

1. 게임 종료Dusklight가 읽는 중인 번들을 이동하거나 교체하지 않습니다.
2. 패키지 격리테스트한 파일이나 폴더를 즉시 삭제하지 말고 날짜가 있는 장소로 옮깁니다.
3. 기준 확인패키지를 끈 상태에서 메뉴, 장면, 저장, 다시 로드를 반복합니다.
4. 증거 작성게임 데이터를 올리지 않고 id, 버전, 순서, 첫 오류와 비교 결과를 적습니다.

Dusklight 모드 매니저 자주 묻는 질문