okya for MapleStory
Português
English한국어日本語简体中文繁體中文EspañolPortuguêsไทยTiếng ViệtDeutschFrançaisItalianoNederlandsעבריתSvenskaРусский
Menu do guia⌄
Início›Guia do produto

01 · Visão geral do produto

Automação local para desktop

Bot para MapleStory Classic World

Um bot configurável para Global MapleStory Classic World, com execução local no Windows 10/11 e em Macs com chip Apple ou Intel. O reconhecimento de tela e as teclas que você definir cuidam do farm, das poções e dos buffs. Escolha ataque parado, patrulha entre dois pontos ou uma rota própria; capture os modelos do personagem e dos monstros no ambiente em que você vai jogar.

Plataformas
Windows 10/11 · Mac com Apple Silicon / Intel
Processamento
Reconhecimento local da tela

Como o okya funciona no Classic World#

O cliente desktop reconhece o personagem, os monstros selecionados, o minimapa e as áreas de HP/MP na janela visível do jogo. Depois executa as teclas locais conforme a estratégia salva, sem pedir sua senha do MapleStory. O editor no navegador serve para criar arquivos de rota; quem executa o bot é o cliente no computador, não a página web. Antes de comprar, confirme com o suporte seu servidor, versão do jogo e sistema operacional, pois atualizações e mudanças visuais podem afetar a compatibilidade.

O que o cliente pode automatizar#

Comece com a configuração mínima, confirme o reconhecimento no registro de execução e ative as opções uma de cada vez.

Reconhecimento de personagem e monstros

Crie modelos voltados para a esquerda e para a direita para localizar seu personagem e os alvos visíveis.

Rotas de grind e farm

Escolha ataque parado, patrulha entre dois pontos ou uma rota própria criada no editor de mapas.

Poções e buffs automáticos

Defina limites de HP/MP, teclas, intervalos e até cinco espaços de buffs periódicos.

Coleta e controles de combate

Configure ataque, salto, coleta, direção e intervalos específicos de cada estratégia em um único painel.

Registros e verificações iniciais

Confira a janela, o minimapa, o personagem, os monstros e os indicadores vitais antes de deixar uma estratégia ativa.

Perfis e rotas locais

Salve localmente configurações, modelos personalizados e arquivos de rota para testar e ajustar cada perfil.

Antes de começar#

  • Windows 10/11 64 bits ou Mac com Apple Silicon (série M, macOS 11 ou superior) ou Intel (macOS 12 ou superior)
  • MapleStory com o minimapa visível
  • Permissões de Acessibilidade e Gravação da Tela e Áudio do Sistema no macOS
  • Licença válida e internet para a primeira ativação
  • Modelos capturados no sistema operacional e ambiente de jogo usados na prática

Perguntas sobre o bot para MapleStory Classic World#

Funciona no Windows e no macOS?+

Sim. O cliente atual funciona no Windows 10/11 64 bits e em Macs com Apple Silicon (macOS 11 ou superior) e Macs com Intel (macOS 12 ou superior), com um pacote para cada chip.

Que informações da versão Classic World devo confirmar antes da compra?+

Este guia tem como foco o Global MapleStory Classic World. A compatibilidade depende do servidor, da versão do jogo, do sistema operacional e da interface atual. Envie essas informações para hi@okya.app antes de comprar. O nome Classic não garante que todos os servidores ou atualizações funcionem com a mesma configuração.

O bot roda online ou precisa ser instalado no computador?+

O bot é um cliente desktop pago, executado localmente no Windows ou no Mac. Já o editor de rotas é gratuito e roda no navegador: importe uma imagem do mapa, crie os nós e movimentos, exporte o JSON e importe no cliente. O editor não executa o jogo nem o bot.

Onde recebo a licença e baixo o programa?+

Mensal $19 / 30 dias, trimestral $39 / 90 dias, anual $99 / 365 dias. Todos os recursos incluídos. Licenças vitalícias não estão mais à venda. Após a confirmação do pagamento, a página do pedido disponibiliza a chave e os botões de download separados para Windows e Mac com chip Apple. Baixe o cliente pelo pedido oficial e siga as instruções de instalação e primeira configuração abaixo.

