Skip to content

Houmgaor/MHFrontier-Blender-Addon

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Monster Hunter Frontier Blender Add-on

A model importer for Monster Hunter Frontier FMOD/FSKL files into Blender.

Install

Install as any Blender add-on:

  • Download this repo as a ZIP from the latest release
  • Open Blender, Edit > Preferences > Add-ons > Install... select the ZIP folder.

Usage

Locate the data you want to import, have a look at the documentation section to find them. Open Blender, File > Import > MHF FMOD, select the file.

Disufiroa with textures

Add the "skeleton" (hierarchy of axes), File > Import > MHF FSKL.

Disufiroa skeleton

Convert the skeleton to an armature, Object > Create Armature from FSKL Tree.

Disufiroa with armature

Your model is imported with the textures, and you can change its pose.

Disufiroa rendered

Build

The important part of the addon is in the "mhfrontier" folder. You only need to create a ZIP of this folder to build it.

If you have Blender 4.2+ use:

cd mhfrontier
blender --command extension build

Otherwise we provide a legacy Python script:

python extra/zip_addon.py

Test

Tests are performed with unittest. You need to manually add model folders in tests/models/. Then open a terminal in the main folder and run:

python -m unittest discover -s tests/fmod/

Documentation

An online documentation is available at Getting started (Frontier Z).

To get any data to extract, you need a Monster Hunter Frontier Z game. Then, the game data need to be decompressed, you don't need to decompress everything as the monster models are in "[your MHFrontier folder]/dat/emmodel[_hd]".

To known which file is which monster you can use monster_ids.md as a reference. To decompress data use ReFrontier. You want .fmod (3D model) and .fskl (skeleton) files.

For the next steps, you can follow the Blender tutorial.

In this fork (Houmgaor/)

New features:

  • Weapons such as lance or models with different parts can now be loaded with a skeleton assigned.
  • Some models could not load with the original add-on.
  • Compatibility with Blender 2.8+.

Changes:

  • Correctly scales and orients models.
  • Less memory usage, preventing crash.
  • Documentation.
  • Code linting.

Acknowledgements

  • @AsteriskAmpersand / *& - Original author.
  • @MHVuze / Vuze - For the Frontier Recursive Block Format documentation used to build this importer.
  • @Silvris - For the Materials and Skeleton documentation used to build this importer.

License

Licensed under GPL v3.0, courtesy of @AsteriskAmpersand.

About

A model importer for Monster Hunter Frontier Files.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%