Como usar Geradores de PNJs no Unreal Editor para Fortnite | Unreal Editor para Fortnite Documentação

Esta funcionalidade está em Acesso Antecipado. ocê pode publicar uma ilha com essa funcionalidade, mas lembre-se de que, durante o período de Acesso Antecipado, alterações poderão danificar sua ilha e exigir sua intervenção ativa.

Com o Gerador de PNJs, você pode criar criaturas únicas, inimigos e muito outros personagens com funções envolventes que dão vida ao seu jogo. Esses personagens não jogáveis (PNJs) podem ter vida, patrulhar caminhos definidos e até mesmo ajudar os jogadores a resolver quebra-cabeças. Use esse dispositivo para atribuir scripts e definições de personagem PNJ que possam ser reutilizados em vários níveis.

Inclua PNJs, personagens com inteligência artificial (IA), no seu jogo para adicionar uma camada extra de imersão. Você pode personalizá-los para realizar uma variedade de ações, desde ressuscitar companheiros de equipe até seguir jogadores e executar ações.

O Gerador de PNJs é diferente do dispositivo Personagem. Com o Gerador de PNJs você pode implementar configurações personalizadas que alteram a aparência, os movimentos e o comportamento de um personagem.

O dispositivo Personagem, assim como o Gerador de Guardas é ótimo para uma instância singular de um personagem básico. No entanto, ambos estão limitados aos revestimentos do Fortnite. O Gerador de PNJs pode criar instâncias de personagens com revestimentos do Fortnite ou revestimentos importados pelo usuário e até mesmo animais selvagens.

Modifique as configurações desse dispositivo para criar personagens personalizados com tempos de surgimento definidos. Essas configurações também permitem a definição de Blueprints de personagens para modificar ainda mais elementos cosméticos, animações, comportamentos e muito outros elementos.

Atualmente, este é um dispositivo exclusivo para o Unreal Editor para Fortnite (UEFN), localizado em Todos > Fortnite > Dispositivos > !Acesso Antecipado > Gerador de PNJs.

Filtro contextual

Alguns dispositivos são afetados por uma funcionalidade chamada filtro contextual. Essa funcionalidade realça ou sombreia opções dependendo dos valores selecionados para determinadas opções relacionadas. Ela também remove itens desnecessários do painel Detalhes e facilita o gerenciamento e a navegação pelas opções.

Opções do usuário

Por meio dessas configurações, você pode controlar as condições de surgimento desse dispositivo, fazer referência a definições de personagens e designar funções e eventos.

Os valores padrão estão em negrito. Os valores que acionam o filtro contextual estão em itálico.

Opção	Valor	Descrição
Limite de geração	1, Digitar um valor	Define o número de PNJs que esse gerador pode ter ativos em determinados momentos. Quando o gerador for ativado, ele produzirá um PNJ por vez.
Geração através de paredes	True, False	Determina se o PNJ deve surgir na linha de visão do gerador ou se ele pode aparecer atrás de paredes obstrutivas.
Geração de personagem no início do jogo	True, False	Determina se o gerador já está habilitado quando o jogo começa para gerar PNJs. Defina como "False" para ter um personagem animado.
Substituição de script de comportamento de PNJ	Nenhum, Selecione um script	Substitui o comportamento padrão ou atribuído da definição de personagem PNJ atribuída a esse dispositivo.
Definição de Personagem PNJ	CharacterDefinition_Default, Selecione uma definição de personagem	Determina a definição de personagem PNJ que será usada para gerar o PNJ. A configuração padrão é um ponto de partida não modificável e um placeholder para configurações básicas.
Modificadores adicionais de personagens PNJ	Adicionar um elemento de matriz	Adiciona uma lista extra de modificadores que serão usados para gerar o PNJ. Mais modificadores podem ser adicionados por meio de Definições de Personagens. Os modificadores atribuídos ao dispositivo substituirão os modificadores atribuídos na Definição de Personagem. Acesse o documento Definições de Personagem para saber mais sobre os modificadores.
Índice	Modificador Cosmético	As configurações abaixo modificarão os elementos cosméticos do PNJ. Algumas configurações abaixo possuem filtragem contextual e só podem ser escolhidas com configurações compatíveis. Cada tipo de personagem possui diferentes opções de propriedades.
Aparência do Personagem	Personagem do Fortnite, Personagem Personalizado	Determina se um personagem do Fortnite será gerado a partir dos elementos cosméticos disponíveis no campo Cosmético de Personagem ou se será gerado um Personagem Personalizado definido por meio de um Blueprint de ator criado pelo usuário. Você pode escolher entre 150 elementos cosméticos do Fortnite.
Cosmético de Personagem	Jonesy, Selecione um elemento cosmético de personagem	Define o elemento cosmético do personagem.
Blueprint de Personagem	Nenhum, Selecione um Blueprint de personagem	Define o Blueprint de personagem.
Movimento do Personagem	Movimento Padrão, Redirecionar a partir do personagem do Fortnite, Predefinição de animação	Define o movimento do PNJ.
Permitir Geração Infinita	True, False	Determina se o gerador tem um limite total de geração.
Limite Total de Geração	1, Digite um valor	Define o número máximo de IAs que esse gerador pode produzir durante sua vida útil.
Gerar com Temporizador	True, False	Determina se a IA é gerada na contagem regressiva do temporizador de surgimento ou se é em eventos.
Temporizador de Surgimento	3,0s, Digite um valor	Define o tempo mínimo entre a geração de IAs.
Mostrar Raio de Surgimento	True, False	Determina se o raio de surgimento será mostrado.
Raio de Surgimento	1,0m, Digite um valor	Define a distância máxima do dispositivo que a IA pode gerar.
Remover IAs quando Desabilitado	True, False	Quando o dispositivo está desabilitado, este valor determina se as IAs permanecem geradas ou se são removidas.