02

Guia de uso

Capturas do jogo#

Instalação, permissões e ativação#

Instale o pacote correto e conclua as verificações da plataforma antes de configurar uma estratégia.

Windows

Extraia todo o ZIP de 64 bits para uma pasta fixa. Não execute pelo visualizador do ZIP. Execute o programa como administrador.

Instalação no Mac

Mova o app para Aplicativos antes de abri-lo. Conceda Acessibilidade e Gravação da Tela e Áudio do Sistema, encerre totalmente e abra novamente. Use o pacote correspondente ao seu chip: Apple silicon ou Intel.

Verificar permissões do macOS

Acessibilidade permite enviar teclas; Gravação da Tela e Áudio do Sistema permite ler janela, personagem, minimapa e HP/MP. Adicione o app instalado — não Terminal, Python, versão antiga ou pasta — às duas listas, ative as opções, encerre com Command-Q e abra novamente.

Ativação e dados locais

Informe a licença completa sem espaços extras e aguarde a confirmação on-line. No macOS, o Acesso às Chaves pede a senha de login do Mac, não a licença. Os dados ficam em %LOCALAPPDATA%\Okya\ no Windows e ~/Library/Application Support/Okya/ no macOS. Copie apenas config.json, templates e maps; nunca license.dat.

Crie modelos de reconhecimento confiáveis#

Capture as duas direções no sistema e na configuração do jogo que serão usados.

Personagem (15 × 15 px)

Crie e nomeie o perfil. Capture uma área estável próxima ao topo da cabeça olhando para a esquerda e exatamente a mesma região olhando para a direita. Confira se as duas prévias contêm apenas o personagem, salve e selecione o perfil.

Monstros (10 × 10 px)

Prefira monstros com poucos movimentos e quadros. Em um quadro estável, capture a mesma região distinta — topo da cabeça, chifre ou perto dos olhos — nas duas direções. Comece com um; normalmente um a três oferecem mais estabilidade.

Amostras boas e ruins

Um bom par usa a mesma região e contém apenas o alvo. Refaça imagens com chão, borda de plataforma, fundo, nomes, dano, chat, mascotes, efeitos ou outro monstro.

Quando recapturar

Capture todos os modelos novamente se mudar o visual, os efeitos, o cliente ou o sistema operacional. Windows e macOS também podem renderizar pixels de forma diferente.

Configuração do primeiro uso#

O fluxo abaixo foi baseado no cliente real para desktop e no guia de primeiro uso.

  1. 1

    Instale o pacote correto para Windows 64 bits, Mac com Apple Silicon ou Mac com Intel. No macOS, mova o app para Aplicativos antes de conceder as permissões.

  2. 2

    Execute o jogo no modo janela ou janela sem bordas. Deixe o minimapa e as áreas de HP/MP totalmente visíveis na tela principal.

  3. 3

    Ative a licença e selecione o servidor real para usar as regiões corretas de reconhecimento do minimapa e de HP/MP.

  4. 4

    Capture modelos do personagem e do monstro olhando para a esquerda e para a direita. Faça novas capturas ao mudar de sistema, aparência ou cliente.

  5. 5

    No primeiro teste, selecione Ataque parado e configure apenas o personagem, um monstro, a tecla de ataque e a de salto.

  6. 6

    Inicie a estratégia e leia o registro. Só ative poções, buffs e coleta depois que o personagem e o minimapa forem reconhecidos.

Modos, combate e ações opcionais#

Altere uma configuração por vez, salve e verifique o registro antes de ativar a próxima.

Tela e ajustes básicos

Use o jogo em janela ou sem bordas na tela principal. Mantenha o minimapa aberto e HP/MP na posição padrão. Selecione o servidor real, o personagem salvo e um monstro; mantenha o alerta do detector de mentiras ativo e teste o som.

Modos de diagnóstico

