API

차원

나만의 하늘, 지형, 바이옴을 가진 월드. 플레이어와 생물은 순간이동으로 그곳에 갑니다.

차원 선언하기

종류와 지형 모양을 지정해 선언합니다.

content/dimensions.craftCraftScript

dimension "ruby_realm" { kind: "overworld", terrain: "normal", biome: "ruby_meadow" }
dimension "flatland" { terrain: "flat" }

속성	값
`kind`	하늘, 빛, 규칙: `overworld`, `nether`, `end`
`terrain`	지형의 모양, 아래 참고
`biome`	선택 사항: 어디서나 하나의 바이옴. 모드의 것(`"ruby_meadow"`)이나 게임의 것(`"minecraft:cherry_grove"`) 모두 가능. 없으면 그 지형의 일반적인 바이옴

지형

지형	모양
`normal`	언덕, 동굴, 바다가 있는 오버월드 같은 지형
`flat`	평탄: 기반암, 흙, 풀
`nether`	용암 바다가 있는 닫힌 동굴 세계
`islands`	허공에 떠 있는 섬들

게임의 차원 모양 바꾸기

오버월드, 네더, 엔드도 자신만의 차원 없이 바꿀 수 있습니다. 모드는 그중 하나의 땅에 코드로 쓴 모양(terrain "minecraft:the_end" { … })을 줄 수 있고, 엔드에서 어느 곳에 어떤 바이옴을 둘지 고를 수 있습니다(biome_map "minecraft:the_end" { … }). 각 차원의 모양을 만들 수 있는 모드는 하나뿐이고, 바이옴을 고를 수 있는 모드도 하나뿐입니다. 둘 다 코드로 생성하기 페이지에서 설명합니다.

이동하기

플레이어와 생물은 차원 안의 위치로 순간이동해서 이동합니다. 그 월드는 ID <모드 id>:<이름>으로 얻습니다. 도착하면 목적지 청크가 로드됩니다.

이벤트에서도 같은 방식으로 할 수 있습니다. 예를 들어 아이템을 사용할 때입니다. 좋은 예는 플레이어를 그곳으로 보냈다가 다시 돌려보내는 /realm 명령어입니다.

commands/realm.craftCraftScript

command realm describe "Travel to the Ruby Realm and back" {
    if player == null { return "Players only" }
    let realm = world("rubies:ruby_realm")
    if player.world.id == realm.id {
        player.teleport(world().block_at(0, 100, 0).location)
        return "Back home"
    }
    player.teleport(realm.block_at(0, 100, 0).location)
    return "Welcome to the Ruby Realm"
}

Kotlin에서

content/Dimensions.ktKotlin

dimension("ruby_realm") {
    kind = DimensionKind.OVERWORLD
    terrain = Terrain.NORMAL
    biome = "ruby_meadow"
}

dimension("flatland") { terrain = Terrain.FLAT }

entity.teleport(location)에 그 월드의 위치를 넘겨 이동합니다.