Super Mario Kart November 1991 Prototype Repair by MrL314

Overview
******************************
*  Super Mario Kart Nov'91   *
*     Prototype  Repair      *
*                            *
*         by MrL314          *
******************************
last updated: July 28, 2021


>>>>> Please read through the entire README before starting! <<<<<


If you encounter issues, see if your issue is answered in the FAQ section at the bottom.

Table of Contents:
1. Setup
2. User Manual
3. FAQ




Special Thanks:
  Sirgren
  Dirtbag
  Catador
  atomic
  SmorBjorn
  R4M0N
  SMK Workshop community
  and YOU!




DISCLAIMERS:
--------------------------------------------------------------------------
This set of scripts and programs is provided free of charge and without warranty.
It is not to be distributed with any additional files, these must be provided by 
the user at their own risk. 

This project is in no way affiliated with Nintendo. I have no connections to Nintendo,
and I have not been endorsed or sponsored by Nintendo. 









====================================================================

    Setup

====================================================================



Requirements:
 - Python 3 (https://www.python.org/downloads)
   - I recommend at least Python 3.6. See "Python Notes" below for more info.
 - bsnes-plus
   - I have provided a download mirror link below. See "BSNES Notes".
 - (Optional) bsnes-plus SFX-DOS
   - I have provided a download mirror link below. See "BSNES Notes".
     - Please use this version, as it supports the remapping needed to
       use DOS functions with Super Mario Kart




IMPORTANT NOTE:
--------------------------------------------------------------------------
To get this repair to work correctly, the .cht file, .xml file, and .srm file MUST have the 
same file name as the repaired ROM. By default this is done for you, since the repaired
ROM is named "Nov91.sfc". However, if you rename the ROM, you must also change the names
of the .xml, .cht, and .srm file to the same name. These files MUST always be in the same 
folder as the repaired ROM to work correctly.

Example: if you rename the ROM to "SMKnovember.sfc", you will also need to change the other 
files to
 - "SMKnovember.xml"
 - "SMKnovember.srm"
 - "SMKnovember.cht"







How to build:
--------------------------------------------------------------------------

Downloads and Installs:
1. Install Python. (See "Python Notes" below)
2. Download bsnes-plus. You may use the mirror link I provided above.
3. Download bsnes-plus SFX-DOS. You may use the mirror link I provided above.



Obtain files:
  !!! By obtaining these files, you do so at your own risk. !!!
1. Obtain the NEWS_05 folder from the July 24, 2020 gigaleak.
2. Obtain game.hex from NEWS_05/home/kimura/games.lzh/games/temp, and put in this folder.
3. Obtain drive-data from NEWS_05/home/kimura/kart/mak.lzh/mak, and put in this folder.
4. Obtain a USA unheadered (512kb) ROM of Super Mario Kart, and put in this folder.
5. Rename the USA ROM to "Super Mario Kart (USA).sfc" if it is not already named so.
6. Obtain a dsp1b binary (usually literally called dsp1b.bin), and put in this folder.



At this point you have two options. If you are doing this just to play around with the 
Nov'91 prototype, read the instructions in "Build (Base and Fix)". However, if you are building
with the intent of research or documentation without all of my other playability fixes 
on top, read the instructions in "Build (Base Only)".






Build (Base and Fix):
1. Run "base_setup.bat". This will create the base repair, without any of the extra fixes.
  - See "Python Notes" below if you encounter issues with this step.
2. Run "extra_fixes.bat". This will enable ALL of my extra fixes for the prototype.
  - This includes SFX-DOS repairs.

Now read "SFX-DOS or not?" below to continue.





Build (Base Only):
1. Run "base_setup.bat". This will create the base repair, without any of the extra fixes.
  - See "Python Notes" below if you encounter issues with this step.

This will not apply any of the extra fixes that I have applied to the code. The only things that
are changed by the base repair are that the asset data is added, and the pointers are adjusted
accordingly so that the data will be read properly. 

Now read "SFX-DOS or not?" below to continue.






SFX-DOS or not?:

If you would like to run in bsnes-plus SFX-DOS, you may do so at this time by opening
   "Nov91.sfc" in bsnes-plus SFX-DOS. Make sure to open the cheat editor by going to 
   Tools > Cheat Editor, and enable cheats 7 and 8. Then restart the ROM.


If you instead would like to run in regular bsnes-plus, first open "Nov91.sfc" in bsnes-plus.
   Then, go to the cheat editor by going to Tools > Cheat Editor, and enable cheats 2 and 3. Then
   restart the ROM. This will disable the SFX-DOS stuff, meaning you will be able to run this on 
   regular bsnes-plus.







Python Notes:
--------------------------------------------------------------------------
- When installing Python, make sure that you select "Add to PATH" during the set up.
- Make sure that you turn off app execution aliases if using windows. Go to 
   Settings > Apps > Apps & Features > App execution aliases
   and turn off all of the ones that say "python".
- When running the setup script, if you see the message 
     "'python' is not recognized as an internal or external command, operable program
     or batch file."
  you likely will need to edit the settings in "settings.bat". Right click the file and
  click "Edit". Then edit the python_cmd variable. In most cases, it will work if you change
  the variable to one of these options:
    - "python"
    - "python3"
    - "py"
    - "py3"
  If none of those work, you will need to look up what the PATH variable was set to.






BSNES Notes:
--------------------------------------------------------------------------
This repair will ONLY work in BSNES. Due to compatibility 
issues with other emulators, this prototype cannot run in other 
emulators or on physical hardware. I apologize for the inconvenience, 
but ensuring compatibility for all emulators would cause more issues 
than it would solve.

I have made mirror links to the versions of bsnes-plus and bsnes-plus SFX-DOS that I used
while making this repair. For the most accurate results, please use these versions:
* bsnes-plus: 
        https://download1592.mediafire.com/gwscvs01pwzg/twtl3tfa902z9rc/bsnes-plus.zip
* bsnes-plus SFX-DOS: 
        https://download1338.mediafire.com/mj7pmd8d3yvg/p1qhc7pal9n0zo5/bsnes-plus-v05.79-sfx-dos.zip

For the most accurate results, I recommend using the accuracy versions. You are free to
try with other versions of bsnes, but I cannot guarantee that they will work as intended.








====================================================================

    User Manual

====================================================================

More information on controls can also be found here: https://tcrf.net/Proto:Super_Mario_Kart/November_29,_1991_Proto

This is just a compact reference just in case.



General controls:
-----------------
Start - Pause:  Works in most screens and modes. If the game seems to have frozen try pressing start to unpause
Y+B+Start+Select - Reset:  Works on all modes, use to get back to the main menu from any mode
Up/Down - Navigates the menu
Left/Right - Change menu values
B/Y - Starts with whatever menu values are selected


Main Menu:
----------
MODE
  A = Player 1/ Top screen
  B = Player 2/ Bottom screen
  MAN - Human control racer
  MON - Monitoring mode, debug values are displayed
  COM - CPU controlled racer

PLAY-1/2 - Driver selection (If MAN or COM is selected)
  PLAY-1 = Player 1 driver
  PLAY-2 = Player 2 driver
  MARIO, LUIGI, KOOPA (Bowser), PEACH (Princess), CONG (D.K. J.r.), NOKO (Koopa Troopa), KINO (Toad), YOSSY (Yoshi)

DISP-1/2 - Screen mode if MON is selected
  FR-VIEW - Same perspective as the main screen but with debug values and AI path's denoted with the tracks items
  REA-VIEW - Backwards looking view of your racer SD-VIEW - Same view as main screen, without extra sprites layers (Lakitu etc.)
  LONG-PER - View of the whole track (Similar to the final version of the game (Racers sprites are smaller than on the final version)
  NO-PERS1 - Over head view of of the whole track
  NO-PERS2 - Over head view of main racer
  NO-PERS3 - Over head view of main racer but with a keystone effect

MAP - Course selection
  CIRC = Mario Circuit
  OBAKE = Ghost Valley
  GRASS = Donut Plains
  CASTLE = Bower Castle
  ICE = Vanilla Lake
  DART = Chocolate Island SAND = Koopa Beach
  BATTLE = Battle mode test course

PROG - Mode
  RACE = Takes the MODE, PLAY-1, PLAY-2 & MAP Settings and starts a race  
  BATL = Takes the MODE, PLAY-1, PLAY-2 & MAP Settings and starts a battle
    - Note that the battle mode can be changed via ED-3)
    - Any course other than BATTLE-1 will result in a VS race style mode without checkpoints
    - Anything other than MODE MAN-MAN might result in strange effects
  ED-1 = Editor mode for setting AI Zones and Targets
  ED-2 = Editor mode for overlay items such as Item boxes and Zippers
  ED-3 = Settings


RACE Mode
---------

Just a standard race 5 laps with CPU races, once the race is over it will not progress to another track and you will need to reset back to the main menu.


BATL Mode
---------

2 Players on the track to do battle, there is no scoring but you can make the other player spin when you hit them.
If you select MAN-MAN and any normal race track (not BATTLE-1) it will result in a VS-like race, but without the Checkpoint Zones.
If you select MAN-MON it will result in a VS-like race with a CPU opponent and the MON effect selected
If you select MAN-MAN, BATTLE-1 and BATTLE (mode) 0 there will be Coins/ Balls on the track to avoid
If you select MAN-MAN, BATTLE-1 and BATTLE (mode) 1 there you can press the L Button to fire projectiles 
Use ED2 to place item boxes and save to SRAM to make it a bit more interesting. Use ED3 to Enable Machine gun mode



ED1:
--------

EDITING:
  D-PAD     - Moves the cursor
  SELECT    - Cycles through the AI Zone Editing modes
  R-Trigger - Opens the Save/Load Menu


AI Zone Editing modes:
  CODE - Set the AI Zone type
            00: Rectangle
            02: Triangle top-left
            04: Triangle top-right
            06: Triangle bottom-right
            08: Triangle bottom-left
            0A: Diagonal Line top-right to bottom-left
            0C: Diagonal Line top-left to bottom-right
        B - Increase the zone type. After 0C, this will remove the zone.
        Y - Decrease the zone type. After 00, this will remove the zone.
  SET  - Set the AI Zone size. 
        Remove zone   - Press Y on the tile you placed in CODE
        Set zone size - Press B on the tile you placed in CODE (this is your Start_X and Start_Y), then 
                        press B on another part of the map. (this is your Final_X and Final_Y)
          Each zone has specific requirements for size placement.
            00: Final_X more right than Start_X, Final_Y lower than Start_Y
            02: Final_X equal to Start_X, Final_Y lower than Start_Y
            04: Final_X equal to Start_X, Final_Y lower than Start_Y
            06: Final_X equal to Start_X, Final_Y higher than Start_Y
            08: Final_X equal to Start_X, Final_Y higher than Start_Y
            0A: Final_X more left than Start_X, Final_Y lower than Start_Y
                  - Distance between Final_X and Start_X must be less than distance 
                    between Final_Y and Start_Y to work properly
            0C: Final_X more right than Start_X, Final_Y lower than Start_Y
                  - Distance between Final_X and Start_X must be less than distance 
                    between Final_Y and Start_Y to work properly
  PONT - Setting the AI Targets & Zone speeds. 
           Zone that the current target is connected to is indicated by P in the menu on the left
        B - Set the Zone Target. 
        Y - Delete the Zone Target.
        X - Cycle through the Zone Speeds (Indicated by S in the menu on the left)
          Blue   - Speed 1 (Low speed)
          Green  - Speed 2 (Mid-Low speed)
          Yellow - Speed 3 (Mid-High speed)
          Red    - Speed 4 (High speed)


Save/Load Menu: 
  R-Trigger        - Closes the Save/Load Menu
  L-Trigger        - Cycles through the save slot numbers (0-5)
  D-PAD Up/Down    - Cycles through Save/Load options
                     S-DISK - Save data to the Floppy Disk (virtual) via the SFX-DOS
                     S-RAM  - Save data to SRAM
                     L-DISK - Load data from the Floppy Disk (virtual) via the SFX-DOS
                     L-RAM  - Load data from SRAM
                     CLEA   - Remove edited data from the course
  D-PAD Left/Right - Select between YES/NO for Save and Load options
  B                - Executes the selected option


Note: When you edit a level, you MUST save to SRAM (by using the S-RAM option) and exit to the main menu (Y+B+START+SELECT). Then when you race/battle on that course, it will use your edited values.



ED-2
--------

EDITING:
  D-PAD     - Moves the cursor
  B         - Places the object
  Y         - Deletes the object
  SELECT    - Opens the "SELECT YAKUMONO" Menu
  R-Trigger - Opens the Save/Load Menu

Save/Load Menu: 
  R-Trigger        - Closes the Save/Load Menu
  L-Trigger        - Cycles through the save slot numbers (0-5)
  D-PAD Up/Down    - Cycles through Save/Load options
                     S-DISK - Save data to the Floppy Disk (virtual) via the SFX-DOS
                     S-RAM  - Save data to SRAM
                     L-DISK - Load data from the Floppy Disk (virtual) via the SFX-DOS
                     L-RAM  - Load data from SRAM
                     CLEA   - Remove edited data from the course
  D-PAD Left/Right - Select between YES/NO for Save and Load options
  B                - Executes the selected option
  


SELECT YAKUMONO Menu:
  SELECT           - Closes the "SELECT YAKUMONO" Menu
  D-PAD Up/Down    - to select overlay item type
                       QUES - Item Box
                       NIKO - Used Item box
                       AROW - Zipper Arrow
                       KABE - Multicolored 2x2 Wall
  D-PAD Left/Right - to select overlay item orientation
                       0N (Upward facing)
                       0E (Right facing)
                       0S (Downward facing)
                       0W (Left facing)


Note: When you edit a level, you MUST save to SRAM (by using the S-RAM option) and exit to the main menu (Y+B+START+SELECT). Then when you race/battle on that course, it will use your edited values.




ED-3:
----

Y - Reduce value
B - Increase value


BATTLE OBJ  - If 0, the BATTLE mode will be the coins flying around the field.
              If 1, the BATTLE mode will be the machine gun mode.
BOUND POWER - Collision bounce power. It’s a signed number, so anything 80h and above you need to subtract 256 from it.
MODE7 CHAR  - Tile map for the course selected under MAP on the main menu
COLOR MAP   - Palette set for the course selected under MAP on the main menu
MARIO       - Sprite view of the 8 racers with the palette set for the course selected - Most likley this was used to make sure the 
              drivers sprites looked correct for each theme

After you set the values for BATTLE OBJ and BOUND POWER, exit back to the main menu with (Y+B+START+SELECT). This will save your settings.



Fun things to try:
------------------
- With MON mode as FR-VIEW, you can see a unique RAM editor, as well as see the AI target coordinates.
- You can use the level editor ED-1 to create a custom AI pathing for a track, save it to SRAM and then race on that track with that AI setup.
- You can use the level editor ED-2 to set item boxes on the course, save it to SRAM and then battle/ race on that track with items.
- You can toggle item debug mode by pressing L+R+X+A
- You can toggle the mini memory viewer by pressing L+R+Down+SELECT
- You can toggle the CPU usage viewer by pressing L+R+Up+SELECT while in MON mode


Things to be aware of:
----------------------
This is early code, so it is full of bugs, the game can crash easily.










====================================================================

    FAQ

====================================================================

Q: The script says "'python' is not recognized as an internal or external command, operable program
   or batch file."
A: See "Python Notes" above.


Q: The base patch batch script keeps opening up the Windows Store.
A: See "Python Notes" above.


Q: Why is the screen blue with a weird glitched sprite on the top left?
A: You are running the SFX-DOS enabled version on normal BSNES. Make sure you disable the SFX-DOS via
   the cheat editor by enabling cheats 2 and 3, then restarting the ROM.


Q: Why can't this run on snes9x, zsnes, retroarch, etc.?
A: See "BSNES Notes" above.


Q: I loaded in my data using the L-DISK command. Why is it not showing up in the race?
A: The data that gets used comes from SRAM. So, you need to first use L-DISK to load the data,
   and then use S-RAM to save it to SRAM. Then it will show up in the race.


Q: The game freezes when I try to use L-DISK.
A: Most likely the save data is missing from the floppy disk. If you never saved to the disk using S-DISK
   for that file, this will happen. You can only load from the disk if there is data for that file already
   on that disk. You can check if your file was saved by opening the floppy disk created by BSNES-plus SFX_DOS
   in a hex editor (my personal preference is HxD) and going to around address 2000. The file should be named 
   in this format: ABBB-CD, where
        A     - is the editing mode: R for ED-1, Y for ED-2
        BBB-C - is the track name and number
          where BBB can be 
            CIR = CIRCUIT
            OBA = OBAKE
            GRA = GRASS
            CAS = CASTLE
            ICE = ICE
            DAR = DART
            SAN = SAND
            BTL = BATTLE
          and C can be a value from 1-4 depending on the track name.
        D     - is the save slot number, (0-5)
   For example, the file name "YCAS-32" indicates 
        A     = Y (ED-2 mode)
        BBB-C = CAS-3 (CASTLE-3 map)
        D     = 2 (Save slot 2)
   and the file name "RCIR-41" indicates 
        A     = R (ED-1 mode)
        BBB-C = CIR-4 (CIRCUIT-4 map)
        D     = 1 (Save slot 1)
   If the file name does not exist, this will crash the game. 
   
   Alternatively, if you have the dos.hex tool working, you may copy the floppy disk files, rename them accordingly, 
   and then run dos.hex in BSNES-plus SFX-DOS. Input the command "chdisk dd9", press enter, and then input the 
   command "dir". This will show you a list of the files saved on the disks. If your file is not listed, it doesn't
   exist, and will crash the game when trying to load it.
   
   TL;DR - L-DISK only works if the file exists, which happens after you save it using S-DISK.


Q: I messed up my SRAM file, and I want to revert my changes to the original version. How do I do that?
A: Run the reset_sram.bat file after closing BSNES. This will revert the SRAM to its default.


Q: The game won't let me go to the main menu with the button combo Y+B+START+SELECT
A: The game has likely hard crashed and will need to be restarted manually.


Q: How do I download this?
A: Here's a quick download link. https://github.com/MrL314/smknov91/archive/refs/heads/main.zip



-MrL314
Owner
MrL314
MrL314
Experimental Brawl Stars v37.222 server emulator written in Python.

Brawl Stars v37 Experimental Brawl Stars v37.222 server emulator written in Python. Requirements: Python 3.7 or higher colorama Running the server In

13 Oct 08, 2021
2D ping pong game

pingpong 2D Ping Pong game How to play: player 1 w To move up s To move Down player 2 up To move up down To move Down To change the game settings, you

menachem 0 Mar 27, 2022
A basic quiz game using Python

QuizGame A basic quiz game using Python Passwords for quizzes (NO CAPS LOCK!): -ryzermattishandsome -canisleepwithyou Before using this, please make s

Austin 1 Nov 12, 2021
A Game of Life implementation in Python

Game of Life in Python (Golipy) Golipy is a simulator of John H. Conway's Game of Life, developed in Python based on the Pygame library. This is a toy

Alber 2 Dec 10, 2021
I automated the lumberjack game on telegram, by recognising pixels and using pyautogui module

Lumberjack Automated: @gamebot According to the official documentation, @gamebot is a demo bot for the Telegram Gaming Platform.` It provides some sam

Yew Chong 1 Dec 07, 2021
A launcher to launch games from Riot Games under Linux

rito-launcher A launcher to launch games from Riot Games under Linux Requirements: Python 3, with the following pip plugins: 'configparser, pathlib, w

6 Mar 07, 2022
Automatic game data translator for RPGMaker-MV

RPGMaker-MV Translator 🕹️ 🎮 Use AI to translate all the dialogs and texts of your RPGMaker automatically. 👊 You worked hard to make your game, now

Davide Liu 11 Dec 26, 2022
Building a Mario-like, classic platformer game in Python using the PyGame Library

Building a Mario-like, classic platformer game in Python using the PyGame Library

Clarence Vinzcent Reyes 1 Feb 06, 2022
Open source Brawl Stars server emulator for version 29 of the game!

Welcome to Classic-Brawl v29 Remake 👋 Open source Brawl Stars server emulator for version 29 of the game! (Remake) What's working ? Battles Trophies

CrossFire 4 Jan 19, 2022
Command-line Hangman game

Hang-_an-game-python-build Hangman C command-line Hangman game. Compilation Navigate to the root of the repository from your Terminal and run make to

Hemant Choudhary 3 Jan 16, 2022
A Pygame Hangman Game coded in Python 3. Run Hangman.py in a terminal if you have Python 3

Hangman A Pygame Hangman Game coded in Python 3. Run python3 Hangman.py in a terminal if you have Python 3.

1 Dec 24, 2022
python script to convert .OBJ files into Minecraft, rendering them in game with a core shader.

samples: random notes about the tool general output format: (animation not supported yet but planned) vertex id Minecraft's gl_VertexID isn't per mode

199 Jan 02, 2023
Turn NY Times crosswords into Across Lite files

NYT Crossword to Puz A windows program to convert NY Times crosswords from the web to Across Lite compatible files. To run this, first download and de

31 Oct 11, 2022
The Bowling Club (Facebook Game) get all strikes.

TheBowlingClubBot The Bowling Club (Facebook Game) get all strikes. FAQ Q: What is this? A: TheBowlingClubBot is a automation bot with 99.99% guarante

#~Rith 1 Jan 19, 2022
Flappy bird using Pygames

flappy-bird Esse é um jogo que eu fiz utilizando a biblioteca de jogos do Python

Leandro Henrique 2 Jan 05, 2022
3D online shooter written on Panda3D 1.10.10 and Python 3.10.1

на русском itch.io page Droid Game 3D This is a fresh game that was developed using the Panda3D game engine and Python language in the PyCharm IDE (I

Marcus Kemaul 5 Jun 04, 2022
Cocos2d-x is a suite of open-source, cross-platform, game-development tools used by millions of developers all over the world.

cocos2d-x Win32 Others cocos2d-x is a multi-platform framework for building 2d games, interactive books, demos and other graphical applications. It is

cocos2d 16.7k Jan 04, 2023
A minimal open source mtg-like tcg game made in python that can be played on a terminal emulator using a keyboard.

A minimal open source mtg-like tcg game made in python that can be played on a terminal emulator using a keyboard.

Amos 3 Aug 29, 2021
Open source translation for the Tsukihime Remake game

Tsukihime-Translation Open source translation for the Tsukihime Remake game prepared by Clovermoon and Tsukihimates. Copyright Disclaimer under Sectio

118 Jan 01, 2023
中文版本的ai地牢,一个使用GPT-2的文字冒险游戏,使用清源CPM预训练模型finetune而成。

中文版本的ai地牢,一个使用GPT-2的文字冒险游戏,使用清源CPM预训练模型finetune而成。

icybee 178 Jan 03, 2023