Skip to content

Configuração de acesso

Use a propriedade access para controlar quais superfícies de jogo os usuários podem acessar e por que ficam bloqueados quando não podem.

Exemplo básico

js
MindtrainingPlatform.init('mindtraining', {
  access: {
    games: {
      crossword: {
        default: {
          playToday: true,
          playArchive: false,
          saveState: true,
          blockedReason: 'subscription_required',
        },
      },
      sudoku: {
        default: {
          playToday: true,
          playArchive: true,
          saveState: true,
        },
      },
    },
  },
})

Propriedades da política de acesso

Cada entrada de jogo tem uma política default e um mapa variants opcional para sobrescritas por variante.

PropriedadeTipoPadrãoDescrição
playTodaybooleantruePermite jogar o jogo de hoje
playArchivebooleantruePermite navegar pelo arquivo
saveStatebooleantruePermite salvar e retomar o progresso
blockedReasonstringMotivo exibido quando o acesso é negado (veja abaixo)
blockedReasonsobjectMotivos de bloqueio por superfície (sobrescreve blockedReason)
meterLimitobjectLimita o número de inícios de jogo em uma janela móvel
levelLimitobjectLimita o acesso acima de um determinado nível de dificuldade

Motivos de bloqueio

ValorSignificado
"login_required"O usuário precisa fazer login para acessar
"subscription_required"O usuário precisa ter uma assinatura ativa
"variant_locked"Esta variante do jogo está bloqueada
"host_rule"Bloqueado por uma regra de negócio do site

Motivos de bloqueio por superfície

Se você precisa de mensagens diferentes para o jogo de hoje e para o arquivo, use blockedReasons:

js
crossword: {
  default: {
    playToday: true,
    playArchive: false,
    blockedReasons: {
      archive: 'subscription_required',
    },
  },
}

Meter limit (paywall medido)

Permita um número limitado de inícios gratuitos dentro de uma janela móvel:

js
crossword: {
  default: {
    playToday: true,
    playArchive: true,
    meterLimit: {
      maxStarts: 5,      // número máximo de inícios permitidos
      intervalDays: 30,  // janela móvel em dias
    },
    blockedReason: 'subscription_required',
  },
}

O que são variantes?

Uma variant é uma versão do mesmo tipo de jogo com categorias de conteúdo ou características diferentes: mesmas regras, proposta diferente. Por exemplo, crossword pode ter variantes como mini (grade menor), kids (vocabulário simples) ou sports (pistas com tema esportivo). Cada variante compartilha o mesmo motor de jogo, mas é tratada como uma superfície de acesso separada.

As variantes são identificadas por um string ID configurado no lado da plataforma. Quando nenhuma política específica de variante é definida, aplica-se a política default.

Sobrescritas em nível de variante

Aplique uma política diferente a uma variante específica, mantendo default para todo o resto:

js
crossword: {
  default: {
    playToday: true,
    playArchive: false,
    blockedReason: 'subscription_required',
  },
  variants: {
    mini: {
      // O mini crossword é gratuito: sobrescreve o default
      playToday: true,
      playArchive: true,
    },
    kids: {
      // A variante kids exige login, mas não assinatura
      playToday: true,
      playArchive: false,
      blockedReason: 'login_required',
    },
  },
}

Tipos de jogo suportados

  • connect4
    Relaciona palavras a 4 personagens ou objetos; cada item é exibido como imagem com uma palavra abaixo.

  • crossmath
    Grade em estilo palavras cruzadas em que as células são preenchidas com expressões matemáticas em vez de letras.

  • crossword
    Palavras cruzadas clássicas com pistas para palavras que se cruzam.

  • crossword_mini
    Versão mais curta e rápida de palavras cruzadas.

  • difference
    Jogo dos erros: encontre 8 diferenças entre duas imagens semelhantes.

  • memory
    Jogo de memória: vire cartas para encontrar pares.

  • number
    Puzzle baseado em números (por exemplo, sequências, lógica ou aritmética).

  • puzzle
    Puzzle geral (quebra-cabeça, lógica ou similar).

  • quiz
    Quiz de conhecimento com perguntas e respostas.

  • self_defined
    Palavras cruzadas em que cada célula contém sua própria definição ou pista.

  • seven_letters
    Jogo estilo Spelling Bee: forme palavras a partir de um conjunto de 7 letras, com uma letra central obrigatória.

  • sudoku
    Puzzle de grade 9×9: preencha cada linha, coluna e bloco 3×3 com dígitos de 1 a 9.

  • tiles
    Jogo de combinar peças: encontre pares ou grupos em um tabuleiro com muitos elementos.

  • timeline
    Ordene eventos, datas ou itens na sequência cronológica correta.

  • word
    Adivinhe uma palavra escondida em um número limitado de tentativas.

  • word_links
    Conecte palavras que pertencem à mesma família ou categoria.

  • word_search
    Encontre palavras escondidas em uma grade de letras (horizontal, vertical ou diagonal).

Client integration documentation maintained in-repo.