KubeJS: 커스텀 레시피와 스크립트
프로그래밍 없이 모드팩 레시피와 메커니즘 변경: KubeJS 스크립트 구조, 리로드, 일반적인 실수를 다룹니다.
업데이트 2026년 8월 13일
KubeJS를 사용하면 스크립트로 모드팩을 변경할 수 있어요. 레시피를 제거하거나 추가하고, 드롭을 바꾸고, 이벤트를 연결할 수 있죠. 모드팩 밸런스를 맞추는 표준적인 방법이에요.
구조
kubejs/
server_scripts/ recipes, drops, server events
client_scripts/ tooltips, interface
startup_scripts/ item and block registration
호스팅에서는 서버 스크립트가 필요해요.
예시
ServerEvents.recipes(event => {
event.remove({ output: 'minecraft:diamond_block' })
event.shaped('4x minecraft:stick', [
'P',
'P'
], { P: 'minecraft:oak_planks' })
})
리로드
/kubejs reload server_scripts
레시피는 재시작 없이 적용돼요. 시작 스크립트는 완전한 재시작이 필요해요.
오류
스크립트 오류는 일반 로그뿐만 아니라 logs/kubejs/server.txt에도 기록돼요. 먼저 이곳을 확인하세요. 서버는 여전히 시작되지만, 변경 사항이 적용되지 않을 뿐이에요.
주의
- 스크립트는 서버에서 전체 권한으로 실행돼요. 다른 사람의 스크립트를 확인하지 않고 복사하지 마세요.
- 모드팩 퀘스트 체인에서 사용되는 레시피를 제거하면 플레이어의 진행이 망가져요.
- 매 틱 또는 매 블록마다 발생하는 이벤트는 TPS를 쉽게 떨어뜨려요. — 모드 서버 최적화.
Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기
