Pausando jogos e modo de processo¶

Introdução¶

Na maioria dos jogos é desejável, em algum momento, interromper o jogo para fazer algo mais, como fazer uma pausa ou mudar as opções. Implementar um controle refinado para o que pode ser pausado (e o que não pode) é muito trabalhoso, portanto, uma estrutura simples para pausar é fornecida no Godot.

Como a pausa funciona¶

Para pausar o jogo, o estado de pausa deve ser definido. Isto é feito atribuindo true à propriedade SceneTree.paused:

get_tree().paused = true

GetTree().Paused = true;

Doing this will cause two things. First, 2D and 3D physics will be stopped for all nodes. Second, the behavior of certain nodes will stop or start depending on their process mode.

Nota

The physics servers can be made active while the game is paused by using their set_active methods.

Modos de processo¶

Each node in Godot has a "Pause Mode" that defines when it processes. It can be found and changed under a node's Node properties in the inspector.

Você também pode alterar a propriedade com o código:

func _ready():
    pause_mode = Node.PAUSE_MODE_PROCESS

public override void _Ready()
{
    PauseMode = Node.PauseModeEnum.Process;
}

This is what each mode tells a node to do:

Herdar: Processa dependendo do estado do pai, avô, etc. O primeiro pai que tem um estado não Inherit.
Stop: Para o nó não importa o que aconteça (e filhos no modo Inherit). Quando pausado, este nó não será processado.
Process: Processa o nó independentemente do que aconteça (e os filhos no modo Inherit). Pausado ou não, este nó será processado.

Por padrão, todos os nós têm esta propriedade no estado "Herdar". Se o pai estiver configurado para "Herdar", então o avô será verificado e assim por diante. Se um estado não puder ser encontrado em nenhum dos avós, o estado de pausa no SceneTree é usado. Isto significa que, por padrão, quando o jogo for pausado, todos os nós serão pausados. Várias coisas acontecem quando um nó pára de processar.

The _process, _physics_process, _input, and _input_event functions will not be called. However signals still work and cause their connected function to run, even if that function's script is attached to a node that has its pause mode set to "Stop".

Animation nodes will pause their current animation, audio nodes will pause their current audio stream, and particles will pause. These resume automatically when the game is no longer paused.

It is important to note that even if a node is processing while the game is paused physics will NOT work for it by default. As stated earlier this is because the physics servers are turned off. The physics servers can be made active while the game is paused by using their set_active methods.

Exemplo de Menu de Pausa¶

Aqui está um exemplo de um menu de pausa. Crie um popup ou painel com controles dentro, e defina seu modo de pausa para "Process" e depois o esconda. Ao definir a raiz do popup de pausa para "Process", todos os filhos e netos herdarão esse estado. Desta forma, este ramo da árvore da cena continuará funcionando quando pausado.

Finalmente, faça isso quando um botão de pausa for pressionado (qualquer botão serve), habilite a pausa e mostre a tela de pausa.

func _on_pause_button_pressed():
    get_tree().paused = true
    $pause_popup.show()

public void _on_pause_button_pressed()
{
    GetTree().Paused = true;
    GetNode<Control>("pause_popup").Show();
}

Para despausar, faça o oposto quando a tela de pausa estiver fechada:

func _on_pause_popup_close_pressed():
    $pause_popup.hide()
    get_tree().paused = false

public void _on_pause_popup_close_pressed()
{
    GetNode<Control>("pause_popup").Hide();
    GetTree().Paused = false;
}