voxelcore

(★ 1,429)

VoxelCore – voxel game engine in C++

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug.md
  - enhancement.md
  - question.md
- - appimage.yml
  - build.yml
  - cmake.yml
  - macos.yml
  - release.yml
  - windows-clang.yml
  - windows.yml
- FUNDING.yml
- - BuildAppdir.cmake
- - base_entities.lua
  - bytearray.lua
  - canvas_lines.lua
  - chunks.lua
  - data_buffer.lua
  - filesystem.lua
  - io_stream.lua
  - memory_filesystem.lua
  - network_http.lua
  - network_tcp.lua
  - network_udp.lua
  - raycast.lua
  - world.lua
- AppImageBuilder.yml
- fix_dylibs.sh
- valgrind.suppress
- VoxelCore.desktop
- VoxelCore.png
- - 3d-text.md
  - assets-preload.md
  - audio.md
  - block-models.md
  - block-properties.md
  - console.md
  - content-packs.md
  - engine-use-recommendations.md
  - entity-properties.md
  - item-properties.md
  - main-page.md
  - particles.md
  - resources.md
  - rigging.md
  - scripting.md
  - text-styles.md
  - vcm.md
  - world-generator.md
  - xml-ui-layouts.md
- - cell-noise.gif
  - simplex-noise.gif
- - 3d-text.md
  - assets-preload.md
  - audio.md
  - block-models.md
  - block-properties.md
  - console.md
  - content-packs.md
  - engine-use-recommendations.md
  - entity-properties.md
  - item-properties.md
  - main-page.md
  - particles.md
  - resources.md
  - rigging.md
  - scripting.md
  - text-styles.md
  - vcm.md
  - world-generator.md
  - xml-ui-layouts.md
- - binary_json_spec.md
  - debugging_protocol.md
  - fragment_file_spec.md
  - region_file_spec.md
  - region_voxels_chunk_spec.md
  - vec3_model_spec.md
- - bindings.toml
  - defaults.toml
- - default_syntax_scheme.toml
- - font_0.png
  - font_1.png
  - font_2.png
  - font_3.png
  - font_4.png
- - default.toml
- - code_editor.xml
  - code_editor.xml.lua
  - console.xml
  - console.xml.lua
  - files_panel.xml
  - files_panel.xml.lua
  - ingame_chat.xml
  - ingame_chat.xml.lua
  - inventory.xml
  - inventory.xml.lua
  - process.xml
  - process.xml.lua
- - block.vec3
  - drop-item.vec3
  - stairs.vcm
- - bit_converter.lua
  - data_buffer.lua
  - inventory_utils.lua
  - io_stream.lua
  - schedule.lua
  - tests_util.lua
  - toml.lua
  - vector2.lua
  - vector3.lua
- - classes.lua
  - hud.lua
  - hud_classes.lua
  - internal_events.lua
  - post_content.lua
  - stdcmd.lua
  - stdlib.lua
  - stdmin.lua
  - world.lua
- - background.glslf
  - background.glslv
  - clouds.glslf
  - clouds.glslv
  - effect.glslf
  - effect.glslv
  - entity.glslf
  - entity.glslv
  - lines.glslf
  - lines.glslv
  - main.glslf
  - main.glslv
  - shadows.glslf
  - shadows.glslv
  - skybox_gen.glslf
  - skybox_gen.glslv
  - translucent.glslf
  - translucent.glslv
  - ui.glslf
  - ui.glslv
  - ui3d.glslf
  - ui3d.glslv
- - be_BY.txt
  - de_DE.txt
  - en_US.txt
  - fi_FI.txt
  - langs.json
  - pl_PL.txt
  - ru_RU.txt
  - uk_UA.txt
  - uz_UZ.txt
- preload.json
- project.toml
- project_client.lua
- resources.json
- - assetload_funcs.cpp
  - assetload_funcs.hpp
  - Assets.cpp
  - Assets.hpp
  - assets_util.cpp
  - assets_util.hpp
  - AssetsLoader.cpp
  - AssetsLoader.hpp
