ClassiCube

ClassiCube é um cliente personalizado compatível com Minecraft Classic escrito em C do zero.

Importante

ClassiCube não é afiliado (ou apoiado por) Mojang AB, Minecraft ou Microsoft de forma alguma.

ClassiCube não está tentando replicar o Minecraft moderno.
Ele nunca oferecerá suporte à sobrevivência, contas do Minecraft ou servidores modernos do Minecraft.

O que é ClassiCube

ClassiCube pretende replicar o cliente Minecraft Classic de 2009, ao mesmo tempo que oferece melhorias opcionais para melhorar a jogabilidade. ClassiCube pode ser executado em muitos sistemas, incluindo desktop, web, dispositivos móveis e até mesmo alguns consoles.

Recursos (clique para expandir)

• Desempenho muito melhor e uso mínimo de memória em comparação com o Minecraft Classic original
• Aprimoramentos opcionais, incluindo blocos, modelos e cores de ambiente personalizados
• Suporta parcialmente alguns recursos das versões do Minecraft Classic anteriores a 0.30
• Funciona efetivamente com todas as placas gráficas que suportam OpenGL ou Direct3D 9
• Funciona em Windows, macOS, Linux, Android, iOS e em um navegador da web
• Também roda em OpenBSD, FreeBSD, NetBSD, Solaris, Haiku, IRIX, SerenityOS
• Embora esteja em vários estágios iniciais de desenvolvimento, também roda em vários consoles

Você pode baixar o ClassiCube aqui e as versões mais recentes aqui.

Precisamos da sua ajuda

ClassiCube se esforça para replicar a experiência original do Minecraft Classic, aderindo estritamente à abordagem de engenharia reversa de sala limpa .

Se você estiver interessado em documentar ou verificar o comportamento do Minecraft Classic original, entre em contato no ClassiCube Discord

Como jogar

Inicialmente, você precisará executar ClassiCube.exe para baixar os ativos necessários de minecraft.net e classicube.net.
Basta clicar em 'OK' no menu de diálogo que aparece quando você inicia o inicializador.

Nota: Ao executar no VirtualBox, desative a integração do mouse, caso contrário a câmera do jogo não funcionará corretamente.

Modo Singleplayer Execute ClassiCube.exe e clique em Singleplayer no menu principal.

Modo multijogador Execute ClassiCube.exe. Você pode se conectar a servidores LAN/hospedados localmente e a servidores classicube.net se tiver uma conta ClassiCube.

Preso no OpenGL 1.1?

O motivo mais comum para travar no OpenGL 1.1 são os drivers de GPU que não funcionam - portanto, se possível, você deve tentar instalar ou atualizar os drivers para sua GPU.

De outra forma:

• No Windows, você ainda pode executar a versão OpenGL do ClassiCube de qualquer maneira.
  (Você pode tentar baixar e usar o renderizador de software MESA aqui para obter um desempenho um pouco melhor)
• Em outros sistemas operacionais, você mesmo terá que compilar o jogo.
  Não se esqueça de adicionar -DCC_BUILD_GL11 à linha de comando de compilação para que o jogo compilado suporte OpenGL 1.1.

Sistemas suportados

ClassiCube funciona em:

• Windows - 95 e posterior
• macOS - 10.5 ou posterior (pode ser compilado para 10.3/10.4)
• Linux - precisa de libcurl e libopenal
• Android - 2.3 ou posterior
• iOS – 8.0 ou posterior
• A maioria dos navegadores da web (até mesmo roda no IE11)

E também funciona em:

