Skip to content

armgit / 67.js

Public Imported from GitHub
0

3D engine that AI agents drive

3.5 KB
Raw Blame

Install

This page makes a new web project and adds 67js to it. At the end, you have a project that the first-scene tutorial builds on.

Before you start

You need these two things:

  • Node.js 20.19 or later. Run node --version to see your version. Get Node.js from nodejs.org.
  • A browser with WebGL2. Current Chrome, Edge, Firefox and Safari have it.

1. Make a project

Make a new project with Vite. Vite is a development server that loads npm packages in the browser.

npm create vite@latest my-scene -- --template vanilla

Go into the folder and install its packages:

cd my-scene
npm install

The my-scene folder now has index.html, package.json and a src folder.

2. Add 67js

Install the package with the name 67js:

npm install 67js@npm:@codepawlhq/67js

The package on npm is @codepawlhq/67js. The 67js@npm: part gives it the shorter name 67js, so your code writes import { Renderer67 } from '67js'. If you install it without that part, import from @codepawlhq/67js instead.

3. Check the install

Run this command in the project folder:

npm ls 67js

It prints the installed version:

[email protected]
`-- 67js@npm:@codepawlhq/[email protected]

Your version can be newer. The changelog lists what each version adds.

Use 67js without npm

A plain HTML page can import 67js from this site. Use the exact module URL from the release metadata. The URL contains the version, so a release does not change your page.

<script type="importmap">
  { "imports": { "67js": "https://67js.codepawl.com/releases/0.15.0/67.module.js" } }
</script>
<script type="module">
  import { Renderer67, box } from '67js';
</script>

Serve the page over HTTP, for example with npx serve. A page opened from a file:// path cannot import modules. This file has the core only. Addons such as 67js/addons/gltf need the npm package.

Use 67js from jsdelivr

From version 0.20.0 the npm package holds one self-contained module, build/67.standalone.js. It has no relative imports, so jsdelivr (and unpkg) serve it from one URL. Pin the version in the URL. This works in a plain HTML file and in a claude.ai artifact, which loads scripts only from cdnjs, jsdelivr and unpkg.

<canvas id="view" width="640" height="400"></canvas>
<script type="module">
  import { Renderer67, box } from 'https://cdn.jsdelivr.net/npm/@codepawlhq/[email protected]/build/67.standalone.js';

  const parts = [{
    name: 'Cube',
    geometry: box(),
    matrix: new Float32Array([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]),
    material: { color: [0.8, 0.3, 0.2], metallic: 0, roughness: 0.4, emission: 0 },
  }];
  const renderer = new Renderer67(document.querySelector('#view'), parts, { samples: 4 });
  renderer.render({ eye: [2.5, 2, 3.5], target: [0, 0, 0] });
</script>

The file has the core only. Addons such as 67js/addons/gltf need the npm package. Versions before 0.20.0 have no standalone file; their build/67.module.js also loads from jsdelivr, but it imports 16 chunk files.

Good to know

Note: 67js is plain JavaScript and has no TypeScript types. In a strict TypeScript project, add the line declare module '67js'; to a .d.ts file. The imports then have the type any.

Tip: Addons are separate imports, such as 67js/addons/gltf for GLB models. You only download the addons that you import.

Next: your first scene | #first-scene | Draw, color, place and animate shapes step by step.