Somente reconhecimento verifica janela, personagem, monstros, minimapa e HP/MP sem atacar. Somente movimento valida patrulha ou rota. Use a execução completa apenas após os dois testes.

Combate e movimento

Faça as teclas de ataque e salto coincidirem com o jogo. Comece com alcances horizontal e vertical conservadores para não perseguir outro andar.

Poções, buffs e coleta

Teste HP/MP com limite de 50% e cerca de um segundo de intervalo; nunca menos de 0,1 s. Teste primeiro um dos cinco espaços de buff. Para coleta, 0,45 s é um início estável e 0,05 s é o mínimo; frequência alta interrompe o combate.

Primeira execução completa

Entre no mapa, abra o minimapa e confira HP/MP. Salve servidor, personagem, monstro, estratégia e teclas. Inicie em local seguro, aguarde o app devolver o foco ao jogo e não troque de aplicativo. Só está em execução quando o registro confirma todas as verificações.

Verificação de 30 segundos

Confirme mapa e posição segura, o jogo na tela principal, minimapa aberto, servidor/perfil/monstro/estratégia corretos, todas as teclas, suprimentos e espaço suficientes, e alerta audível.

Três estratégias de mapa#

Cada estratégia atende a um tipo de mapa. Teste primeiro o movimento sem ações opcionais.

Ataque parado

Recomendado para o primeiro teste e plataformas fixas. Registra a posição inicial e pode tentar retornar após recuo ou deslocamento.

Patrulha entre dois pontos

Move-se entre as coordenadas horizontais A e B do minimapa, com pausas e ataques nos extremos configuráveis.

Patrulha em rota personalizada

Segue os nós, plataformas e ações criados no editor de mapas. A rota precisa corresponder ao mapa atual.

Criar e usar uma rota personalizada#

O editor de mapas define como o bot deve se mover em um mapa específico. Crie a rota usando o mesmo mapa e visual do jogo usados no cliente desktop.

Crie a rota em três etapas

  1. 1
    Importe o mapa usado de verdade

    Abra o mapa no jogo com o mesmo modo de janela e layout do minimapa que serão usados no cliente desktop e capture a tela atual. No editor, escolha Importar mapa. Evite imagens de guias, imagens redimensionadas ou capturas de outro computador, pois as coordenadas podem não corresponder.

  2. 2
    Recorte o minimapa no canto superior esquerdo

    Escolha Recortar, clique primeiro no canto superior esquerdo do minimapa visível e depois no canto inferior direito, e salve o recorte. Inclua todas as plataformas transitáveis, cordas, escadas e portais; exclua o cenário do jogo, chat, missões e outras partes da interface. Confirme que o recorte corresponde ao minimapa reconhecido pelo cliente.

  3. 3
    Coloque pontos e monte a rota

    Use Nó para marcar curvas, pontos de pouso, entradas de cordas ou escadas e portais. Desenhe plataformas quando ajudarem a representar o terreno, conecte nós vizinhos e atribua a ação correta de andar, pular, subir, descer ou teleportar. Exporte a rota, importe-a para o mesmo mapa no cliente desktop e teste primeiro apenas o movimento.

Atualizações, backup e suporte#

Preserve a configuração testada sem mover a licença vinculada ao dispositivo nem compartilhar segredos.

Antes de atualizar

Pare a estratégia, encerre o app e copie config.json, templates e maps. Depois, confira versão, servidor, modelos, teclas e estratégia.

Mudar de computador

Configurações e rotas podem ser revisadas e migradas, mas license.dat não. Ative o novo dispositivo, conceda permissões e recapture os modelos.

Trocar o dispositivo vinculado

A licença fica vinculada ao dispositivo em que foi ativada pela primeira vez. Ao trocar de computador, reinstalar o sistema ou substituir hardware, fale com o suporte (hi@okya.app) com o número do pedido para alterar o vínculo. Não copie o license.dat para o novo dispositivo.

Falar com o suporte