Vinculação direta de eventos

Veja a seguir opções de vinculação direta de eventos para esse dispositivo.

Funções

Uma função escuta um evento em um dispositivo e depois executa uma ação.

Para qualquer função, clique na opção e em Selecionar dispositivo para acessar e selecionar no menu suspenso Dispositivo.
Depois de selecionar um dispositivo, clique em Selecionar evento para vincular esse dispositivo a um evento que acionará a função dele.
Se mais de um dispositivo ou evento acionar uma função, pressione o botão Adicionar para adicionar uma linha e repita essas etapas.

Opção	Descrição
Habilitar	Habilita esse dispositivo quando ocorre um evento.
Desabilitar	Desabilita esse dispositivo quando ocorre um evento.
Gerar	Gera uma IA nesse dispositivo quando ocorre um evento.
Remover	Remove a IA nesse dispositivo quando ocorre um evento.
Reiniciar Limite Total de Geração	Redefine a contagem do Limite Total de Geração quando ocorre um evento.

Eventos

A vinculação direta de eventos usa eventos como transmissores. Um evento instrui outro dispositivo a executar uma função.

Para qualquer opção de evento, clique na opção e depois em Selecionar dispositivo para acessar e selecionar no menu suspenso Dispositivo.
Depois de selecionar um dispositivo, clique em Selecionar função para vincular o temporizador a uma função desse dispositivo.
Se mais de uma função for acionada pelo evento, pressione o botão Adicionar e repita o processo.

Opção	Descrição
Ao Gerar	Envia um evento para um dispositivo vinculado quando um jogador interage com o botão.
Ao Eliminar	Envia um evento para um dispositivo vinculado quando um jogador interage com o botão.

Usar o Gerador de PNJs em Verse

Você pode usar o código abaixo para controlar um dispositivo Gerador de PNJs em Verse. Esse código usa todas as funcionalidades da API do dispositivo Gerador de PNJs. Modifique-o para atender às necessidades da sua experiência.

using { /Fortnite.com/AI }
using { /Fortnite.com/Characters }
using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }


# Acesse [este link](https://dev.epicgames.com/documentation/pt-br/uefn/create-your-own-device-in-verse) para criar um dispositivo Verse.


# Um dispositivo do Modo Criativo criado com Verse que pode ser colocado em um nível.
npc_spawner_device_example := class(creative_device):


    # Referência ao Gerador de PNJs no nível.
    # No painel Detalhes desse dispositivo Verse,
    # Defina essa propriedade no seu Gerador de PNJs.
    @editable
    MyNPCSpawnerDevice:npc_spawner_device = npc_spawner_device{}


    # É executado quando o dispositivo é iniciado em um jogo em execução.
    OnBegin<override>()<suspends>:void=


        # Exemplo de inscrição em um evento no dispositivo do Modo Criativo.
        # Sinalizado quando um personagem é gerado a partir do Gerador de PNJs.
        # Envia o personagem `agent` que foi gerado.
        MyNPCSpawnerDevice.SpawnedEvent.Subscribe(OnCharacterSpawned)


        # Sinalizado quando um personagem gerado a partir do Gerador de PNJs é
        # eliminado. Envia um "device_ai_interaction_result" do agente que eliminou
        # o personagem e
        MyNPCSpawnerDevice.EliminatedEvent.Subscribe(OnCharacterEliminated)


        # gera um personagem no Gerador de PNJs.
        MyNPCSpawnerDevice.Spawn()


        Sleep(15.0)


        # Elimina todas as criaturas geradas por esse dispositivo.
        MyNPCSpawnerDevice.DespawnAll(false)


    # Essa função é executada quando um personagem é gerado no Gerador de PNJs
    # porque é um manipulador de eventos para SpawnedEvent.
    OnCharacterSpawned(SpawnedAgent:agent):void=


        Print("Um personagem acabou de ser gerado neste dispositivo.")


        # Quando um personagem surgir, faça com que ele se concentre no primeiro jogador na área de jogo
        if:
            FortCharacter := SpawnedAgent.GetFortCharacter[]
            FocusInterface := FortCharacter.GetFocusInterface[]
            PlayerToFocus := GetPlayspace().GetPlayers()[0]
        then:
            spawn{FocusInterface.MaintainFocus(PlayerToFocus)}


    # Essa função é executada quando um personagem gerado no Gerador de PNJs
    # é eliminado, porque é um manipulador de eventos para EliminatedEvent.
    OnCharacterEliminated(AIInteractionResult:device_ai_interaction_result):void=


        # `Source` é o `agent` que eliminou a criatura.
        # Se a criatura tiver sido eliminada por um não-agente, `Source` será 'false'.
        # `Target` é a criatura que foi eliminada.
        if(AIInteractionResult.Source?):
            Print("O personagem foi eliminado por outro agente.")
        else:
            Print("O personagem não foi eliminado por outro agente.")

