setOceanHole
Abre um buraco retangular no oceano: dentro dele o mar deixa de ser desenhado, e o jogo informa que não há água naquele ponto — então você pode construir e andar abaixo do nível do mar sem o oceano voltar a alagar.
Sintaxe
Seção intitulada “Sintaxe”bool setOceanHole ( )bool setOceanHole ( number minX, number minY, number maxX, number maxY [, bool furado = true ] )Parâmetros
Seção intitulada “Parâmetros”| Nome | Tipo | Padrão | Descrição |
|---|---|---|---|
minX, minY | number | — | Um canto do retângulo. |
maxX, maxY | number | — | O canto oposto. Os dois cantos podem ser passados em qualquer ordem. |
furado | bool | true | Se os blocos tocados pelo retângulo são furados (true) ou fechados de novo (false). |
O oceano é tratado em blocos de 500 × 500 unidades, o primeiro começando em -3000. O retângulo é arredondado para fora, para blocos inteiros: um buraco sempre cobre todos os blocos que ele toca, nunca parte de um. Os blocos fora do retângulo ficam como estavam — furados ou não — então os buracos se acumulam chamada por chamada. Sem argumentos, todos os buracos são fechados de uma vez.
A área aceita vai aproximadamente de -15000 a 12500 em cada eixo; um retângulo inteiramente fora dela é recusado.
A mudança vale para o servidor inteiro: ela chega a todos os jogadores conectados e é reaplicada em quem entrar depois. As superfícies de água criadas com createWater são elementos à parte, não fazem parte do oceano.
Retorno
Seção intitulada “Retorno”true quando a chamada foi aceita. false com um aviso quando falta um argumento ou ele é do tipo errado, quando as coordenadas não são finitas, ou quando o retângulo está inteiramente fora da área aceita.
Exemplo
Seção intitulada “Exemplo”-- dique seco: abre um retângulo abaixo do nível do mar para construirsetOceanHole(-400, -1500, 300, -1000)
-- fecha de novosetOceanHole(-400, -1500, 300, -1000, false)
-- limpa todos os buracos de uma vezsetOceanHole()