ClassiCube is a custom Minecraft Classic compatible client written in C from scratch.
It is not affiliated with (or supported by) Mojang AB, Minecraft, or Microsoft in any way.
ClassiCube runs on:
- Windows - 95 and later
- macOS - 10.5 or later (but can be compiled to work with 10.3/10.4 though)
- Linux - needs
libcurl
andlibopenal
- Android - 2.3 or later
- iOS - 10.3 or later
- Most web browsers (even runs on IE11)
And also runs on:
- Raspberry Pi - needs
libcurl
andlibopenal
- FreeBSD - needs
libexecinfo
,curl
andopenal-soft
packagea - NetBSD - needs
libexecinfo
,curl
andopenal-soft
packages - OpenBSD - needs
libexecinfo
,curl
andopenal
packages - Solaris - needs
curl
andopenal
packages - Haiku - needs
openal
package - BeOS - untested on actual hardware
- IRIX - needs
curl
andopenal
packages - SerenityOS - needs SDL2
- 3DS - unfinished, but usable
- Wii - unfinished, but usable
- GameCube - unfinished, but usable
- PSP - unfinished, rendering issues
- Dreamcast - unfinished, but renders
- PS Vita - majorly unfinished
- Xbox - majorly unfinished
You can download ClassiCube from here and the very latest builds from here.
ClassiCube strives to support providing an experience identical to the original Minecraft Classic by strictly following a clean room reverse engineering approach.
If you're interested in documenting or verifying the behaviour of the original Minecraft Classic, please get in contact with me. (unknownshadow200
on Discord)
- A complete re-implementation of Minecraft Classic 0.30, with optional additions
- Partially supports some features of Minecraft Classic versions before 0.30
- Lightweight, minimal memory usage compared to original Minecraft Classic
- Much better performance than original Minecraft Classic
- Works with effectively all graphics cards that support OpenGL or Direct3D 9
- It does not work with Minecraft Java or Bedrock edition servers
- It does not have a survival mode (nor will such a mode be added)
- It does not support logging in with Mojang/Minecraft accounts
Note: When running from within VirtualBox, disable Mouse Integration, otherwise the camera will not work properly
Initially, you will need to run ClassiCube.exe to download the required assets from minecraft.net and classicube.net.
Just click 'OK' to the dialog menu that appears when you start the launcher.
Singleplayer Run ClassiCube.exe, then click Singleplayer at the main menu.
Multiplayer Run ClassiCube.exe. You can connect to LAN/locally hosted servers, and classicube.net servers if you have a ClassiCube account.
The most common reason for being stuck on OpenGL 1.1 is non-working GPU drivers - so if possible, you should try either installing or updating the drivers for your GPU.
Otherwise:
- On Windows, you can still run the OpenGL build of ClassiCube anyways. (You can try downloading and using the MESA software renderer from here for slightly better performance though)
- On other operating systems, you will have to compile the game yourself. Don't forget to add
-DCC_BUILD_GL11
to the compilation command line so that the compiled game supports OpenGL 1.1.
Note: The various instructions below automatically compile ClassiCube with the recommended defaults for the platform.
If you (not recommended) want to override the defaults (e.g. to compile OpenGL build on Windows), see here for details.
Open ClassiCube.sln (File -> Open -> Project/Solution) and compile it (Build -> Build Solution).
If you get a The Windows SDK version 5.1 was not found
compilation error, see here for how to fix
- Use 'Developer Tools for Visual Studio' from Start Menu
- Navigate to the directory with ClassiCube's source code
- Enter
cl.exe *.c /link user32.lib gdi32.lib winmm.lib dbghelp.lib shell32.lib comdlg32.lib /out:ClassiCube.exe
I am assuming you used the installer from https://sourceforge.net/projects/mingw-w64/
- Install MinGW-W64
- Use either Run Terminal from Start Menu or run mingw-w64.bat in the installation folder
- Navigate to the directory with ClassiCube's source code
- Enter
gcc *.c -o ClassiCube.exe -mwindows -lwinmm -limagehlp
I am assuming you used the installer from https://osdn.net/projects/mingw/
- Install MinGW. You need mingw32-base-bin and msys-base-bin packages.
- Run msys.bat in the C:\MinGW\msys\1.0 folder.
- Navigate to the directory with ClassiCube's source code
- Enter
gcc *.c -o ClassiCube.exe -mwindows -lwinmm -limagehlp
I am assuming you used tcc-0.9.27-win64-bin.zip
from https://bellard.org/tcc/
- Extract the .zip file
- In TCC's
lib/kernel32.def
, add missingRtlCaptureContext
at line 554 (In betweenRtlAddFunctionTable
andRtlDeleteFunctionTable
) - Copy
winapi
folder and_mingw_dxhelper.h
fromwinapi-full-for-0.9.27.zip
into TCC'sinclude
folder - Navigate to the directory with ClassiCube's source code
- In
ExtMath.c
, changefabsf
tofabs
andsqrtf
tosqrtf
- Enter
tcc.exe -o ClassiCube.exe *.c -lwinmm -limagehlp -lgdi32 -luser32 -lcomdlg32 -lshell32
Install appropriate libs as required. For ubuntu these are: libx11-dev, libxi-dev and libgl1-mesa-dev
gcc *.c -o ClassiCube -rdynamic -lm -lpthread -lX11 -lXi -lGL -ldl
i686-w64-mingw32-gcc *.c -o ClassiCube.exe -mwindows -lwinmm -limagehlp
x86_64-w64-mingw32-gcc *.c -o ClassiCube.exe -mwindows -lwinmm -limagehlp
Although the regular linux compiliation flags will work fine, to take full advantage of the hardware:
gcc *.c -o ClassiCube -DCC_BUILD_RPI -rdynamic -lm -lpthread -lX11 -lXi -lEGL -lGLESv2 -ldl
cc *.c -o ClassiCube -framework Carbon -framework AGL -framework OpenGL -framework IOKit
cc *.c interop_cocoa.m -o ClassiCube -framework Cocoa -framework OpenGL -framework IOKit -lobjc
NOTE: If you are distributing a modified version, please change the package ID from com.classicube.android.client
to something else - otherwise Android users won't be able to have both ClassiCube and your modified version installed at the same time on their Android device
Open android
folder in Android Studio (TODO explain more detailed)
Run gradlew
in android folder (TODO explain more detailed)
iOS version will have issues as it's incomplete and only tested in iOS Simulator
NOTE: If you are distributing a modified version, please change the bundle ID from com.classicube.ios.client
to something else - otherwise iOS users won't be able to have both ClassiCube and your modified version installed at the same time on their iOS device
Import ios/CCIOS.xcodeproj
project into Xcode (TODO explain more detailed)
xcodebuild -sdk iphoneos -configuration Debug
(TODO explain more detailed)
Install libxi, libexecinfo, curl and openal-soft package if needed
cc *.c -o ClassiCube -I /usr/local/include -L /usr/local/lib -lm -lpthread -lX11 -lXi -lGL -lexecinfo
Install libexecinfo, curl and openal package if needed
cc *.c -o ClassiCube -I /usr/X11R6/include -I /usr/local/include -L /usr/X11R6/lib -L /usr/local/lib -lm -lpthread -lX11 -lXi -lGL -lexecinfo
Install libexecinfo, curl and openal-soft package if needed
cc *.c -o ClassiCube -I /usr/X11R7/include -I /usr/pkg/include -L /usr/X11R7/lib -L /usr/pkg/lib -lpthread -lX11 -lXi -lGL -lexecinfo
cc *.c -o ClassiCube -I /usr/local/include -L /usr/local/lib -lm -lpthread -lX11 -lXi -lGL -lexecinfo
gcc *.c -o ClassiCube -lm -lsocket -lX11 -lXi -lGL
Install openal_devel package if needed
cc *.c interop_BeOS.cpp -o ClassiCube -lm -lGL -lnetwork -lstdc++ -lbe -lgame -ltracker
cc *.c interop_BeOS.cpp -o ClassiCube -lm -lGL -lbe -lgame -ltracker
gcc -lGL -lX11 -lXi -lm -lpthread -ldl
Install SDL2 port if needed
cc *.c -o ClassiCube -lgl -lSDL2
emcc *.c -s ALLOW_MEMORY_GROWTH=1 --js-library interop_web.js
The generated javascript file has some issues. See here for how to fix
Run make psp
. You'll need pspsdk
NOTE: It is recommended that you install the precompiled pspsdk version from here
The PSP port needs assistance from someone experienced with PSP homebrew development - if you're interested, please get in contact with me. (unknownshadow200
on Discord)
Run make 3ds
. You'll need libctru
NOTE: It is highly recommended that you install the precompiled devkitpro packages from here - you need the 3ds-dev
group)
The 3DS port needs assistance from someone experienced with 3DS homebrew development - if you're interested, please get in contact with me. (unknownshadow200
on Discord)
Run make wii
. You'll need libogc
NOTE: It is highly recommended that you install the precompiled devkitpro packages from here - you need the wii-dev
group)
The Wii port needs assistance from someone experienced with Wii homebrew development - if you're interested, please get in contact with me. (unknownshadow200
on Discord)
Run make gamecube
. You'll need libogc
NOTE: It is highly recommended that you install the precompiled devkitpro packages from here - you need the gamecube-dev
group)
The GC port needs assistance from someone experienced with GameCube homebrew development - if you're interested, please get in contact with me. (unknownshadow200
on Discord)
Run make xbox
. You'll need nxdk
The Xbox port needs assistance from someone experienced with Xbox homebrew development - if you're interested, please get in contact with me. (unknownshadow200
on Discord)
Run make dreamcast
. You'll need KallistiOS
The Dreamcast port needs assistance from someone experienced with Dreamcast homebrew development - if you're interested, please get in contact with me. (unknownshadow200
on Discord)
You'll have to write the necessary code. You should read portability.md in doc folder.
Functions and variables in .h files are mostly documented.
Further information (e.g. style) for ClassiCube's source code can be found in the doc and misc folders.
Fixes for compilation errors when using musl or old glibc for C standard library
-
Press escape (after joining a world) or pause to switch to the pause menu.
-
Pause menu -> Options -> Controls lists all of the key combinations used by the client.
-
Note that toggling 'vsync' to on will minimise CPU usage, while off will maximimise chunk loading speed.
-
Press F to cycle view distance. A smaller number of visible chunks can improve performance.
-
If the server has disabled hacks, key combinations such as fly and speed will not do anything.
-
To see the list of built in commands, type
/client
. -
To see help for a given built in command, type
/client help <command name>
.
- curl - HTTP/HTTPS for linux and macOS
- FreeType - Font handling for all platforms
- GCC - Compiles client for linux
- MinGW-w64 - Compiles client for windows
- Clang - Compiles client for macOS
- Emscripten - Compiles client for web
- RenderDoc - Graphics debugging
- libctru - Backend for 3DS
- citro3D - Rendering backend for 3DS
- Citra - Emulator used to test 3DS port
- pspsdk - Backend for PSP
- PPSSPP - Emulator used to test PSP port
- vitasdk - Backend for PS Vita
- Vita3K - Emulator used to test Vita port
- libogc - Backend for Wii and GameCube
- libfat - Filesystem backend for Wii/GC
- Dolphin - Emulator used to test Wii/GC port
- KallistiOS - Backend for Dreamcast
- nullDC - Emulator used to test Dreamcast port
- nxdk - Backend for Xbox
- xemu - Emulator used to test Xbox port
ClassiCube uses sounds from Freesound.org
Full credits are listed in doc/sound-credits.md