JDFixer

Was once based on Kylemc1413's NjsFixer but has grown to much more.

I wanted a stripped down mod that focused only on JD modification to fix floaty maps without NJS/BPM modification since I don't use those features. I felt there was a gap between Njsfixer and Leveltweaks that isn't filled for JD-focused players and this is my interpretation for meeting those needs.

Supports CustomCampaigns, Tournament Assistant, all flavors of Multiplayer, OST / DLC / Base Campaign. Score posting is unaffected. For Beat Saber 1.17.1+.

New Features

Selected map's original JD and RT is displayed. You can easily decide if you want to use JDFixer without having to play the map to feel it. Saves time.
Selected map's lowest JD and RT allowed by the game is displayed. When it seems like JDFixer "isn't working", check if you exceeded these values shown in grey.
Automated JD and RT fixing. Preferences has been changed to selecting the NJS-JD (or RT) pair that is equal or lower to the selected map's NJS. This allows you to cover large ranges without having to add many values and also handles the rare non-integer NJS. For RT Preferences: Automatically sets a map's JD to give your preferred reaction time for a given NJS. Ability to fix constant JD or RT across all maps (no need to worry about slider getting moved).
Heuristic to bypass Preferences where if the selected map by default runs closer than the JD in the matching NJS-JD pair, the map will run at its original JD (and likewise for RT).
Upper and Lower NJS Thresholds where Preferences will be bypassed. If a map's NJS is at or exceeds thresholds, the map will run at its original JD and RT.
Multiple UIs and Options with choice of linked or single sliders for JD and RT. New purpose-built UI for Tournaments.
Mod Settings menu to easily configure UI options and Thresholds.
Snap JD and RT to fractions of a beat. Run map at JDs and RTs that line up with multiples of a desired beat fraction.
Choose whether song speed affects JD or RT settings and Automated Preferences. Choice of keeping JD settings regardless of song speed, auto-compensating RT based on song speed, or both! Applies to Practice mode and modifiers in Solo / MP / Party.

How To Use

Place JDFixer.dll in Plugins folder
Select a map or difficulty to see its original JD and RT
Set up Automated Preferences to select JD or RT based on map's NJS with in-game menu (If you require finer decimal values for NJS, JD and RT, you can edit the preferences in /UserData/JDFixer.json)
To access the RT Preferences menu, set Automated Preferences to ReactionTime and click Configure RT Preferences
Setting Automated Preferences to JumpDistance or ReactionTime will override the JD and RT sliders
If you enable Bypass Preferences if map is closer, you must set base game settings to Dynamic Default
You can configure Bypass Preferences if NJS is equal to, less, or greater than Lower and Upper Thresholds in Mod Settings (or /UserData/JDFixer.json in ≤v5.x.x)
To enable Snap JD and RT to beat fraction, go to Mod Settings and toggle on Separate JD and RT sliders and set the fraction's denominator (eg. 1/3rd, 1/4th, 1/64th etc) using the slider
To configure song speed behavior, go to Mod Settings and choose one of the options. See below for a detailed explanation of how each option behaves.
Hover over menu in-game for additional explanations
v7.0.0 for BS 1.26.0+ requires BSIPA, BSML, and SiraUtil
Not compatible with NjsFixer and LevelTweaks. Using with these mods may result in conflicts and unexpected behavior.

UI Customization

Linked JD and RT sliders: The JD or RT slider will remember its last value when you click between maps. Scroll to the bottom of JDFixer's tab to swap. This is the default UI (v3.1.0+)
One slider for JD or RT, and a display value for other: Go to Mod Settings and toggle on Unlink JD and RT sliders (for ≤v5.x.x, change legacy_ui_enabled in /UserData/JDFixer.json to "true"). Scroll to the bottom of the JDFixer's tab to swap between JD and RT
Show (or hide) the default and minimum Reaction Times for maps: Go to Mod Settings and toggle on/off Show map Reaction Times (for ≤v5.x.x, change rt_display_enabled in /UserData/JDFixer.json to "false")
TA and MP dedicated UI: Choose to set your map by JD or RT. You can only set one at a time (v4.0.0+)
Min and max ranges for JD and RT sliders can be changed in /UserData/JDFixer.json

Above Left: Show map Reaction Times is ON. Above Right is OFF.

Understanding Preferences Behavior

Suppose your Jump Distance Preferences contain these NJS-JD pairs: 22-18, 21-16, 18-15.

Example 1: Your selected map's NJS is 22 and JD is 20. The map will run at 18 JD because there is an exact match for 22 NJS

Example 2: Your selected map's NJS is 21.5 and JD is 20. The map will run at 16 JD because 21 NJS is the closest lower match.

Example 3: Your selected map's NJS is 21.5 and JD is 14 and Bypass Preferences if map is closer is toggled ON. The map will run at its original 14 JD because it is lower than your matching preference (21-16).

