How to Add Item Displays

Updated 2 weeks ago

Setup a Body for Editing

  • Download the mod and go to config.
    • The mod comes with one pre-loaded so you don't have to run the game the first time.
  • enable "Export Unused Item Displays" and "Allow Unused Child Locator Entries"
  • run the game
  • look in the mod folder, there are now two folders called "Rules" and "Export"
  • go to "Export" and find the [MonsterInternalName]Body.json file for the monster(s) you want to adjust
  • move the .json file to the Rules folder
  • Close the game.
  • Make sure you have this mod installed: Item Display Placement Helper
  • open the game again
  • You should now be able to press f2 on the title screen and edit the Item Displays for the monster.

Huge thanks to viliger for making this all work. This section would have been a lot longer and required building the mod without his help.

Setup IDPH for editing

  • Copy this block of text
          {childName},
          [{r:localPos.x},{r:localPos.y},{r:localPos.z}],
          [{r:localAngles.x},{r:localAngles.y},{r:localAngles.z}],
          [{r:localScale.x},{r:localScale.y},{r:localScale.z}],
  • select any character on the top left
  • select any item display on the middle left
  • select one of the display prefabs on the right
  • click this cog:
    image
  • paste the block you copied above into the custom field
  • you're good to start editing!

Editing Item Displays

  • open up the .json file of the body you wanted to edit in any text program
    • it's not formatted perfectly, but it should be decent enough to work with, hopefully
  • you'll likely see elite crown displays for enemies. These are from vanilla, and won't be applied since they already exist, however they are decent examples to look at.
    • we may update the mod in the future to support overriding these displays
  • under these displays are stubbed displays for all the other items, based on Merc's setup.
    here's an example: Let's look at Monster tooth, because it has multiple displays for one item
    ["Tooth",[["DisplayToothNecklaceDecal","",
    "Head",[0,0,0],[0,0,0],[1,1,1]
    ],
    ["DisplayToothMeshLarge","",
    "Head",[0,0,0],[0,0,0],[1,1,1]
    ],
    ["DisplayToothMeshSmall1","",
    "Head",[0,0,0],[0,0,0],[1,1,1]
    ],
    ["DisplayToothMeshSmall2","",
    "Head",[0,0,0],[0,0,0],[1,1,1]
    ],
    ["DisplayToothMeshSmall2","",
    "Head",[0,0,0],[0,0,0],[1,1,1]
    ],
    ["DisplayToothMeshSmall1","",
    "Head",[0,0,0],[0,0,0],[1,1,1]
    ]]],```
    
  • The main lines you have to worry about are the ones that look like this: "Head",[0,0,0],[0,0,0],[1,1,1]
  • For each display in your ItemDisplayRule, place it how you like in the helper, then hit copy on the right
  • highlight this line, and paste to replace it.
  • Save, and your new item display should now be applied

any questions, let thetimesweeper know!

AdditionalChildren

This is now done automatically, feel free to skip this section.

Normally, the base game is not equipped to put item displays on all bones. This is because they are not set up in the character's child locator. This mod adds the ability to add new entries to the child locator for item displays to use. When you generate a new .json for a monster, they should already be there.

Contributing

once your json file is ready, send it over to us to update the mod with it!
(and by "ready" I mean with whatever you'd like to do. any amount of items done for a monster is still fantastic to contribute)

  • Directly on github:
  • Directly on discord:
    • dm thetimesweeper directly
    • ping thetimesweeper anywhere, such as the ror2 modding discord or the enforcergang discord
  • once you're done doing Item displays, go ahead and disable the configs from earlier. They are not needed for normal play.