O editor

The editor

A tela de edição tem uma barra no topo, uma faixa de ferramentas, o palco (canvas) e painéis laterais.

The edit screen has a top bar, a toolbar, the stage (canvas) and side panels.

Tela de Projetos

Projects screen

Lista os projetos salvos. Criar pede um nome e um pacote (ex.: com.meujogo). Restaurar importa um backup .fish. Cada item pode ser aberto ou apagado (toque no ícone da lixeira e confirme).

Lists saved projects. Create asks for a name and a package (e.g. com.mygame). Restore imports a .fish backup. Each item can be opened or deleted (tap the trash icon and confirm).

Configurações

Settings

O ícone de engrenagem no topo da tela de Projetos abre as Configurações. Tudo fica salvo em Fish/settings.json.

The gear icon at the top of the Projects screen opens the Settings. Everything is saved in Fish/settings.json.

• Idioma — Português ou English: troca todo o editor, inclusive os nomes dos blocos.
• Cor de destaque — cor dos botões e das seleções.
• Tamanho da interface — aumenta ou diminui textos e ícones do editor.
• Mostrar grade / Tamanho da grade / Encaixar na grade — grade da cena e encaixe ao arrastar objetos.
• Confirmar antes de apagar — pede um segundo toque para apagar objetos, projetos e animações.
• Salvar automático — grava o projeto sozinho enquanto você edita.
• Backup automático — cria um .fish de segurança ao sair para a lista de projetos.
• Controles do jogo / Vibrar ao tocar — tamanho dos botões na tela e vibração.

• Language — Português or English: changes the whole editor, including block names.
• Accent color — color of buttons and selections.
• Interface size — makes the editor's text and icons bigger or smaller.
• Show grid / Grid size / Snap to grid — the scene grid and snapping while dragging.
• Confirm before deleting — asks for a second tap to delete objects, projects and animations.
• Autosave — saves the project by itself while you edit.
• Auto backup — creates a safety .fish when you return to the project list.
• Game controls / Vibrate on touch — on-screen control size and vibration.

O idioma só muda os nomes exibidos; os dois nomes de função Lua (português e inglês) funcionam sempre nos scripts.

The language only changes the displayed names; both Lua function names (Portuguese and English) always work in scripts.

Barra superior

Top bar

• Voltar — grava e volta para os projetos.
• Scripts — abre os blocos/Lua do objeto selecionado.
• Salvar — grava o projeto na pasta Fish.
• Backup — gera um arquivo <nome>.fish portátil.
• Executar / Parar — liga e desliga o jogo.

• Back — saves and returns to projects.
• Scripts — opens the selected object's blocks/Lua.
• Save — writes the project into the Fish folder.
• Backup — creates a portable <name>.fish file.
• Run / Stop — toggles the game.

Ferramentas

Tools

Desfazer/Refazer ficam ao lado: use os botões ou Ctrl+Z / Ctrl+Shift+Z.

Undo/Redo sit next to them: use the buttons or Ctrl+Z / Ctrl+Shift+Z.

Painel Cena

Scene panel

Lista os objetos em grupos (Sprites e Tilemaps), com busca por nome. + Sprite e + Tilemap criam objetos novos. O ícone da lixeira apaga o objeto.

Lists objects in groups (Sprites and Tilemaps), with search by name. + Sprite and + Tilemap create new objects. The trash icon deletes an object.

Painel Inspecionar

Inspect panel

• Nome e Camada — a camada define a ordem de desenho (menor desenha antes).
• Textura — toque para escolher uma imagem do projeto.
• Cor — cor de fundo quando não há imagem.
• Animação — toca uma animação automaticamente.
• Pos. X/Y, Largura, Altura, Rotação — transformações do objeto.
• Static — o objeto não cai nem se move pela física (fica parado no ar).
• Sólido — o objeto serve de chão para os outros. Um objeto Static + Sólido é uma plataforma; Static sem Sólido é uma moeda que flutua e pode ser atravessada.
• Espelhar — vira a imagem horizontalmente.

• Name and Layer — layer sets draw order (lower draws first).
• Texture — tap to pick an image from the project.
• Color — background color when there is no image.
• Animation — plays an animation automatically.
• Pos. X/Y, Width, Height, Rotation — the object transform.
• Static — the object does not fall or move via physics (it floats in place).
• Solid — the object acts as ground for the others. A Static + Solid object is a platform; Static without Solid is a coin that floats and can be passed through.
• Flip — mirrors the image horizontally.

Tilemap

Tilemap

Um tilemap usa uma imagem de tileset com grade quadrada. Selecione o tamanho do tile (ex.: 32), escolha o tile na paleta e pinte na cena. Células pintadas viram chão sólido por padrão.

A tilemap uses a tileset image with a square grid. Set the tile size (e.g. 32), pick a tile from the palette and paint on the scene. Painted cells become solid ground by default.

Arquivos do projeto

Project files

• Imagens — importe PNG/JPG/WEBP/GIF e toque em uma para usar no objeto selecionado.
• Animações — crie uma animação, defina FPS e Repetir, e monte os quadros tocando nas imagens. Há uma prévia ao vivo.
• Sons — importe MP3/OGG/WAV e toque para ouvir; use nos blocos de Áudio ou em Lua.

• Images — import PNG/JPG/WEBP/GIF and tap one to use it on the selected object.
• Animations — create an animation, set FPS and Loop, and build frames by tapping images. A live preview shows.
• Sounds — import MP3/OGG/WAV and tap to listen; use them in Audio blocks or Lua.

Mundo e câmera

World and camera

Sem nenhum objeto selecionado, o Inspetor mostra o Mundo (Largura × Altura). Aumente para criar fases maiores que a tela; no jogo, use o bloco "Seguir objeto" ou seguir("heroi") para a câmera acompanhar o jogador.

With no object selected, the Inspector shows the World (Width × Height). Increase it to build levels bigger than the screen; in-game, use the "Follow object" block or seguir("hero") so the camera tracks the player.

Executar e controles

Run and controls

Ao executar, aparecem os controles na tela (esquerda, direita, cima) e o teclado funciona no desktop. As teclas são lidas com tecla("direita") ou pelo bloco "Enquanto tecla".

When running, on-screen controls appear (left, right, up) and the keyboard works on desktop. Keys are read with tecla("direita") or the "While key" block.