Settings Setter

Annoyed by that one streamer who always play with static lights? Recommend they play your map with the correct settings using Settings Setter™!

Additionally, other mod developers can add compatibility to have their mod integrate with settings setter as well. If the appropriate mod for which your setting comes from is not installed, Heck will skip over your setting.

Warning

Although all settings are included for posterity's sake, it is HIGHLY recommended to only list settings you NEED, e.g. your map uses a lot of text and left handed mode needs to be disabled to not mirror your text. Keep it to the bare minimum!

Adding recommended settings

• "_customData" -> "_settings"
  • category: The category your setting belongs to. See below for category names.
    • setting name: The name of your setting. See below for setting names.

Custom data for settable settings is set in the info.dat.

Example

{
  "_version": "2.0.0",
  "_songName": "NULCTRL MEISO FLIP",
  ...
  "_difficultyBeatmapSets": [
    {
      "_beatmapCharacteristicName": "Standard",
      "_difficultyBeatmaps": [
        {
          "_difficulty": "ExpertPlus",
          "_difficultyRank": 9,
          "_beatmapFilename": "ExpertPlusStandard.dat",
          "_noteJumpMovementSpeed": 19,
          "_customData": {
            "_settings": {
              "_playerOptions":{
                "_leftHanded": true,
                "_hideNoteSpawnEffect": false
              },
              "_graphics": {
                "_mirrorGraphicsSettings": 0
              },
              "_chroma": {
                "_disableEnvironmentEnhancements": true
              }
            }
          }
        }
      ]
    }
  ]
}

Categories

Vanilla

These settings are implemented by default.

• "_playerOptions"
  • "_leftHanded": bool
  • "_playerHeight": float
  • "_automaticPlayerHeight": bool
  • "_sfxVolume": float
  • "_reduceDebris": bool
  • "_noTextsAndHuds": bool
  • "_noFailEffects": bool Hidden setting: This will hide "Miss" text.
  • "_advancedHud": bool
  • "_autoRestart": bool
  • "_saberTrailIntensity": float
  • "_noteJumpDurationTypeSettings": "Dynamic"/"Static"
  • "_noteJumpFixedDuration": float Only available w/ "Static"
  • "_noteJumpStartBeatOffset": float Only available w/ "Dynamic",
    • Close: -0.5
    • Closer: -0.25
    • Default: 0
    • Further: 0.25
    • Far: 0.5
  • "_hideNoteSpawnEffect": bool
  • "_adaptiveSfx": bool
  • "_environmentEffectsFilterDefaultPreset": "AllEffects"/"StrobeFilter"/"NoEffects"
  • "_environmentEffectsFilterExpertPlusPreset": "AllEffects"/"StrobeFilter"/"NoEffects"
• "_modifiers"
  • "_energyType": Bar, Battery
  • "_noFailOn0Energy": bool
  • "_instaFail": bool
  • "_failOnSaberClash": bool Hidden setting: Instantly fails player when sabers clash.
  • "_enabledObstacleType": "All"/"FullHeightOnly"/"NoObstacles" The "FullHeightOnly" option is a hidden setting and disables crouch walls.
  • "_fastNotes": bool Hidden setting: Forces NJS to 20.
  • "_strictAngles": bool
  • "_disappearingArrows": bool
  • "_ghostNotes": bool
  • "_noBombs": bool
  • "_songSpeed": "Normal"/"Faster"/"Slower"/"SuperFast"
  • "_noArrows": bool
  • "_proMode": bool
  • "_zenMode": bool
  • "_smallCubes": bool
• "_environments"
  • "_overrideEnvironments": bool Enable or disable user environment. If you are using chroma environment enhancement, this setting is redundant.
• "_colors"
  • "_overrideDefaultColors": bool Enable or disable user color scheme.
• "_graphics"
  • "_mirrorGraphicsSettings": int (0 - 3) Off/Low (0/1) will not create cameras. "Low" duplicates base game notes to create a "fake" mirror.
  • "_mainEffectGraphicsSettings": int (0 - 1) "Bloom Post Process" Disabling will switch to baked/fake "Quest style" bloom
  • "_smokeGraphicsSettings": int (0 - 1) Also enables depth texture/"Soft Particles" when used.
  • "_burnMarkTrailsEnabled": bool Hidden setting: Hides burn trails left by sabers.
  • "_screenDisplacementEffectsEnabled": bool
  • "_maxShockwaveParticles": int (0 - 2)

Chroma

• "_chroma"
  • "_disableChromaEvents": bool
  • "_disableEnvironmentEnhancements": bool
  • "_disableNoteColoring": bool
  • "_forceZenModeWalls": bool

Other Mods

There are a handful of other mods with support for Settings Setter as well. Main properties for these will be provided here, and the full list of available settings will be linked alongside if required.

Counters+

Full property list with things like HUD offsets, size, colors, etc can be found on the Counters+ Wiki.

• "_countersPlus"
  • "_mainEnabled": bool
  • "_mainParentedToBaseGameHUD": bool
  • "_missedEnabled": bool
  • "_progressEnabled": bool
  • "_scoreEnabled": bool
  • "_personalBestEnabled": bool
  • "_speedEnabled": bool
  • "_cutEnabled": bool
  • "_spinometerEnabled": bool
  • "_notesLeftEnabled": bool
  • "_failEnabled": bool

UITweaks

UITweaks Wiki

• "_uiTweaks"
  • "_multiplierEnabled": bool
  • "_energyEnabled": bool
  • "_comboEnabled": bool
  • "_positionEnabled": bool
  • "_progressEnabled": bool

NoteTweaks

Significantly more settings and all default values can be found at the NoteTweaks Wiki.

• "_noteTweaks"
  • "_enabled": bool
  • "_enableBombOutlines": bool
  • "_enableNoteOutlines": bool
  • "_enableAccDot": bool
  • "_enableDots": bool
  • "_enableChainDots": bool
  • "_fixDotsIfNoodle": bool
  • "_enableFog": bool
  • "_enableHeightFog": bool
  • "_noteScaleX": float
  • "_noteScaleY": float
  • "_noteScaleZ": float
  • "_arrowScaleX": float
  • "_arrowScaleY": float
  • "_dotScaleX": float
  • "_dotScaleY": float
  • "_linkScale": float
  • "_bombScale": float

Tip

Noodle will override any scaling options set by NoteTweaks or BS+. If you don't want any random "big note jumpscares", it's a good idea to assign all notes a scale value of [1,1,1] using Noodle directly.