Introdução ao Portal: criações avançadas usando a Ferramenta SDK do Portal e o Editor de Regras

Sua visão, nossa Ferramenta SDK do Portal, infinitas possibilidades de Experiência da Comunidade.

Pela primeira vez na história da franquia Battlefield, estamos expondo oficialmente os mecanismos internos do nosso jogo e permitindo que vocês, a comunidade, usem um Kit de Desenvolvedor de Software (SDK) e criem as experiências que querem jogar. Vimos o incrível trabalho que vocês fizeram com Battlefield 2042 e nossa primeira iteração do Portal; com a Ferramenta SDK do Portal e sua capacidade de editar mapas, além de adições ao Editor de Regras no Construtor do Portal, não podemos entender o que está por vir.

Dito isto, não vamos chegar ao ponto de oferecer um curso universitário de verdade, de nível de graduação e com duração de um semestre, para cobrir cada detalhe mínimo da Ferramenta SDK e dos conceitos de design de jogos. Em vez disso, este guia detalha uma experiência inicial com a ferramenta para uma Experiência Personalizada, desde a exportação do seu mapa personalizado para a Ferramenta de Construção do Portal até o uso do Editor de Regras:

Instalando a Ferramenta SDK do Portal

Ao contrário da Ferramenta de Construção do Portal, disponível no site da EA, o software Ferramenta SDK do Portal precisa ser baixado em um PC Windows para ser usado. O SDK do Portal inclui todos os arquivos necessários para usar as ferramentas de edição do jogo Godot em edições espaciais nos níveis do jogo, além de scripts de exemplo para você começar a criar suas próprias regras personalizadas. 

É possível baixar a ferramenta clicando aqui. É o mesmo link de download que o fornecido no site do Construtor do Portal.

Não recomendamos nem apoiamos o download de nenhuma versão da Ferramenta SDK do Portal fora do site oficial EA.com. Isso pode resultar em graves problemas relacionados à segurança para o seu PC. Faça o download apenas da Ferramenta SDK do Portal, bem como de suas atualizações, de EA.com

Após baixar a ferramenta, abra o arquivo ReadMe (Leia-me) para concluir a instalação. Em seguida, abra-a para acompanhar este primeiro passo a passo da Ferramenta SDK do Portal.  

Ferramenta SDK do Portal - Um breve guia para edição de mapas

Acima: um exemplo de mapa personalizado criado com a Ferramenta SDK do Portal.

Primeiro, passe o mouse sobre "Cena" no canto superior esquerdo do aplicativo; clique e selecione "Cena Aberta" no menu suspenso. Abra a pasta "níveis" para ver os nomes de todos os mapas disponíveis para editar e, em seguida, escolha o mapa que deseja editar.

Provavelmente, você estará abaixo da área jogável do mapa. Dentro da janela central que mostra o ambiente 3D digital, essas são suas principais ferramentas para movimentar o espaço:

• Mira da câmera ou "olhando"- Clique com o botão direito, mantenha pressionado e arraste o cursor do mouse para apontar a câmera.
• Movimento - Teclas W, A, S, D para se mover bidimensionalmente (para frente, para trás, esquerda e direita) e a barra de espaço para se mover "Para cima", que é sempre +90 graus de onde você está olhando.
• Aumentar ou diminuir a velocidade de movimento - Role com a roda do mouse; frente acelera, trás desacelera.

Ao abrir um nível, todos os objetos, prédios, peças de cobertura, estradas e muito mais, estão na posição-padrão, como seria em qualquer experiência regular e verificada de Battlefield 6. A Ferramenta SDK do Portal é usada para realizar modificações aditivas; há certos objetos, como o terreno e as principais construções, que não podem ser removidos.

Na parte inferior da tela fica a sua Biblioteca de Objetos. Expanda-a e clique nas reticências (...) ao lado da função de busca da biblioteca em "Gerar Biblioteca". É assim que se ganha mais detalhes sobre todos os objetos que podem ser colocados no mapa. Agora você pode arrastar e soltar esses objetos no mapa. Observação: caso já tenha executado a Configuração do Portal, este passo não é necessário.

Pressione "Q" para entrar no Modo Seleção, sua forma principal de escolher um objeto para manipulação ou movimento, depois aperte "W" para mover o objeto no mapa. Enquanto um objeto estiver selecionado, você também pode pressionar "E" para entrar no Modo Rotação, usando as teclas WASD para girar o objeto na direção desejada. Se quiser aumentar ou diminuir um objeto, olhe para o lado direito do avião 3D para ver uma Janela do Inspetor, onde você pode deixar o objeto maior ou menor de maneira uniforme. O dimensionamento não uniforme de objetos não é permitido no momento.

Exportação e upload de um nível para a Ferramenta de Construção do Portal

Quer fazer uma pausa e concluir sua criação mais tarde? Clique na aba "Cena" no canto superior esquerdo do aplicativo e clique em "Salvar Cena" para garantir que seu progresso seja salvo.

Quando estiver pronto para publicar sua criação, procure o botão "Exportar Nível Atual" na janela inferior direita ("BFPortal"). Clique nele e clique em "Abrir Exportações" na mesma janela para ver sua criação. Este arquivo JSON é o que você enviará por upload para a Ferramenta de Construção do Portal no seu navegador escolhido.

Entre novamente na Ferramenta de Construção do Portal, caso ainda não tenha feito login, e selecione um modelo existente para modificá-lo ou prosseguir com o processo de criação de uma nova experiência.

