
  VRM Rewriter   V1.21c2 
                               Copyright(c) F.Issiki 2023, 2026 


This is a set of VRM Rewriter for Win32 compatible environment. 

This tool rewrites parameters in a VRM model file (VRM0/VRM1) 
according to the assigned options in "modsetup.ini." 

This tool also converts a VRM model file (VRM file) to more 
familar format with those recommended in glTF 2.0 specification 
and deletes unused data area. 


<< How to use (easy way) >> 

    Just start this tool with 
    drag-and-dropping a VRM file onto "VrmRewriter" (.exe).
    
    Converted VRM file will be automatically generated in the 
    same folder with that has original VRM file.  
    
    If you prepare "modsetup.ini" file and assign 
    -SCST, -SCGP, -SCDF, -SCHR, and -SCBG options in it, 
    this tool rewrites the spring-bone coefficients of the skirt 
    bones to the assigned values. 
    Also, if you assign 
    -LCR0, -LCR1, -LCR2, and -LCR9 options in it, 
    this tool rewrites the radii of the leg-fixed colliders 
    to the assigned values. 
    
    ex.)
      -SCBG="Skirt"  // name of the skirt bone group 
      -SCST=0.35     // Stiffness of the spring bones 
      -SCGP=0.50     // GravityPower of the spring bones  
      -SCDF=0.30     // DragForce of the spring bones 
      -SCHR=0.040    // HitRadius of the spring bones (0.030-0.065)
      
      -LCR0=0.040    // radii of the closest colliders to hips 
      -LCR1=0.045    // radii of the 2nd closest colliders 
      -LCR2=0.065    // radii of the 3nd closest colliders 
      -LCR9=0.065    // radii of the colliders after them 
    
    You can omit any of the options. 
    Any letters after the double slash '//' will be skipped and 
    ignored. 
    
    The converted file name will be as "***-rew.VRM", where the
    additional string "-rew" will be attached to the end of the 
    original file name.   
    
    If no option is assigned and the original VRM file has no 
    room to be refined, no change will be made on the converted 
    VRM file. 



<< Details of the conversion >> 

  This tool supports deleting of unused binary data and reformatting 
  of JSON data of VRMs in the recommended format in glTF 2.0 
  specification. 
  The unused binary data are figured out within the manners also 
  defined in glTF 2.0 specification.   
  
  This tool of this version (V1.21) targets deleting unused data only, 
  converts VRM files keeping the formats of original VRM files as 
  unchanged as possible, and rewrites minimum parts of the data in the 
  VRMs without degrading the quality of the models. 
  

<< Supported OS versions >> 

  OS: Windows 8, 8.1, 10, and 11  (x32, x64) 
　　　 (also available on Windows 10/11 in UTF-8 mode)
  RAM: 64MB or more  (not Giga) 

- This tool set is a Windows 95 compatible software. 
  By the default, the OS launches this tool in ANSI compatible 
  mode and does not support Unicode-specific characters in file/folder 
  names (including parent folders). 
  The supported character codes in the ANSI mode are typically 
  multi-byte character codes (famous as DBCS or SHIFT-JIS, etc.).   
  If you encountered an error executing this tool, please 
  remove Unicode-specific characters in file/folder names, or 
  move all related files directly onto the Desktop.
   
  This tool set also supports UTF-8 console mode (the mode using 
  "UTF-8 for worldwide language support", which can be enabled in 
  Region Settings in Settings menu) on Windows 10/11. 
  You can also use UTF-8 console mode, if you encountered with 
  character code problems. 

- Norton Sonar (by NortonLifeLook Inc.(formerly Symantec)) 
  has been found to detect .exe files of this software as a "unknown 
  executable file" and automatically delete them, even if the executable 
  files are free from viruses (not infected). 
  In that case, check and re-scan the executable files (VrmRewriter.EXE, 
  etc.) again with the manual scan in the Norton. If the result of the 
  re-scan shows "no infection" and clarified it to be clean from viruses, 
  please "Recover" and "Exclude" the VrmRewriter.exe 
  from the scan in the "Process" menu in Norton. 

- Windows Defender Smartscreen, which is similar to Norton 
  Sonar, was reported to cause incorrect malware warnings  
  on Windows 10/11 24H2 and later. 
  In that case, check and re-scan the executable files (.exe) again with 
  the manual scan by Microsoft Defender in the "other options" menu at 
  the bottom of the right-click menu.  
   

<< Copyrights and conditions for use (legal notice) >> 

  The author (F.Issiki) holds overall copyrights of this tool. 
  This tool (experimental version) is a freeware.  
  This software is provided 'as-is', without any express or implied 
  warranty.  In no event will the authors be held liable for any damage 
  arising from the use of this software nor inability for using the program. 


<< version history >> 

  V1.15     First released version  
  V1.16     Binary data reduction for VRoid output VRM is supported.  
  V1.16a    Speeding up with omitting temporary file output. 
  V1.16a2   More accurate and stricter checking for data reduction. 
  V1.16a4   Result file size display appended. 
  V1.16a4-2 Attached documents (ReadMe) revised. 
  V1.17     File name display removed in the dialog messages for avoiding  
            character code problems in UTF-8 mode on Windows OS (10/11) 
            sometimes supposing ANSI message letters for the dialog. 
  V1.18     Supported UTF-16 file path recognition (automatic switching 
            of ANSI, UTF-8, and UTF-16 code systems). 
  V1.20     Supported leg-fixed collider radius rewriting. 
            Windows code signing supported. 
  V1.21     Bug fix: learningposePMX failed in starting in the folders 
            that have UTF-specific letters in the folder names. 
            => Fixed. 
  V1.21a    Limited file output speed to improve reliability of the file 
            recording on Windows 11.  
  V1.21b    Supported rewriting of skirt spring bones. 
  V1.21c    Supported rewriting of VRM1 models. 
  V1.21c2   Supported auto-switching of VRM0 and VRM1. 


<< Acknowledgements >> 
  
  We gratefully acknowledge DWANGO Co.,Ltd. for proposing the VRM format  
  and Khronos Group for glTF specification. 
  
  This software is based on the glTF 2.0 specification and in-house VRM 
  file analysis. 
  
  We thank SHOKO for supplying test VRM files, which was the first 
  motivation for this tool. 
  
  The author would like to thank all the authors and artists of tools, 
  models, and application software related with VRMs. 


Feb 14, 2026 
F.Issiki
Finekit, Artist Support, 
https://finekit.co.jp/base/
