Manual · Ok-Prompt

1Primeiros passos

Abra a página e aperte uma tecla ou clique na tela: o MSX liga (os navegadores só liberam o som depois disso). Marque Power on by itself (ligar sozinho) no painel Machine para pular esta etapa da próxima vez.
A máquina embutida é o C-BIOS, uma ROM de sistema MSX livre. Ela inicia cartuchos, mas não tem BASIC; por isso, com os slots vazios, aparece No cartridge found.
Solte um jogo (.rom, ou um .zip com um dentro) em qualquer lugar da página. Ele vai para o slot 1 e o MSX reinicia com ele.
Para ter o MSX BASIC, carregue a ROM de uma máquina de verdade (próximo capítulo).

Speed (velocidade) roda o MSX a 2x ou 4x (o som fica mudo nesse caso). Region (região) escolhe 60 Hz (NTSC, como no Japão e no Brasil) ou 50 Hz (PAL, Europa) num MSX1; a BIOS de um MSX2 define isso sozinha.

2Escolhendo a máquina

O menu System ROM (ROM de sistema) decide qual computador você tem. As três máquinas C-BIOS já vêm embutidas; as ROMs de máquinas reais têm direitos autorais, então você carrega os dumps das suas, e eles ficam no seu navegador.

Você carrega	Você ganha	Arquivos
Nada	C-BIOS MSX1, MSX2 ou MSX2+: roda cartuchos, sem BASIC	Embutido
Uma BIOS de MSX1	MSX BASIC: Gradiente Expert 1.0 ou 1.1, Sharp Hotbit, qualquer MSX1	Um arquivo de 32K, como `expert_1.1_basic-bios1.rom`
Uma BIOS de MSX2	MSX BASIC 2.0, 80 colunas, SCREEN 5-8	ROM principal e SUB-ROM juntas (dois arquivos, ou um zip)
O kit MSX2+ brasileiro	Seu Expert ou Hotbit como MSX2+: BASIC 3.0, o logotipo do MSX2+, 512K e MSX-MUSIC, se a SUB-ROM tiver	Uma ROM `main_2p_…` e uma ROM `sub_2p_…` juntas

Carregando uma BIOS

Clique em Load BIOS… (carregar BIOS), embaixo de System ROM.
Escolha o arquivo; para um MSX2 ou MSX2+, os dois arquivos de uma vez (segure ⌘ ou Ctrl para selecionar dois) ou um zip com ambos.
Ela entra no menu System ROM e o MSX reinicia com ela. Troque de máquina pelo menu quando quiser; Remove (remover) esquece a que estiver selecionada.

3Cartuchos e a estante

Clique num slot ou solte um arquivo na página para carregar um cartucho (.rom, .mx1, .mx2, .bin ou .zip). O ⏏ tira o cartucho.
Todo cartucho, fita e disquete que você carrega vai para a Shelf (estante), embaixo dos slots. Clique num deles para recolocá-lo no slot 1, ou no seu 2 para o slot 2; o × tira o item da estante.
Cartuchos grandes trocam bancos de memória, e cada fabricante fez isso do seu jeito. O Ok-Prompt adivinha o esquema pelo código; se um jogo não iniciar, escolha outro no menu embaixo do slot: Konami, Konami SCC, ASCII 8K, ASCII 16K.
Jogos que salvam (RPGs com memória mantida por bateria) precisam de ASCII 8K + 8K battery RAM ou ASCII 16K + 2K battery RAM nesse menu. Os saves ficam no navegador e voltam junto com o cartucho.

Carregando por um link

Um link pode trazer os arquivos junto, e assim um site pode dizer "jogue isto no navegador":

https://ok-prompt.stern.workers.dev/?rom=https://example.org/jogo.rom

`rom=`, `rom2=`	Um cartucho para o slot 1 ou 2 (um `.zip` também serve)
`tape=`	Um `.cas` ou `.tsx` para o gravador de fita
`disk=`, `diskb=`	Um `.dsk` para o drive A ou B
`bios=`	`cbios`, `cbios2` ou `cbios2p` (MSX1, MSX2, MSX2+), ou o nome do arquivo de uma BIOS que você carregou

Junte vários com &. O navegador busca cada arquivo no site dele, que precisa permitir isso (o GitHub e o archive.org permitem, muitos acervos de ROMs não); se não der, o slot avisa, e você pode baixar o arquivo e soltá-lo na página.

4Teclado, colar texto e joysticks

As teclas digitam o que está impresso no teclado do seu PC: símbolos e acentos passam pela tabela de teclas da BIOS em uso, então um teclado brasileiro digita ç, ã e " certinho num Expert. Letras, setas e Espaço continuam nas posições do MSX, para os jogos. O ajuste Keyboard (teclado) pode pôr todas as teclas nas posições do MSX.

