Skip to content

Files

Latest commit

kraifpatrikkraifpatrik
Update Assimp to 5.4.3 on Windows + increase version to 3.22.4
Mar 23, 2025
9640652 · Mar 23, 2025

History

History
127 lines (86 loc) · 4.59 KB

README.md

File metadata and controls

127 lines (86 loc) · 4.59 KB

Logo

Make 3D games in GameMaker!

License Discord

Table of Contents

About

BBMOD is a library that makes creating 3D games in GameMaker easier! Whether you just need to draw 3D models in 2D games or you are building fully immersive 3D worlds, BBMOD helps you bring your vision to life! For more info, please see its homepage https://blueburn.cz/bbmod/.

Screenshots

Sponza Sponza

Vehice demo Vehicle demo

Zombie demo Zombie demo

Documentation, tutorials, samples and help

An online documentation for the latest release of BBMOD is always available at https://blueburn.cz/bbmod/docs/3. Tutorials for BBMOD can be found on its homepage at https://blueburn.cz/bbmod/tutorials and sample projects at https://blueburn.cz/bbmod/samples. If you need any additional help, you can join our Discord server.

Building BBMOD CLI and DLL

Requires CMake version 3.23 or newer!

1. Build Assimp

Normally this can be omitted, since Assimp binaries are included in this repo, but in case of need, here's how to build them from scratch:

git clone https://github.com/assimp/assimp.git
cd assimp
git checkout v5.4.3
cmake -S . -B build # Use -DCMAKE_OSX_ARCHITECTURES="arm64;x86_64" on macOS!
cmake --build build --config=Release

When finished, copy

  • assimp-vc143-mt.dll into /BBMOD_CLI/bin/ on Windows,
  • assimp-vc143-mt.lib into /BBMOD_CLI/lib/
  • and libassimp.5.4.3.dylib into /BBMOD_CLI/lib/libassimp.5.dylib on macOS.

Up-to-date license text of Assimp (from its LICENSE file) should be kept in /BBMOD_CLI/bin/LICENSE-Assimp‼️

2. Build BBMOD CLI and DLL

cd BBMOD_CLI
cmake -S . -B build
cmake --build build --config=Release

This builds both BBMOD CLI and DLL into /BBMOD_CLI/build/. Do not forget to copy the files to /BBMOD_GML/datafiles/Data/BBMOD/ on release! On Windows, these are BBMOD.exe, assimp-vc143-mt.dll and LICENSE-Assimp. On macOS it's BBMOD, libassimp.5.dylib, libBBMOD.dylib and LICENSE-Assimp.

3. Fix rpaths and codesign (for macOS)

  • Check rpaths:
otool -l libBBMOD.dylib | grep -B 1 -A 2 LC_RPATH
  • Remove bad rpaths:
install_name_tool -delete_rpath "/Volumes/KINGSTON/Git/BBMOD/BBMOD_CLI/lib" libBBMOD.dylib # Replace with the path you got from the previous command
  • Add rpaths:
install_name_tool -add_rpath "@executable_path/data/bbmod" libBBMOD.dylib
install_name_tool -add_rpath "@loader_path/" libBBMOD.dylib
install_name_tool -add_rpath "@executable_path/../Resources/Data/BBMOD" libBBMOD.dylib

install_name_tool -add_rpath "@executable_path/data/bbmod" libassimp.5.dylib
install_name_tool -add_rpath "@loader_path/" libassimp.5.dylib
install_name_tool -add_rpath "@executable_path/../Resources/Data/BBMOD" libassimp.5.dylib
  • Codesign:
codesign --force --timestamp --sign "Developer ID Application: Your Name (Y0URT3AM1D)" BBMOD
codesign --force --timestamp --sign "Developer ID Application: Your Name (Y0URT3AM1D)" libBBMOD.dylib
codesign --force --timestamp --sign "Developer ID Application: Your Name (Y0URT3AM1D)" libassimp.5.dylib

License

BBMOD is available under the MIT license. Full text is available here.

Logo terms of use

BBMOD logo is property of BlueBurn and you're not allowed to do any modifications to it! Only uniform scaling is allowed, to change the logo size as required.

Links

Special thanks