Settings - Aeroluna/Heck GitHub Wiki

Although all settings are included for posterity's sake, it is HIGHLY recommended to only list settings you NEED i.e. 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!

If the appropriate mod for which your setting comes from is not installed, Heck will skip over your setting.

Settable 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
              }
            }
          }
        }
      ]
    }
  ]
}

Heck

These settings are implemented by Heck 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) -> "FullHeightOnly" 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.
  • "_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+

Basic settings (see full list below):

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

Full property list with things like HUD offsets, size, colours, etc:
Counters+ Wiki

UITweaks

All available settings:

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

UITweaks Wiki

NoteTweaks

Common settings:

  • "_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)

NOTE: 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.

Significantly more settings and all default values:
NoteTweaks Wiki