Envie versão, sistema e chip, servidor, modo de janela, estratégia, parâmetros e o registro completo até a primeira falha. Remova licenças, identificadores e nomes de conta.

03

Solução de problemas

Encontre o sintoma, aplique a correção e pare no primeiro passo que funcionar. Conclua a configuração básica antes de investigar um problema específico.

Solução de problemas na ordem certa#

Corrija primeiro a verificação inicial mais antiga que falhou no registro.

Janela do jogo não encontrada

Use o jogo em janela ou sem bordas na tela principal. No macOS, confira a permissão de gravação e reinicie o app.

Falha de reconhecimento

Remova obstruções, confira servidor e modelo, abra o minimapa e recapture as duas direções. Teste apenas um monstro.

HP e MP mostram 0,0%

Desative primeiro a recuperação automática e confira servidor, interface padrão, posição da janela e permissão de gravação.

Monstros não reconhecidos ou confundidos

Selecione um, recapture as duas direções em quadro estável e use uma área exclusiva. Exclua modelos com fundo ou copiados de outro sistema operacional.

Reconhece, mas não envia teclas

Dê foco ao jogo, confira os atalhos e a Acessibilidade no macOS. No Windows, execute o programa como administrador.

macOS continua pedindo permissões

Remova entradas antigas, de teste, Python, Terminal ou pastas. Adicione o app atual em Aplicativos às duas permissões, ative ambas, encerre com Command-Q e abra novamente.

Patrulha ultrapassa a borda

Afaste A e B das extremidades e teste primeiro somente movimento. A inércia pode causar uma pequena ultrapassagem.

Instalação e ativação#

O macOS diz que não é possível verificar o desenvolvedor ou que o app está danificado+
O que verificar

Primeiro confirme que o pacote veio do endereço oficial, foi baixado por completo e corresponde ao seu chip (Apple silicon ou Intel). Uma mensagem de «danificado» sozinha não revela a causa real.

Se a fonte for confiável, abra Ajustes do Sistema → Privacidade e Segurança e procure «Abrir Mesmo Assim». Se ainda não abrir, fale com o suporte informando a mensagem completa, a versão do cliente, o chip do Mac e a versão do macOS.

Depois de reinstalar o sistema ou trocar de computador, a licença diz que já está vinculada+
Como funciona

Uma licença fica vinculada a um dispositivo. O mesmo dispositivo pode trocar de conta de jogo, mas isso não permite executar vários jogos ao mesmo tempo nem usar uma licença em vários computadores ou máquinas virtuais.

Se aparecer uma mensagem de vínculo após uma reinstalação ou um dispositivo novo, escreva para hi@okya.app com o número do pedido para que o vínculo seja verificado e alterado.

Não fique testando a licença de outra pessoa e nunca publique sua chave completa em fóruns ou capturas públicas.

A verificação da licença passou, então por que não inicia?+
Como funciona

«License check passed» só significa que a licença é válida. Não significa que a janela do jogo, o personagem, o minimapa e a fonte de captura foram reconhecidos.

Continue lendo o log para ver se falhou na captura da janela, no reconhecimento do personagem ou no do minimapa e use a entrada correspondente abaixo.

O software de segurança bloqueia ou sinaliza o programa+
O que verificar

No Windows, o programa precisa ser iniciado como administrador. Não é possível garantir compatibilidade com todas as configurações de antivírus.

Envie ao suporte o aviso exato e o local de onde baixou o pacote para que verifiquem o arquivo oficial. Desativar o software de segurança ou adicionar exceções não deve ser a sua solução padrão.

Inicialização e captura de janela#

A janela do jogo não é encontrada ou a resolução está errada+
O que verificar

Siga estes passos em ordem:

  1. Confirme que a janela real do jogo está em 1366 × 768, e não apenas que a configuração mostra isso em tela cheia.
  2. Use o modo janela e mantenha a janela inteira visível: sem minimizar, sem maximizar e sem outras janelas por cima.
  3. Se a sua versão permite escolher uma fonte de captura, selecione a janela real do jogo.
  4. Depois de mudar a resolução, pare a execução e inicie de novo; reinicie o cliente se necessário.
  5. Capture de novo os modelos do personagem e dos monstros sempre que a resolução ou o tamanho da tela mudar.
