pmx

Convert PMX 3D model files to and from JSON for editing.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/minarin0179/pmx-edit-skill --skill pmx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pmx
Source: https://github.com/minarin0179/pmx-edit-skill/tree/main
Command: npx skills add https://github.com/minarin0179/pmx-edit-skill --skill pmx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows for the programmatic reading and editing of PMX (MikuMikuDance 3D model) files, simplifying complex 3D model manipulations that would otherwise require specialized software.

Core Features & Use Cases

  • PMX <-> JSON Conversion: Enables round-trip conversion for easy data manipulation.
  • Material Editing: Modify colors, transparency, and edge settings.
  • Bone & Morph Adjustments: Edit bone positions and morph values.
  • Physics Configuration: Adjust rigidbody and joint parameters.
  • Vertex Manipulation: Move, scale, and normalize vertex weights.
  • Use Case: Quickly change the color of all materials on a model, adjust the strength of a specific facial expression morph, or fine-tune physics settings for better animation.

Quick Start

Use the pmx skill to unpack the model 'character.pmx' into 'character.pmx.json'.

Frequently Asked Questions about pmx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit MMD 3D models programmatically without specialized software?

You can edit MMD 3D models by converting PMX files to and from a JSON format. This enables programmatic manipulation of materials, bones, morphs, vertices, and physics properties without specialized modeling software.

Can I batch modify material colors and transparency in a PMX file?

Yes, you can batch modify material colors, transparency, and edge settings in a PMX file. By unpacking the model into JSON, you can programmatically adjust all materials and repack it with round-trip fidelity.

Does this PMX editing method support both version 2.0 and 2.1 formats?

Yes, PMX editing supports both 2.0 and 2.1 formats. The conversion process to and from JSON ensures round-trip fidelity for these specific MikuMikuDance 3D model versions during detailed manipulation.

What is the best way to adjust physics and rigidbody parameters in MMD models?

The best way to adjust physics parameters is converting the PMX model to JSON. This allows you to directly modify rigidbody and joint configurations to fine-tune physics settings for better animation.

How do I unpack a PMX file into JSON to start editing 3D model vertices?

To unpack a PMX file, use the pmx skill to convert your model, such as 'character.pmx', into 'character.pmx.json'. You can then move, scale, and normalize vertex weights directly within the JSON structure.