ClassiCube is a custom Minecraft Classic and ClassiCube client written in C that works on Windows, macOS, Linux, Android, iOS, FreeBSD, NetBSD, OpenBSD, Solaris, Haiku, and in a web browser.
It is not affiliated with (or supported by) Mojang AB, Minecraft, or Microsoft in any way.
You can download the game from here and the very latest builds from here.
- A complete re-implementation of Minecraft Classic 0.30, with optional additions
- 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 reimplement Minecraft Classic versions before 0.30
- Windows: 95 or later
- macOS: 10.5 or later (can be compiled to work with 10.3/10.4 though)
- Linux: libcurl and libopenal
- Android: 2.3 or later
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. 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, minecraft.net servers, and classicube.net servers through the launcher.
If you're on Windows, you should first try using the MESA software renderer from here. Typically though, this occurs because you have not installed GPU drivers.
Otherwise, 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.
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 directory with game's source code
- Enter
cl.exe *.c /link user32.lib gdi32.lib crypt32.lib ws2_32.lib wininet.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 directory with game's source code
- Enter
gcc *.c -o ClassiCube.exe -mwindows -lwinmm -limagehlp
I am assuming you used the installer from http://www.mingw.org/
- 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 directory with game'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
ExtMath.C
, changefabsf
tofabs
andsqrtf
tosqrtf
- In TCC's
include/math.h
, remove the inline definition forfabs
at around line 217 - In TCC's
lib/kernel32.def
, add missingRtlCaptureContext
- Add missing include files from
winapi-full-for-0.9.27.zip
as required - ???
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
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
Import ios/CCIOS.xcodeproj
project into Xcode (TODO explain more detailed)
xcodebuild -sdk iphoneos -configuration Debug
(TODO explain more detailed)
Install 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 and libexecinfo_devel package if needed
cc *.c Window_Haiku.cpp -o ClassiCube -lm -lexecinfo -lGL -lnetwork -lstdc++ -lbe -lgame -ltracker
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
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 the game'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
ClassiCube uses sounds from Freesound.org
Full credits are listed in doc/sound-credits.md