Roommates Tool

Roommates Tool allows you to place most NPCs (even a few that don't normally appear in-game) anywhere you want in each of your 4 rooms, the Research Base, Astera, Seliana, and the Seliana Pub.

You can place the same NPC multiple times and even have them use animations from different NPCs (including cats).

Modifications are client-side. Only you will see the NPCs in Seliana Pub and Seliana Suite unless your fellow hunters have the same modifications.

Feel free to upload screenshots and share your layouts in the comments!

• []Not compatible with my mod, Roommates for Life. Uninstall RfL before using this tool to avoid a few inconsistencies.

  [] Optional File provided for compatible versions of RfL NPCs and locations, extract to MHW install directory.

  []Old files not compatible. You can use an older version of the app to check the NPC locations in the old files.

• []Extract to MHW install directory. "MHWRoommates" folder should be neighbours with "chunk" "DLL" and "nativePC"

  []Download any presets you want from optional files.

  If you don't have any other mods using "/village/st301" "/village/st303" "/village/st305" "/village/st306" "/village/st501" "/village/st502" "/village/st503" or "/village/st506" simply delete those folders.

  Otherwise you can use the tool itself to delete the mod files one by one. Delete both individual NPCs and the Room Lists

  • []Use the "NPC Lists" window to enable/disable NPCs for each room. (Modifies .sobjl files)

    []Use the main window to setup the positions and animations of each NPC. (Modifies .sobj files)

   If the NPC normally doesn't exist in the chosen room, the default location/rotation is based on the Housekeeper's for that room; The Handler for the Research Base, Astera, and Seliana; and Pub Event Manager for Seliana Pub.

  Make sure you don't forget to add the Housekeeper back into the rooms!

  Click the yellow "?" button for an explanation of the colours.

  • []NPCs must be both present in the Enabled List and have a .sobj file for the room in order to show up.

    []No need to relaunch the game to see changes. Simply reloading the room by re-entering or accessing the change appearance menu will work.

    []Consider using an overlay that can show the player's current location to help with positioning.

    []If you want more than one copy of the same NPC in the same room, add them to the Enabled NPCs list multiple times.

   The copies will be enabled in numerical order starting from 0 so don't skip any.
  • []There are a lot of combinations of NPC/rooms/animations so it's hard to test them all

  If you find any combinations that crash, don't work, or are labelled wrong, please let me know!
  • NPCList.xml file should be easy to read/modify so you can:

   Change/Remove annoying tags (no cheating!)

  Hide certain NPCs from the tool (with warning = "Ignore")

  Add animations. (If you know of any not in the XML file already, please let me know!)

  Source: https://github.com/mastermune/MHWRoommatesTool