Night Config Fixes
Night Config 라이브러리의 "Not enough data available" 예외로 게임이 크래시되는 문제를 우회하는 Fuzs의 모드. 비어 버린 설정 파일을 기본값으로 다시 만듭니다.
📖 소개
Night Config Fixes는 Fuzs가 만든 모드로, 목적이 단 하나입니다. Night Config 라이브러리를 쓸 때 설정 로딩 과정에서 자주 발생하는 com.electronwill.nightconfig.core.io.ParsingException: Not enough data available 문제를 우회하는 것입니다.
Night Config는 Forge의 설정 시스템이 사용하고, Fabric 쪽에서도 많은 모드가 쓰는 라이브러리입니다. 문제는 설정 파일이 무작위로 그냥 비어 버리는 현상입니다. 그 뒤 Night Config가 그 파일을 다시 읽으려 할 때 위 예외를 던지고, 게임이 크래시됩니다. 모드 페이지에 따르면 Better Minecraft 모드팩 쪽에서 이 문제 보고가 매일 올라올 만큼 흔해서 전용 우회 모드를 만들게 됐다고 합니다.
해결 방식 — Night Config Fixes는 이 예외를 잡아내 게임이 크래시되지 않게 하고, 대신 해당 설정을 기본값으로 다시 생성합니다.
모드팩 제작자가 반드시 알아야 할 점 — 그래서 모드팩은 자기가 조정한 설정 파일을 config가 아니라 defaultconfigs 디렉터리에 넣어 두어야 합니다. 그래야 파일이 비었을 때 바닐라 기본값이 아니라 모드팩이 의도한 값으로 복원됩니다.
Forge 전용 추가 옵션 — Forge에서는 서버 설정(server config)을 월드별 serverconfig 대신 전역 config 디렉터리에 생성하도록 하는 옵션도 제공합니다.
설치 위치 — 클라이언트와 서버 어느 쪽이든 선택 사항입니다. 필요한 쪽에만 넣어도 됩니다.
설정 방법 — 인게임 모드 목록·Mod Menu에서 직접 설정할 수 있습니다(Fabric에서는 Prospector의 Mod Menu가 필요하고, 구버전 마인크래프트에서는 Forge Config Screens도 필요합니다). 직접 편집하려면 .minecraft/config 아래의 MOD_ID-client.toml / MOD_ID-common.toml / MOD_ID-server.toml 파일을 열면 됩니다.
🕒 이 모드는 언제 쓰는가
설치해 두면 자동으로 작동합니다. 설정 파일이 비어 버렸을 때만 개입합니다.
📦 어떤 모드팩에서 중요한가
설정 파일이 많은 대형 Forge·Fabric 모드팩. Better Minecraft 계열에서 특히 문제 보고가 많았습니다.
🎮 플레이 체감 변화
평소에는 아무 효과도 보이지 않습니다. 설정 파일이 비었을 때 크래시 대신 기본값 재생성이 일어나는 것이 전부입니다.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
1단계 — "Not enough data available" 크래시를 겪었는지 확인합니다. 이 모드가 우회하는 것은 그 예외 하나입니다.
2단계 — 그대로 둡니다. 별도 설정 없이 작동합니다.
3단계 — 모드팩을 직접 구성한다면, 조정한 설정 파일을 config가 아니라 defaultconfigs에 배치합니다.
💡 플레이 팁
- 모드팩을 만든다면 조정한 설정 파일을
defaultconfigs에 넣으세요 —config에만 두면 파일이 비었을 때 모드팩 값이 아니라 바닐라 기본값으로 복원됩니다. - Forge에서는 서버 설정 위치를 바꿀 수 있습니다 — 월드별
serverconfig대신 전역config디렉터리에 생성하도록 옵션이 있습니다. - 클라이언트·서버 어느 쪽이든 선택 사항 — 문제가 나는 쪽에만 넣어도 됩니다.
- 설정은 인게임 모드 목록에서 — Fabric에서는 Mod Menu가, 구버전에서는 Forge Config Screens가 추가로 필요합니다.
⚠️ 자주 헷갈리는 부분
- • 복원되는 값은 '기본값'입니다 — 비어 버린 설정 파일은 기본값으로 다시 만들어지므로, 손으로 조정해 둔 값은 그 파일에 한해 사라집니다. 모드팩이
defaultconfigs를 제대로 쓰고 있어야 의도한 값으로 복원됩니다. - • 이 모드가 하는 일은 딱 하나입니다 — Night Config의 특정 예외를 우회할 뿐, 일반적인 크래시나 성능 문제와는 무관합니다.
❓ 자주 묻는 질문
어떤 문제를 해결하나요?
Night Config 라이브러리를 쓰는 설정 로딩에서 발생하는 ParsingException: Not enough data available 예외입니다. 설정 파일이 무작위로 비어 버린 뒤 그 파일을 읽으려 할 때 발생하며, 원래는 게임이 크래시됩니다.
Night Config가 뭔가요?
설정 파일을 읽고 쓰는 자바 라이브러리입니다. Forge의 설정 시스템이 이 라이브러리를 사용하고, Fabric 쪽에서도 많은 모드가 씁니다.
모드팩 설정이 날아가지 않나요?
비어 버린 파일은 기본값으로 다시 만들어집니다. 모드팩이 조정한 값을 지키려면 그 설정 파일을 config가 아니라 defaultconfigs 디렉터리에 넣어 두어야 합니다.
Forge와 Fabric 차이가 있나요?
핵심 우회는 양쪽 모두 동일합니다. Forge에서는 서버 설정을 월드별 serverconfig 대신 전역 config 디렉터리에 생성하는 옵션이 추가로 제공됩니다.
