Skip to content

Installing Natives

squid233 edited this page Jun 22, 2025 · 15 revisions

The library loader first finds the shared library from path ${overrungl.natives}/basename.suffix where overrungl.natives is a system property.

If the shared library is not found on local, then the loader will find it on classpath with path moduleName/osFamilyName-nativeArch/basename.suffix and extract it to ${java.io.tmpdir}/overrungl${user.name}/basename-version.suffix.

OS family names:

  • freebsd
  • linux
  • macos
  • windows

Modules

Module Name Basename
GLFW glfw glfw
NFD (Native File Dialog) nfd nfd
OpenAL openal openal
stb stb stb
Vulkan Memory Allocator vma VulkanMemoryAllocator

The artifact id of these native libraries are io.github.over-run:overrungl-<moduleName>:[overrunglVersion]:natives-<classifier>.

Supported Architectures

Name <classifier>
FreeBSD x64 freebsd-x64
Linux x64 linux-x64
Linux arm32 linux-arm32
Linux arm64 linux-arm64
Linux ppc64le linux-ppc64le
Linux riscv64 linux-riscv64
macOS x64 macos-x64
macOS arm64 macos-arm64
Windows x64 windows-x64
Windows arm64 windows-arm64
Clone this wiki locally