Skip to content

Papyszoo/Modelibr

Repository files navigation

Modelibr

.NET React Three.js Docker License

Modelibr is a self-hosted game asset library. It keeps models, texture sets, environment maps, sprites, and sounds in one place, lets you preview them in the browser, and helps you organize them into projects and reusable packs.

Main Site | Documentation | Live Demo | Discord | GitHub Issues

The live demo stores its data in your browser, so what you add there is visible only to you.


Main features

Title Description
All your asset types in one place Store models, texture sets, environment maps, sprites, and sounds in the same library instead of spreading them across different tools.
Projects and packs Group assets into project-specific collections or reusable packs you can use again later.
Model version history Keep multiple versions of the same model and switch between them when needed.
Built-in previews Browse models, environment maps, sprites, and sounds with generated previews, including a lit Three.js environment map viewer.
Environment map variants Upload panoramic files or six cube faces (px/nx/py/ny/pz/nz), keep multiple size variants, choose the preview variant, and override it with a custom thumbnail when needed.
Texture set workflows Attach texture sets to model versions, choose defaults, and work with channel-packed maps.
Dual-panel workspace Open tabs side by side and keep your current layout in the URL for easy sharing and return visits.
WebDAV access Work with the library through a file-browser style workflow when that fits better than a browser-only flow.
Blender CLI at runtime Download Blender CLI from Settings when you need it instead of treating it as a fixed install requirement from day one.
Recycle bin and deduplication Restore deleted assets and avoid wasting storage on identical files.

Quick start

git clone https://github.com/Papyszoo/Modelibr.git
cd Modelibr
cp .env.example .env
docker compose up -d

Open https://localhost:3010 in your browser. The first visit uses a self-signed certificate, so your browser may ask you to continue manually.


WebDAV and Blender

  • WebDAV gives Modelibr a more file-browser style workflow, which is useful when you want the library to sit closer to art-pipeline tools.
  • Environment maps are exposed through WebDAV globally and inside packs/projects, alongside the rest of the library.
  • Blender-related flows are part of the repository, and Blender CLI can be downloaded at runtime from the Settings page when you want that workflow.
  • If you want more detail, start with the main site and the documentation.

Read more


Supported model uploads

  • .obj
  • .fbx
  • .gltf
  • .glb
  • .blend

Supported environment map uploads

  • panoramic uploads in common image formats supported by the preview pipeline
  • .hdr
  • .exr
  • six-face cube uploads using px, nx, py, ny, pz, and nz

Feedback and bug reports


License

Business Source License 1.1 — free to use, modify, and self-host. See LICENSE for details.