- - audio.cpp
  - audio.hpp
  - effects.hpp
  - MemoryPCMStream.cpp
  - MemoryPCMStream.hpp
  - NoAudio.cpp
  - NoAudio.hpp
- - BasicParser.hpp
  - BasicParser.inl
  - binary_json.cpp
  - binary_json.hpp
  - byte_utils.cpp
  - byte_utils.hpp
  - commons.cpp
  - commons.hpp
  - compression.cpp
  - compression.hpp
  - GLSLExtension.cpp
  - GLSLExtension.hpp
  - gzip.cpp
  - gzip.hpp
  - imageio.cpp
  - imageio.hpp
  - json.cpp
  - json.hpp
  - obj.cpp
  - obj.hpp
  - ogg.cpp
  - ogg.hpp
  - png.cpp
  - png.hpp
  - rle.cpp
  - rle.hpp
  - syntax_parser.cpp
  - syntax_parser.hpp
  - toml.cpp
  - toml.hpp
  - vcm.cpp
  - vcm.hpp
  - vec3.cpp
  - vec3.hpp
  - vector_fonts.cpp
  - vector_fonts.hpp
  - wav.cpp
  - wav.hpp
  - xml.cpp
  - xml.hpp
  - yaml.cpp
  - yaml.hpp
- - Content.cpp
  - Content.hpp
  - content_fwd.hpp
  - ContentBuilder.cpp
  - ContentBuilder.hpp
  - ContentControl.cpp
  - ContentControl.hpp
  - ContentLoader.cpp
  - ContentLoader.hpp
  - ContentPack.cpp
  - ContentPack.hpp
  - ContentPackVersion.cpp
  - ContentPackVersion.hpp
  - ContentReport.cpp
  - ContentReport.hpp
  - PacksManager.cpp
  - PacksManager.hpp
- - dv.cpp
  - dv.hpp
  - dv_fwd.hpp
  - dv_util.hpp
  - setting.cpp
  - setting.hpp
  - StructLayout.cpp
  - StructLayout.hpp
- - Logger.cpp
  - Logger.hpp
- - actions.hpp
  - AppScriptsControl.cpp
  - AppScriptsControl.hpp
  - DebuggingServer.cpp
  - DebuggingServer.hpp
  - Editor.cpp
  - Editor.hpp
  - Project.cpp
  - Project.hpp
  - stdin_cmd_reader.cpp
  - stdin_cmd_reader.hpp
  - syntax.hpp
  - SyntaxProcessor.cpp
  - SyntaxProcessor.hpp
- - AssetsManagement.cpp
  - AssetsManagement.hpp
  - CoreParameters.hpp
  - Engine.cpp
  - Engine.hpp
  - EnginePaths.cpp
  - EnginePaths.hpp
  - Mainloop.cpp
  - Mainloop.hpp
  - PostRunnables.hpp
  - ServerMainloop.cpp
  - ServerMainloop.hpp
  - Time.hpp
  - WindowControl.cpp
  - WindowControl.hpp
- - ContentGfxCache.cpp
  - ContentGfxCache.hpp
  - debug_panel.cpp
  - hud.cpp
  - hud.hpp
  - LevelFrontend.cpp
  - LevelFrontend.hpp
  - locale.cpp
  - locale.hpp
  - menu.cpp
  - menu.hpp
  - UiDocument.cpp
  - UiDocument.hpp
- - Process.hpp
  - Serializable.hpp
  - Task.hpp
- - deflate_istream.hpp
  - deflate_ostream.hpp
  - finalizing_ostream.hpp
  - fwd.hpp
  - io.cpp
  - io.hpp
  - memory_istream.hpp
  - memory_ostream.hpp
  - path.cpp
  - path.hpp
  - settings_io.cpp
  - settings_io.hpp
  - util.hpp
- - Inventories.cpp
  - Inventories.hpp
  - Inventory.cpp
  - Inventory.hpp
  - ItemDef.cpp
  - ItemDef.hpp
  - ItemStack.cpp
  - ItemStack.hpp
