Minecraft 1.21, 26.3용 Prickle 모드

Prickle은 JSON 기반 설정 형식입니다. 이 모드는 그 형식을 Minecraft에서 사용할 수 있게 해줍니다! 기술 문서는 GitHub 페이지를 참고하세요.

자주 묻는 질문

Prickle이 제공하는 이점은 무엇인가요? Prickle은 JSON을 기반으로 하지만 주석과 데코레이터 같은 여러 유용한 기능을 추가합니다. Prickle은 JSON과 100% 하위 호환되며 모든 기능, 도구, 구문 강조를 지원합니다.

왜 이름이 Prickle인가요? Prickle은 고슴도치 무리를 뜻하는 집합 명사입니다. 고슴도치는 제가 가장 좋아하는 동물 중 하나이며, 설정 파일에 딱 맞는 비유라고 생각합니다. 예를 들어 둘 다 처음에는 위협적으로 보일 수 있지만 알고 이해하게 되면 괜찮아집니다.

기존 형식을 사용하지 않는 이유는 무엇인가요? 과거에 설정 파일에 JSON을 사용했지만 주석과 기본값의 부재 같은 여러 문제가 있었습니다. Prickle은 100% 하위 호환성을 유지하면서 이러한 기능을 JSON에 추가합니다. TOML 같은 다른 형식도 시도해 보았지만 많은 Java 구현에 실망했습니다. 그들은 제가 중요하다고 생각하는 기능이 자주 빠져 있고, 심각한 버그가 있으며, 더 이상 유지 관리되지 않습니다. Minecraft는 이미 데이터팩과 명령어에 JSON을 사용하므로 대부분의 플레이어에게 익숙한 선택입니다.

형식 사양

Prickle에서 속성 값은 JSON 객체로 감싸집니다. 이를 통해 주석 같은 메타데이터를 해당 속성에 귀속시킬 수 있습니다.

예를 들어 표준 JSON 파일은 다음과 같습니다.

{ "databasehost": "192.168.1.222" }

같은 JSON을 Prickle 파일로 나타내면 다음과 같습니다.

{ "databasehost": { "//": "The IP address of the database to connect to.", "value": "192.168.1.222" } }

주석

// 키는 주석용으로 예약되어 있습니다. 주석은 독자에게 추가적인 맥락을 제공하는 데만 사용되며 파일이 파싱되는 방식에 영향을 주어서는 안 됩니다. 주석은 JSON 문자열이거나 여러 줄 주석을 위한 문자열 배열일 수 있습니다.

{ "databasehost": { "//": [ "The IP address of the database to connect to.", "The port can be defined at the end using an :" ], "value": "192.168.1.222:1273" } }

데코레이터

데코레이터는 속성의 특정 속성을 전달하는 이름이 붙은 주석입니다. 흔한 예로 //default가 있으며, 이는 속성의 기본값을 표시하는 데 사용할 수 있습니다. 주석과 마찬가지로 데코레이터는 파일이 파싱되는 방식에 영향을 주지 않으며, 속성이 어떻게 파싱될지 설명할 뿐입니다.

prickle 파일에서 다음과 같은 데코레이터를 만날 수 있습니다.

• //default - 속성의 기본값입니다.
• //reference - 위키 페이지 링크처럼 더 알아볼 수 있는 자료입니다.
• //range - 값의 허용 범위입니다. 예를 들어 >=5.
• //regex - 값이 일치해야 하는 정규식 패턴입니다.
• //empty-allowed - 값이 비어 있을 수 있는지 여부입니다. (기본값은 true).

후원

이 프로젝트는 Nodecraft의 후원을 받습니다. 코드 DARKHAX를 사용하면 첫 달 서비스 요금 30% 할인을 받을 수 있습니다!