Teclas que o PC não tem

GRAPH	Alt da esquerda
CODE	Alt da direita (acentos nos MSX brasileiros)
STOP	F7 (CTRL+STOP: Ctrl+F7)
SELECT	F8
F6-F10	Shift + F1-F5
Teclado numérico	O teclado numérico do PC

Joysticks e o mouse

As setas e o Espaço funcionam na maioria dos jogos. Um gamepad é o joystick 1: conecte e aperte um botão.
A Joystick port 1 (porta de joystick 1, em Settings) pode receber um mouse MSX, para programas de desenho. Clique na tela para capturar o ponteiro; Esc devolve. Os botões esquerdo e direito são os do mouse.

5Fitas cassete

Clique no gravador ou solte um arquivo .cas ou .tsx. O gravador mostra o primeiro arquivo da fita e de que tipo ele é.
▶ Load (carregar; com uma BIOS que tenha BASIC) reinicia o MSX e digita o comando certo para você. Ou digite você mesmo: BLOAD"CAS:",R (código de máquina), CLOAD e depois RUN (BASIC), RUN"CAS:" (BASIC em texto).
⏮ rebobina; o número ao lado da fita indica quanto já foi tocado.
＋ Blank (fita virgem) insere uma fita vazia: CSAVE"NAME", SAVE"CAS:NAME" ou BSAVE"CAS:… gravam nela, e ⤓ faz o download.

6O drive de disquete

Um drive precisa da ROM de disco de uma interface de verdade (ela contém o Disk BASIC e o MSX-DOS, que têm direitos autorais). Carregue a sua uma vez e ela fica no navegador. Como funcionavam os drives, e os modelos brasileiros, está na página de história.

Configurando

Em Disk drive, no painel Machine, clique em Load disk ROM… (carregar ROM de disco) e escolha a ROM (16K, ou um zip com ela). O MSX reinicia com um drive.
Dois drives aparecem embaixo do gravador de fita, A: e B:. Solte um .dsk na página (ele vai para o A:) ou clique num drive; ＋ Blank insere um disquete vazio de 720K. Na estante, o B de um disquete o coloca no drive B.
Jogos em vários disquetes pedem o próximo: ejete e coloque-o no drive A:, pela estante ou pelo botão do drive. Copiar entre disquetes funciona entre o A: e o B:.
O MSX1 não tem relógio, então a ROM de disco pede a data ao iniciar, como num aparelho de verdade. Digite no formato que ela pedir (umas querem dia-mês-ano, outras mês-dia-ano), ou simplesmente aperte Enter.
Você cai no Disk BASIC. Um disquete com MSXDOS.SYS e COMMAND.COM dá boot no MSX-DOS.

Disk BASIC em cinco comandos

`FILES`	Lista o disquete
`SAVE"NAME"`	Salva o programa (`LOAD"NAME"` e `RUN"NAME"` trazem de volta)
`BLOAD"GAME.BIN",R`	Carrega e executa código de máquina
`KILL"NAME.BAS"`	Apaga um arquivo
`CALL FORMAT`	Formata o disquete: responda A e depois qualquer tecla

Quais ROMs de disco funcionam

Qualquer ROM de disco MSX comum: testadas as do Philips VG-8235, Sony HB-3600, Microsol CDX-2 e FastDROM (a versão para CDX-2), no Expert 1.0 e 1.1, no Hotbit, em MSX1 internacionais e no kit MSX2+.
Alguns dumps de EPROM de placas brasileiras (DDX, TPX, DMX), como arquivo, não iniciam do jeito que uma ROM de disco inicia, e são recusados. Para esses drives, use o arquivo da CDX-2 ou da FastDROM CDX-2: aqui ele faz o mesmo serviço.
A FastDROM é a que deixa mais memória livre.

Guardando seus disquetes

Tudo o que o MSX grava fica no navegador. ⤓ baixa o disquete como .dsk, para guardar ou abrir em outros emuladores.

7Som e música FM

O chip de som do próprio MSX (três tons e ruído) sempre toca; os cartuchos Konami com SCC somam seus cinco canais de forma de onda.
FM sound (MSX-MUSIC) (som FM), no painel Sound, coloca na máquina o chip FM Yamaha YM2413, como no cartucho FM-PAC e nas máquinas MSX2+. Os jogos que o conhecem tocam sua música FM. Mudar essa opção reinicia o MSX.
Com a SUB-ROM com_fm do kit MSX2+, o chip já vem embutido, com seu FM-BASIC: CALL MUSIC e depois PLAY #2,"CDEFGAB".
O controle de volume fica no painel Sound; o som começa depois do primeiro clique ou tecla na página.

8Estados salvos