No Mac, as permissões estão ativas, mas Iniciar não faz nada+
O que verificar

Verifique se Acessibilidade e Gravação de Tela estão ativadas para o cliente que realmente está em execução e leia o log de inicialização completo.

Em um caso a permissão parecia errada, mas o verdadeiro bloqueio era o reconhecimento dos modelos do personagem e dos monstros. Não fique alternando permissões por causa de um único aviso; confira também o tamanho da janela, o minimapa, o modelo do personagem e a fonte de captura.

Se persistir, envie a tela de permissões, as configurações do cliente, uma captura da área de trabalho inteira e o log de inicialização.

O log mostra «Game is not in the foreground»+
Como funciona

Clicar nas configurações ou na janela de log do cliente tira o foco do jogo, então essa mensagem é esperada nesse caso. Pare a execução antes de mudar configurações, inicie de novo e clique no jogo para que fique na frente.

Se o jogo realmente está na frente e a mensagem continua aparecendo, envie o log completo e a disposição da sua tela em vez de supor que o erro é seu.

O log mostra uma janela 0 × 0 ou «minimap not detected»+
O que verificar

Há relatos de tamanho de janela 0 × 0, volta para a captura de tela cheia do monitor principal e «minimap not detected» ao mesmo tempo. Confirme que o jogo não está minimizado, que a fonte capturada é a janela do jogo e que o minimapa está aberto para o marcador do jogador aparecer.

Deixe o personagem parado e fora de combate ao iniciar. Se ainda falhar, envie o log completo e uma captura da janela inteira do jogo.

Reconhecimento de personagens e monstros#

O personagem se perde o tempo todo. Como devo capturar o modelo?+
O que verificar

Capture o personagem em pé normalmente, sem piscar por causa de um golpe. Prefira a parte superior do corpo, principalmente uma característica clara e estável perto da cabeça.

  1. Deixe de fora texto de habilidades, números de dano, decoração de fundo e efeitos grandes.
  2. Capture separadamente a orientação para a esquerda e para a direita, salve e selecione o perfil.
  3. Evite que efeitos cubram o personagem durante a execução.
  4. Capture de novo depois de mudar a resolução do jogo; não continue usando um modelo de outro tamanho.
O modelo do monstro está salvo, mas os monstros ainda não são reconhecidos+
O que verificar

Primeiro descarte a próxima entrada (contagem 0 porque os monstros estão fora do alcance de ataque) e depois verifique o modelo:

  1. Escolha um monstro com pose estável e uma característica clara, como o topo da cabeça ou um chifre.
  2. Capture a mesma característica voltado para a esquerda e para a direita.
  3. Evite o fundo, números de dano e efeitos de habilidades.
  4. Capture de novo na resolução que você realmente usa e confirme que o modelo está selecionado.
  5. Teste com apenas um monstro selecionado para enxergar melhor a causa.
Há monstros na tela, mas o log mostra 0+
Como funciona

O log conta apenas os monstros dentro do alcance horizontal de ataque que você configurou, não todos os da tela. Um 0 para monstros fora desse alcance é normal.

Observe se a contagem muda quando um monstro entra no alcance. Só se ela ficar em 0 com um monstro dentro do alcance você deve verificar o modelo e as configurações de reconhecimento. Não capture os modelos de novo só porque viu um 0.

O que devo verificar no minimapa e no reconhecimento do personagem?+
O que verificar

Confirme que o servidor certo está selecionado, que o minimapa está totalmente aberto com o marcador do jogador visível e que o jogo está na resolução e no modo de janela corretos. Fique parado e fora de combate ao iniciar.

Observe no log CHARACTER_RECOGNITION, MINIMAP_RECOGNITION ou MARKER_COLOR_ABSENT e verifique o personagem e o minimapa separadamente. Um personagem reconhecido não prova que o minimapa funcionou.

