New extension: ParticleFur3D

[github-actions]

Description

Particle Fur 3D adds animated outer coat and undercoat to GDevelop 3D Model
objects.

The fur follows the source model's skeletal animation, can sample the model's
base-color texture, and can be restricted or styled with Blender vertex-group
masks exported as GLB custom attributes.

Main use cases include:

• short or long animal fur;
• animated tails, ears, paws, toes, and head coat;
• dense undercoat and longer outer coat;
• long coat with hanging and wave motion;
• model-texture-colored fur;
• fur limited to painted regions of a custom model.

How to use the extension

1. Import ParticleFur3D.json.
2. Add the Particle Fur 3D behavior to a 3D Model object.
3. Leave Fur coverage vertex group(s) empty to test the whole mesh.
4. Start with a moderate generated root count and run a Preview.
5. For painted regional control, install the included Blender vertex-group
   exporter.
6. Export Blender groups as _VG_... FLOAT/POINT mesh attributes.
7. Export the model as GLB and enter the original group names in the behavior.

Common groups recognized automatically include:

• BODY
• HEAD
• FEET
• PAWS
• EARS
• INNEREARS
• TAIL
• LONGFUR

FEET and PAWS are mapped separately so legs do not consume the root budget
reserved for paws and toes.

The included example package uses a model with exported regional groups and can
be used to verify installation and configuration.

Particle Fur 3D Blender Vertex Group Exporter v1.0.0

This Blender add-on copies vertex-group weights into custom mesh
attributes that can be exported through glTF/GLB and read by the
Particle Fur 3D GDevelop extension.

Installation

1. Open Blender.
2. Open Edit > Preferences > Add-ons.
3. Choose Install from Disk.
4. Select ParticleFur3D_Blender_Helper_v1.0.0.zip.
5. Enable Particle Fur 3D Vertex Group Exporter.

The panel appears in:

3D Viewport > Sidebar (N) > Particle Fur 3D

The .py file can also be opened and run in Blender's Text Editor.
Running it directly registers the same panel.

Exporting a group

1. Select the mesh object.
2. Select a group in Vertex group.
3. Click Export Selected Group.
4. Export the model as GLB.
5. In GDevelop, enter the original Blender vertex-group name.

Example:

• Blender vertex group: tail_fur
• Generated mesh attribute: _VG_tail_fur
• GDevelop field: tail_fur

Blender's glTF exporter exports mesh attributes whose names begin with
an underscore. Keep mesh/data attributes enabled in the glTF export
settings.

Exporting several groups

Enter names separated by commas, semicolons, |, or new lines:

fur
tail_fur
head
nosebridge
inner_ears
afghan_long_coat

Then click Export Named Groups.

particlefur3dexample.zip

Checklist

• I've followed the extension best practices.
• I confirm that this extension can be integrated into this GitHub
  repository, distributed, and MIT licensed.
• I am aware that the extension may be updated by anyone and does not need
  my explicit consent for future maintenance.

ParticleFur3D.zip

Checklist

• I've followed all of the best practices.
• I confirm that this extension can be integrated to this GitHub repository, distributed and MIT licensed.
• I am aware that the extension may be updated by anyone, and do not need my explicit consent to do so.

AI usage

• I used an AI to generate some part of the code.
• I don't understand the generated code or I don't feel able to modify it.

Example file

particlefur3dexample.zip

Extension file

particlefur.zip

---

Extension by @monjanse

You can update the extension on this "Pull Request" by commenting the update command: in the comment field, type !update, then drag and drop a zip file with your extension file in the commenting field, like how you initially submitted the extension. It should look like this:

!update [MyExtension.zip](https://github.com/GDevelopApp/GDevelop-extensions/files/12709661/MyExtension.zip)

It can take a few seconds for the file to fully upload and show as the above. Once it is like shown above, click "Comment" and let the bot do the rest!