Selecione a aba "Rotação dos Mapas" e você verá a opção para anexar seu arquivo .JSON; o ícone parece uma seta apontando para um colchete aberto. Localize o arquivo na janela do Explorador de Arquivos que aparece, selecione-o e clique em abrir. Agora você verá seu nível de exportação na Ferramenta de Construção do Portal!

Editor de Regras na Ferramenta de Construção do Portal: edição de interface e scripts de IA

O recurso mais avançado do Construtor do Portal Web é o Editor de Regras, que só está disponível apenas para Experiências da Comunidade Personalizadas. Semelhante ao funcionamento em Battlefield 2042, mas com novos comandos, o Editor de Regras baseado em lógica permite vincular eventos e condições no jogo, como a morte de um jogador ou distância de um quartel-general, para desencadear ações específicas.

Um exemplo de "regra" é o que acontece quando você captura um objetivo em Conquista. Pense na entrada em uma área de objetivo: o que acontece a seguir? Primeiro, ao entrar em uma área de objetivo (evento ou condição), uma roda de progresso aparece (ação) e uma fala diz que você está capturando o objetivo (outra ação). Após um tempo predefinido (uma condição), a área de objetivo é capturada (ação). Então, como a área de objetivo está sob o controle da sua equipe (condição), você ganha pontos (ação recorrente).

Simples? O Editor de Regras tem mais de 200 ações para implementar uma quantidade incalculável de combinações de script, com e sem bots. Assim como as outras abas do Editor de Regras, há dicas de ferramenta para seguir; basta clicar com o botão direito em um bloco dentro do Editor de Regras e clicar em "Ajuda" para obter mais informações.

Scripts da IA

Assim como uma regra padrão, os Comportamentos de IA têm Blocos de Ação e Condições próprios que modificam seu movimento, lógica de combate e muito mais.

Para scripts de IA mais complexos ou modos mais complexos, recomenda-se que os criadores usem o TypeScript. Aqui está um exemplo de script de movimento simples da IA:

[[OBSERVAÇÃO: como o TypeScript é escrito em inglês, todos os códigos de exemplo estão em inglês. Se você não estiver recebendo os resultados pretendidos devido a possíveis conflitos com outros códigos em seu script, talvez seja necessário ajustar o código exato que está sendo usado.]]

//Isso gera uma unidade de IA scriptável. função OnGameStarted() {
mod.SpawnAIFromAISpawner(mod.GetSpawner(1), mod.GetTeam(1)); }

//Este é um comportamento simples de "Seguir" que fará com que a IA fique e ande até o local de outro jogador. async function simpleAIFollowBehavior(player: mod.Player, target: mod.Player) {

//Define a postura do Jogador da IA para De Pé.
mod.AISetStance(player, mod.Stance.Stand);

//Define a velocidade de movimento do Jogador da IA para Andar. 
mod.AISetMoveSpeed(player, mod.MoveSpeed.Walk);

//Enquanto essa IA e o Jogador-Alvo estiverem vivos, execute este loop que diz à IA para ir para a localização do jogador-alvo. 
while (mod.GetSoldierState(player, mod.SoldierStateBool.IsAlive) == true && mod.GetSoldierState(target, mod.SoldierStateBool.IsAlive) == true) {

    //Chama o AIMoveToBehavior no jogador Bot da IA e o faz se mover para a localização do jogador-alvo.
    mod.AIMoveToBehavior(player, mod.GetSoldierState(target, mod.SoldierStateVector.GetPosition));

    //Espera 1 s. 
    await mod.Wait(1);
}

}

Além deste script de amostra, vamos deixar o resto com você. Não existe jeito certo de aprender a desenvolver jogos. Você pode fazer cursos de design e código para jogos, ou aprender por meio de experiência e vários fóruns na internet, o importante é que temos certeza de que você conseguirá criar uma incrível Experiência Personalizada.

Dicas rápidas dos desenvolvedores - Ferramenta SDK do Portal e scripts

1. Faça parte da comunidade de desenvolvedores. Como qualquer comunidade de arte, o desenvolvimento de jogo é melhor quando se interage positivamente com outros criadores. Embora este guia seja um ótimo ponto de lançamento para editar mapas, o melhor conhecimento vem de colegas desenvolvedores com mais experiência. Participe da comunidade de desenvolvimento do Battlefield Portal, no Discord oficial, por exemplo, e não tenha medo de fazer perguntas!

2. Verifique a lógica (e os acessórios). Quando uma Regra do Editor de Regras não funciona, as duas razões mais comuns são: um dos Blocos (uma Regra, Condição ou Ação) pode não estar vinculado ao Bloco do Mod, ou a lógica da sua Regra é impossível, como uma Condição verdadeira atribuída a dois valores contraditórios. Sempre verifique várias vezes antes de testar uma Experiência Personalizada.

3. Experimente. Teste. Solte a imaginação. 99,9% das vezes, seu primeiro mapa personalizado, ou IA com script, não funcionará exatamente como esperado. Não desanime. Continue editando e testando até sua experiência ficar exatamente como você imaginou.

4. Crie para a comunidade. O design de jogo costuma fazer referências à "experiência do usuário", ou UX; existem cursos universitários inteiros focados apenas neste conceito, mas, em termos mais simples, trata-se de como seus jogadores se sentem quando jogam sua Experiência Personalizada. Testes de UX podem ser simples, como pedir a um amigo, parente ou colega de comunidade para jogar sua Experiência Personalizada. Convide outras pessoas para jogar, anote o que é difícil de entender, o que impede a diversão, e tome isso em consideração no desenvolvimento do seu produto final.