Skip to content

Documentation

Julian Koberg edited this page Aug 1, 2025 · 84 revisions

List of JSON Keys (Not all values have to be used. Though some may):

Custom Entry Values

Main Values

  • "monster_name" (Example: "TEST_NAME"): Name of the monster.

  • "monster_description" (Example: "DESCRIPTION"): Description of the monster, allows special formatting.

  • "monster_portrait_image_name" (Example: "image.png"): Name of the image inside the same folder.

  • "monster_audio_clip_name" (Example: "sound.wav"): Name of the sound file inside the same folder.

  • "access_level" (Examples (INT): 0-5): Which access level is needed when playing the main campaign (0 → No permissions needed).

  • "include_campaign" (Examples: true, false) (Default: false): If to include it in the main campaign.

  • "attached_custom_campaign_name" (Example: "Name of custom campaign"): If to be included in a custom campaign. Only requires name to be provided. Will only show up in the custom campaign provided.

  • "monster_id" (Optional / Deprecated) (INT (Examples: 0-99999)): ID for the monster, best to leave it empty and let the mod handle it for you. If the ID already exists, it will instead replace it. I do not recommend using this to replace unless you are replacing an entry in a complicated mater. Use the replace option in the advanced section instead!

Phobias

  • "spider_phobia" (Optional) (Examples: true, false) (Default: false): If to hide the image of the entry if spider phobia is enabled.
  • "darkness_phobia" (Optional) (Examples: true, false) (Default: false): If to hide the image of the entry if darkness phobia is enabled.
  • "dog_phobia" (Optional) (Examples: true, false) (Default: false): If to hide the image of the entry if dog phobia is enabled.
  • "holes_phobia" (Optional) (Examples: true, false) (Default: false): If to hide the image of the entry if holes phobia is enabled.
  • "insect_phobia" (Optional) (Examples: true, false) (Default: false): If to hide the image of the entry if insect phobia is enabled.
  • "watching_phobia" (Optional) (Examples: true, false) (Default: false): If to hide the image of the entry if watching phobia is enabled.
  • "tight_space_phobia" (Optional) (Examples: true, false) (Default: false): If to hide the image of the entry if tight spaces phobia is enabled.

DLC: Seasonal Worker

  • "only_dlc" (Examples: true, false) (Default: false): If to only show in the DLC.
  • "include_dlc" (Examples: true, false) (Default: false): If to also include in the DLC.

Caller Arcade Mode Values (Values of the caller for the Entry)

  • "arcade_calls" (List) (Example: ["Hello, I have this problem…", "Hi, I think I have this problem…"]): List of text that appear when called in Arcade (Training) Mode.
  • "caller_audio_clip_name" (Example: "sound.wav"): Audio played when called for this entry.

Caller Main Campaign Values (Values of the caller for the Entry) (Requires include_campaign to be true)

This is for main campaign callers! For custom campaign, see how to add custom callers.

  • "caller_audio_clip_name" (Example: "sound.wav"): Audio played when called for this entry.
  • "caller_name" (Example: "John Safety"): Name of the caller.
  • "caller_transcript" (Example: "Hello, I need help."): Transcript of the caller in text form.
  • "caller_image_name" (Example: "image.png"): Name of the image for the caller inside the same folder.
  • "caller_chance" (Example: 0.3) (Default 0.1): Chance that this entry replaces the caller. Must be between 0.0 and 1.0. (Or equal). Requires to be included in the main campaign for it to work.
  • "allow_calling_again_over_restarts" (Default: true) (Example: true, false): If the call is allowed to happen again upon restarting the game. Default is true. If set to false, it would prevent you from getting that call again. (Setting this to true or not providing it, will reset previous save for it)

Consequence Main Campaign Values (Values of the caller for the entry after the player got it wrong) (Requires include_campaign to be true)

This is for main campaign consequence callers! For custom campaign, see how to add custom callers.

  • "consequence_caller_audio_clip_name" (Example: "sound.mp3"): Audio played when called for this entry after the player got it wrong.
  • "consequence_caller_name" (Example: "John Safety"): Name of the consequence caller.
  • "consequence_caller_transcript" (Example: "Hello, I need help."): Consequence transcript of the caller in text form.
  • "consequence_caller_image_name" (Example: "image.png"): Name of the image for the consequence caller inside the same folder.

Advanced Values

  • "replace_entry" (Examples: true, false) (Default: false): Replace an entry / monster instead of adding it. (Also works in custom campaigns)

