Taito Type X no Hyperspin com Hyperlaunch 3 e o módulo PCLauncher

Taito Type X no Hyperspin com Hyperlaunch 3 e o módulo PCLauncher

Configurar o sistema Taito Type X é uma tarefa simples, porém requer atenção aos detalhes.

Esta postagem tem o objetivo de configurar jogos do sistema Taito Type X no Hyperspin, utilizando o Hyperlaunch na versão 3 ou superior, e o módulo PCLauncher.

Passo 00:

Ter em mãos os jogos desejados da Taito Type X e a versão 3 ou superior do Hyperlaunch.

Passo 01:

Criar o sistema Taito Type X pelo Main Menu Wizard do HyperHQ.

Wizard do HyperHQ

Passo 02:

Alimentar o Database/Hyperlist do Taito Type X com os jogos desejados.

No meu caso eu usei apenas o "Raiden III" e o "Super Street Fighter IV Arcade Edition", para não poluir minha lista com jogos que não possuo.

Abaixo segue a Hyperlist de referência:

Taito Type X.xml [hyperlist]

<?xml version="1.0"?>
<menu>
<game name="Arcana Heart 3" index="" image="">
<description>Arcana Heart 3</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Examu</manufacturer>
<year>2009</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Battle Fantasia"  index="" image="">
<description>Battle Fantasia</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Arc System Works</manufacturer>
<year>2007</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="BlazBlue Calamity Trigger"  index="" image="">
<description>BlazBlue: Calamity Trigger</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Arc System Works</manufacturer>
<year>2008</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="BlazBlue Continuum Shift" index="" image="">
<description>BlazBlue: Continuum Shift</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Arc System Works</manufacturer>
<year>2009</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Chaos Breaker" index="" image="">
<description>Chaos Breaker</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Eolith</manufacturer>
<year>2004</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Contra - Evolution Revolution"  index="" image="">
<description>Contra - Evolution Revolution</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Konami</manufacturer>
<year>2011</year>
<genre>Shooter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Daemon Bride"  index="" image="">
<description>Daemon Bride</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Examu</manufacturer>
<year>2009</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="GigaWing Generations"  index="" image="">
<description>GigaWing Generations</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Takumi Corporation</manufacturer>
<year>2004</year>
<genre>Shooter</genre>
<rating>AAMA - Green (Suitable For All Ages)</rating>
<enabled>Yes</enabled>
</game>
<game name="Homura"  index="" image="">
<description>Homura</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Skonec</manufacturer>
<year>2005</year>
<genre>Shooter</genre>
<rating>AAMA - Green (Suitable For All Ages)</rating>
<enabled>Yes</enabled>
</game>
<game name="KOF - Maximum Impact Regulation A"  index="" image="">
<description>KOF - Maximum Impact Regulation A</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>SNK Playmore</manufacturer>
<year>2007</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="King of Fighters '98, The Ultimate Match" index="" image="">
<description>King of Fighters '98, The: Ultimate Match</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>SNK</manufacturer>
<year>2008</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="King of Fighters XII, The" index="" image="">
<description>King of Fighters XII, The</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>SNK Playmore</manufacturer>
<year>2009</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="King of Fighters XIII, The" index="" image="">
<description>King of Fighters XIII, The</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>SNK Playmore</manufacturer>
<year>2010</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Otomedius" index="" image="">
<description>Otomedius</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Konami</manufacturer>
<year>2007</year>
<genre>Shooter</genre>
<rating>AAMA - Green (Suitable For All Ages)</rating>
<enabled>Yes</enabled>
</game>
<game name="Power Instinct The Commemoration"  index="" image="">
<description>Power Instinct: The Commemoration</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Atlus</manufacturer>
<year>2009</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Raiden III"  index="" image="">
<description>Raiden III</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Moss</manufacturer>
<year>2005</year>
<genre>Shooter</genre>
<rating>AAMA - Green (Suitable For All Ages)</rating>
<enabled>Yes</enabled>
</game>
<game name="Raiden IV" index="" image="">
<description>Raiden IV</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Moss</manufacturer>
<year>2007</year>
<genre>Shooter</genre>
<rating>AAMA - Green (Suitable For All Ages)</rating>
<enabled>Yes</enabled>
</game>
<game name="Samurai Shodown - Edge of Destiny"  index="" image="">
<description>Samurai Shodown - Edge of Destiny</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>SNK Playmore</manufacturer>
<year>2008</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Shikigami no Shiro III" index="" image="">
<description>Shikigami no Shiro III</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Alfa System / Skonec</manufacturer>
<year>2006</year>
<genre>Shooter</genre>
<rating>AAMA - Green (Suitable For All Ages)</rating>
<enabled>Yes</enabled>
</game>
<game name="Silent Hill The Arcade" index="" image="">
<description>Silent Hill The Arcade</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Konami</manufacturer>
<year>2007</year>
<genre>Shooter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Spica Adventure" index="" image="">
<description>Spica Adventure</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Arc</manufacturer>
<year>2005</year>
<genre>Platform</genre>
<rating>AAMA - Green (Suitable For All Ages)</rating>
<enabled>Yes</enabled>
</game>
<game name="Street Fighter IV" index="" image="">
<description>Street Fighter IV</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Dimps / Capcom</manufacturer>
<year>2008</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Super Street Fighter IV Arcade Edition" index="" image="">
<description>Super Street Fighter IV Arcade Edition</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Dimps / Capcom</manufacturer>
<year>2010</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Suggoi! Arcana Heart 2"  index="" image="">
<description>Arcana Heart 2</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Examu</manufacturer>
<year>2008</year>
<genre>Fighter</genre>
<rating>AAMA - Yellow (Animated Violence Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Taisen Hot Gimmick 5 " index="" image="">
<description>Taisen Hot Gimmick 5 </description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>XNaunts</manufacturer>
<year>2005</year>
<genre>Mahjong</genre>
<rating>AAMA - Yellow (Sexual Content Mild)</rating>
<enabled>Yes</enabled>
</game>
<game name="Tetris The Grand Master 3 Terror Instinct"  index="" image="">
<description>Tetris The Grand Master 3: Terror Instinct</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Arika</manufacturer>
<year>2005</year>
<genre>Puzzle</genre>
<rating>AAMA - Green (Suitable For All Ages)</rating>
<enabled>Yes</enabled>
</game>
<game name="Trouble Witches AC" index="" image="">
<description>Trouble Witches AC</description>
<cloneof></cloneof>
<crc></crc>
<manufacturer>Studio Siesta / Bouken</manufacturer>
<year>2008</year>
<genre>Shooter</genre>
<rating>AAMA - Green (Suitable For All Ages)</rating>
<enabled>Yes</enabled>
</game>
</menu>

Passo 03:

Preparar o arquivo de inicialização do módulo.

É necessário criar o arquivo "PCLauncher.ini", e em seu conteúdo deve constar o nome dos jogos desejados e o atributo "FadeTitle" de cada jogo.

O arquivo "PCLauncher.ini" deve ser criado no diretório  "..\Hyperspin\Hyperlaunch\Modules\PCLauncher\". Como opção, neste mesmo diretório existe o arquivo "PCLauncher (Example).ini" que pode ser utilizando como exemplo.

Após a criação do arquivo, a tarefa seguinte é editá-lo, alimentando-o com a seção do jogo, no qual é a informação entre colchetes, junto com a propriedade "FadeTitle".

Como referência, abaixo consta a lista de "FadeTitle" de cada jogo:

Fonte: http://www.hyperspin-fe.com/forum/showthread.php?26741-Taito-Type-X-and-Hyperlaunch-3-0/page4

FadeTitle - Trecho a ser copiado e colado no PCLauncher.ini

[Arcana Heart 3]
FadeTitle=AH3

[Battle Fantasia]
FadeTitle=BattleFantasia

[BlazBlue Calamity Trigger]
FadeTitle=Blaz Blue

[BlazBlue Continuum Shift]
FadeTitle=Blaz Blue

[Chaos Breaker]
FadeTitle=GAME

[GigaWing Generations]
FadeTitle=YOKUSHIN

[Homura]
FadeTitle=HOMURA for TypeX

[King of Fighters '98, The Ultimate Match]
FadeTitle=Kof98

[King of Fighters XII, The]
FadeTitle=ahk_class NGLU_CLASS

[King of Fighters XIII, The]
FadeTitle=KOF XIII

[KOF - Maximum Impact Regulation A]
FadeTitle=KOF@MAXIMUM@IMPACT@regulation gAh

[Power Instinct The Commemoration]
FadeTitle= ??????????????????????

[Raiden III]
FadeTitle=(C)2005 MOSS LTD ALL RIGHTS RESERVED.

[Raiden IV]
FadeTitle=RAIDEN 4 (C)2007 MOSS LTD ALL RIGHTS RESERVED.

[Samurai Shodown - Edge of Destiny]
FadeTitle=Samurai Shodown 3D Ver[Mar 31 2008 15:23:19]

[Shikigami no Shiro III]
FadeTitle=SHIKIGAMI NO SHIRO3

[Spica Adventure]
FadeTitle=SpikaADV.

[Street Fighter IV]
FadeTitle=Street Fighter 4

[Super Street Fighter IV]
FadeTitle=SF41 - Sep 14 2010 17:42:49

[Super Street Fighter IV Arcade Edition]
FadeTitle=SF41 - Nov  4 2010 14:01:12 ahk_class SF41

[Taisen Hot Gimmick 5]
FadeTitle=MTS for PC

[Tetris The Grand Master 3 Terror Instinct]
FadeTitle=TGM3 - Copyright (C) Arika Co., Ltd - 2004-2005 (Jan 30 2005 17:52:56)

[Trouble Witches AC]
FadeTitle=Trouble Witches

*** O FadeTitle do jogo Super Street Fighter IV Arcade Edition adicionei o que funcionou para mim.

Uma observação importante é que o nome do jogo da seção do jogo no arquivo PCLauncher.ini deve coincidir com o nome do jogo informado no atributo "name" do jogo alimentado no xml do Hyperlist.

A figura abaixo demonstra os conteúdos dos arquivos Taito Type X.xml e PCLauncher.ini, no qual é destacado que nome do jogo deve coincidir em ambos os arquivos.

O conteúdos do hyperlist para o Taito Type X.xml e o PCLauncher.ini

Passo 04:

Configurar o módulo PCLauncher pelo HyperlaunchHQ.

Executar o HyperlaunchHQ, e seguir os sub-passos:

1. Selecionar o sistema recém criado, o Taito Type X;
2. Selecionar a aba "Modules";
3. Selecionar o módulo "PCLauncher.ahk";
4. Acionar a opção do icone "Edit Global Module Settings".

Inicio da configuração pelo HyperlaunchHQ

Na configuração do módulo, seguir os sub-passos:

1. Selecionar a aba "Rom Settings";
2. Acionar o botão para maximizar a tela;
3. Selecionar e arrastar para baixo o painel, até que os botões do lado direito apareçam;
4. Selecionar o jogo a ser configurado. Observação: Os jogos dessa lista são os contidos no Hyperlist (Taito Type X.xml);
5. Selecionar o launcher do jogo (pode ser um arquivo *.exe ou *.bat, depende do jogo) na propriedade "Application";
6. Selecionar o executor do jogo na propriedade "AppWaitExe". Esse arquivo, na maioria das vezes, é o game.exe contido no diretório do jogo. Em caso de dúvidas, é recomendado executar o jogo sozinho, tirar o foco do jogo com as teclas Alt+Tab ou Windows, acessar o prompt de comando e digitar "tasklist", no qual listará todos os processos em execução no Windows, e identificar o nome do processo que é responsável pela execução do jogo. (no caso do SSFIVAE o arquivo é o "Ttxshell.exe", que no meu caso eu fiz uma cópia com o nome "game.exe");
7. A propriedade "ExitMethod" é responsável por fechar o jogo. Caso o jogo trave e não feche, e recomendado testar outros métodos desta opção, até achar aquele que realmente feche o jogo;
8. Apenas para conhecimento, visualizar a informação de FadeTitle. Se essa informação estiver incorreta, o Hyperspin não manterá o foco na janela do jogo. Conferir no Passo 03 essa postagem.

Configurando jogo Raiden III no módulo.

Para o jogo Super Street Fighter IV Arcade Edition, no meu caso, precisei alterar a propriedade "ExitMethod". Além disso, a propriedade "Application" é um arquivo *.bat.

Configuração para o SSFIVAE

Passo 04-2 (atualização em 29.06.2014):

Informar um "Emulador Padrão" para o sistema Taito Type X.

Apesar desse sistema não precisar de um emulador de fato, essa configuração se faz necessária.

1. Selecionar o sistema "Taito Type X";
2. Selecionar a aba "Emulators";
3. No campo "Default Emulator", acionar a opção de configuração;
4. Configurar o emulador "PCLauncher [Global]".

Configurar o "PCLauncher [Globa]" como emulador padrão.

Passo 05:

Executar os jogos pelo Hyperspin !!!

Passo 06:

Eventuais problemas !

No meu caso, quando a tecla de saída do jogo (Esc) era acionada, o jogo era encerrado, mas o foco não retornava para o Hyperspin. Com isso, bastando apenas um simples "click" do mouse para normalizar isso... entretanto, em um gabinete arcade, isso se torna um problema.

Para contornar este problema, foi criado o seguinte script AHK:

Conteúdo do script AHK para retornar o foco do Hyperspin

 
;---- colocar o foco no Hyperspin (via click)
;
Process, Exist, Hyperspin.exe
frontendPID := ErrorLevel
ControlClick, , ahk_pid %frontendPID%

sleep, 2000
MouseClick, left

OBS: O AutoHotKey deve estar instalado ! http://www.autohotkey.com/

O arquivo foi criado com o bloco de notas e salvo com o nome "AHK_FocusHyperspin.ahk", e colocado no diretório do módulo PCLauncher, que é "..\Hyperspin\Hyperlaunch\Modules\PCLauncher\".

Em seguida, em cada jogo, o arquivo foi configurado na propriedade "PostExit" de cada jogo, como demonstra a imagem abaixo de exemplo:

Arquivo AHK para retornar o foco no Hyperspin quando for acionado a tecla de saída do jogo.

Conclusões:

Uma vez entendido o funcionamento do PCLauncher, fica tranquilo configurar os jogos. Ademais, com esse módulo também é possível utilizá-lo para configurar sistemas de jogos de PC e Steam.


Agradecimentos e fontes:

• Fórum do Hyperspin;
• Vídeo do Gigapig (Giga Guides): 

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.