lucas-martinic/polyfork-catalog

项目介绍

Polyfork Catalog 是 polyfork.dev 的公开索引，收录 2,791 个免费低多边形 3D 模型，按 26 个主题套件组织，面向 three.js 开发者、游戏制作者以及需要网页轻量 3D 素材的人。

模型有两种交付形式：一种是标准 glTF/GLB 文件，可被 three.js、Unity、Godot、Blender 等支持 glTF 的工具加载；另一种是 ES 模块，导出 createAsset() 函数，通过 colorway、roof、season 等参数调整外观（模型即代码示例）。每个套件内的部件共用一套配色和比例，便于在同一场景中组合。

本仓库只保存名称、链接和小尺寸封面，模型文件本身留在 polyfork.dev，因此链接始终指向最新版本（仓库说明）。

快速使用

README 提供了一个可直接运行的 three.js 页面。将以下内容保存为 van.html 并在浏览器中打开：

<!doctype html>
<body style="margin:0">
<script type="importmap">
{ "imports": {
  "three": "https://unpkg.com/three@0.180.0/build/three.module.js",
  "three/addons/": "https://unpkg.com/three@0.180.0/examples/jsm/"
} }
</script>
<script type="module">
  import * as THREE from 'three';
  import { createAsset } from 'https://polyfork.dev/cdn/pop-top-camper-van-62a322.mjs';

  const scene = new THREE.Scene();
  scene.background = new THREE.Color('#e9edf3');
  scene.add(new THREE.HemisphereLight('#ffffff', '#8a94a6', 3));

  const camera = new THREE.PerspectiveCamera(35, innerWidth / innerHeight, 0.1, 100);
  camera.position.set(6, 3.5, 7);
  camera.lookAt(0, 1, 0);

  const renderer = new THREE.WebGLRenderer({ antialias: true });
  renderer.setSize(innerWidth, innerHeight);
  document.body.append(renderer.domElement);
  scene.add(createAsset({ colorway: 'tomato', roof: 0, season: 'winter' }));

  renderer.render(scene, camera);
</script>

如果只需要网格，用 GLTFLoader 加载 https://polyfork.dev/cdn/<模型 ID>.glb 即可（加载示例）。在终端中执行 npx polyfork add <模型 ID> 可把模型复制进项目，无需全局安装；npx polyfork search <关键词> 用于查找 ID（CLI 说明）。完整列表见 polyfork.dev/assets，也可从 README 中按类型的索引进入。

使用约束

• 模型文件不在本仓库中，加载时需要能访问 polyfork.dev。
• 免费模型可用于个人和商业项目，可自由修改且无需署名，但不得重新上传或再分发文件本身；若产品需要保存自己的副本，则需使用平台许可证（许可证说明、完整条款）。
• 索引本身的许可证与模型许可证分开，由 LICENSE.md 覆盖；GitHub 显示的许可证为 NOASSERTION。
• 套件是按统一配色和比例组织的主题子集，README 列出的 26 个套件之外仍有未收录内容，部分套件标注的部件数只是阶段性数量（制作中列表）。

HotRepo 点评

在 HotRepo 2026-11-06 的新项目榜记录中，该仓库为 132 Star、14 Fork；在 13:45 至 14:45 UTC 约一小时的统计窗口内净增 22 Star 和 2 Fork。这条单次快照显示，一个只做索引、素材托管在站外的仓库在早期获得了较快关注。目录本身由线上目录生成，价值取决于 polyfork.dev 的覆盖面，而不是本仓库中的实现；判断是否适合自己，主要看套件覆盖和 GLB/ES 模块两种形式能否接入现有流程。