From c9f08ece8c145568e624ef0cb7670340970667bb Mon Sep 17 00:00:00 2001 From: birdybro Date: Mon, 19 Apr 2021 10:05:56 -0600 Subject: [PATCH] Update readme and add MiSTer-themed custom borders (#158) With this proposed change the readme now references the custom borders feature, and I added the custom borders from @siskavard (with his permission) and one of my own. I also mildly adjusted the grammar in the readme for enhanced readability. --- ReadMe.md | 22 ++++++++++++---------- borders/borders_20210418.zip | Bin 0 -> 12333 bytes 2 files changed, 12 insertions(+), 10 deletions(-) create mode 100644 borders/borders_20210418.zip diff --git a/ReadMe.md b/ReadMe.md index eab8da1..2d0e97c 100644 --- a/ReadMe.md +++ b/ReadMe.md @@ -1,4 +1,4 @@ -# [Gameboy](https://en.wikipedia.org/wiki/Game_Boy) / [Gameboy Color](https://en.wikipedia.org/wiki/Game_Boy_Color) for MiSTer Platform +# [Gameboy](https://en.wikipedia.org/wiki/Game_Boy) / [Gameboy Color](https://en.wikipedia.org/wiki/Game_Boy_Color) port to [MiSTer](https://github.com/MiSTer-devel/Main_MiSTer/wiki) This is port of [Gameboy for MiST](https://github.com/mist-devel/mist-board/tree/master/cores/gameboy) @@ -8,6 +8,7 @@ This is port of [Gameboy for MiST](https://github.com/mist-devel/mist-board/tree ## Features * Original Gameboy & Gameboy Color Support * Super Gameboy Support - Borders, Palettes and Multiplayer +* Custom Borders * SaveStates * Fastforward * Rewind - Allows you to rewind up to 40 seconds of gameplay @@ -18,25 +19,26 @@ This is port of [Gameboy for MiST](https://github.com/mist-devel/mist-board/tree * Cheats ## Open Source Bootstrap roms -This now includes the open source boot ROMs from [https://github.com/LIJI32/SameBoy/](https://github.com/LIJI32/SameBoy/) (for maximum GBC compatibility/authenticity you can still place the Gameboy color bios/bootrom into the Gameboy folder and rename it to boot1.rom) +This now includes the open source boot ROMs from [https://github.com/LIJI32/SameBoy/](https://github.com/LIJI32/SameBoy/). For maximum GBC compatibility/authenticity you can still place the Gameboy color bios/bootrom into the Gameboy folder and rename it to boot1.rom ## Palettes -Core supports custom palettes (*.gbp) which should be placed into Gameboy folder. Some examples are available in palettes folder. +This core supports custom palettes (*.gbp) which should be placed into the Gameboy folder. Some examples are available in the palettes folder. + +## Custom Borders +This core supports custom borders (*.sgb) which should be placed into the Gameboy folder. Some examples are available in the borders folder. ## Autoload -To autoload favorite game at startup rename it to boot2.rom +To autoload your favorite game at startup rename it to `boot2.rom`. ## Video output -The Gameboy can disable video output at any time which causes problems with vsync_adjust=2 or analog video during screen transitions. Enable the Stabilize video option to fix this at the cost of some latency. +The Gameboy can disable video output at any time which causes problems with vsync_adjust=2 or analog video during screen transitions. Enabling the Stabilize video option may fix this at the cost of some increased latency. # Savestates -Core provides 4 slots to save and restore the state. -Those can be saved to SDCard or reside only in memory for temporary use(OSD Option). -Usage with either Keyboard, Gamepad mappable button or OSD. +This core provides 4 slots to save and restore the memory state which means you can save at any point in the game. These can be saved to your SDCard or they can reside only in memory for temporary use (OSD Option). Save states can be performed with the Keyboard, a mapped button to a gamepad, or through the OSD. Keyboard Hotkeys for save states: -- Alt-F1..F4 - save the state -- F1...F4 - restore +- Alt+F1 thru Alt+F4 - save state +- F1 thru F4 - restore state Gamepad: - Savestatebutton+Left or Right switches the savestate slot diff --git a/borders/borders_20210418.zip b/borders/borders_20210418.zip new file mode 100644 index 0000000000000000000000000000000000000000..7434a620a864a36390f20a9b21fef85b27a1b022 GIT binary patch literal 12333 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 z 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 Vp#FI*(SCngelNNhvHdyv{{W-l#M}S? literal 0 HcmV?d00001