Tutorial
Este tutorial leva cerca de dez minutos. Você precisa do Turian e do SDK do .NET 10 instalados.
1. Crie um projeto
Abra o Turian Studio, escolha File → New Project…, selecione uma pasta e chame o projeto de HelloTurian. Ou, no terminal:
turian-cli new HelloTurian
turian-studio --project HelloTurian
O projeto novo contém uma cena inicial, Assets/scene-01.prefab, com uma Camera, uma Light e uma Box. Clique duas vezes nela no painel Assets para abri-la.
2. Conheça o ambiente
- Scene Tree (esquerda) — os nós da cena aberta.
- Scene / Game (centro) — a visão de edição da cena e o que a câmera do jogo vê.
- Inspector (direita) — o transform e os componentes do nó selecionado.
- Assets / Output (embaixo) — os arquivos do projeto e o log com erros de compilação.
Todo painel pode ser arrastado para outro lugar, empilhado em abas ou destacado; o Studio lembra o seu layout.
3. Mova algo
Clique em Box na Scene Tree. Na visualização Scene, pressione W para a ferramenta de mover e arraste uma seta, ou digite uma nova Position no Inspector. Segure o botão direito do mouse na visualização Scene e use W A S D para voar pela cena.
4. Escreva um script
Crie Assets/Spinner.cs no seu editor de código:
namespace Usercode;
public class Spinner : Component
{
/// <summary>Graus por segundo.</summary>
public float speed = 90f;
public override void OnUpdate(float deltaTime) =>
Node!.Transform.SetRotationY(Node.Transform.Rotation.Y + speed * deltaTime);
}
Salve. O Studio recompila em segundo plano; a barra de status mostra a tarefa e o painel Output informa o sucesso ou os erros.
5. Anexe o script
Selecione Box, clique em Add Component no Inspector e escolha Spinner — ou arraste Spinner.cs do painel Assets sobre Box. O Inspector agora mostra um campo speed. Salve a cena com Ctrl+S.
6. Execute
Pressione F5. A visualização Game executa a cena: a caixa gira. Pressione F5 de novo para parar — a cena volta exatamente ao que era, porque o Play Mode roda sobre uma cópia. F6 pausa e F10 avança um quadro.
7. Reaja à entrada
Faça a caixa girar só enquanto Espaço estiver pressionado:
public override void OnUpdate(float deltaTime)
{
if (!Input.IsKeyDown(Key.Space)) return;
Node!.Transform.SetRotationY(Node.Transform.Rotation.Y + speed * deltaTime);
}
Clique dentro da visualização Game para que ela receba o teclado e segure Espaço. Esc devolve o teclado ao Studio. Para controles remapeáveis e gamepads, veja Entrada.
8. Exporte o jogo
Escolha Project → Export, ou:
turian-cli export HelloTurian
O Turian compila o projeto em modo Release e grava um jogo autocontido em HelloTurian/Output/: um executável com o nome do projeto, os assets empacotados em Content/ e as configurações necessárias. Compacte essa pasta e compartilhe — os jogadores não precisam do .NET.
Project → Build & Run é o ciclo mais rápido durante o desenvolvimento: compila uma versão de depuração e a abre em sua própria janela.
Próximos passos
- Conceitos principais — o vocabulário em uma página.
- Programando seu jogo — ciclo de vida e o Inspector.
- Componentes — o modelo de componentes em detalhe.