settings.json

settings.json is a configurable file of your settings for a game.

The file is located in /Library/N64/Games/{Game Folder}/settings.json .

The contents of settings.json are written by 3D^OS when the console is booted down. When editing files, please ensure you are using valid JSON and your file is validated against the provided schema. If a file fails validation, it will be overwritten with defaults when the console boots up next.

Sample File

settings.json

{…
  "$schema": "https://schemas.analogue.co/platform/3d/settings.json",
  "display": {…
    "odm": "bvm",
    "catalog": {…
      "bvm": {…
        "horizontal_beam_convergence": "professional",
        "vertical_beam_convergence": "professional",
        "enable_edge_overshoot": false,
        "enable_edge_hardness": "soft",
        "image_fit": "original",
        "image_size": "fill"
      },
      "pvm": {…
        "horizontal_beam_convergence": "professional",
        "vertical_beam_convergence": "professional",
        "enable_edge_hardness": "soft",
        "image_fit": "original",
        "image_size": "fill"
      },
      "crt": {…
        "horizontal_beam_convergence": "consumer",
        "vertical_beam_convergence": "consumer",
        "enable_edge_hardness": "soft",
        "image_fit": "original",
        "image_size": "fill"
      },
      "scanlines": {…
        "horizontal_beam_convergence": "off",
        "vertical_beam_convergence": "off",
        "enable_edge_hardness": "soft",
        "image_fit": "original",
        "image_size": "fill"
      },
      "clean": {…
        "interpolation_alg": "bc-spline",
        "gamma_transfer_function": "tube",
        "sharpness": "medium",
        "image_fit": "original",
        "image_size": "fill"
      }
    }
  },
  "library": {…
    "cartridge_color": "gray"
  },
  "hardware": {…
    "disable_antialiasing": false,
    "disable_deblur": false,
    "disable_texture_filtering": false,
    "enable_32_bit_color": false,
    "force_original_hardware": false,
    "force_progressive_output": true,
    "overclock": "auto",
    "region": "auto",
    "virtual_expansion_pak": true,
    "horizontal_upscaling": true
  }
}

Schema

You can add autocompletion, type checking, schema validation and in-editor documentation by using a JSON schema for settings.json.

To enable this, add the $schema key to your JSON file pointing at https://schemas.analogue.co/platform/3d/settings.json like the example below.

/Library/Games/{Game Folder}/settings.json

{…
  "$schema": "https://schemas.analogue.co/platform/3d/settings.json"
  // ...
}

JSON Definitions

displayobjectrequired

odmstringrequired

This is the Original Display Mode specified when playing.

Accepted values

bvmpvmcrtscanlinesclean

catalogobjectrequired

bvmobjectrequired

horizontal_beam_convergencestringrequired

Accepted values

consumerprofessionaloff

vertical_beam_convergencestringrequired

Accepted values

consumerprofessionaloff

enable_edge_overshootbooleanrequired

enable_edge_hardnessbooleanrequired

image_sizestringrequired

Accepted values

fillintegerinteger+

image_fitstringrequired

Accepted values

originalstretchcinema-zoom

pvmobjectrequired

horizontal_beam_convergencestringrequired

Accepted values

consumerprofessionaloff

vertical_beam_convergencestringrequired

Accepted values

consumerprofessionaloff

enable_edge_hardnessbooleanrequired

image_sizestringrequired

Accepted values

fillintegerinteger+

image_fitstringrequired

Accepted values

originalstretchcinema-zoom

crtobjectrequired

horizontal_beam_convergencestringrequired

Accepted values

consumerprofessionaloff

vertical_beam_convergencestringrequired

Accepted values

consumerprofessionaloff

enable_edge_hardnessbooleanrequired

image_sizestringrequired

Accepted values

fillintegerinteger+

image_fitstringrequired

Accepted values

originalstretchcinema-zoom

scanlinesobjectrequired

horizontal_beam_convergencestringrequired

Accepted values

consumerprofessionaloff

vertical_beam_convergencestringrequired

Accepted values

consumerprofessionaloff

enable_edge_hardnessbooleanrequired

image_sizestringrequired

Accepted values

fillintegerinteger+

image_fitstringrequired

Accepted values

originalstretchcinema-zoom

cleanobjectrequired

interpolation_algstring

Accepted values

bc-splinebilinearblackman-harrislanczos2

gamma_transfer_functionstringrequired

Accepted values

tubemodern

sharpnessstringrequired

Accepted values

very-softsoftmediumsharpvery-sharp

image_sizestringrequired

Accepted values

fillintegerinteger+

image_fitstringrequired

Accepted values

originalstretchcinema-zoom

hardwareobjectrequired

disable_antialiasingbooleanrequired

disable_deblurbooleanrequired

disable_texture_filteringbooleanrequired

enable_32_bit_colorbooleanrequired

force_original_hardwarebooleanrequired

force_progressive_outputbooleanrequired

horizontal_upscalingbooleanrequired

overclockstringrequired

Accepted values

autoenhancedenhanced-plusunleashedoff

regionstringrequired

Accepted values

autontscpal

virtual_expansion_pakbooleanrequired

libraryobjectrequired

cartridge_colorstringrequired

This is what color the cartridge will show up in the Library view.

Accepted values

grayredgreenblueyellowgoldblackpurplerose