Skip to content

Settings

Đặng Đoàn Đức Trung edited this page Aug 12, 2020 · 12 revisions

Important: You can find your key-codes here. If you can't find what you are looking for (for example, mouse left or mouse right), or the key-code provided by the website doesn't trigger correctly, refer to this guide instead (remember that the numbers from this site are in hexadecimal, so you need to convert to base 10 to use with this program).

Important: If you want to add custom mode, please refer to this page.

Tips: Ctrl + R will reread and reload the config and sprites for the current bongo.exe process.

The following settings are the default one. You can change whichever configurations you want to in the config.json file within the same folder as the bongo.exe file. For example:

{
    "mode": 2,
    "decoration": {
        "rgb": [0, 0, 255]
    }
}

will change the current playing mode to osu!taiko, set the background to dark blue, while maintaining every other default configurations. Note that, if config.json is not found in the folder, the default settings are used.

{
    "mode": 1,
    "resolution": {
        "letterboxing": false,
        "width": 1920,
        "height": 1080,
        "horizontalPosition": 0,
        "verticalPosition": 0
    },
    "decoration": {
        "leftHanded": false,
        "rgb": [255, 255, 255],
        "offsetX": [0, 11],
        "offsetY": [0, -65],
        "scalar": [1.0, 1.0]
    },
    "osu": {
        "mouse": true,
        "paw": [255, 255, 255],
        "pawEdge": [0, 0, 0],
        "key1": [90],
        "key2": [88],
        "smoke": [67],
        "wave": [],
        "toggleSmoke": true
    },
    "taiko": {
        "leftCentre": [88],
        "rightCentre": [67],
        "leftRim": [90],
        "rightRim": [86]
    },
    "catch": {
        "left": [37],
        "right": [39],
        "dash": [16]
    },
    "mania": {
        "4K": true,
        "key4K": [68, 70, 74, 75],
        "key7K": [83, 68, 70, 32, 74, 75, 76]
    }
}

General

mode: Current playing mode: 1 for osu!, 2 for osu!taiko, 3 for osu!catch, 4 for osu!mania, 5 for the custom mode.

Resolution

  • letterboxing: Whether osu! is using letterboxing or not.
  • width: osu! width resolution. (I highly recommend changing this one into your desired value)
  • height: osu! height resolution. (Also highly recommended to be changed)
  • horizontalPosition: osu! horizontal position. Leave this at 0 if you're not using letterboxing.
  • verticalPosition: osu! vertical position. Leave this at 0 if you're not using letterboxing.

Decoration

  • leftHanded: Whether you are left-handed or not. If set to true then flip the scene horizontally in OBS.
  • rgb: An array containing three values (red, green, blue respectively) describing the desired background's RGB values.
  • offsetX, offsetY, scalar: Parameters to calibrate the device's position and scaling. The first number in each list is for calibrating the mouse (i.e. mouse.png), while the second is for calibrating the tablet (i.e. tablet.png).

Note: scalar is a floating-point variable, meaning you must use a decimal point. For example, if you want to set your scalar value to 2, you must put 2.0.

osu! mode

  • mouse: Whether you are using a mouse.
  • paw: An array containing three color parameters (red, green, and blue respectively) for modifying the interior color of the pointing device paw.
  • pawEdge: An array containing three color parameters (red, green, and blue respectively) for modifying the edge color of the pointing device paw.
  • key1, key2: arrays containing virtual key-codes of your Key 1 and Key 2 accordingly. For example, if key1 contains 90 and 65 corresponding to Z and A key (i.e. "key1": [90, 65]), then each of these keys will trigger the left-key-press animation.
  • smoke: arrays containing virtual key-codes of your smoke key.
  • wave: arrays containing virtual key-codes of the waving bindings.
  • toggleSmoke: Whether you want smoke key to be push or toggle.

Warning: key1 and key2 and wave must not contain similar values. If you are having trouble with duplicate keybinds, try adding "wave": [].

osu!taiko mode

  • leftCentre: an array containing virtual key-codes of your left centre key.
  • rightCentre: an array containing virtual key-codes of your right centre key.
  • leftRim: an array containing virtual key-codes of your left rim key.
  • rightRim: an array containing virtual key-codes of your right rim key.

Warning: leftCentre and leftRim must not contain similar values; rightCentre and rightRim must not contain similar values.

osu!catch mode

  • left: an array containing virtual key-codes of your left key.
  • right: an array containing virtual key-codes of your right key.
  • dash: an array containing virtual key-codes of your dash key.

Warning: left and right must not contain similar values.

osu!mania mode

Currently, only osu!mania 4K and 7K are supported.

  • 4K: Whether you are playing 4K mode (then set this to false), or 7K mode (set this to true).
  • key4K: an array containing 4 virtual key-codes of your 4K mania bindings.
  • key7K: an array containing 7 virtual key-codes of your 7K mania bindings.

Custom mode

Clone this wiki locally