Abdessamad Derraz
123d698e43
generate_site.py writes the Starlight project in website/ and nothing else: mkdocs.yml, the MkDocs hooks, theme overrides and stylesheet go, and the wiki is written in Starlight's syntax. Both workflows set up Node with the official actions/setup-node pinned by commit, run npm ci from the committed lockfile, build with the strict link validator and check the result with validate_site.py. The search weighs a page by what it answers: Start here pages first, a system page's cards and file names before a guide citing them, deep guides, launchers, aliases and frozen copies after. Status badges, hash blocks and the export change lists leave the index. The ranking sits at the centre of a range where the 13 queries of search_gate.py all answer, in the search box itself. 839 pages, every URL and 45,611 ids match the MkDocs build. The tests read the Starlight content and syntax.
1.8 KiB
level, order, nav_title
| level | order | nav_title |
|---|---|---|
| start | 10 | What BIOS files are |
What is a BIOS?
A console has a small program inside it. It starts first, then starts the game. This program is the BIOS, also called firmware.
An emulator is an app that acts like a console. For many consoles, it needs a copy of the BIOS. That copy is a file: a BIOS file.
How it works
- You pick a game in your game menu.
- The menu starts the emulator.
- The emulator opens the BIOS file in your BIOS folder.
- The game starts.
If step 3 fails, you see "BIOS missing" or a black screen.
Do I need one?
- Yes: PlayStation 1 and 2, Saturn, Dreamcast, Neo Geo, PC Engine CD and many home computers.
- Usually not: NES, Super Nintendo, Mega Drive, Game Boy and Game Boy Advance.
- Add-ons need their own: the Famicom Disk System and the Mega-CD.
Details: Every console, one by one
The name must match
An emulator looks for one exact name. A PlayStation emulator looks for
scph5501.bin. A file with another name is not found.
The version must match
Two files can have the same name and different contents. One may be for Japan, another for Europe.
Some setups check each file's hash, a fingerprint of its contents. Batocera, Recalbox and EmuDeck report a version they do not expect.
Our files are the versions each setup expects.
Can a game start without it?
Sometimes. Some emulators carry their own code in place of the BIOS. Some games then glitch or do not start. The real file works best, so we include it.
Is it legal?
Laws differ by country. Read the project's position.
:::tip[Next]