Patchouli

Patchouli는 Vazkii가 만든 인게임 가이드북 라이브러리입니다. 프로젝트가 스스로 붙인 설명은 이렇습니다 — "모드 개발자와 모드팩 제작자를 위한, 접근하기 쉽고 데이터 주도적이며 의존성 없는 문서화 도구."

자체 콘텐츠는 없습니다. 이 모드만 깔면 게임 안에 아무것도 추가되지 않습니다. Patchouli는 다른 모드와 모드팩이 책을 만들 수 있게 해 주는 토대입니다.

제공하는 기능

- 데이터 주도 방식 — 책 내용을 JSON으로 작성합니다. 자바 코드를 쓸 필요가 없어, 프로그래밍을 하지 않는 모드팩 제작자도 책을 쓸 수 있습니다. - 여러 페이지 타입 — 텍스트, 제작 레시피, 이미지. - 멀티블록 시각화 — 복잡한 블록 배치를 책 안에서 보여 줍니다. Patchouli의 대표 기능입니다. - 매크로가 붙는 서식 텍스트와 인게임 텍스트 미리보기. - 어드밴스먼트 기반 해금 — 진행 상황에 따라 책의 내용이 열립니다. - 중첩 카테고리, 커스텀 템플릿, 다국어 지원.

대표적인 이용 모드는 Botania입니다. 같은 작가의 마법 모드로, Botania의 가이드북이 Patchouli 위에서 동작합니다.

Modonomicon과의 관계 — Modonomicon은 klikli-dev가 만든 별개의 가이드북 라이브러리로, Thaumonomicon 스타일의 책을 목표로 합니다. 서로 다른 모드가 각각 다른 라이브러리를 쓰기 때문에, 한 모드팩에 두 라이브러리가 함께 들어 있는 것은 정상입니다.

플레이어가 만질 설정도 있습니다. 라이브러리지만 설정 파일은 따로 있고, 다음 항목은 개발자가 아니라 플레이어용입니다.

- 도전과제 잠금 해제 — 위에 적은 어드밴스먼트 기반 해금을 끌 수 있습니다. 기본값은 켜짐이라, 아직 조건을 채우지 못한 항목은 책에서 보이지 않습니다. "가이드북에 내용이 없다"고 느껴지는 원인이 대개 이것입니다. 전체를 한 번에 풀 수도 있고 책 ID 단위로 특정 책만 풀 수도 있습니다. - 빠른 조회(quick lookup) — 아이템에 커서를 올린 채 키를 누르고 있으면 그 아이템을 설명하는 책 페이지로 바로 갑니다. 기본은 Ctrl이며 설정에서 Shift로 바꿀 수 있고, 눌러야 하는 시간도 조절됩니다(기본 10틱, 0.5초). - 인벤토리 버튼 — 책 ID를 지정하면 인벤토리의 제작법 책 자리를 그 책이 대신합니다. 모드팩에서 대표 가이드북을 항상 손 닿는 곳에 두고 싶을 때 씁니다. - 텍스트 넘침 처리 — 글이 페이지를 넘칠 때 흘려보낼지, 잘라낼지, 크기를 줄여 맞출지 고릅니다. 기본은 맞춰 줄이기이고, 바꾸면 재접속해야 반영됩니다.

Forge·NeoForge·Fabric·Quilt를 모두 지원하며, 1.12.2부터 최신 버전대까지 폭넓게 유지되고 있습니다.