Skip to content

Making A Custom Character

Jump to bottom
Devyn Myers edited this page Apr 4, 2021 · 9 revisions

First Things First

Character files are built as Deli mods, so you'll want to get comfortable with how Deli mods are created and formatted. You can find some information on building Deli mods here

Here is an example of what a characters Deli manifest file can look like:

{
  "guid": "h3vr.tnhtweaker.comradekolbasa",
  "version": "1.1.0",
  "require": "0.3.0",
  "dependencies": {
      "h3vr.tnhtweaker.deli": "1.6.0"
  },
  "name": "Comrade Kolbasa",
  "description": "A character with Russian and Czech weaponry",
  "authors": [ 
    "Devyn Myers" 
  ],
  "assets": {
    "setup": {
      "ComradeKolbasa/*sosig*.json": "h3vr.tnhtweaker.deli:sosig",
      "ComradeKolbasa/*vault*.json": "h3vr.tnhtweaker.deli:vault_file",
      "ComradeKolbasa/": "h3vr.tnhtweaker.deli:character"
    }
  }

}

Another useful resource for building you first character is by looking at existing characters. Here you can find one of my own characters to use as reference.

Finally, you will want to set the config option BuildCharacterFiles to true, which allows TNH Tweaker to generate additional files within the TNH_Tweaker folder inside of the main H3VR folder.

Base Requirements

Characters have two base requirements, a character.json file containing information about the character, and a thumb.png file which will appear in the TNH menu.

The character.json file can be made in several different ways. One option is to use one of generated default character files found in the TNH_Tweaker/DefaultCharacters folder, and change the properties to your liking.

Another option is to build a character file from the provided CustomCharacterSchema.json using JSON editors such the Visual JSON Editor. If you plan on using this editor, make sure you check out the wiki page on Quirks of the Visual JSON Editor

You can find more info about making the character.json file on the Character File wiki page

Once you have your character.json and thumb.png files together in a folder, that folder must be referenced in the Deli manifest file, with the tag h3vr.tnhtweaker.deli:character

Equipment Pool Icons

There are two ways to set icons for equipment pools. The first, is to use one of the pre-existing icons for TNH. The names of these icons can be found inside TNH_Tweaker/IconIDs.txt. Simply use those icon IDs in the IconName field for each equipment pool

The other option for equipment pool icons is using custom icons, which must be placed in the same folder as the character.json file. In this case, you would put the full name (including .png) of the icon into the IconName fields

Custom Sosigs

Sosig templates allow you to create custom sosigs. Making these files is very similar to how character.json files are made. You can find template files for default sosigs in the TNH_Tweaker/DefaultSosigTemplates folder. I highly recommend using these files as a base for your custom sosigs, and editing the values. You can find more info about sosig files here [INSERT LINK TO SOSIG PAGE]

If you're using a JSON editor, the schema for sosig files can be found here

Once you have your custom sosig files made, you must reference them in the Deli manifest file. Sosig files should be referenced in the setup section of the Deli manifest assets list, followed by the tag h3vr.tnhtweaker.deli:sosig

Vault Files

With TNH Tweaker, vaulted guns can be spawned at object constructors or dropped as sosig loot. Simply build the guns you want to spawn, vault them in the item spawner, and then enter the TNH Menu scene (only works for the first time entering for now). All vaulted gun files will appear in the TNH_Tweaker/VaultFiles folder. You can find more info about vault files here [INSERT LINK TO VAULT FILE WIKI PAGE]

Once you have your desired vault files, you must reference them in the Deli manifest file with the tag h3vr.tnhtweaker.deli:vault_file

Clone this wiki locally