Kumodesu FirstPerson Compat
A compatibility mod between KumoDesu and First Person Model for Minecraft 1.20.1 (Forge).
Features
- Hide head bone in first person: When playing as a spider evolution (or any evolution form), the head bone of the KumoDesu model is hidden while in first person view so you don't see your own head floating in front of you.
- Per-evolution model offsets: Configure custom X/Y/Z offsets for each evolution ID via datapack JSON files. The offset rotates with your body yaw so it moves relative to where you're facing.
- Datapack-driven configuration: All settings live in
data/kumodesu_firstperson_compat/firstperson_offsets/— add or edit JSON files and run/reloadin-game; no restart required.
Requirements
- Minecraft 1.20.1
- Forge 47.2.0+
- KumoDesu (0.3.8+)
- First Person Model (2.7+)
Installation
- Install KumoDesu and First Person Model.
- Place
kumodesu-firstperson-compat-1.0.0.jarin yourmods/folder. - Launch Minecraft once to generate the default config, then edit the JSON files as needed.
Configuration
Config files go in your world's datapack folder at:
data/kumodesu_firstperson_compat/firstperson_offsets/<filename>.json
Each JSON file contains a map of evolution ID to offset settings:
{
"small_lesser_taratect": {
"x": 0.0,
"y": 0.0,
"z": 0.0,
"hide_head": true
},
"arachne": {
"x": 0.0,
"y": -0.3,
"z": 0.0,
"hide_head": true
}
}
Fields
| Field | Type | Default | Description |
|---|---|---|---|
x |
number | 0.0 |
X offset (east/west) |
y |
number | 0.0 |
Y offset (up/down) |
z |
number | 0.0 |
Z offset (north/south) |
hide_head |
boolean | true |
Whether to hide the head bone in first person |
Notes
- The offset rotates with your body yaw (not head pitch), so it always points in the direction your body is facing.
- Set
"hide_head": falseto keep the head visible for that evolution. - Changes take effect immediately after running
/reloadin-game — no restart needed.
Compatibility
- Works with all KumoDesu evolution forms (spider, goblin, snail, etc.)
- Only affects players in evolution form — humans, humanified players, and players with "Render Race Model" disabled are unaffected.
- Client-side only.