using { /Fortnite.com/AI }
using { /Fortnite.com/Characters }
using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

# Acesse [este link](https://dev.epicgames.com/documentation/pt-br/uefn/create-your-own-device-in-verse) para criar um dispositivo Verse.

# Um dispositivo do Modo Criativo criado com Verse que pode ser colocado em um nível.
npc_spawner_device_example := class(creative_device):

# Referência ao Gerador de PNJs no nível.
    # No painel Detalhes desse dispositivo Verse,
    # Defina essa propriedade no seu Gerador de PNJs.
    @editable
    MyNPCSpawnerDevice:npc_spawner_device = npc_spawner_device{}

# É executado quando o dispositivo é iniciado em um jogo em execução.
    OnBegin<override>()<suspends>:void=

# Exemplo de inscrição em um evento no dispositivo do Modo Criativo.
        # Sinalizado quando um personagem é gerado a partir do Gerador de PNJs.
        # Envia o personagem `agent` que foi gerado.
        MyNPCSpawnerDevice.SpawnedEvent.Subscribe(OnCharacterSpawned)

# Sinalizado quando um personagem gerado a partir do Gerador de PNJs é
        # eliminado. Envia um "device_ai_interaction_result" do agente que eliminou
        # o personagem e
        MyNPCSpawnerDevice.EliminatedEvent.Subscribe(OnCharacterEliminated)

# gera um personagem no Gerador de PNJs.
        MyNPCSpawnerDevice.Spawn()

Sleep(15.0)

# Elimina todas as criaturas geradas por esse dispositivo.
        MyNPCSpawnerDevice.DespawnAll(false)

# Essa função é executada quando um personagem é gerado no Gerador de PNJs
    # porque é um manipulador de eventos para SpawnedEvent.
    OnCharacterSpawned(SpawnedAgent:agent):void=

Print("Um personagem acabou de ser gerado neste dispositivo.")

# Quando um personagem surgir, faça com que ele se concentre no primeiro jogador na área de jogo
        if:
            FortCharacter := SpawnedAgent.GetFortCharacter[]
            FocusInterface := FortCharacter.GetFocusInterface[]
            PlayerToFocus := GetPlayspace().GetPlayers()[0]
        then:
            spawn{FocusInterface.MaintainFocus(PlayerToFocus)}

# Essa função é executada quando um personagem gerado no Gerador de PNJs
    # é eliminado, porque é um manipulador de eventos para EliminatedEvent.
    OnCharacterEliminated(AIInteractionResult:device_ai_interaction_result):void=

# `Source` é o `agent` que eliminou a criatura.
        # Se a criatura tiver sido eliminada por um não-agente, `Source` será 'false'.
        # `Target` é a criatura que foi eliminada.
        if(AIInteractionResult.Source?):
            Print("O personagem foi eliminado por outro agente.")
        else:
            Print("O personagem não foi eliminado por outro agente.")

Para usar esse código com a sua experiência no UEFN, siga estas etapas.

Arraste um Gerador de PNJs até sua ilha.
Crie um novo dispositivo Verse chamado npc_spawner_device_verse_example. Consulte Criar o próprio dispositivo usando Verse para conhecer as etapas.
No Visual Studio Code, abra npc_spawner_device_verse_example.verse no Visual Studio Code e cole o código acima.
Compile o código e arraste o dispositivo criado com Verse até a ilha. Consulte Como adicionar um dispositivo Verse ao seu nível para conhecer as etapas.
Selecione seu dispositivo Verse no Organizador.
No painel Detalhes do dispositivo, atribua a referência do objeto do Gerador de PNJs ao dispositivo na sua ilha. Você pode usar o conta-gotas para selecionar o dispositivo na janela de visualização ou o menu suspenso para procurar o dispositivo.
Salve o projeto e clique em Iniciar Sessão.

API do Gerador de PNJs

Consulte a referência da API npc_spawner_device para obter mais informações sobre como usar o Gerador de PNJs em Verse.