Moonlight Lib

MehVahdJukaar의 모드들이 공통으로 쓰는 코어 라이브러리. 동적 리소스팩·데이터팩, 동적 블록 셋 등록, 맵 마커, 주민 AI, 소프트 유체 시스템 등을 제공합니다.

📖 소개

Moonlight Lib는 MehVahdJukaar가 자기 모드들을 받치기 위해 만든 코어 라이브러리입니다. 자체 콘텐츠는 없고, 모드 개발자가 쓰는 도구 모음입니다.

제공하는 기능 (모드 페이지 기준) - 동적 리소스팩·데이터팩 유틸리티 — 런타임에 리소스팩과 데이터팩을 만들어 내고, 기존 텍스처를 다시 칠하거나 갈아 끼웁니다. 새 나무 블록을 추가할 때 특히 유용합니다. - 동적 블록 셋 등록 — 모드가 '나무 타입' 같은 블록 셋을 정의하면, 등록된 블록을 모두 훑어 셋을 채운 뒤 그에 의존하는 블록을 등록하게 해 줍니다. 등록 순서 문제 때문에 일반적인 방법으로는 하기 어려운 작업입니다. 결과적으로 모드 블록이 다른 모드가 추가한 나무 타입까지 자동으로 지원하게 됩니다. - 커스텀 맵 마커 — 지도에 마커와 장식을 추가하고 렌더링까지 제어하는 시스템. 데이터팩으로 새 마커를 등록할 수 있습니다. - 동적 주민 AI — 기존 AI를 통째로 덮어쓰지 않고 주민의 작업·일정을 더하거나 바꿉니다. - 소프트 유체 시스템 — 병·그릇·양동이 등 여러 용기에 담을 수 있고, 스튜나 음료는 탱크에서 바로 마실 수 있는 데이터 주도 가상 유체 시스템. 기본 단위가 병 하나(250 Forge mb)입니다. - 1인칭·3인칭 커스텀 애니메이션 인터페이스, 디스펜서 동작 등록 유틸리티, 숫돌 어드밴스먼트 트리거 등.

어떤 모드가 쓰나요Supplementaries, Every Compat (Wood Good), Fast Paintings 가 모두 Moonlight Lib를 의존성으로 요구합니다. 이 중 하나라도 들어 있는 모드팩이면 Moonlight Lib도 함께 깔려 있습니다.

설정이 있고, 그중 하나는 플레이어에게 직접 쓸모가 있습니다.

- 전역 데이터팩 폴더 — 기본값 moonlight-global-datapacks 입니다. 이 폴더에 데이터팩을 넣어 두면 모든 월드에 자동으로 적용됩니다. 월드마다 datapacks 폴더에 복사해 넣을 필요가 없다는 뜻이라, 같은 데이터팩을 여러 세이브에서 쓰는 경우 편합니다. 빈 문자열로 두면 꺼집니다. - 동적 에셋 멀티스레드 생성 — 기본 켜짐. 코어가 많은 PC에서 로딩이 빨라질 수 있습니다. - 캐시 검색 방식 — 기본 켜짐. 동적 에셋 캐시를 트리 구조로 색인해 조회를 크게 앞당기는 대신 RAM을 조금 더 씁니다. - 디버그 덤프 — 기본 꺼짐. 켜면 블록 타입 정보를 .minecraft/debug/ 아래 파일로 남깁니다. 문제를 추적할 때만 쓰는 항목입니다.

이전 이름은 Selene Library입니다. CurseForge 프로젝트 주소가 여전히 selene 인 것도 그 때문입니다.

🕒 이 모드는 언제 쓰는가

MehVahdJukaar의 모드가 모드팩에 있으면 함께 동작합니다. 사용자가 조작할 부분은 없습니다.

📦 어떤 모드팩에서 중요한가

Supplementaries·Every Compat·Fast Paintings가 들어 있는 모드팩.

🚀 시작 가이드 — 첫 30분 동안 해야 할 것

1단계 — 모드팩에 포함돼 있는지 확인합니다. Supplementaries·Every Compat·Fast Paintings 중 하나라도 있으면 함께 들어 있습니다.

2단계 — 그대로 둡니다. 라이브러리는 손대지 않는 것이 정답입니다.

3단계 — Every Compat이 다른 모드의 나무 타입까지 블록을 만들어 내는 걸 보면, 동적 블록 셋 등록이 무슨 일을 하는지 눈으로 확인할 수 있습니다.

💡 플레이 팁

  • 임의로 빼지 마세요 — Supplementaries, Every Compat, Fast Paintings가 모두 이 라이브러리를 요구합니다.
  • 데이터팩을 모든 월드에 한 번에 적용하고 싶다면 Moonlight 설정의 전역 데이터팩 폴더(기본 moonlight-global-datapacks)를 쓰세요. 월드마다 복사해 넣지 않아도 됩니다.
  • Forge·NeoForge·Fabric 모두 지원합니다. 모드팩이 로더에 맞는 빌드를 함께 가져옵니다.
  • 모드팩 설명에서 Selene 이라는 이름을 봐도 같은 모드입니다. 이름이 바뀌었을 뿐입니다.

⚠️ 자주 헷갈리는 부분

  • 아무 일도 일어나지 않는 것이 정상입니다. JEI에 잡히는 아이템이 없습니다.
  • MehVahdJukaar 모드 전용 라이브러리에 가깝습니다. 그 모드들이 없으면 설치해도 하는 일이 없습니다.
  • Selene Library와 같은 모드입니다. 옛 이름이 Selene이었고 CurseForge 주소에 그 흔적이 남아 있습니다.

❓ 자주 묻는 질문

어떤 모드가 이걸 필요로 하나요?

Supplementaries, Every Compat (Wood Good), Fast Paintings 가 Moonlight Lib를 의존성으로 요구합니다.

Selene Library와 같은 모드인가요?

네. 이름이 Selene에서 Moonlight Lib로 바뀌었습니다. CurseForge 주소가 아직 selene 인 것도 그 때문입니다.

Fabric에서도 되나요?

됩니다. Forge·NeoForge·Fabric 모두 지원합니다.

같은 데이터팩을 월드마다 넣기 번거롭습니다.

Moonlight Lib의 전역 데이터팩 폴더를 쓰면 됩니다. 기본 폴더명은 moonlight-global-datapacks이고, 여기 넣은 데이터팩은 모든 월드에 자동으로 적용됩니다. 설정에서 폴더명을 바꾸거나 빈 문자열로 꺼 둘 수도 있습니다.

📦 이 모드가 포함된 모드팩

🔗 관련 모드