- - Lighting.cpp
  - Lighting.hpp
  - Lightmap.cpp
  - Lightmap.hpp
  - LightSolver.cpp
  - LightSolver.hpp
- - BlocksController.cpp
  - BlocksController.hpp
  - ChunksController.cpp
  - ChunksController.hpp
  - CommandsInterpreter.cpp
  - CommandsInterpreter.hpp
  - EngineController.cpp
  - EngineController.hpp
  - LevelController.cpp
  - LevelController.hpp
  - PlayerController.cpp
  - PlayerController.hpp
- - aabb.hpp
  - fastmaths.hpp
  - FastNoiseLite.h
  - FrustumCulling.hpp
  - Heightmap.cpp
  - Heightmap.hpp
  - LMPacker.cpp
  - LMPacker.hpp
  - rays.cpp
  - rays.hpp
  - util.hpp
  - UVFace.hpp
  - UVRegion.hpp
  - voxmaths.hpp
- - commons.hpp
  - Curl.cpp
  - Network.cpp
  - Network.hpp
  - Sockets.cpp
- - Entities.cpp
  - Entities.hpp
  - Entity.cpp
  - Entity.hpp
  - EntityDef.cpp
  - EntityDef.hpp
  - Player.cpp
  - Player.hpp
  - Players.cpp
  - Players.hpp
  - rigging.cpp
  - rigging.hpp
  - Rigidbody.cpp
  - Rigidbody.hpp
  - ScriptComponents.hpp
  - Transform.cpp
  - Transform.hpp
- - Hitbox.cpp
  - Hitbox.hpp
  - PhysicsSolver.cpp
  - PhysicsSolver.hpp
- - NotePreset.cpp
  - NotePreset.hpp
  - ParticlesPreset.cpp
  - ParticlesPreset.hpp
  - WeatherPreset.cpp
  - WeatherPreset.hpp
- - AreaMap2D.hpp
  - ArgsReader.hpp
  - array_queue.hpp
  - Buffer.hpp
  - BufferPool.hpp
  - CallbacksSet.hpp
  - CentredMatrix.hpp
  - Clock.cpp
  - Clock.hpp
  - command_line.cpp
  - command_line.hpp
  - data_io.hpp
  - EnumMetadata.hpp
  - functional_util.hpp
  - HandlersList.hpp
  - Interpolation.hpp
  - listutil.hpp
  - ObjectsKeeper.hpp
  - ObjectsPool.hpp
  - observer_handler.hpp
  - platform.cpp
  - platform.hpp
  - platform_internal.cpp
  - random.cpp
  - random.hpp
  - RunnablesList.hpp
  - SmallHeap.hpp
  - span.hpp
  - stack_vector.hpp
  - stringutil.cpp
  - stringutil.hpp
  - ThreadPool.hpp
  - timeutil.cpp
  - timeutil.hpp
  - type_helpers.hpp
- - Block.cpp
  - Block.hpp
  - blocks_agent.cpp
  - blocks_agent.hpp
  - Chunk.cpp
  - Chunk.hpp
  - Chunks.cpp
  - Chunks.hpp
  - compressed_chunks.cpp
  - compressed_chunks.hpp
  - GlobalChunks.cpp
  - GlobalChunks.hpp
  - Pathfinding.cpp
  - Pathfinding.hpp
  - voxel.hpp
  - VoxelsVolume.cpp
  - VoxelsVolume.hpp
- - Camera.cpp
  - Camera.hpp
  - input.cpp
  - input.hpp
  - Window.hpp
- - Environment.cpp
  - Environment.hpp
  - Level.cpp
  - Level.hpp
  - LevelEvents.cpp
  - LevelEvents.hpp
  - Weather.cpp
  - Weather.hpp
  - World.cpp
  - World.hpp
- CMakeLists.txt
- constants.hpp
- core_defs.cpp
- core_defs.hpp
- delegates.hpp
- main.cpp
- settings.hpp
- typedefs.hpp
- - binary_json.cpp
  - byte_utils.cpp
  - GLSLExtension.cpp
  - json.cpp
  - rle.cpp
  - toml.cpp
  - vec3.cpp
  - xml.cpp
  - yaml.cpp
