Use a conta correta
Use a mesma conta verificada que possui os créditos e as gerações anteriores. O histórico é separado por conta.
MANUAL DO FOLOSA BRIDGE
Da ideia no Folosa ao Actor pronto no Foundry.
O fluxo completo para Game Masters: instalar o módulo, conectar a conta com segurança, escolher um dos três modos, acompanhar a renderização, importar gerações novas ou antigas e resolver problemas.
- Foundry
- V13 ou superior; V14 verificado
- Acesso
- Permissão de Game Master
- Entradas
- Build, Prompt ou Upload
- Entrega
- WebM + PNG verificados como Actors
1. Antes de começar
Confirme conta, arquivos, permissões e ambiente antes da instalação.
Entre como Game Master
Só um GM pode conectar, enviar tarefas pagas, gravar em Foundry Data e criar Actors.
Confira a versão
Use Foundry V13 ou superior; V14 está verificado. Atualize o módulo antes de investigar um cliente antigo.
Prepare uploads
PNG, JPG ou WebP, mínimo 300x300 px e máximo 10 MB. Prefira corpo inteiro centralizado com margem ao redor de membros e efeitos.
2. Instalar e ativar
Use o ZIP ou a URL do manifest quando aceita pelo gerenciador.
Faça backup
Crie um backup do mundo antes de instalar ou atualizar.
Instale o pacote
Baixe o ZIP. Instale pelo manifest ou extraia folosa-bridge em Data/modules.
Reinicie o Foundry
Reinicie o aplicativo ou servidor para carregar scripts e templates.
Ative no mundo
Abra Manage Modules, ative Folosa Bridge e salve.
Abra o painel
Como GM, escolha Folosa Bridge em Settings ou use Ctrl+B. Pode fechá-lo durante a renderização.
3. Conectar com segurança
Um código temporário cria uma credencial limitada e revogável; a senha nunca é digitada no Foundry.
Inicie
Connect Folosa abre a página de aprovação e mostra um código temporário.
Entre no Folosa
Faça login no navegador e confirme o e-mail antes de aprovar.
Aprove o dispositivo
Aprove apenas o cliente e mundo reconhecidos. O código expira e é de uso único.
Confira a conta
Aguarde Connected, e-mail, créditos e plano. O status é atualizado automaticamente.
Entenda os escopos
A credencial lê créditos, tarefas e ativos próprios, cria tarefas e checkout; não lê senha nem dados de outro usuário.
4. Escolher um dos três modos
Os modos correspondem às entradas do site, mas o Bridge envia uma tarefa por vez.
Build
Escolha linhagem, arquétipo, cenário e ação. O Bridge monta um prompt estruturado de corpo inteiro.
Prompt
Escreva até 800 caracteres com um sujeito, equipamento visível, ação e estilo.
Upload
Escolha uma imagem autorizada. Opcionalmente descreva movimento usando mãos ou armas já visíveis.
Não misture modos
Só o modo ativo é enviado; valores escondidos de outros modos são ignorados.
Escolha o estilo
Dark Fantasy, Anime e Ink mudam a direção; no upload a referência mantém a identidade.
Composição prática
Evite close com membros cortados. Em prompt, peça um corpo inteiro centralizado e silhueta clara.
5. Qualidade e créditos
A qualidade define a entrega e a reserva de créditos.
Standard VTT
80 CRD por token, WebM transparente 512p compacto para jogo ao vivo.
HD Pro
200 CRD por token, entrega 1080p mais nítida.
4K Master
280 CRD por token, saída de maior resolução para arquivo.
Reserva
Créditos são reservados ao aceitar e cobrados no sucesso. Falha de sistema confirmada libera a reserva. Não reenvie só porque levou minutos.
6. Enviar, esperar, atualizar ou cancelar
A lista de tarefas é a fonte de verdade. Um único Refresh atualiza conta e histórico.
Revise
Confira modo, imagem ou prompt, estilo, qualidade e saldo.
Crie uma vez
Clique Create token uma vez. A chave de idempotência protege a submissão aceita.
Leia o status
Queued aguarda; Processing trabalha; Completed está pronto; Partial failed possui ao menos um resultado.
Continue trabalhando
Pode fechar o painel. O servidor continua e o Bridge verifica a cada dez segundos.
Cancele só quando oferecido
Cancel aparece apenas antes da tarefa queued ser assumida. Depois do início, aguarde.
Importante: depois que um provedor externo assume a tarefa, ela não pode ser cancelada com segurança. Só uma tarefa ainda não assumida na fila pode ser cancelada.
7. Usar gerações novas e antigas
A lista mostra as 50 tarefas mais recentes da conta, inclusive do Forge web.
Veja a origem
Foundry foi criada no Bridge; Website foi criada em folosa.com.
Importação automática
Só tarefas novas do Bridge entram automaticamente; o histórico web nunca é importado em massa.
Importação manual
Import verifica tamanho e SHA-256, envia os arquivos para Foundry Data e cria Actors.
Abra o Actor
Open Actor abre o Actor importado para reutilização em Scenes.
Restaure um Actor apagado
Após Refresh, Import volta a aparecer sem nova geração ou cobrança.
8. Usar o Actor na mesa
Os arquivos ficam em uma pasta por tarefa e a animação fica separada do retrato.
Localize arquivos
Data/folosa/tokens/<job-id>. Não mova enquanto os Actors usam os caminhos.
Inspecione
Confira retrato PNG e Prototype Token WebM; complete os campos do sistema normalmente.
Teste em Scene
Arraste para uma Scene pequena e verifique transparência, loop, escala e desempenho.
Reutilize
Use o mesmo Actor em várias Scenes; duplique apenas para estatísticas diferentes.
9. Créditos, checkout e segurança
A conta abre por um handoff curto; a credencial não aparece na URL de pagamento.
Compre créditos
Credits abre conta e checkout. Confira e-mail e pacote; depois volte e use Refresh uma vez.
Gire a chave
Rotate key revoga e substitui uma credencial possivelmente exposta.
Desconecte
Disconnect revoga a credencial, sem apagar tarefas, ativos ou Actors.
Máquinas compartilhadas
Desconecte antes da troca de usuário. Nunca envie a credencial em chat, ticket, macro ou screenshot.
10. Solução de problemas
Siga a tabela em ordem e não reenvie antes de saber o estado da primeira tarefa.
| Sintoma | Verifique | Solução |
|---|---|---|
| Não conecta | Página de aprovação, e-mail e validade do código. | Inicie nova conexão e aprove o novo código. |
| 401 ou credencial inválida | Rotação, revogação ou cópia entre perfis. | Desconecte e conecte novamente; uma credencial por perfil. |
| Saldo antigo | Checkout concluído no mesmo e-mail. | Use Refresh uma vez e confira a transação na conta. |
| Queued por muito tempo | ID e horário; não crie cópia. | Aguarde ou cancele apenas se Cancel aparecer; depois use suporte. |
| Processing por minutos | O provedor está trabalhando. | Aguarde; fechar o painel é seguro, reenviar não. |
| Completed, mas Import falha | Permissão GM, escrita em Data, disco e console. | Corrija o armazenamento, Refresh e Import novamente sem cobrança. |
| Actor sem vídeo | Caminho WebM, suporte, pausa e hardware. | Confira no Actor, teste Scene pequena sem pausa e use Standard VTT. |
| Tarefa web antiga ausente | E-mail conectado e limite das 50 mais recentes. | Refresh; use o histórico da conta para registros mais antigos. |
11. Checklist antes da sessão
Aceitação rápida antes do jogo ao vivo.
Conta
E-mail correto conectado e saldo atualizado.
Tarefa
Completed ou Partial failed e apenas um envio.
Arquivos
Actor, retrato PNG e textura WebM funcionam.
Scene
Transparência, escala, loop e desempenho testados em dispositivo de jogador.
Suporte
Envie ID, horário, modo, qualidade, screenshot e descrição; nunca a credencial.