bunexceptional / classicube-contribs Goto Github PK

ClassiCube is a custom Minecraft Classic compatible client written in C that works on Windows, macOS, Linux, iOS, Android, FreeBSD, NetBSD, OpenBSD, Solaris, Haiku, IRIX, 3DS (unfinished), PSP (unfinished), 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.

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#2728 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

• 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 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.

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

1. Use 'Developer Tools for Visual Studio' from Start Menu
2. Navigate to directory with game's source code
3. 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/

1. Install MinGW-W64
2. Use either Run Terminal from Start Menu or run mingw-w64.bat in the installation folder
3. Navigate to directory with game's source code
4. Enter gcc *.c -o ClassiCube.exe -mwindows -lwinmm -limagehlp

I am assuming you used the installer from https://osdn.net/projects/mingw/

1. Install MinGW. You need mingw32-base-bin and msys-base-bin packages.
2. Run msys.bat in the C:\MinGW\msys\1.0 folder.
3. Navigate to directory with game's source code
4. 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/

1. Extract the .zip file
2. In ExtMath.C, change fabsf to fabs and sqrtf to sqrtf
3. In TCC's include/math.h, remove the inline definition for fabs at around line 217
4. In TCC's lib/kernel32.def, add missing RtlCaptureContext
5. Add missing include files from winapi-full-for-0.9.27.zip as required
6. ???

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

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

cd into src directory, then run make psp. You'll need pspsdk

cd into src directory, then run make 3ds. You'll need libctru

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