Free cup and mug 3D models for three.js (GLB, CC BY and CC0)
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.
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:
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 by martin_dalm
CC BY 4.0 · 22,380 triangles · 0.306 MB · realistic · 0.08 m tallasset_search {"pick": "b3c233751c824b1a9af21abaeaf68e76"}
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.
CE Mug by vsigno
CC BY 4.0 · 38,340 triangles · 0.91 MB · scanned · 0.1 m tallasset_search {"pick": "f3b7a5b95c6b4e599e914a79e563f2d7"}
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.
pig cup by zookavin
CC BY 4.0 · 9,419 triangles · 0.121 MB · scanned · 0.1 m tallasset_search {"pick": "94afa2785d4548f7abb0a40adcd4033f"}
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.
Hobo Mug by Mountrise
CC BY 4.0 · 87,957 triangles · 1.126 MB · realistic · 0.12 m tallasset_search {"pick": "98a7dd95a1aa44f184c3b6967b2a4e18"}
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.
cup by Wolfy23
CC BY 4.0 · 1,430 triangles · 0.165 MB · realistic · 0.1 m tallasset_search {"pick": "09a02c9b14da4cbd9c2a92d27835a6e4"}
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.
Worn metallic cup by Kalle
CC BY 4.0 · 9,874 triangles · 0.564 MB · realistic · 0.1 m tallasset_search {"pick": "2a950021a0914fc6be680954378b9a9e"}
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.
Mug with a biblical scene by Virtual Museums of Małopolska
CC0 · 61,422 triangles · 0.515 MB · scanned · 0.15 m tallasset_search {"pick": "3c0ef6442d0f48928394b284107a9444"}
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.
Coffee to go cup by markdragan
CC BY 4.0 · 3,636 triangles · 0.118 MB · stylized · 0.12 m tallasset_search {"pick": "cdb8ee2283664400939454f36b68fb53"}
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.
Beer Mug by Stoerbi
CC BY 4.0 · 14,619 triangles · 0.631 MB · stylized · 0.12 m tallasset_search {"pick": "cf859a556f274d74a6c3d5ccf73988eb"}
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.
Stylized Old Beer Cup by Isl_Takhir
CC BY 4.0 · 3,154 triangles · 0.239 MB · stylized · 0.15 m tallasset_search {"pick": "8b1203f5cd4440929d317719afdf2441"}
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.
Mug - SGD 116 by jackjprice
CC BY 4.0 · 4,342 triangles · 0.268 MB · realistic · 0.15 m tallasset_search {"pick": "f15c826d13dc4d5f9df1898bf3f4c634"}
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.
Paper Cup Coffee by AndreyErmolaev
CC BY 4.0 · 802 triangles · 0.07 MB · realistic · 0.12 m tallasset_search {"pick": "19c12761d6884c5882f10449d2711fe1"}
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.
Mary Rose Tankard - Low Poly by John Fino (tauricity)
CC BY 4.0 · 964 triangles · 0.183 MB · low-poly · 0.2 m tallasset_search {"pick": "2873d816bb964e488f1cabf5013c7095"}
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.
Dark coffee cup by tombuben
CC BY 4.0 · 27,592 triangles · 0.203 MB · scanned · 0.1 m tallasset_search {"pick": "2bfc0133883b4560b62de3e5eb58e76c"}
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.
Medieval Cup by aAquariuZz
CC BY 4.0 · 13,665 triangles · 0.65 MB · stylized · 0.12 m tallasset_search {"pick": "e3ed780a868245c69e9e45613c495ba8"}
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.
Mug by natancassano
CC BY 4.0 · 672 triangles · 0.352 MB · realistic · 0.15 m tallasset_search {"pick": "2756ab033f094e568034245a19479974"}
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.
Painted cup by Aupuma
CC BY 4.0 · 20,796 triangles · 0.212 MB · scanned · 0.12 m tallasset_search {"pick": "d2c546af84df4afa96f6ae565df76434"}
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.
Cup of Coffee by mornaista
CC BY 4.0 · 12,672 triangles · 0.186 MB · realistic · 0.1 m tallasset_search {"pick": "e692c997bb4d4ffd87beda42b7626688"}
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.
Tankard by Seats
CC BY 4.0 · 5,315 triangles · 0.362 MB · realistic · 0.15 m tallasset_search {"pick": "462498b44e9a413ea94c58724b69ded5"}
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.
Metal Cup (WW2 Style cup, vintage) by Warkarma
CC BY 4.0 · 1,806 triangles · 0.221 MB · realistic · 0.1 m tallasset_search {"pick": "d70c2777df9e4971a7303a6d9da2dd97"}
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.
VSCO girl mug by Chloe Garces
CC BY 4.0 · 7,200 triangles · 0.186 MB · stylized · 0.1 m tallasset_search {"pick": "12aecefa782c4e15b94920cab9f4243e"}
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.
Cup from abandoned space station by tokkilap
CC BY 4.0 · 53,440 triangles · 0.56 MB · sci-fi · 0.1 m tallasset_search {"pick": "d334529585db4b66b11a1e6344a45c47"}
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.
Pottery Vessel or Mug by The Hunt Museum
CC0 · 85,170 triangles · 0.586 MB · scanned · 0.25 m tallasset_search {"pick": "f11b4220bda84ca19012727e26e284c1"}
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.
Aluminum mug (lowpoly) by Mikhail Antonov
CC BY 4.0 · 1,890 triangles · 0.116 MB · low-poly · 0.1 m tallasset_search {"pick": "7bc2b14a48d1413e9375c32a53e3ee6f"}
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.
Related
- Free barrel 3D models for three.js (GLB, CC BY)
- Free book 3D models for three.js (GLB, CC BY and CC0)
- Free guitar 3D models for three.js (GLB, CC BY)
- Free shoe 3D models for three.js (GLB, CC BY and CC0)
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.