Example 4: Your selected map's NJS is 23 and JD is 20 and your Upper Threshold is set to 23 NJS. The map will run at its original 20 JD because it triggered the threhold.

Example 5: To run every map at a constant JD regardless of its NJS, create a single preference with 0 NJS and your desired JD (e.g. 0 NJS - 18 JD)

If Automated Preferences is set to JumpDistance but no Preferences are set, the map will run at JD and RT slider value
If you enable the Bypass Preferences if map is closer heuristic, you must set base game settings to Dynamic Default. Failing to do so give you inconsistent results.
Heuristic and Thresholds override Preferences only
If you need decimal values for Preferences, you can manually edit them in JDFixer.json.

Reaction Time Preferences: This works exactly the same as JD Preferences. The five examples above apply, except in Reaction Time. Reaction Time is a function of the map's original NJS and Jump Distance. This means that RT Preferences automatically sets the map's JD to give your preferred RT for its given NJS.

Understanding Snapping to Beat Fractions

To use this feature, toggle on Separate JD and RT sliders, Snap JD and RT to fractions of a beat and set the Beat Fraction (1/n) in Mod Settings. Enabling Automated Preferences overrides the snapped value. The snap display consists of four values (A, B) JD RT.

Given the current JD or RT slider value:

A: This is how many fractions of a beat relative to the map's default offset that the map will run at.
B: This is the equivalent absolute offset that the will map run at.
JD: This is the equivalent JD that the map will snap to and run at.
RT: This is the equivalent RT that the map will snap to and run at.

Understanding Song Speed Options

By base game behavior, maps maintain their JD when played at different song speeds (e.g. when playing with Modifiers or 200% on Practice Mode). This is so logically, higher song speed settings make maps "play faster" and increases the difficulty by lowering the player's reaction time.

JDFixer can change this. Choose one of the options:

JD_Settings: If you prefer the base game behavior or you prefer to always have a known JD (meaning you want to play at the JD you set, at any song speed). This behaves the same as JDFixer v6.0.0 and below and is the default option.
RT_Settings: If you prefer to always have a known reaction time (and would prefer the JD to be auto-adjusted depending on the song speed to give the RT you set). This means when the map is run at a higher song speed, the JD will be pushed back to give the same RT as if the map is being played at normal speed. Likewise, playing the map at lower song speed will bring the JD closer.
JD_RT_Respectively: If you prefer to have both of options, depending on whether you are using the JD or RT sliders and Automated Preferencences. This means when the JD slider is active or JD Automated Preferences is enabled, it will behave like the JD_Settings option, and when the RT slider is active or RT Automated Preferences is enabled, it will behave like the RT_Settings option.

Tournaments and MP

Tournament Assistant: Supports Default, Dual Sync and AutoPause matches. You can only use one of the sliders at a time. As usual, enabling Preferences override both sliders. Avoid opening the Preferences menu in TA! You will be stuck in it until you relaunch the game or the coordinator lets you out (this is by design in TA). However if you do choose to get yourself stuck inside just before a match, your match will still play fine when the coordinator starts it (but I hope you've set your Preferences correctly or left the slider in a sane spot lol).
Multiplayer: Shares the UI with TA. As usual, you can only use one of the sliders at a time and enabling Preferences override both sliders. It is safe to open the Preferences menu here lol.
CustomCampaigns: Comes with display for map's default JD and RT (v3.1.0+)
OST, DLC Levels and Base Campaign are fully supported.

Versions

v7.1.1 for BS 1.31.0+ only
v7.0.0 to v7.1.0 for BS 1.26.0+
v6.0.0 for BS 1.26.0+
v5.x.x for BS 1.20.0+ only
4.0.0 for BS 1.19.0 / 1.19.1
v3.x.x for BS 1.19.0 / 1.19.1 requires SiraUtil 3.0.0+ (Do not use 3.x.x versions for TA or MP)
≤v2.1.6 for BS ≤1.18.3 requires BS_Utils
v2.1.3+ will import your settings file
v2.1.0 is not compatible with settings files from previous versions: Delete or rename your old JDFixer.json and allow the mod to generate a new one. Re-enter your settings in-game. If you are knowledgeable, you can copy the relevant data from the old json file to the new one. Just make sure you do it correctly.

About

This is my first time writing a mod. I made it for my own needs but friends thought it useful so I think it would be beneficial to share it. I hope others find this useful.

Donate and Support

❤️ Love JDFixer and want to show your support? Donate on Patreon or buy a me a ☕ and get your name featured in the Supporters panel in-game!❤️

TYs

Thanks @Shurdoof for autoupdate! Thanks Kyle for the original NjsFixer and thanks to the cool peeps in BSMG for the help and advice when I first started out :)

denpadokei/JDFixer