A free, open-source fan-made 3D kart racing game inspired by SuperTuxKart and the SSK/SSKDX series by Lucasliu9595, built from the ground up in C++ using the raylib library!

⚠️ Fan Project Disclaimer: This is a non-commercial, fan-made project. All original concepts and characters are inspired by the "Super Scratch Kart" series and the Scratch Team. This project is not affiliated with or endorsed by the original creators.

Note: This project is currently a work in progress (WIP). As it is in active development, you may encounter bugs, performance issues, or incomplete features. We appreciate your patience and feedback!

🏎️ Features

• Modern Engine: High-performance 3D rendering powered by raylib.

• Classic Gameplay: Drift-heavy kart physics and high-speed racing.

• Cross-Platform: Designed to run on Windows, Linux, and macOS.

• Open for Contribution: Built with clean C++ code for easy modding and updates.

🎮 Controls

Action	Key Binding
Accelerate	W / Up Arrow
Brake / Reverse	S / Down Arrow
Steer Left	A / Left Arrow
Steer Right	D / Right Arrow
Drift	L Shift / R Shift
Hop	Z
Pause	Esc

🛠️ Build Instructions

Prerequisites

• A C++ 17 compatible compiler (GCC, Clang, MSVC, or MSYS2 for Windows).
• raylib 5.5+.
• CMake 4.2.3+ (Required for build configuration)
• Git
• Notepad++ or Visual Studio Code (recommended for development)

Building from source

Open a terminal and run these commands:

git clone https://github.com/JimmiesAndTheCoders/SuperScratchKartR.git
cd SuperScratchKartR

How to compile

🪟 Windows

Ensure you have raylib installed at C:\raylib.

1. Open the project folder.
2. Run build.bat

🐧 Linux

Ensure you have gcc and raylib development headers installed (libraylib-dev).

1. Open your terminal in the project folder.
2. Make the script executable: chmod +x build.sh
3. Run it: ./build.sh

🍎 MacOS

Ensure you have brew install raylib or the raylib framework installed.

1. Open your terminal in the project folder.
2. Make the script executable: chmod +x build.sh
3. Run it: ./build.sh

🗺️ Roadmap

I made this roadmap, just for development of things that are crucial for this game. When I complete all of these, I will add more features and content, but for now, this is the bare minimum for a playable game.

Development

Completed Tasks

• Implement basic kart physics and controls.
• Add sound effects and music.
• Add .glb files for track (formerly .obj).
• Add drifting, and a more robust physics system.
• Add character models and animations.
• Add tree models scattered around without lagging.
• Add .ttf font and replace current font assets.
• Add logo and put it into the game.
• Implement a suspension system for better terrain handling.

In Progress & Upcoming

• Implement power-up system (boosts, projectiles, obstacles) by question lootboxes.
• Create UI HUD (Speedometer, Lap counter, Position).
• Remodel the entire track, now with grass.
• Redesign the pause screen, now with moving stripes, and with some shadows.
• Design a "Mini-map" system to track player.
• Design and implement multiple race tracks.
• Add more characters and karts with unique stats.
• Add local split-screen or online multiplayer support.
• Add debug system by Konami Code.
• Implement AI opponents with waypoint pathfinding.
• Implement AI defensive/offensive logic (using power-ups strategically).
• Add environmental hazards (oil spills, falling rocks).
• Add dynamic lighting and custom shaders (smoke, sparks).
• Create a particle system for mud, grass, and drift marks.
• Remaster the physics for the kart's suspension, and add a more robust collision system.
• Add a screen capture tool.
• Implement a camera shake system for high speeds and collisions.
• Optimize performance and fix physics engine bugs.
• Add crash handler and error logging system.
• Integrate a save system for high scores and unlocks.
• Add settings menu (audio, graphics) and credits.
• Add a screen recorder with using ffmpeg.
• Implement a "Replay System" to watch previous races.
• Add a main menu screen, game/player/map select.
• Implement a localization system for multi-language support.
• Add an achievement and trophy system.
• Add a mods and addons system.
• Final touches, and end roadmap.

🌟 Credits

• Programming: Jimmy Santoyo
• Model: Kenney
• Original Concept and Characters: Lucasliu9595 and the Scratch Team
• Music: Kevin Macleod
• Engine: raylib by Ramon Santamaria (raysan5)

💬 Feedback and Contributions

We welcome feedback, bug reports, and contributions! If you'd like to contribute, please fork the repository and submit a pull request with your changes. For major changes, please open an issue first to discuss what you would like to change.

📄 Non-commercial Notice

This project is a fan-made creation for educational and entertainment purposes. It is distributed as-is without a formal commercial license. Use, study, and modification of the source code are encouraged for personal and community learning.