Custom Campaign Values

Main Values

  • "custom_campaign_name" (Example: "Custom Campaign Name"): The internal name of the custom campaign.
  • "custom_campaign_days" (Example: 5): Amount of days the custom campaign runs for. Recommended to use accurate values to avoid any errors or unexpected actions.
  • "custom_campaign_desktop_name" (Example: "Custom Campaign\nDesktop Name"): Name of custom campaign on the desktop. This option is purely cosmetic!
  • "custom_campaign_icon_image_name" (Example: "smug_cat.png"): Image used for icon on the desktop.
  • "custom_campaign_remove_main_entries" (Example: true) (Default: false): Removes all default entries / monsters from the custom campaign.

Thresholds for Warning and Game Over

  • "custom_campaign_gameover_threshold" (Default Value: 60): Threshold when to trigger the game over screen at the end of the day. (Except first day)
  • "custom_campaign_warning_threshold" (Default Value: 60): Threshold when to trigger a warning call. Do not forget, it happens after a certain caller.
  • "custom_campaign_threshold_amount" (Example: [3, 2, 3, 4, 5, 7]): This refers to the amount of monster / entry callers that need to have called before the warning call happens. This does not include dynamic (non-entry callers) callers.

Game Over and End Cutscenes

  • "custom_campaign_end_cutscene_video_name" (Example: "cat_upset.mp4"): Cutscene Video to show at the end. Meaning that they finished the campaign successfully.
  • "custom_campaign_gameover_cutscene_video_name" (Example: "cat_upset.mp4"): Cutscene video to show when the player loses. Meaning, when the player didn't have enough correct callers at the end of the day. This does not trigger at the first day.

Day Customization

  • "custom_campaign_days_names" (Example: ["Monday", "Second Day", ..., "Last Day]): A list of names for the different days. These get shown at the beginning of each day.

  • "start_year" (Example: 1997): The year that will be displayed on the desktop date.

  • "start_month": (Example: 12): The month that will be displayed on the desktop date.

  • "start_day" (Example: 15): The day that will be displayed on the desktop date.

  • "use_europe_date_format" (Example: true) (Default: false): If to show the desktop date in the european date format.

Loading Settings

  • "custom_campaign_loading_desktop_text1" (Example: ["First Text loading", "First Text loading.", "First Text loading..", "First Text loading..."]): Text shown when loading in. The first loops trough each text. So by adding a dot at the end, you can animate a loading text.
  • "custom_campaign_loading_desktop_text2" (Example: ["Second Text loading", "Second Text loading\nSecond Text loading 2"]): This section of the loading screen just goes through each line displays that.

Desktop Settings

  • "desktop_username_text" (Example: "USER Bob"): Username to show on the desktop.

  • "custom_campaign_desktop_backgrounds" (Example: ["firstDayBackground.png", "secondDayBackground.png"]): Background to show for each different day. First image in the list is for the first day, second image for the second day and so on.

  • "custom_campaign_desktop_game_finished_background" (Example: "cat.jpg"): When the player beats the game, they get a custom background. You can provide that banner with this option.

  • "disable_green_color_on_desktop" (Default: false): Disables the green tint on the background if set true.

  • "disable_desktop_logo" (Default: false): Disables the logo on top of the background on desktop.

  • "custom_desktop_logo_name" (Example: "cat.jpg"): If you wish to change the logo with an image, you can use this option.

  • "custom_desktop_logo_transparency" (Default: 0.2627): Allows you to set the transparency of the logo. Higher values mean less transparency, and lower values mean more transparency.

  • "rename_main_game_desktop_icon" (Example: "John Safety Hotline"): Renames the main game program to a different name.

  • "main_game_desktop_icon_path" (Example: "cat.jpg"): Allows you to change the image of the main program on the desktop.

Removing existing main campaign emails and videos

  • "remove_default_emails" (Default: true): Removes all the main campaign emails from appearing in the custom campaign.
  • "disable_main_campaign_videos" (Default: true): Removes all main campaign videos from appearing in the custom campaign.

Helper Options for testing in custom campaign

  • "entry_browser_always_active" (Default: false):

  • "scorecard_always_active" (Default: false):

  • "artbook_always_active" (Default: false):

  • "arcade_always_active" (Default: false):

  • "always_show_skip_call_wait_time" (Default: false):

Custom Email Values

Custom Video Values