• Raspberry Pi - precisa de libcurl e libopenal
• FreeBSD - precisa dos pacotes libexecinfo , curl e openal-soft (pode baixar aqui)
• NetBSD - precisa de pacotes libexecinfo , curl e openal-soft (pode baixar aqui)
• OpenBSD - precisa de pacotes libexecinfo , curl e openal
• Solaris - precisa de pacotes curl e openal
• Haiku - precisa de um pacote openal (se você tiver uma conta no GitHub, pode fazer o download aqui)
• BeOS - não testado em hardware real
• IRIX - precisa de pacotes curl e openal
• SerenityOS - precisa de SDL2
• Mac OS clássico (sistema 7 e posterior)
• Dreamcast – inacabado, mas utilizável (pode baixar aqui)
• Saturno - inacabado, grandes problemas de renderização e estabilidade (pode fazer download aqui)
• Switch – inacabado, mas utilizável (pode baixar aqui)
• Wii U – problemas importantes e inacabados, quebrados em hardware real (pode fazer download aqui)
• Wii – inacabado, mas utilizável (pode baixar aqui)
• GameCube – inacabado, mas utilizável (pode baixar aqui)
• Nintendo 64 – problemas de renderização moderados e inacabados (pode fazer download aqui)
• 3DS – inacabado, mas utilizável (pode baixar aqui)
• DS/DSi - problemas de renderização inacabados (pode baixar aqui)
• PS Vita - problemas de renderização inacabados (pode baixar aqui)
• PSP - problemas de renderização inacabados (pode baixar aqui)
• PS3 - problemas de renderização inacabados (pode baixar aqui)
• PS2 - inacabado, grandes problemas de renderização e estabilidade (pode fazer download aqui)
• PS1 - inacabado, grandes problemas de renderização e estabilidade (pode fazer download aqui)
• Xbox 360 – completamente inacabado, quebrado em hardware real (pode baixar aqui)
• Xbox – grandes problemas de renderização inacabados (pode fazer download aqui)

Compilando

Nota: As instruções abaixo compilam automaticamente o ClassiCube com os padrões recomendados para a plataforma.
Se você (não recomendado) deseja substituir os padrões (por exemplo, para compilar a compilação OpenGL no Windows), veja aqui para obter detalhes.

Compilando - Windows

Usando o Visual Studio

1. Abra ClassiCube.sln (Arquivo -> Abrir -> Projeto/Solução)
2. Compilar/Construir (Construir -> Construir Solução) .

Se você receber um erro de compilação The Windows SDK version 5.1 was not found , veja aqui como corrigir

Usando o Visual Studio (linha de comando)

1. Use 'Ferramentas de desenvolvedor para Visual Studio' no menu Iniciar
2. Navegue até o diretório com o código-fonte do ClassiCube
3. Execute cl.exe *.c /link user32.lib gdi32.lib winmm.lib dbghelp.lib shell32.lib comdlg32.lib /out:ClassiCube.exe

Usando MinGW-w64

Supondo que você usou o instalador de https://sourceforge.net/projects/mingw-w64/ :

1. Instale MinGW-W64
2. Use Executar Terminal no Menu Iniciar ou execute mingw-w64.bat na pasta de instalação
3. Navegue até o diretório com o código-fonte do ClassiCube
4. Execute gcc -fno-math-errno *.c -o ClassiCube.exe -mwindows -lwinmm

Usando MinGW

Supondo que você usou o instalador de https://osdn.net/projects/mingw/ :

1. Instale o MinGW. Você precisa dos pacotes mingw32-base-bin e msys-base-bin.
2. Execute msys.bat na pasta C:MinGWmsys1.0 .
3. Navegue até o diretório com o código-fonte do ClassiCube
4. Execute gcc -fno-math-errno *.c -o ClassiCube.exe -mwindows -lwinmm

Usando TCC (compilador Tiny C)

Configurando o TCC:

1. Baixe e extraia tcc-0.9.27-win64-bin.zip de https://bellard.org/tcc/
2. Baixe winapi-full-for-0.9.27.zip em https://bellard.org/tcc/
3. Copie a pasta winapi e _mingw_dxhelper.h de winapi-full-for-0.9.27.zip para a pasta include TCC

Compilando com TCC:

1. Navegue até o diretório com o código-fonte do ClassiCube
2. Em ExtMath.c , altere fabsf para fabs e sqrtf para sqrt
3. Execute tcc.exe -o ClassiCube.exe *.c -lwinmm -lgdi32 -luser32 -lcomdlg32 -lshell32
   (Observação: pode ser necessário especificar o caminho completo para tcc.exe em vez de apenas tcc.exe )

Compilando - Linux

Usando gcc/clang

1. Instale as bibliotecas de desenvolvimento X11, XInput2 e OpenGL, se necessário.
   Para Ubuntu, estes são os pacotes libx11-dev , libxi-dev e libgl1-mesa-dev
2. Execute:
   • make linux ou
   • cc -fno-math-errno src/*.c -o ClassiCube -rdynamic -lpthread -lX11 -lXi -lGL -ldl

Compilação cruzada para Windows (32 bits):

1. Instale MinGW-w64 se necessário. (Ubuntu: pacote gcc-mingw-w64 )
2. Execute i686-w64-mingw32-gcc -fno-math-errno src/*.c -o ClassiCube.exe -mwindows -lwinmm

Compilação cruzada para Windows (64 bits):

1. Instale MinGW-w64 se necessário. (Ubuntu: pacote gcc-mingw-w64 )
2. Execute x86_64-w64-mingw32-gcc -fno-math-errno src/*.c -o ClassiCube.exe -mwindows -lwinmm

Framboesa Pi

Embora os sinalizadores regulares de compilação do Linux funcionem bem, para aproveitar ao máximo o hardware:

gcc -fno-math-errno src/*.c -o ClassiCube -DCC_BUILD_RPI -rdynamic -lpthread -lX11 -lXi -lEGL -lGLESv2 -ldl

Compilando - macOS

1. Instale um compilador C, se necessário. A maneira mais fácil de obter um é instalando o Xcode .
2. Execute:
   • make darwin ou
   • cc -fno-math-errno src/*.c src/*.m -o ClassiCube -framework Cocoa -framework OpenGL -framework IOKit -lobjc

Usando a GUI do Xcode

1. Abra o projeto misc/macOS/CCMAC.xcodeproj no Xcode
2. Compilar o projeto

Compilando - para Android

NOTA: Se você estiver distribuindo uma versão modificada, altere o ID do pacote de com.classicube.android.client para outro - caso contrário, os usuários do Android não poderão ter o ClassiCube e sua versão modificada instalados ao mesmo tempo em seus Dispositivo Android

Usando a GUI do Android Studio

Abra a pasta android no Android Studio (TODO explica mais detalhadamente)

Usando linha de comando (gradle)

Execute gradlew na pasta Android (TODO explica mais detalhadamente)

Compilando - para iOS

A versão iOS terá problemas porque está incompleta e só foi testada no iOS Simulator

NOTA: Se você estiver distribuindo uma versão modificada, altere o ID do pacote de com.classicube.ios.client para outro - caso contrário, os usuários do iOS não poderão ter o ClassiCube e sua versão modificada instalados ao mesmo tempo em seus dispositivo iOS

Usando a GUI do Xcode

1. Abra o projeto misc/ios/CCIOS.xcodeproj no Xcode
2. Compilar o projeto

Usando linha de comando (Xcode)

xcodebuild -sdk iphoneos -configuration Debug (TODO explica mais detalhadamente)

Compilando - webclient

1. Instale o emscripten se necessário.
2. Execute:
   • make web ou
   • emcc src/*.c -s ALLOW_MEMORY_GROWTH=1 -s TOTAL_STACK=1Mb --js-library interop_web.js

O arquivo javascript gerado apresenta alguns problemas. Veja aqui como consertar

Para detalhes sobre como integrar o webclient em um site, veja aqui

Compilando - consoles

Todas as portas de console precisam da ajuda de alguém com experiência em desenvolvimento de homebrew - se você estiver interessado, entre em contato no ClassiCube Discord.

Consoles Nintendo (clique para expandir)

Trocar

Execute make switch . Você precisará de libnx e mesa

NOTA: É altamente recomendado que você instale os pacotes devkitpro pré-compilados a partir daqui - você precisa do grupo switch-dev e dos pacotes switch-mesa switch-glm )

Wii U

Execute make wiiu . Você vai precisar de tudo

NOTA: É altamente recomendado que você instale os pacotes devkitpro pré-compilados daqui - você precisa do grupo wiiu-dev )

3DS

Execute make 3ds . Você precisará do libctru

NOTA: É altamente recomendado que você instale os pacotes devkitpro pré-compilados aqui - você precisa do grupo 3ds-dev )

Wii

Execute o make wii . Você precisará de libogc

NOTA: É altamente recomendado que você instale os pacotes devkitpro pré-compilados daqui - você precisa do grupo wii-dev )

GameCube

Execute make gamecube . Você precisará de libogc

NOTA: É altamente recomendável que você instale os pacotes devkitpro pré-compilados aqui - você precisa do grupo gamecube-dev )

Nintendo DS/DSi

Execute make ds . Você precisará do BlocksDS

Nintendo 64

Execute make n64 . Você precisará do branch opengl da libdragon

Consoles Sony (clique para expandir)

Playstation Vita

Corre make vita . Você precisará do VitaSDK

PlayStation portátil

Execute make psp . Você precisará do pspsdk

NOTA: É recomendado que você instale a versão pré-compilada do pspsdk aqui

PlayStation 3

Execute make ps3 . Você precisará do PSL1GHT

Playstation 2

Execute make ps2 . Você precisará do ps2sdk

PlayStation 1

Execute make ps1 . Você precisará do PSn00bSDK

Consoles Microsoft (clique para expandir)

Xbox 360

Execute make 360 . Você precisará de libxenon

Xbox (original)

Execute make xbox . Você precisará de nxdk

Consoles SEGA (clique para expandir)

Consolas SEGA

Dreamcast

Execute make dreamcast . Você precisará do KallistiOS

Saturno

Corra make saturn . Você vai precisar de libyaul

Compilando - outras plataformas (clique para expandir)

FreeBSD

1. Instale os pacotes libxi , libexecinfo , curl e openal-soft se necessário
2. Execute:
   • make freebsd ou
   • cc src/*.c -o ClassiCube -I /usr/local/include -L /usr/local/lib -lm -lpthread -lX11 -lXi -lGL -lexecinfo

OpenBSD

1. Instale os pacotes libexecinfo , curl e openal se necessário
2. Execute:
   • make opensd ou
   • cc src/*.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

NetBSD

1. Instale os pacotes libexecinfo , curl e openal-soft se necessário
2. Execute:
   • make netbsd ou
   • cc src/*.c -o ClassiCube -I /usr/X11R7/include -I /usr/pkg/include -L /usr/X11R7/lib -L /usr/pkg/lib -lpthread -lX11 -lXi -lGL -lexecinfo

LibélulaBSD

1. Instale os pacotes libxi , libexecinfo , curl e openal-soft se necessário
2. Execute:
   • make dragonfly ou
   • cc src/*.c -o ClassiCube -I /usr/local/include -L /usr/local/lib -lm -lpthread -lX11 -lXi -lGL -lexecinfo

Solaris

1. Instale os pacotes necessários, se necessário
2. Execute:
   • make sunos ou
   • gcc -fno-math-errno src/*.c -o ClassiCube -lsocket -lX11 -lXi -lGL

Haiku

1. Instale os pacotes gcc , haiku_devel , openal_devel se necessário
2. Execute:
   • make haiku ou
   • cc -fno-math-errno src/*.c src/*.cpp -o ClassiCube -lGL -lnetwork -lstdc++ -lbe -lgame -ltracker

BeOS

1. Instale um compilador C
2. Execute:
   • make beos ou
   • cc -fno-math-errno src/*.c src/*.cpp -o ClassiCube -lGL -lbe -lgame -ltracker

IRIX

1. Instale os pacotes necessários, se necessário
2. Execute:
   • make irix ou
   • gcc -fno-math-errno src/*.c -o ClassiCube -lGL -lX11 -lXi -lpthread -ldl`

Serenidade OS

1. Instale a porta SDL2, se necessário
2. Execute:
   • make serenityos ou
   • cc src/*.c -o ClassiCube -lgl -lSDL2

Mac OS clássico

1. Instale Retro68
2. Execute também
   • make macclassic_68k (para uma compilação M68k)
   • make macclassic_ppc (para uma construção PPC)

A compilação PowerPC geralmente terá um desempenho muito melhor

Outros sistemas

Você terá que escrever o código necessário. Você deve ler portability.md na pasta doc.

Documentação

Funções e variáveis ​​em arquivos .h são principalmente documentadas.

Mais informações (por exemplo, estilo) do código-fonte do ClassiCube podem ser encontradas nas pastas doc e misc.

Erros de compilação conhecidos

Correções para erros de compilação ao usar musl ou glibc antigo para biblioteca padrão C

Pontas

• Pressione escapar (depois de entrar em um mundo) ou pausar para alternar para o menu de pausa.

• Menu de pausa -> Opções -> Controles lista todas as combinações de teclas usadas pelo cliente.

• Observe que ativar 'vsync' minimizará o uso da CPU, enquanto desativar maximizará a velocidade de carregamento do bloco.

• Pressione F para percorrer a distância de visualização. Distâncias de visão mais baixas podem melhorar o desempenho.

• Se o servidor tiver desabilitado hacks, combinações de teclas como voar e velocidade não farão nada.

• Para ver a lista de comandos integrados, digite /client .

• Para ver a ajuda de um determinado comando integrado, digite /client help <command name> .

Tecnologias de código aberto (clique para expandir)

• curl - HTTP/HTTPS para Linux e macOS
• FreeType - Manipulação de fontes para todas as plataformas
• GCC - Compila cliente para Linux
• MinGW-w64 - Compila cliente para Windows
• Clang - Compila cliente para macOS
• Emscripten - Compila cliente para web
• RenderDoc - depuração de gráficos
• BearSSL - suporte SSL/TLS em consoles
• libnx - Back-end para Switch
• Ryujinx – Emulador usado para testar a porta do Switch
• wut - Back-end para Wii U
• Cemu - Emulador usado para testar a porta Wii U
• libctru - Back-end para 3DS
• citro3D - Back-end de renderização para 3DS
• Citra - Emulador usado para testar a porta 3DS
• libogc – Back-end para Wii e GameCube
• libfat - Backend do sistema de arquivos para Wii/GC
• Dolphin - Emulador usado para testar a porta Wii/GC
• libdragon - Back-end para Nintendo 64
• ares - Emulador usado para testar a versão do Nintendo 64
• BlocksDS – Back-end para Nintendo DS
• melonDS - Emulador usado para testar a porta Nintendo DS
• vitasdk – Back-end para PS Vita
• Vita3K - Emulador usado para testar a porta Vita
• pspsdk – Back-end para PSP
• PPSSPP - Emulador usado para testar a porta PSP
• PSL1GHT - Back-end para PS3
• RPCS3 – Emulador usado para testar a porta PS3
• ps2sdk – Back-end para PS2
• PCSX2 - Emulador usado para testar a porta PS2
• PSn00bSDK – Back-end para PS1
• duckstation - Emulador usado para testar a porta PS1
• libxenon - Back-end para Xbox 360
• nxdk – Back-end para Xbox
• xemu - Emulador usado para testar a porta Xbox
• cxbx-reloaded - Emulador usado para testar a porta Xbox
• KallistiOS – Back-end para Dreamcast
• GLdc - Base de backend de renderização para Dreamcast
• flycast - Emulador usado para testar a porta Dreamcast
• libyaul - Back-end para Saturno
• mednafen - Emulador usado para testar a porta Saturn

Créditos de som

ClassiCube usa sons do Freesound.org
Os créditos completos estão listados em doc/sound-credits.md