As quatro posições em Save states (estados salvos, no painel Machine) guardam cada uma a máquina inteira: memória, chips, cartuchos, a fita e o disquete onde estiverem.
Save (salvar) guarda o MSX como está agora; salvar por cima de uma posição ocupada pede confirmação antes. Load (carregar) traz tudo de volta, BIOS, ROM de disco e cartuchos incluídos, exatamente onde estava.
Um estado precisa que sua BIOS e sua ROM de disco continuem carregadas no navegador. Os estados ficam só neste navegador.

9A impressora

LPRINT "Hello" e LLIST imprimem no papel do painel Printer (impressora). ⤓ Download salva a impressão como arquivo de texto; Clear (limpar) começa uma página nova.

10O modem e a BBS de IA

Pegue o ☎ Ok-Modem na estante e coloque num slot.
Com MSX BASIC, digite CALL TERM; com o C-BIOS, o terminal inicia sozinho. Num MSX2 ele mostra 80 colunas.
ATI lista as BBSes, ATDT 1 liga para a primeira. Você ouve o tom de discagem e o handshake.
ATDT DEEPSEEK liga para a BBS de IA: converse com o sysop ou com o BOFH, ou encomende um programa em BASIC; ele chega na sua fita para RUN"CAS:".
CTRL+STOP (Ctrl+F7) volta ao BASIC.

11O que o navegador guarda

Suas BIOS e ROMs de disco, os cartuchos nos slots e na estante, a fita, o disquete, os saves por bateria, os estados salvos, os ajustes e a memória do relógio do MSX2 ficam neste navegador, neste computador. Nada é enviado para fora. Apagar os dados do site (ou usar uma janela anônima) começa tudo do zero, então baixe as fitas e os disquetes que quiser guardar.

12Onde encontrar software

A maior parte do software de MSX, e toda BIOS e ROM de disco de máquina real, ainda tem direitos autorais. O Ok-Prompt não traz nada disso: o que você carrega é assunto seu. As fontes mais limpas vêm primeiro.

Livres ou legais

C-BIOS: a BIOS livre de MSX1, MSX2 e MSX2+, que já vem embutida.
MSXdev: o concurso anual de jogos novos para MSX. Os participantes são homebrew, em geral de download gratuito.
Project EGG: relançamentos oficiais de jogos de computadores japoneses, MSX entre eles (pagos, a maioria em japonês).
Sua própria máquina e seus cartuchos: fazer o dump do que é seu é o caminho mais seguro. O guia de configuração do openMSX explica ROMs de sistema e dumps.

Acervos da comunidade

File-Hunter: o maior acervo de MSX: jogos, fitas, disquetes, ROMs de sistema; algumas editoras liberaram seus títulos lá.
MSXPro: brasileiro, forte em máquinas brasileiras, versões de BIOS e interfaces de disco.
MSX Resource Center: notícias, a wiki do MSX e downloads de homebrew e ferramentas.
Generation MSX: um catálogo de todos os lançamentos de MSX (o que existe, quem fez, que máquina exige), sem downloads.

Esses acervos também hospedam arquivos com direitos autorais; para muitos títulos, isso é uma zona cinzenta.

O que o Ok-Prompt lê

Cartuchos	`.rom`, `.mx1`, `.mx2`, `.bin`
Fitas	`.cas`, `.tsx`
Disquetes	`.dsk` (360K ou 720K)
ROMs de sistema	Uma BIOS de MSX1 (32K); a ROM principal de um MSX2 ou MSX2+ com sua SUB-ROM
ROMs de disco	Dumps comuns de 16K (não as EPROMs das placas DDX, TPX ou DMX)
Qualquer um deles	Dentro de um `.zip`

13Quando algo não funciona

Um jogo mostra tela preta ou reinicia: tente outro esquema de bancos no menu embaixo do slot.
Sem som: clique uma vez na página; confira o volume e se Speed está em Normal.
Um jogo em fita não carrega com ▶ Load: ele precisa de uma BIOS com BASIC; o C-BIOS sozinho não carrega fitas.
A ROM de disco é recusada: provavelmente é um dump de EPROM de placa que não é lido como ROM de disco; use uma comum (veja O drive de disquete).
O BASIC responde Invalid date ao iniciar: a ROM de disco está pedindo a data; digite na ordem que ela mostra, ou aperte Enter.
O MSX2+ entra em 32 colunas: SCREEN 0:WIDTH 80:SET SCREEN.
As teclas digitam os símbolos errados: alterne o ajuste Keyboard entre Types what your keys say (digita o que está nas teclas) e MSX key positions (posições das teclas do MSX).

Pronto?

Carregue uma BIOS, coloque um cartucho, uma fita ou um disquete e digite PRINT "Olá, MSX".

Abrir o MSX →