01 · Visão geral do produto
Automação local para desktop
Bot para MapleStory Classic World
O okya for MapleStory usa reconhecimento de imagem da tela e controles locais do teclado para automatizar grind, farm e evolução repetitivos. Crie modelos do personagem e dos monstros e escolha uma estratégia adequada ao mapa.
- Plataformas
- Windows 10/11 · Mac com Apple Silicon
- Tela do jogo
- 1366 × 768
- Processamento
- Reconhecimento local da tela
Um bot configurável para tarefas repetitivas no MapleStory#
O cliente para desktop analisa a janela visível do jogo e não pede a senha da sua conta. Ele detecta o personagem, os monstros escolhidos, a posição no minimapa e as áreas de HP/MP; depois executa a estratégia e as teclas salvas. Os modelos e as configurações comuns ficam no dispositivo.
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)
- MapleStory em 1366 × 768 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; não é destinado a Macs Intel.
Por que a resolução precisa ser 1366 × 768?+
As áreas da janela, do minimapa e de HP/MP são calibradas para essa visualização. Outras resoluções podem impedir a verificação inicial.
O cliente precisa da senha da minha conta?+
Não. Ele funciona com a imagem visível e controles locais. Nunca envie sua senha nem o arquivo license.dat ao suporte.
Qual estratégia devo testar primeiro?+
Comece com Ataque parado, um único monstro e as opções desativadas. Ative as demais funções quando o reconhecimento estiver estável.
Posso copiar modelos entre Windows e Mac?+
Configurações e rotas podem ser copiadas, mas a renderização varia entre sistemas. Recomendamos capturar novamente os modelos no computador de destino.
Posso criar minha própria rota para o bot?+
Sim. Marque plataformas, nós e movimentos no editor web, exporte a rota JSON e importe-a no cliente. Crie e teste cada rota no mapa e na resolução correspondentes.
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.
Mac com Apple silicon
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. O pacote atual não é compatível com Mac 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 (20 × 20 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 a resolução do jogo, a escala, o visual, os efeitos, o cliente ou o sistema operacional. As imagens precisam corresponder exatamente à resolução usada; 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
Instale o pacote correto para Windows 64 bits ou Mac com Apple Silicon. No macOS, mova o app para Aplicativos antes de conceder as permissões.
- 2
Execute o jogo em 1366 × 768 no modo janela ou janela sem bordas. Deixe o minimapa e as áreas de HP/MP totalmente visíveis na tela principal.
- 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
Capture modelos do personagem e do monstro olhando para a esquerda e para a direita. Faça novas capturas ao mudar de sistema, escala, aparência ou cliente.
- 5
No primeiro teste, selecione Ataque parado e configure apenas o personagem, um monstro, a tecla de ataque e a de salto.
- 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 1366 × 768 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, resolução, 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, 1366 × 768 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
- 1Importe o mapa usado de verdade
Abra o mapa no jogo com a mesma resolução, 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.
- 2Recorte 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.
- 3Coloque 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.
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 1366 × 768 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, 1366 × 768, 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.
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.
Falar com o suporte
Envie versão, sistema e chip, servidor, resolução, modo de janela, estratégia, parâmetros e o registro completo até a primeira falha. Remova licenças, identificadores e nomes de conta.