# Free cup and mug 3D models for three.js (GLB, CC BY and CC0)
https://paprika3d.com/docs/models/cups

24 free cups and mugs for three.js from the 913 in the paprika3d asset library (CC BY and CC0), as meshopt GLB files: each with its author, license, credit line, triangles and file size, and the asset_search call that fetches it.

## What the library holds

The paprika3d asset library holds 913 cups and mugs among its 57,732 models. 903 of them are licensed CC BY 4.0, which asks you to credit the author wherever you use the model, and 10 are CC0, which asks nothing. 5 are AI-generated, from Scenario's 3D Collection, and say so on their card.

791 of the 913 pass the library's quality checks: textured (or drawn in vertex colours, for a low-poly or voxel model), not flat, at most 15 MB, with a name, a description and a real-world height. Among those, the median model has 3,570 triangles, with the middle half between 1,220 and 17,800, and the median file is 0.22 MB, with nine in ten at most 0.6 MB. The median one stands 0.12 m tall at real size. 3 carry a texture of 2048 px, the library's largest; the rest are smaller. 14 are animated and 2 rigged. The most common styles are realistic (382), stylized (237) and low-poly (95).

## Cups and mugs in a three.js scene

Most of these mugs and cups are light: the median file is 0.22 MB with 3,570 triangles, so a table can hold several without trouble. A cup is usually one mesh, and the place a print goes depends on its texture coordinates. To put a user's logo or text on a mug, draw it on a canvas, wrap it in a `CanvasTexture` with `colorSpace = THREE.SRGBColorSpace`, and set `needsUpdate = true` after each redraw. When the mug's own coordinates do not suit the print, `DecalGeometry` from `three/addons/geometries/DecalGeometry.js` projects the picture onto the surface from a point and direction you choose.

Coffee or tea inside is a separate flat disc you add at the right depth; it reads as liquid with a dark colour and low roughness. Steam rises well as a few soft sprites with `depthWrite: false`, drifting up and fading out.

## Fetch one and load it

With the paprika3d plugin in Claude Code, or its MCP server in any other agent, the agent searches the library in words or picks a model by the id on its card. `pick` downloads the file into the project's `assets/` folder (`public/assets/` under vite), adds the credit line to `assets/CREDITS.md` and answers with the code that loads it at real size. Give `cwd`, the project folder, as with every paprika3d tool.

```text
asset_search {"query": "mug", "cwd": "."}
asset_search {"pick": "b3c233751c824b1a9af21abaeaf68e76", "cwd": "."}
```

Every file is a binary glTF (.glb) compressed with meshopt, so GLTFLoader needs the meshopt decoder that ships with three.js. The origin sits at the bottom centre of each model, so it stands on the floor where you place it:

```js
import * as THREE from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';

const loader = new GLTFLoader().setMeshoptDecoder(MeshoptDecoder);
const gltf = await loader.loadAsync('assets/thai-traditional-tea-cup-b3c233.glb');
scene.add(gltf.scene);
```

## 24 cups and mugs to start from

Chosen from the 791 that pass the checks: the ones agents picked most through `asset_search` first, then the ones whose name says what they are, then lighter files, with at most 2 per author. Each CC BY card ends with its credit line: paste it into your credits, as the license requires.

