HyperSpin v1.3.2.0 e HyperLaunch v3

Instalação limpa do HyperSpin v1.3.2.0 e HyperLaunch v3 

Este passo-a-passo visa facilitar as tarefas para quem deseja uma instalação limpa do HyperSpin, e não está tendo sorte. As motivações para isso são: o próprio site deste front end se mostra desorganizado; há muitos tutoriais de versões previamente configuradas, no qual para fazer a reconfiguração se torna confusa.

Passo 01

Fazer o download do HyperSpin v1.3.2.0 no endereço http://www.hyperspin-fe.com. É mister ter cadastro neste site, pois algumas seções desse requerem autenticação (estar logado). Atente-se para o caminho do download.



Caminho para download do HyperSpin v1.3.2.0

Passo 02

Após o download, o arquivo deverá ser descompactado e a disposição das pastas deve ficar conforme segue:

- HyperSpin    (na raiz de alguma unidade)
      |
      + Databases
      |
      + Emulators
      |
      + HyperSync Cloud
      |
      + HyperTheme
      |
      + Media
      |
      + Settings

Recomenda-se colocar a pasta HyperSpin na raiz da unidade que será utilizada, podendo ser no C:\ para a unidade local ou E:\, F:\ ou G:\ para unidades escravas ou externas. No meu caso, utilizo uma unidade externa como E:\. É imprescindível respeitar a disposição das pastas e letras das unidades, pois as configurações ulteriores utilizam muitos caminhos fixos.

Abaixo segue a disposição que utilizei:



Disposição das pastas

Passo 03

Executar o HyperSpin.exe ! Ao executa-lo, percebe-se que esse está configurado com o mínimo, pois possui a animação dos sistemas e de um jogo de cada sistema. A princípio, os comando de navegação preliminares são: Tecla Esc para voltar/sair, tecla Enter para ação/start, e as setas para navegação.

A seguir a tela da roda (wheel) dos sistemas:



Roda (wheel) dos sitemas

A tela dos jogos para o sistema MAME. Perceba que há animação, ou estilização, apenas para o jogo 88 Games, os demais estão sem animação:


Roda (wheel) dos jogos

 Ao tentar executar um jogo, o Hyperspin apresenta a mensagem que não achou o Hyperlaunch.


Falta do Hyperlaunch

Passo 04

O que é o Hyperlaunch ? É o lançador (launch) ! Trata-se do executor, ou componente de execução, ou ainda, motor de execução, dos emuladores e respectivos jogos. No qual o Hyperspin é uma camada de visualização (front end), como uma camada superior, e o Hyperlaunch é uma camada de execução, como uma camada inferior.

Uma imagem para esclarecer melhor:

Página do HyperLaunch

Não esquecer do HiperlaunchHQ:

HyperlaunchHQ

Passo 5

Após o download do Hyperlaunch, segue como deve ficar a nova disposição de pastas:


- HyperSpin    (na raiz de alguma unidade)
      |
      + Databases
      |
      + Emulators
      |
      - Hyperlaunch
      |      |
      |      + Data
      |      |
      |      + HyperLaunchHQ
      |      |
      |      + Lib
      |      |
      |      + Media
      |      |
      |      + Module Extensions
      |      |
      |      + Modules
      |      |
      |      + Profiles
      |      |
      |      + Settings
      |
      + HyperSync Cloud
      |
      + HyperTheme
      |
      + Media
      |
      + Settings

Uma imagem para esclarecer:



Disposição das pastas do Hyperlaunch

Passo 06

Ao executar o Hyperlaunch é apresentada uma tela para teste, no qual há uma lista de sistemas, o campo para informar a rom/jogo e o botão de teste. Além disso, há a sintaxe da linha de comando, que será utilizada ulteriormente pela camada de apresentação, o Hyperspin.

Execução em tela do Hyperlaunch

Após escolher um sistema e acionar o botão Test, esse exibe a mensagem de erro:



Erro do Hyperlaunch

Passo 07

Até este passo há duas pendências: 1) Associar a camada de apresentação com a camada de execução, isto é, o front end Hyperspin com o executor Hyperlaunch; 2) Associar o Hyperlaunch com um emulador.

Neste passo será feito a pendência 1, no qual é associar a camada de apresentação com a camada de execução, isto é, o front end Hyperspin com o executor Hyperlaunch.

• Abrir o arquivo \Hyperspin\Settings\Settings.ini em algum editor de texto;
• Achar e ir na propriedade Hyperlaunch_Path;
• Configurar o valor com o caminho da pasta do Hyperlaunch. No meu caso utilizei E:\Hyperspin\HyperLaunch\

A seguir uma tela para esclarecer:



Associação do Hyperspin com o Hyperlaunch

Apenas como teste, execute o Hyperspin e execute um jogo ! Agora o Hyperspin encontra o Hyperlaunch, porém, a mensagem de erro muda, pois o Hyperlaunch não possui emulador configurado. A tela seguinte demonstra esse comportamento:



Hyperpin sem emulador configurado

Passo 08

Neste passo será resolvido a pendência 2, no qual se refere à associar o Hyperlaunch com um emulador. Para isso, há uma ferramenta muito útil, no qual funciona como uma central de configuração, que chama HyperLaunchHQ. Essa ferramenta está contida no Hyperlaunch, e o caminho para acessa-la é \HyperSpin\Hyperlaunch\HyperLaunchHQ.

