Config files

Configuration

Config json-files are created on first start of the emulator and can be found under "./Config". It's enough to call psoff.exe --h.

Our configuration engine automatically fixes your config files when you upgrade to a newer version of psOff-libs. All outdated keys will be deleted automatically and the new ones will be added with the default vaue. The corresponding messages will be displayed in the terminal window.

controls.json : Gamepad layout

You can change the layout now in controls.json, if you want to.

{
  // You don't have to bind all the buttons there.
  // Emulator will show the missing keybind message
  // that you can ignore without any problems.
  // These binds will be used to emulate gamepad actions for the pad with `type` set to "keyboard"
  // Key names can be obtained here: https://wiki.libsdl.org/SDL2/SDL_Scancode
  "keybinds": {
    "gamereport.send": "f11",
    "overlay.open": "tab",
    "controller.circle": "l",
    "controller.cross": "k",
    "controller.dpad_down": "down",
    "controller.dpad_left": "left",
    "controller.dpad_right": "right",
    "controller.dpad_up": "up",
    "controller.l1": "f3",
    "controller.l2": "f5",
    "controller.l3": "space",
    "controller.lx+": "d",
    "controller.lx-": "a",
    "controller.ly+": "s",
    "controller.ly-": "w",
    "controller.options": "f1",
    "controller.r1": "f2",
    "controller.r2": "f6",
    "controller.r3": "home",
    "controller.rx+": "f",
    "controller.rx-": "h",
    "controller.ry+": "g",
    "controller.ry-": "t",
    "controller.square": "j",
    "controller.touchpad": "f4",
    "controller.triangle": "i"
  },
  // This array contains 4 objects with the similar structure.
  // These objects describes the parameters for each pad
  "pads": [
    {
      // Which controller backend should be used for this gamepad:
      // * SDL (almost any gamepad): sdl
      // * All Xbox-compatible gamepads: xinput
      // * Gamepad emulation using keyboard: keyboard
      "type": "sdl",
      "deadzones": { // Ignore it for now, not implemented
        "left_stick": {
          "x": 0.0,
          "y": 0.0
        },
        "right_stick": {
          "x": 0.0,
          "y": 0.0
        }
      }
    },
    // More pads here...
  ]
}

general.json

{
  "systemlang": 0, // System langauge, see the list below to get these indexes
  "netEnabled": false, // Wether enable networking features or not. Better to keep it disabled, not ready for the actual use.
  "netMAC": "00:00:00:00:00:00", // Your ethernet adapter's MAC address. Zero-MAC means "first usable device".
  "trophyKey": "", // ERK trophy key in hex format. You should dump it from your console, otherwise trophies will not work.
  "onlineUsers": 1, // Number of authorized users, 1..4
  "userIndex": 1, // Id of the user that started the game
  "profiles": [ // User profiles, you can change your name there
    {
      "color": "blue",
      "name": "Anon #1"
    },
    // More users here...
  ],
}

Game language can be changed with systemlang : *, default is EnglishUS. Game must support it.

Japanese = 0
EnglishUS = 1
French = 2
Spanish = 3
German = 4
Italian = 5
Dutch = 6
PortuguesePT = 7
Russian = 8
Korean = 9
ChineseTraditional = 10
ChineseSimplified = 11
Finnish = 12
Swedish = 13
Danish = 14
Norwegian = 15
Polish = 16
PortugueseBR = 17
EnglishUK = 18
Turkish = 19
SpanishLA = 20
Arabic = 21
FrenchCA = 22
Czech = 23
Hungarian = 24
Greek = 25
Romanian = 26
Thai = 27
Vietnamese = 28
Indonesian = 29

audio.json

{
  "device": "[default]", // Audio device name, [default] means system default output device
  "volume": 0.05, // Master volume, 0...1
  /**
   * The game will use these audio devices as pad speaker. Starting with psOff v.0.5 you can use
   * the actual DualSense audio device there, it will play the audio that the game supposed
   * to play through gamepad speaker. Note that DualShock 4 spaker is NOT supported!
   */
  "padspeakers": [
    "[null]", // Your full audio device name e.g. "DualSense Wireless Controller (DualSense Wireless Controller)"
    "[null]",
    "[null]",
    "[null]"
  ]
}

graphics.json

Warning

The emulator updates this file every time you gracefully stop the emulation (by closing the emulator window)!

{
  "display": 1, // Your display index, starting from 0
  "fullscreen": false, // Wether emulator will run in fullscreen mode or not
  "height": 1080, // The emulator window dimensions, ignored in fullscreen mode
  "width": 1920,
  "xpos": -1, // The emulator window position, -1 means center
  "ypos": -1
}

logging.json

{
  // Log output
  // Possible values:
  // 1) Baical - to Baical server over network
  // 2) FileBin - to local binary file (you should use this format to post compatibility reports)
  // 3) FileTxt - to local text file
  // 4) Syslog - to system log server
  // 5) Console - to console
  // 6) Auto - try send to Baical server if available, otherwise to file
  // 7) Null - drop all incoming data
  "sink": "FileBin",
  "verbosity": 1 // Verbosity level: 0 - Trace, 1 - Debug, 2 - Warnings, 3 - Errors, 4 - Critical
}