![Thai Traditional Tea Cup](https://paprika3d.com/media/assets/b3c233751c824b1a9af21abaeaf68e76.webp)

**[Thai Traditional Tea Cup](https://sketchfab.com/3d-models/b3c233751c824b1a9af21abaeaf68e76)** by [martin_dalm](https://sketchfab.com/martin_dalm)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 22,380 triangles · 0.306 MB · realistic · 0.08 m tall<br>`asset_search {"pick": "b3c233751c824b1a9af21abaeaf68e76"}`

<small>Credit: "Thai Traditional Tea Cup" by martin_dalm (https://sketchfab.com/3d-models/b3c233751c824b1a9af21abaeaf68e76) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![CE Mug](https://paprika3d.com/media/assets/f3b7a5b95c6b4e599e914a79e563f2d7.webp)

**[CE Mug](https://sketchfab.com/3d-models/f3b7a5b95c6b4e599e914a79e563f2d7)** by [vsigno](https://sketchfab.com/vsigno)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 38,340 triangles · 0.91 MB · scanned · 0.1 m tall<br>`asset_search {"pick": "f3b7a5b95c6b4e599e914a79e563f2d7"}`

<small>Credit: "CE Mug" by vsigno (https://sketchfab.com/3d-models/f3b7a5b95c6b4e599e914a79e563f2d7) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![pig cup](https://paprika3d.com/media/assets/94afa2785d4548f7abb0a40adcd4033f.webp)

**[pig cup](https://sketchfab.com/3d-models/94afa2785d4548f7abb0a40adcd4033f)** by [zookavin](https://sketchfab.com/zookavin)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 9,419 triangles · 0.121 MB · scanned · 0.1 m tall<br>`asset_search {"pick": "94afa2785d4548f7abb0a40adcd4033f"}`

<small>Credit: "pig cup" by zookavin (https://sketchfab.com/3d-models/94afa2785d4548f7abb0a40adcd4033f) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Hobo Mug](https://paprika3d.com/media/assets/98a7dd95a1aa44f184c3b6967b2a4e18.webp)

**[Hobo Mug](https://sketchfab.com/3d-models/98a7dd95a1aa44f184c3b6967b2a4e18)** by [Mountrise](https://sketchfab.com/Mountrise)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 87,957 triangles · 1.126 MB · realistic · 0.12 m tall<br>`asset_search {"pick": "98a7dd95a1aa44f184c3b6967b2a4e18"}`

<small>Credit: "Hobo Mug" by Mountrise (https://sketchfab.com/3d-models/98a7dd95a1aa44f184c3b6967b2a4e18) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![cup](https://paprika3d.com/media/assets/09a02c9b14da4cbd9c2a92d27835a6e4.webp)

**[cup](https://sketchfab.com/3d-models/09a02c9b14da4cbd9c2a92d27835a6e4)** by [Wolfy23](https://sketchfab.com/fanwei.zhong)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 1,430 triangles · 0.165 MB · realistic · 0.1 m tall<br>`asset_search {"pick": "09a02c9b14da4cbd9c2a92d27835a6e4"}`

<small>Credit: "cup" by Wolfy23 (https://sketchfab.com/3d-models/09a02c9b14da4cbd9c2a92d27835a6e4) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Worn metallic cup](https://paprika3d.com/media/assets/2a950021a0914fc6be680954378b9a9e.webp)

**[Worn metallic cup](https://sketchfab.com/3d-models/2a950021a0914fc6be680954378b9a9e)** by [Kalle](https://sketchfab.com/t0ol)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 9,874 triangles · 0.564 MB · realistic · 0.1 m tall<br>`asset_search {"pick": "2a950021a0914fc6be680954378b9a9e"}`

<small>Credit: "Worn metallic cup" by Kalle (https://sketchfab.com/3d-models/2a950021a0914fc6be680954378b9a9e) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Mug with a biblical scene](https://paprika3d.com/media/assets/3c0ef6442d0f48928394b284107a9444.webp)

**[Mug with a biblical scene](https://sketchfab.com/3d-models/3c0ef6442d0f48928394b284107a9444)** by [Virtual Museums of Małopolska](https://sketchfab.com/WirtualneMuzeaMalopolski)<br>[CC0](https://creativecommons.org/publicdomain/zero/1.0/) · 61,422 triangles · 0.515 MB · scanned · 0.15 m tall<br>`asset_search {"pick": "3c0ef6442d0f48928394b284107a9444"}`

<small>CC0, no credit needed. Optional credit: "Mug with a biblical scene" by Virtual Museums of Małopolska (https://sketchfab.com/3d-models/3c0ef6442d0f48928394b284107a9444) is licensed under CC0 1.0 (https://creativecommons.org/publicdomain/zero/1.0/). Optimized for the web by paprika3D.</small>

![Coffee to go cup](https://paprika3d.com/media/assets/cdb8ee2283664400939454f36b68fb53.webp)

**[Coffee to go cup](https://sketchfab.com/3d-models/cdb8ee2283664400939454f36b68fb53)** by [markdragan](https://sketchfab.com/markdragan)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 3,636 triangles · 0.118 MB · stylized · 0.12 m tall<br>`asset_search {"pick": "cdb8ee2283664400939454f36b68fb53"}`

<small>Credit: "Coffee to go cup" by markdragan (https://sketchfab.com/3d-models/cdb8ee2283664400939454f36b68fb53) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Beer Mug](https://paprika3d.com/media/assets/cf859a556f274d74a6c3d5ccf73988eb.webp)

**[Beer Mug](https://sketchfab.com/3d-models/cf859a556f274d74a6c3d5ccf73988eb)** by [Stoerbi](https://sketchfab.com/Stoerbi)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 14,619 triangles · 0.631 MB · stylized · 0.12 m tall<br>`asset_search {"pick": "cf859a556f274d74a6c3d5ccf73988eb"}`

<small>Credit: "Beer Mug" by Stoerbi (https://sketchfab.com/3d-models/cf859a556f274d74a6c3d5ccf73988eb) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Stylized Old Beer Cup](https://paprika3d.com/media/assets/8b1203f5cd4440929d317719afdf2441.webp)

**[Stylized Old Beer Cup](https://sketchfab.com/3d-models/8b1203f5cd4440929d317719afdf2441)** by [Isl_Takhir](https://sketchfab.com/isTakhir)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 3,154 triangles · 0.239 MB · stylized · 0.15 m tall<br>`asset_search {"pick": "8b1203f5cd4440929d317719afdf2441"}`

<small>Credit: "Stylized Old Beer Cup" by Isl_Takhir (https://sketchfab.com/3d-models/8b1203f5cd4440929d317719afdf2441) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Mug - SGD 116](https://paprika3d.com/media/assets/f15c826d13dc4d5f9df1898bf3f4c634.webp)

**[Mug - SGD 116](https://sketchfab.com/3d-models/f15c826d13dc4d5f9df1898bf3f4c634)** by [jackjprice](https://sketchfab.com/jackjprice)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 4,342 triangles · 0.268 MB · realistic · 0.15 m tall<br>`asset_search {"pick": "f15c826d13dc4d5f9df1898bf3f4c634"}`

<small>Credit: "Mug - SGD 116" by jackjprice (https://sketchfab.com/3d-models/f15c826d13dc4d5f9df1898bf3f4c634) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Paper Cup Coffee](https://paprika3d.com/media/assets/19c12761d6884c5882f10449d2711fe1.webp)

**[Paper Cup Coffee](https://sketchfab.com/3d-models/19c12761d6884c5882f10449d2711fe1)** by [AndreyErmolaev](https://sketchfab.com/AndreyErmolaev)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 802 triangles · 0.07 MB · realistic · 0.12 m tall<br>`asset_search {"pick": "19c12761d6884c5882f10449d2711fe1"}`

<small>Credit: "Paper Cup Coffee" by AndreyErmolaev (https://sketchfab.com/3d-models/19c12761d6884c5882f10449d2711fe1) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Mary Rose Tankard - Low Poly](https://paprika3d.com/media/assets/2873d816bb964e488f1cabf5013c7095.webp)

**[Mary Rose Tankard - Low Poly](https://sketchfab.com/3d-models/2873d816bb964e488f1cabf5013c7095)** by [John Fino (tauricity)](https://sketchfab.com/tauricity)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 964 triangles · 0.183 MB · low-poly · 0.2 m tall<br>`asset_search {"pick": "2873d816bb964e488f1cabf5013c7095"}`

<small>Credit: "Mary Rose Tankard - Low Poly" by John Fino (tauricity) (https://sketchfab.com/3d-models/2873d816bb964e488f1cabf5013c7095) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Dark coffee cup](https://paprika3d.com/media/assets/2bfc0133883b4560b62de3e5eb58e76c.webp)

**[Dark coffee cup](https://sketchfab.com/3d-models/2bfc0133883b4560b62de3e5eb58e76c)** by [tombuben](https://sketchfab.com/tombuben)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 27,592 triangles · 0.203 MB · scanned · 0.1 m tall<br>`asset_search {"pick": "2bfc0133883b4560b62de3e5eb58e76c"}`

<small>Credit: "Dark coffee cup" by tombuben (https://sketchfab.com/3d-models/2bfc0133883b4560b62de3e5eb58e76c) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Medieval Cup](https://paprika3d.com/media/assets/e3ed780a868245c69e9e45613c495ba8.webp)

**[Medieval Cup](https://sketchfab.com/3d-models/e3ed780a868245c69e9e45613c495ba8)** by [aAquariuZz](https://sketchfab.com/aAquariuZz)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 13,665 triangles · 0.65 MB · stylized · 0.12 m tall<br>`asset_search {"pick": "e3ed780a868245c69e9e45613c495ba8"}`

<small>Credit: "Medieval Cup" by aAquariuZz (https://sketchfab.com/3d-models/e3ed780a868245c69e9e45613c495ba8) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Mug](https://paprika3d.com/media/assets/2756ab033f094e568034245a19479974.webp)

**[Mug](https://sketchfab.com/3d-models/2756ab033f094e568034245a19479974)** by [natancassano](https://sketchfab.com/natancassano)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 672 triangles · 0.352 MB · realistic · 0.15 m tall<br>`asset_search {"pick": "2756ab033f094e568034245a19479974"}`

<small>Credit: "Mug" by natancassano (https://sketchfab.com/3d-models/2756ab033f094e568034245a19479974) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Painted cup](https://paprika3d.com/media/assets/d2c546af84df4afa96f6ae565df76434.webp)

**[Painted cup](https://sketchfab.com/3d-models/d2c546af84df4afa96f6ae565df76434)** by [Aupuma](https://sketchfab.com/aupuma)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 20,796 triangles · 0.212 MB · scanned · 0.12 m tall<br>`asset_search {"pick": "d2c546af84df4afa96f6ae565df76434"}`

<small>Credit: "Painted cup" by Aupuma (https://sketchfab.com/3d-models/d2c546af84df4afa96f6ae565df76434) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Cup of Coffee](https://paprika3d.com/media/assets/e692c997bb4d4ffd87beda42b7626688.webp)

**[Cup of Coffee](https://sketchfab.com/3d-models/e692c997bb4d4ffd87beda42b7626688)** by [mornaista](https://sketchfab.com/mornaista)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 12,672 triangles · 0.186 MB · realistic · 0.1 m tall<br>`asset_search {"pick": "e692c997bb4d4ffd87beda42b7626688"}`

<small>Credit: "Cup of Coffee" by mornaista (https://sketchfab.com/3d-models/e692c997bb4d4ffd87beda42b7626688) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Tankard](https://paprika3d.com/media/assets/462498b44e9a413ea94c58724b69ded5.webp)

**[Tankard](https://sketchfab.com/3d-models/462498b44e9a413ea94c58724b69ded5)** by [Seats](https://sketchfab.com/Seats)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 5,315 triangles · 0.362 MB · realistic · 0.15 m tall<br>`asset_search {"pick": "462498b44e9a413ea94c58724b69ded5"}`

<small>Credit: "Tankard" by Seats (https://sketchfab.com/3d-models/462498b44e9a413ea94c58724b69ded5) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Metal Cup (WW2 Style cup, vintage)](https://paprika3d.com/media/assets/d70c2777df9e4971a7303a6d9da2dd97.webp)

**[Metal Cup (WW2 Style cup, vintage)](https://sketchfab.com/3d-models/d70c2777df9e4971a7303a6d9da2dd97)** by [Warkarma](https://sketchfab.com/warkarma)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 1,806 triangles · 0.221 MB · realistic · 0.1 m tall<br>`asset_search {"pick": "d70c2777df9e4971a7303a6d9da2dd97"}`

<small>Credit: "Metal Cup (WW2 Style cup, vintage)" by Warkarma (https://sketchfab.com/3d-models/d70c2777df9e4971a7303a6d9da2dd97) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![VSCO girl mug](https://paprika3d.com/media/assets/12aecefa782c4e15b94920cab9f4243e.webp)

**[VSCO girl mug](https://sketchfab.com/3d-models/12aecefa782c4e15b94920cab9f4243e)** by [Chloe Garces](https://sketchfab.com/cgarces)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 7,200 triangles · 0.186 MB · stylized · 0.1 m tall<br>`asset_search {"pick": "12aecefa782c4e15b94920cab9f4243e"}`

<small>Credit: "VSCO girl mug" by Chloe Garces (https://sketchfab.com/3d-models/12aecefa782c4e15b94920cab9f4243e) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Cup from abandoned space station](https://paprika3d.com/media/assets/d334529585db4b66b11a1e6344a45c47.webp)

**[Cup from abandoned space station](https://sketchfab.com/3d-models/d334529585db4b66b11a1e6344a45c47)** by [tokkilap](https://sketchfab.com/tokkilap)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 53,440 triangles · 0.56 MB · sci-fi · 0.1 m tall<br>`asset_search {"pick": "d334529585db4b66b11a1e6344a45c47"}`

<small>Credit: "Cup from abandoned space station" by tokkilap (https://sketchfab.com/3d-models/d334529585db4b66b11a1e6344a45c47) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

![Pottery Vessel or Mug](https://paprika3d.com/media/assets/f11b4220bda84ca19012727e26e284c1.webp)

**[Pottery Vessel or Mug](https://sketchfab.com/3d-models/f11b4220bda84ca19012727e26e284c1)** by [The Hunt Museum](https://sketchfab.com/TheHuntMuseum)<br>[CC0](https://creativecommons.org/publicdomain/zero/1.0/) · 85,170 triangles · 0.586 MB · scanned · 0.25 m tall<br>`asset_search {"pick": "f11b4220bda84ca19012727e26e284c1"}`

<small>CC0, no credit needed. Optional credit: "Pottery Vessel or Mug" by The Hunt Museum (https://sketchfab.com/3d-models/f11b4220bda84ca19012727e26e284c1) is licensed under CC0 1.0 (https://creativecommons.org/publicdomain/zero/1.0/). Optimized for the web by paprika3D.</small>

![Aluminum mug (lowpoly)](https://paprika3d.com/media/assets/7bc2b14a48d1413e9375c32a53e3ee6f.webp)

**[Aluminum mug (lowpoly)](https://sketchfab.com/3d-models/7bc2b14a48d1413e9375c32a53e3ee6f)** by [Mikhail Antonov](https://sketchfab.com/xeofox)<br>[CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · 1,890 triangles · 0.116 MB · low-poly · 0.1 m tall<br>`asset_search {"pick": "7bc2b14a48d1413e9375c32a53e3ee6f"}`

<small>Credit: "Aluminum mug (lowpoly)" by Mikhail Antonov (https://sketchfab.com/3d-models/7bc2b14a48d1413e9375c32a53e3ee6f) is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Optimized for the web by paprika3D.</small>

## Related

- [Free barrel 3D models for three.js (GLB, CC BY)](https://paprika3d.com/docs/models/barrels)
- [Free book 3D models for three.js (GLB, CC BY and CC0)](https://paprika3d.com/docs/models/books)
- [Free guitar 3D models for three.js (GLB, CC BY)](https://paprika3d.com/docs/models/guitars)
- [Free shoe 3D models for three.js (GLB, CC BY and CC0)](https://paprika3d.com/docs/models/shoes)

Counts from the library's catalog on 2026-10-28. The models are their authors' work under the license on each card; paprika3d converted them for the web.

Updated 2026-10-28.