Minecraft 1.20.1, 1.21.1용 Kube Utils 모드

Kube Utils

Kube Utils는 KubeJS의 간단한 애드온으로, 기존 기능에 새로운 기능을 추가하고 더 성능이 좋고 단순하며 간결한 코드를 작성할 수 있는 새로운 시스템을 만들어냅니다.

작동 방식

Kube Utils(이하 Ku)는 명확하고 간결하며 일관된 API와 같은 설계 개념으로 만들어졌습니다. 이 모드가 추가하는 모든 것은 전역 Ku 객체 안에 들어 있으므로, 레벨 API에 접근하고 싶다면 Ku.Level을 통해 접근하고, 유체와 관련된 작업을 하고 싶다면 Ku.Fluids 등을 사용하면 됩니다.

기능

현재는 KubeJS에서 지원이 부족한 일부 영역에 대한 몇 가지 도우미만 제공하지만, 시스템 개발 주기 동안 이를 크게 확장할 계획입니다. 제안 사항이 있으면 기능 요청을 남겨 주세요!

• 블록 위치에서 구조물을 가져오기, 구조물 생성, 엔티티 찾기 및 공간 비우기, 경계 상자를 사용해 무작위 위치 얻기 등과 같은 레벨 추가 기능
• 유체의 네임스페이스를 기반으로 유체 목록을 가져오고, 유체가 비어 있는지 여부를 확인할 수 있는 Fluids
• 가중치 테이블을 기반으로 무작위 항목을 가져오는 등의 리스트 추가 기능
• 아이템, 블록, itemstack, 문자열, 유체 또는 itemEntity 등 어떤 객체가 nullOrEmpty인지 항상 간단하게 알 수 있게 해주는 nullOrEmpty와 같은 일반 유틸리티 추가! (필요에 따라 더 많은 지원 예정)
• 완전히 문서화된 코드
• 프로덕션 검증 완료
• 명확하고 간단한 API

우리의 목표

• Minecraft, Forge 또는 Fabric에서 강제하지 않는 한 절대 호환성을 깨는 변경을 하지 않는 것을 목표로 합니다. 호환성을 깨는 변경이 필요하다고 판단되면, 기존 코드에 영향을 주지 않는 선택적 방식으로 진행합니다.
• 추가 기능을 지나치게 복잡하게 만들지 않기
• 항상 추가 기능을 쉬운 영어로 문서화하기

문서

우리의 목표는 모든 새로운 추가 기능과 사용 방법을 문서화한 웹사이트를 출시하는 것입니다.

지금은 코드 내에서 우리가 추가한 기능을 읽어볼 수 있습니다. BaseBinding 클래스는 Ku 객체에서 사용할 수 있는 객체를 보여줍니다. 예를 들어 BaseBindings에는 Streams가 필드로 포함되어 있습니다. 즉, Ku.Steams.MethodName을 사용할 수 있습니다. 사용 가능한 메서드는 관련 모듈 클래스 파일에서 찾을 수 있습니다. ClassWrapper<?>로 감싸진 필드가 보인다면, KubeJS에서 그 필드를 사용하려면 객체를 생성해야 한다는 뜻입니다. 예를 들어 Level은 ClassWrapper<LevelUtils>로 감싸져 있으므로 new Ku.Level(player.level)처럼 필드를 사용해야 합니다. 조금 복잡하지만 웹사이트가 준비되면 훨씬 간단해질 것입니다.

면책 조항

면책 조항: 베타 기간 동안에는 코드 호환성을 깨는 변경이 있을 수 있습니다. 안정 버전이 출시되면 이 메시지는 제거되며, 그 이후부터는 코드에 호환성을 깨는 변경이 포함되지 않습니다!

문제

문제가 있으면 예제 코드와 함께 이슈 트래커에 보고해 주시면 문제를 확인할 수 있습니다.