- - dv.cpp
  - StructLayout.cpp
- - memory_istream.cpp
  - path.cpp
- - curltest.cpp
- - AreaMap2D.cpp
  - SmallHeap.cpp
  - stack_vector.cpp
  - stringutil.cpp
- - Chunk.cpp
- CMakeLists.txt
- CMakeLists.txt
- main.cpp
.clang-format
.cmake-format.py
.gitignore
CHANGELOG.md
CMakeLists.txt
CMakePresets.json
compile_flags.txt
Dockerfile
flake.lock
flake.nix
README.md
run.sh
vcpkg.json

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/MihailRis/voxelcore

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd voxelcore

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

APT (Debian/Ubuntu 계열) Debian/Ubuntu 계열 리눅스에 기본 내장된 패키지 매니저입니다.
Homebrew macOS/Linux용 패키지 매니저입니다.

apt-get install entt-devel libglfw3-devel libGLEW-devel libglm-devel libpng-devel libvorbis-devel libopenal-devel libluajit-devel libstdc++13-devel-static libcurl-devel libfreetype-devel

APT 패키지 저장소에서 바로 설치합니다 (Debian/Ubuntu 계열).

sudo apt install libglfw3 libglfw3-dev libglew-dev libglm-dev libpng-dev libopenal-dev libluajit-5.1-dev libvorbis-dev libcurl4-openssl-dev libfreetype6-dev

APT 패키지 저장소에서 바로 설치합니다 (Debian/Ubuntu 계열).

brew install glfw3 glew glm libpng libvorbis lua luajit libcurl openal-soft skypjack/entt/entt freetype

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Docker

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker build -t voxel-engine .

Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.

docker run --rm -it -v "$(pwd):/project" voxel-engine bash -c "cmake -DCMAKE_BUILD_TYPE=Release -Bbuild && cmake --build build --parallel"

빌드된 이미지를 실제 컨테이너로 실행합니다.

docker run --rm -it \

빌드된 이미지를 실제 컨테이너로 실행합니다.

docker run --rm -it -v "${PWD}:/project" voxel-engine bash -c "cmake -DCMAKE_BUILD_TYPE=Release -Bbuild && cmake --build build --parallel"

빌드된 이미지를 실제 컨테이너로 실행합니다.

docker run --rm -it -v "${PWD}:/project" -e DISPLAY=host.docker.internal:0.0 --network=host voxel-engine ./build/VoxelEngine

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

4. CMake

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
CMake 빌드 설정을 생성하는 도구입니다.
C/C++ 컴파일러 Windows는 Visual Studio(Community 무료), macOS는 Xcode Command Line Tools, Linux는 gcc/g++ 패키지가 필요합니다.

cmake -DCMAKE_BUILD_TYPE=Release -DENTT_INSTALL=ON ..

이 명령어를 터미널에 그대로 입력해 실행하세요.

cmake -DCMAKE_BUILD_TYPE=Release ..

이 명령어를 터미널에 그대로 입력해 실행하세요.

cmake --build . --parallel

이 명령어를 터미널에 그대로 입력해 실행하세요.

cmake --preset default-vs-msvc-windows

이 명령어를 터미널에 그대로 입력해 실행하세요.

cmake --build --preset default-vs-msvc-windows

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ build 폴더 안에 실행 파일이 생성됐는지 확인하고, 직접 실행해보세요 (예: ./build/앱이름).

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

5. Node.js

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

⚠️ 이 프로젝트는 규모가 큰 저장소라, 이 방법이 실제 핵심 제품이 아니라 내부 하위 패키지를 가리키는 것일 수 있습니다. README 전체를 함께 확인해보세요.

cd res/content/base

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

voxelcore

파일 탐색기

# 설치 가이드

2. 공식 설치 스크립트

3. Docker

4. CMake

5. Node.js

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

voxelcore

파일 탐색기

# 설치 가이드

2. 공식 설치 스크립트

3. Docker

4. CMake

5. Node.js

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README