Comando
/schedule
Executa uma função, ou todas as funções de uma tag de função, após um atraso, ou cancela uma função agendada.
Sintaxe
| /schedule clear <function> |
| /schedule function <function> <time> [(append|replace)] |
Argumentos
| Argumento | Tipo de valor | O que digitar |
|---|---|---|
| <function> | Id | Com schedule function: o id da função a executar, ou uma tag de função escrita com # na frente. Com schedule clear: o id da função agendada a cancelar. |
| <time> | Tempo | Quanto tempo esperar, contado a partir de agora. Um número com uma unidade opcional: t (tiques, padrão), s (segundos) ou d (dias do jogo). Precisa ser de pelo menos 1 tique. Pelo menos 0. |
Detalhes
| Nível de permissão | 2: operadores, mundos com trapaças ativadas, blocos de comando e funções |
| Funciona em | Um jogador com cheats ativados, servidores multijogador, blocos de comando e funções. Exige o nível de permissão 2 (mestres de jogo): operadores, jogadores em um mundo com trapaças ativadas, blocos de comando e funções. |
| Resultado | schedule function informa "Scheduled function ... in N tick(s) at gametime T" (ou "Scheduled tag ...") e retorna o tempo de jogo, em tiques, em que ela será executada. schedule clear informa "Removed N schedule(s) with ID ..." e retorna o número de agendamentos removidos. |
| Unidades de tempo | O tempo é um número seguido de uma unidade: t para tiques (também o padrão quando nenhuma unidade é escrita), s para segundos (20 tiques) e d para dias do jogo (24000 tiques). Decimais são permitidos e arredondados para tiques inteiros, por exemplo 1.5s são 30 tiques. |
| Sem atraso zero | Um tempo de 0 falha com "Você não pode programar no tique atual". O menor atraso é de 1 tique. |
| replace e append | replace é o padrão: qualquer agendamento existente da mesma função ou tag é removido e só o novo permanece. append mantém os agendamentos existentes e adiciona outro, então a função pode rodar várias vezes. Dois agendamentos da mesma função para exatamente o mesmo número de tiques contam como um. |
| Tags de função | Escreva um # antes do id para agendar todas as funções de uma tag de função, por exemplo #mypack:waves. |
| Macros | Uma função que usa linhas de macro não pode ser agendada: "Você não pode programar uma macro". |
| clear | schedule clear remove todos os agendamentos pendentes do id de função informado. Se não houver nenhum, falha com “Nenhum agendamento com o ID ...”. O argumento é um id simples; ele não aceita a forma com #. |
| Os agendamentos são salvos | Agendamentos pendentes são guardados com o mundo e permanecem ao fechá-lo e abri-lo de novo. |
Exemplos
/schedule function mypack:start 5sExecuta a função mypack:start daqui a 5 segundos.
/schedule function mypack:tick_slow 100tExecuta a função daqui a 100 tiques (5 segundos), substituindo qualquer agendamento anterior dela.
/schedule function mypack:reminder 30s appendAdiciona outra execução em 30 segundos sem remover agendamentos que já existem.
/schedule function #mypack:waves 1d replaceExecuta todas as funções da tag mypack:waves daqui a um dia do jogo (20 minutos).
/schedule clear mypack:startCancela todas as execuções pendentes da função mypack:start.