Ao executar o HyperLaunchHQ, a tela seguinte é apresentada:




Erro do caminho do Hyperlaunch

Após acionar a opção OK, será aberta uma árvore de diretórios para que o caminho do Hyperlaunch seja informado. Informe \HyperSpin\Hyperlaunch.

Em seguida, execute-o novamente e a seguinte tela irá se apresentar:



Tela do HyperlaunchHQ

Passo 09

Neste momento é mister criar o diretório para o emulador e o respectivo diretório de roms. Utilizei o MAME, que é o meu foco.

Abaixo a disposição dos diretórios de emuladores e roms:

- HyperSpin    (na raiz de alguma unidade)
      |
      + Databases
      |
      - Emulators
      |      |
      |      - mame
      |          |
      |          - mame0.134 (colocar o mame nesse diretório)
      |
      + Hyperlaunch
      |      
      + HyperSync Cloud
      |
      + HyperTheme
      |
      + Media
      |
      - Roms
      |   |
      |   - mame (colocar as roms do mame nesse diretório)
      |
      + Settings

Utilizei essa disposição de diretórios para diminuir o acoplamento entre as roms e os emuladores e entre o emulador e suas versões.

Agora é mister colocar o emulador e as roms nos respectivos diretórios.

Passo 10

Cadastrar o emulador no HyperlaunchHQ. Seguir as tarefas:

1. Selecionar o sistema, no caso o MAME;
2. Acionar o menu Emulators;
3. Acionar o símbolo de adição, para adicionar o emulador.



Cadastrar emulador

Adicionar o emulador:

1. Colocar um nome para o emulador na propriedade Name usei MAME;
2. Informar o Path, que é o caminho do arquivo executável do emulador, usei \Hyperspin\Emulators\mame\mame0.134\mame.exe;
3. Informar as extenções das roms que o emulador utiliza, usei zip;
4. Informar a propriedade Module, refere-se aos arquivos de extensão *.ahk que são requeridos pelo Hyperlaunch para cada emulador. Usei o módulo que está contido na instalação do Hyperlaunch, no qual é o caminho \Hyperspin\Hyperlaunch\Modules\MAME\MAME.ahk.



Adicionando o emulador

Informar o emulador padrão e o diretório de roms.

1. Diretório de roms, usei \Hyperspin\Roms\mame;
2. Emulador padrão, usei o MAME, anteriormente adicionado.

Emulador padrão e diretório de roms

Passo 11

Testar o emulador cadastrado e a rom pelo Hyperlaunch.

Após executar o teste, apresentou o erro no qual o Hyperlaunch não acha a configuração do plug-in para o 7z (um descompactador).

Caso isso ocorra,  faça as seguintes tarefas:

1. Selecionar o sistema GLOBAL, no qual é referente a configuração geral;
2. Selecionar o menu General Settings;
3. Selecionar a aba Third Party;
4. Informar o caminho 7z. Esse está contido na configuração do Hyperlaunch, eu use o caminho \Hyperspin\Hyperlaunch\Module Extension\7z.exe.

Configurar o plug-in do 7z

Agora é testar, novamente, o emulador pelo Hyperlaunch.

Observação:

Caso o Hyperlaunch exibir mensagem de erro com relação ao "ahk". É mister verificar se a versão do módulo é compatível com a versão do emulador. No meu caso tive problemas, pois meu MAME é v0.134 e o MAME.ahk era para a v.0150. O erro apresentado foi:



Erro do Hyperlaunch referente ao "ahk"

Não abro mão da minha versão do MAME v.0134, pois eu tive que fazer uma compilação dessa para que o xpadder funcione corretamente, além dessa ser uma versão muito estável para as roms que possuo.

Dado essas restrições, tive que alterar o MAME.ahk da versão v0.150 para ser compatível com a v0.134. Despreendido de 2h, identifiquei que o MAME v0.134 não suporta os parâmetros -nohlsl_enable -nouse_cpanels -nouse_marquees. Após retirar esses parâmetros do módulo, na instrução de execução do emulador, esse funcionou.

Passo 12

Testar o jogo pelo Hyperspin ! Neste momento tanto o emulador quanto o jogo serão executados com sucesso.

Passo 13

Para ajustar o Hyperspin é mister utilizar a ferramenta HyperHQ, no qual se encontra no diretório do Hyperspin. Com o HyperHQ é possível configurar o Hyperspin para abrir em tela cheia, ajustar os volumes de sons e efeitos, criar novas rodas, ou alterar-las, para sistemas e jogos, entre outros.



HyperHQ, configurador do front end Hyperspin

Conclusão

Após seguir os passos, percebe-se que a primeira configuração do Hyperspin é complicada, porém, depois da primeira vez, nas próximas se torna mais fácil. Um pequeno glossário fica claro:

• HyperSpin: É a camada de apresentação, o front end, único para todos emuladores e jogos;
• HyperHQ: É a ferramenta de configuração da camada de apresentação, ou seja, do HyperSpin;
• HyperLaunch: É a camada de execução, o component ou motor de execução, dos emuladores e jogos;
• HyperLaunchHQ: É a ferramenta de configuração da camada de execução, ou seja, do HyperLaunch.

Os pontos a serem explorados em uma próxima oportunidade são:

• Configurar o Xpadder para o HyperSpin e os emuladores.
• Abastecer o HyperSpin com as animações e estilizações para os demais emuladores e jogos.