Firefly
A firefly at real size (1 = a 1.4 cm beetle; the size knob scales it up to a 40 cm fantasy lantern bug): a flat rounded head shield with a dark centre spot and a pale rim, big eyes and long beaded antennae, two dark wing cases lifted and spread in flight with pale outer margins, smoky hind wings beating underneath, dangling legs, and a hanging abdomen whose last segments form a pale lantern that glows yellow-green at night. Flies by distance, slowly, wings buzzing and the body drifting up and down.
- Size
- 0.03 × 0.01 × 0.02 m
- Triangles
- 1,448
- Kit
- Garden Bugs
Tune it
4 knobs: Colours, Lantern, Hind wings, Size.
Specs
- Size
- 0.03 × 0.01 × 0.02 m width × height × depth
- Triangles
- 1,448 of 6,000
- Draw calls
- 1 one vertex-colour material
- Loop clip
- 0.009 m of travel per cycle
- Altitude
- 0.08 m above the ground
- Moving parts
- 6 elytron_L · rotate, elytron_R · rotate, abdomen · rotate, body · slide, wing_L · rotate, wing_R · rotate
- Knobs
- 4 3 presets
- Night lights
- 1 glow
Passed the validator: real scale, rests on y = 0, front faces +Z, deterministic.
Use it
Code for the specimen as it is set up above; it follows your knobs.
import { createAsset } from 'https://gaitkit.com/cdn/firefly.mjs';
const firefly = createAsset();
scene.add(firefly); // rests on y = 0, front faces +Z
let dist = 0;
renderer.setAnimationLoop(() => {
dist += speed * clock.getDelta();
firefly.position.set(0, groundY + firefly.userData.altitude, dist);
firefly.userData.tick(dist); // wings beat with the distance
renderer.render(scene, camera);
});import { useMemo, useRef } from 'react';
import { useFrame } from '@react-three/fiber';
import { createAsset } from 'https://gaitkit.com/cdn/firefly.mjs';
export function Firefly({ speed = 1 }) {
const model = useMemo(() => createAsset(), []);
const dist = useRef(0);
useFrame((_, dt) => {
dist.current += speed * dt;
model.position.set(0, groundY + model.userData.altitude, dist.current);
model.userData.tick(dist.current); // wings beat with the distance
});
return <primitive object={model} />;
}# Import firefly.glb (download below). It carries an in-place "Loop" animation.
@onready var anim: AnimationPlayer = $Firefly/AnimationPlayer
func _physics_process(delta):
velocity = transform.basis.z * speed
move_and_slide()
anim.play("Loop")
anim.speed_scale = speed / 0.009 # one Loop = 0.009 m of travel// Import firefly.glb with glTFast (com.unity.cloud.gltfast).
animator.Play("Loop");
animator.speed = speed / 0.009 // one Loop = 0.009 m of travelUse the gaitkit MCP server: get_variant({ "id": "firefly", "want": "default look" })
then place the result.
# MCP endpoint
https://gaitkit.com/mcpKnobs
| Knob | Type | Values | Default | What it does |
|---|---|---|---|---|
coat | choice | classic amber dusk | classic | classic (black wing cases with yellow margins, a pink head shield with a black spot), amber (brown and gold), dusk (charcoal with a red-orange shield). |
lantern | range | 1 to 3, step 1 | 2 | How many tail segments form the glowing lantern: 1 (a small tip light, a female) to 3 (a big lantern, a bright male). |
wings | toggle | on / off | true | The smoky membranous hind wings that beat under the lifted wing cases. Off = only the wing cases, like a wingless glow-worm female (she still drifts by distance). |
size | range | 1 to 30, step 0.5 | 1 | Uniform scale. 1 is real size (1.4 cm long); 10 is a 14 cm game-readable firefly; 30 is a 40 cm fantasy lantern bug. |
Presets: summer firefly {"coat":"classic","lantern":2} · golden glow {"coat":"amber","lantern":3,"size":1.5} · glow-worm {"coat":"dusk","lantern":1,"wings":false}
Files
| File | What |
|---|---|
| firefly.glb Pro | GLB, default look · 248 KB |
| firefly.mjs Pro | ES module, every knob live |
| firefly.obj Pro | OBJ, static; colours in the .mtl |
| firefly.mtl | OBJ colours; keep it next to the .obj |
| firefly-params.json | knob schema, presets, night zones |
Licence
Use it in games, apps, renders and client work, commercially and without credit. Do not resell it as an asset or train a 3D generator on it. The full licence.