Combate e alcance de ataque#

Ele só anda de um lado para o outro e nunca luta+
O que verificar

Verifique em ordem: se o personagem e o minimapa são reconhecidos, se o modelo do monstro está selecionado, se os monstros estão dentro do alcance de ataque configurado, se a tecla de ataque corresponde à do jogo e se a habilidade já foi aprendida.

Volte ao ataque parado para verificar o reconhecimento básico e as teclas. Trocar de modo de patrulha, por si só, não prova que o problema foi resolvido.

Como defino o alcance horizontal de ataque?+
Como funciona

O valor é uma distância em pixels na tela do jogo. Baseie-o na distância real de ataque do seu personagem com a sua configuração de tela atual.

Uma ferramenta de captura que mostre o tamanho da seleção em pixels pode ajudar a medir. Não copie o número de outra classe; não existe um valor sempre correto. Para uma adaga curta de iniciante, o suporte já sugeriu 50 pixels ou menos, o que é um exemplo para ataques de curto alcance, não um padrão para todas as classes.

Fica atacando o chão vazio e gasta MP ou consumíveis+
O que verificar

Um alcance de ataque grande demais pode fazer o cliente tentar acertar monstros que você não alcança, e um modelo instável pode causar falhas ou falsas correspondências. Verifique a distância real de ataque, a qualidade do modelo e o resultado atual do reconhecimento.

Se ele continua atacando o nada, pare a execução para não gastar recursos e envie ao suporte suas configurações de ataque, os modelos e uma nota curta sobre como reproduzir. Não existe um botão que garanta parar os ataques quando não há monstro.

Mudei uma configuração, mas nada parece diferente+
Como funciona

As mudanças não são aplicadas a uma sessão que já está em execução. Faça nesta ordem: parar a execução → salvar → iniciar de novo.

Depois de mudar o alcance de ataque, as teclas de habilidade, o limite de contagem ou a resolução, verifique de novo o efeito real.

Patrulha e editor de mapas#

Como importo uma rota? Existe um mapa de exemplo?+
Como funciona

O editor de mapas inclui um mapa de exemplo: use «Load sample map» para ver a estrutura e depois monte a sua própria rota.

Para importar, escolha a patrulha de rota personalizada, use Import ao lado da lista de mapas e selecione o arquivo JSON exportado. Os nomes podem variar entre versões; se não encontrar o controle, envie uma captura do cliente em vez de tentar adivinhar um botão que não existe.

Ao exportar, use apenas letras inglesas e dígitos em Map Name e Map ID.

Exportei um mapa, mas «Add to OKYA» não aparece+
Como funciona

Baixe o arquivo .json exportado pelo editor e use Import ao lado da lista de mapas na patrulha de rota personalizada do cliente de desktop. Quando funciona, o mapa aparece na lista.

Você não precisa copiá-lo à mão para assets/maps; essa pasta é para os mapas internos. Se ainda não importar, verifique Map Name, Map ID e o nome do arquivo e envie ao suporte o JSON exportado com uma captura do erro. Não presuma que o formato do arquivo está errado só porque a importação falhou.

O que incluir ao falar com o suporte#

Envie tudo junto para reduzir as idas e vindas.

  • Sistema operacional e versão; em um Mac, informe se é Apple silicon ou Intel.
  • O número exato da versão do cliente.
  • Nome do jogo, servidor, modo de janela e resolução.
  • Se você usa um monitor externo e a escala da tela.
  • Os passos que você seguiu, o que esperava e o que realmente aconteceu.
  • O log completo, não só a última linha.
  • Uma captura da área de trabalho inteira mostrando o jogo e as configurações do cliente; em problemas de reconhecimento, inclua os modelos voltados para a esquerda e para a direita.
  • Em problemas de teclas, as configurações de teclas do jogo e do cliente.
  • Em problemas de desempenho, por quanto tempo rodou e os dados de monitoramento relevantes; um vídeo curto ajuda se você puder gravá-lo com segurança.