Meow Generator is a procedural 3D cat creation tool that lets users adjust body shape, coat patterns, play with toys, change weather, and generate collectible cards, all running locally in the browser without a backend.

Stars

88

7-day growth

No data

Forks

10

Open issues

0

License

NOASSERTION

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It combines procedural SDF modeling, hand-drawn style rendering, physics toys, weather effects, and an experimental motion system into a single client-side web app, offering a rich, privacy-friendly creative experience.

Who it is for

  • Digital artists and illustrators
  • Game developers needing quick 3D cat assets
  • Cat enthusiasts and hobbyists
  • Developers interested in procedural generation and Three.js

Use cases

  • Creating unique 3D cat characters for games or animations
  • Generating collectible cat cards with custom colors and patterns for social sharing
  • Learning procedural modeling and WebGL techniques via an open-source reference
  • Exploring cat locomotion and animation with the experimental Motion mode

Strengths

  • Fully client-side with no account or backend, ensuring privacy and offline-capable development
  • Rich customization: 11 coat presets, adjustable body proportions, eye colors, and multiple toys/weathers
  • Multi-language support (Chinese, English, Japanese) and responsive desktop/mobile layouts
  • Non-commercial open-source license (PolyForm) encourages study and experimentation while protecting commercial use

Considerations

  • Motion mode is experimental and may have stability issues
  • Extreme body parameters and prolonged WebGL usage can cause performance variation across devices
  • Commercial use requires separate written authorization; not a standard OSI-approved open-source license

README quick start

Meow Generator

中文 · English · 日本語

一个可以捏体型、换花色、玩玩具、切换天气、尝试动作并生成收藏卡片的程序化 3D 小猫工具。

在线体验 · 反馈问题

非商业源码开放授权 · 商业使用与合作

关于 Meow Generator

Meow GeneratorSimon_阿文(Simon Lee)海辛(Ring Hyacinth) 共同创作。每只小猫都由种子和可编辑参数程序化生成;相同种子可以重新生成相同的小猫体型、花色、姿势、玩具、垫子、收藏编号与稀有度。

项目采用本地优先的浏览器体验,不需要登录账号,也没有后端服务。

主要功能

  • 基于 SDF 的程序化小猫身体,可调整头身比、圆润度、腿、耳朵、尾巴与毛发
  • 11 种预设花色,以及自定义颜色和花纹参数
  • 眼睛颜色、异瞳、瞳孔尺寸与泪眼形变
  • 多种静态造型与轻微待机动作
  • 实验性的 Motion 模式:19 根骨骼与 14 段动画
  • 手绘感描边、三渲二明暗与可调排线阴影
  • 可抓取和投掷的鱼、鸭子、毛线球、猫窝及其他物理玩具
  • 晴天、阴天、雷雨、下雨与鱼雨场景
  • GLB 模型导出与 PNG 小猫收藏卡片
  • 实验性的 Codex 宠物导出交接
  • 中文、英文、日文界面
  • 桌面端与移动端布局

小猫收藏卡片

点击 留影 PNG 后,Meow Generator 会读取当前小猫的底色、主辅花纹色和眼睛颜色,为它生成专属的默认卡面。

每只小猫都会获得:

  • 一个稳定的收藏编号,例如 第 2902 张 / 9999
  • 一个由小猫种子稳定决定的 RSRAR 稀有度
  • 一套从小猫自身颜色提取的默认卡面
  • 可通过“换一个皮肤”切换的圆点、格纹、彩屑与波纹主题
  • 印在导出 PNG 上的公开仓库地址,方便重新找到项目

导出给 Codex(Experimental)

点击 🐾 导出给 Codex,可以为当前小猫准备:

  • 保存体型、花纹、眼睛与配色的参数 JSON
  • 帮助确认最终外观的参考图 PNG
  • 一段可直接复制给 Codex 的创建与安装指令
  • 已验证的橘橘动作样机预览

这个入口只负责准备交接文件,不会自动打开或唤醒 Codex。请把 JSON、PNG 和复制的指令一起发送给 Codex;动作图集生成后,应先检查动作总览与左右方向,再安装为新的独立宠物,避免覆盖已有宠物。

本地运行

需要 Node.js 20.19+ 或 22.12+。

npm install
npm run dev

然后打开 。

生产构建:

npm run build
npm run preview

测试

npm run test:share
npm run test:fish-pick
npm run test:poke
npm run test:motion

Motion 测试覆盖 14 段动画、19 根骨骼、蒙皮权重、状态机输入与源动画采样。

操作方式

  • 左键拖动:旋转摄影机
  • 滚轮或触控板:缩放
  • 右键拖动:平移
  • 拖动玩具:抓取与投掷
  • 拖动脸颊或后侧交互区:软体捏猫
  • 拖动后颈:提起小猫
  • Motion 模式:使用 WASD 或方向键;动作快捷键显示在 Motion 面板中

项目结构

  • src/sdf.js — SDF 基础形状与 Surface Nets 网格生成
  • src/catBuilder.js — 小猫结构、花色渲染与面部细节
  • src/coats.js — 花色、眼睛与姿势定义
  • src/rug.js — 基于种子的垫子与配色
  • src/toys.js — Cannon-es 玩具物理与抓取
  • src/weather.js — 天气、闪电、雨、云与落鱼
  • src/shareCard.js — 收藏卡片主题与 PNG 生成
  • src/codexPetPreview.js — Codex 宠物参数、参考图与指令导出
  • src/mesh2motion*.js — 动作采样、重定向、骨骼与蒙皮
  • src/i18n.js — 中文、英文与日文界面文案

应用没有后端。运行状态和导出文件只保留在浏览器或用户设备中;项目不包含数据分析或账号系统。

创作者

Meow Generator 由 Simon_阿文与海辛共同制作。

Simon_阿文(Simon Lee)

海辛 / Ring Hyacinth

如需后续版本开发或合作申请,请联系 [ringhyacinth

Description

A playful procedural 3D kitten generator built with Three.js.

Related repositories

Similar projects matched by category, topics, and programming language.

hoainho
hoainho GitHub avatar

img2threejs

img2threejs reconstructs a 3D object from a single reference image as a procedural Three.js model using code-only, token-efficient, staged pipeline with quality gates, producing animation-ready Three.js groups.

Python
7,414
CatsJuice
Featured
CatsJuice GitHub avatar

sticker-forge

Sticker Forge is a WebGL tool that turns text or uploaded images into interactive stickers with a simulated peel-and-reveal effect, offering a Web Component and imperative API.

JavaScript
627
dilukangelosl
Featured
dilukangelosl GitHub avatar

fluidkit

A framework-agnostic GPU fluid simulation library for the web using Stable Fluids on WebGL2, with pluggable render modes and React/Vue/Svelte adapters.

AI & Machine LearningAI Agents
8