Minetest's fork of Irrlicht
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
lhofhansl 8f13ae81e5
Merge pull request #154 from lhofhansl/skinned
3 weeks ago
.github/workflows Update workflow to address deprecations 1 month ago
bin Delete more old files 11 months ago
cmake Add CMake as new build system 2 years ago
doc Delete more old files 11 months ago
examples Replace core::string implementation with std::basic_string 1 month ago
include Delete profiler 1 month ago
lib Delete more old files 11 months ago
media Remove more dead code (#108) 8 months ago
scripts Properly strip windows binaries produced by CI 9 months ago
source Avoid reskinning joints for animated meshes twice for each frame. 4 weeks ago
.editorconfig Clone .editorconfig from minetest/master 2 years ago
.gitignore Add MSVC CI build (#26) 7 months ago
CMakeLists.txt Bump revision early 3 months ago
Config.cmake.in CMake Config and Version exports (#22) 2 years ago
LICENSE Point to Irrlicht license in root 2 months ago
README.md Add Windows build steps to README (#129) 4 months ago
changes.txt IBillboardSceneNode got functions to access meshbuffers. 1 year ago
irr-readme.txt Add README 2 years ago
ogles-readme.txt Merging r5975 through r6036 from trunk to ogl-es branch. 3 years ago

README.md

IrrlichtMt version 1.9

The Irrlicht Engine is an open source realtime 3D engine written in C++.

This is a fork by the Minetest developers that was stripped-down and customized specifically for use in Minetest. It is intentionally not compatible to upstream and is planned to be eventually absorbed into Minetest.

Build

The build system is CMake.

The following libraries are required to be installed:

  • zlib, libPNG, libJPEG
  • OpenGL
    • or on mobile: OpenGL ES (can be optionally enabled on desktop too)
  • on Unix: X11

Aside from standard search options (ZLIB_INCLUDE_DIR, ZLIB_LIBRARY, ...) the following options are available:

  • BUILD_SHARED_LIBS (default: ON) - Build IrrlichtMt as a shared library
  • BUILD_EXAMPLES (default: OFF) - Build example applications

e.g. on a Linux system you might want to build for local use like this:

git clone https://github.com/minetest/irrlicht
cd irrlicht
cmake . -DBUILD_SHARED_LIBS=OFF
make -j$(nproc)

This will put an IrrlichtMtTargets.cmake file into the cmake directory in the current build directory, and it can then be imported from another project by pointing find_package() to the build directory, or by setting the CMAKE_PREFIX_PATH variable to that same path.

on Windows system:

It is highly recommended to use vcpkg as package manager.

After you successfully built vcpkg you can easily install the required libraries:

vcpkg install zlib libjpeg-turbo libpng opengl-registry --triplet x64-windows

Run the following script in PowerShell:

git clone https://github.com/minetest/irrlicht
cd irrlicht
cmake -B build -G "Visual Studio 17 2022" -A "Win64" -DCMAKE_TOOLCHAIN_FILE=[vcpkg-root]/scripts/buildsystems/vcpkg.cmake -DBUILD_SHARED_LIBS=OFF
cmake --build build --config Release

Platforms

We aim to support these platforms:

  • Windows via MinGW
  • Linux (GL or GLES)
  • macOS
  • Android

This doesn't mean other platforms don't work or won't be supported, if you find something that doesn't work contributions are welcome.

License

The license of the Irrlicht Engine is based on the zlib/libpng license and applies to this fork, too.

The Irrlicht Engine License
===========================

Copyright (C) 2002-2012 Nikolaus Gebhardt

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
 claim that you wrote the original software. If you use this software
 in a product, an acknowledgement in the product documentation would be
 appreciated but is not required.
2. Altered source versions must be clearly marked as such, and must not be
 misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.