# 소설 프로젝트에 문제가 생겼어요 (/emergency-guide/novel-is-gone)





이 문서는 뮤블 [소설 프로젝트](/novel)가 목록에서 사라졌거나, 클라우드 소설이 편집되지 않거나, [자동 로컬 백업](/safeguards/automatic-local-backup)으로 열리는 것처럼 보이는 경우를 다룹니다.
99%의 관련 문의는 대부분 아래 시나리오에 해당하므로 일단 진정하시고 차근차근 확인해주세요.

그럼에도 해결되지 않은 경우에는 [뮤블 공식 커뮤니티](https://discord.gg/KfKqGUdBAZ)에 직접 문의해주세요.

### 제 소설이 목록에서 사라졌어요

### 로컬 도서관인가요?

### 로컬 소설이 있는 폴더를 옮기시진 않으셨나요?

[로컬 소설](/novel/local-storage)은 사용자가 지정한 경로[^1] 내 폴더에 저장됩니다. 경로가 바뀌면 뮤블은 소설을 찾지 못해 목록에서 사라진 것으로 인식합니다.

> 이동한 뮤블 프로젝트 폴더를 찾은 뒤 다시 소설을 열면[^2] 목록에 등록할 수 있습니다.

### 로컬 소설이 있는 폴더를 실수로 삭제하진 않으셨나요?

사용자가 로컬 소설 프로젝트 파일을 직접 삭제한 경우에는 뮤블 안에서 복구할 수 없습니다.

> 먼저 운영체제의 휴지통을 확인하세요. 클라우드 저장소에 프로젝트 폴더를 올려두었다면 해당 서비스의 휴지통이나 버전 기록도 확인하고, 필요한 경우 파일 복구 도구를 사용해야 합니다.

### iOS 아이폰이나 아이패드 앱을 사용하고 계신가요?

앱 재설치나 파일 접근 권한 문제 등으로 로컬 프로젝트 목록을 불러오지 못한 것일 수 있습니다. 로컬 도서관에서 검색창 옆의 <TbRefresh className="mx-1 inline-block" /> **동기화** 버튼을 눌러 프로젝트 목록을 다시 불러오세요.

### 안전한 저장 꺼짐 작성 중 정전 등으로 강제 종료된 적이 있나요?

**안전한 저장을 비활성화한 상태에서** 저장 도중 앱이나 운영체제가 강제로 종료되었다면 소설 메타데이터 파일이 일부만 기록되었을 수 있습니다. 안전한 저장이 켜져 있다면 임시 파일을 먼저 완성한 뒤 원본을 교체하므로 이 문제로 파일이 깨질 가능성은 매우 낮습니다.

> 먼저 [안전한 저장](/safeguards/safe-save)이 켜져 있는지 확인하세요. 파일이 이미 손상되었다면 아래의 [깨진 로컬 소설 파일 복구하기](#깨진-로컬-소설-파일-복구하기) 절차를 따라 복구하세요.

### 제3자 클라우드 사용 프로젝트를 여러 기기에서 동시에 사용하셨나요?

클라우드 동기화 프로그램이 파일 충돌을 처리하면서 `.muvl` 파일을 여러 개 만들 수 있습니다. 같은 프로젝트 안에 메타데이터 파일이 중복되면 뮤블은 어느 파일이 원본인지 판단할 수 없어 목록에서 프로젝트를 제외합니다.

> 중복된 `.muvl` 파일을 프로젝트 밖의 안전한 위치로 옮긴 뒤 소설을 다시 열어주세요.[^2]

### 수동 복제 복제한 프로젝트 폴더를 실행하셨나요?

프로젝트 구성 파일에는 고유 ID가 있습니다. 한 기기에서 폴더를 그대로 복제해 두 프로젝트의 ID가 겹치면 오작동할 수 있습니다.

> 중복 프로젝트를 다른 위치로 옮기거나 등록에서 제외한 뒤 사용할 프로젝트를 다시 열어주세요.[^2]

### v2.6.1 이전 Android iOS 뮤블을 재설치하시진 않으셨나요?

구 버전 모바일 뮤블은 로컬 소설을 앱 저장소에 보관했습니다. 앱을 삭제하면 운영체제가 앱 저장소도 함께 지우므로 그 안의 로컬 소설이 삭제될 수 있었습니다.

> **v2.6.1에서 해결되었습니다.** 로컬 소설의 기본 저장 위치가 문서 폴더의
> `MuvelProjects`로 일원화되어, 앱을 재설치해도 프로젝트 파일은 함께 삭제되지
> 않습니다. 자세한 내용은 [v2.6.1 업데이트
> 노트](/update-note/v2.6#v261-맞춤법-검사기-업데이트)를 참고하세요.

구 버전 앱이 아직 설치되어 있다면 앱을 삭제하지 말고 먼저 로컬 소설을 `Documents/MuvelProjects` 또는 다른 안전한 위치로 옮기세요. 앱 저장소가 이미 삭제됐다면 운영체제나 기기 백업을 통한 복구가 필요합니다.

### 클라우드 도서관인가요?

### 다른 계정으로 로그인하지 않으셨나요?

[클라우드 소설](/novel/muvel-cloud-storage)이 사용자의 조작 없이 삭제된 사례는 지금까지 보고되지 않았으며, 관련 문의의 대부분은 다른 계정으로 로그인한 경우였습니다. 뮤블의 소설은 계정별로 저장됩니다.

기존과 다른 인증 방식(네이버, Discord, Google 등)을 선택했거나, 같은 인증 방식을 사용하더라도 인증 사이트에서 다른 계정이 선택되어 있을 수 있습니다.

> 현재 계정에서 로그아웃한 뒤 기존 소설을 만들 때 사용한 인증 방식과 계정으로 다시 로그인하세요.

### 제 소설이 편집되지 않아요

클라우드 도서관에서 소설이 보이지만 편집할 수 없다면 인터넷 연결 상태와 상단 안내를 확인해주세요.

### 오프라인 모드로 열린 상태인가요?

뮤블 데스크톱 앱에서 서버에 연결할 수 없으면 클라우드 소설이 [오프라인 모드](/safeguards/offline-mode)로 열려 해당 기기의 로컬 백업을 기준으로 표시될 수 있습니다. 이 문서는 읽기 전용이며, 다른 기기에서 수정한 최신 내용이 반영되지 않았을 수 있습니다.

> 인터넷 연결이 복구되면 `서버에서 다시 열기` 또는 `클라우드로 돌아가기`를 눌러 서버 판본을 다시 여세요.

### v2.9.0 이전 다운그레이드한 뒤 클라우드 백업으로 열리나요?

v2.9.0 이상을 사용하다가 v2.9.0 이전 버전으로 다운그레이드하면 서버 판본 대신 데스크톱 앱에 남아 있던 클라우드 백업이 열릴 수 있습니다.

> 백업 판본에서 작업하지 마세요. 최신 뮤블로 다시 업데이트한 뒤 클라우드 도서관에서 서버 판본을 열어 내용을 확인하세요.

[^1]: 미지정 시 기본 경로는 `내 문서/MuvelProjects`입니다.

[^2]: PC의 경우는 뮤블이 종료된 상태에서 프로젝트 내 `.muvl` 파일을 직접 실행하기 또는 로컬 프로젝트 열기. 모바일의 경우에는 로컬 소설 다시 불러오기 버튼(v2.7.9 추가)을 사용 가능합니다.

## 깨진 로컬 소설 파일 복구하기 [#깨진-로컬-소설-파일-복구하기]

정전, 디스크 오류 등 기기 고장, OS 오류 등으로 뮤블 파일이 자체가 깨질 수 있지만, 다행이도 뮤블은 문서별로 파일이 분리되어 있어 전체 문서가 대미지를 받을 일은 없습니다.

> **안전한 저장이 활성화되어 있다면 저장 도중 종료되어도 원본 파일을 바로 덮어쓰지
> 않으므로 일반적으로 이 문제가 발생하지 않습니다.** Dropbox 같은 저장소와의 호환
> 문제 때문에 [안전한 저장](/safeguards/safe-save)을 직접 끈 경우에만
> 아래 복구 절차가 필요할 가능성이 큽니다.

만약 소설 리스트에 표시가 안 되는 경우, `.muvl`로 끝나는 로컬 소설 메타데이터 파일이 깨진 경우입니다.
`.muvl` 파일은 소설 프로젝트의 루트에 위치합니다.

* `.muvl` 파일이 깨졌는지 확인하는 방법
  * **파일의 용량이 0KB**로 표시되는 경우
  * 메모장으로 열었을 때 **정상적인 텍스트로 표시되지 않는 경우**

이 경우 다음 방법으로 복구가 가능합니다.

1. 깨진 `.muvl` 파일을 삭제합니다.
2. 뮤블에서 새 소설 프로젝트를 생성합니다.
3. 새로 생성한 프로젝트의 `.muvl` 파일을 깨진 소설 프로젝트 내로 이동합니다.[^3]
4. 다시 소설을 열면[^2] 복구가 완료됩니다.

단, 이 경우 소설 자체에 저장된 제목, 설명, 태그 등의 정보는 복구되지 않습니다.

[^3]: 또는 기존 프로젝트 파일에서 `.muvl`을 제외한 모든 파일을 새 프로젝트로 복사하는 방법도 있습니다.
