Beat Saber 0.12 Alpha Build!

MORE IMPORTANT

ChromaToggle has been revamped into the Chroma Suite, which is currently available on the discord, and is pending release on ModSaber

IMPORTANT

I am labeling this as an "alpha" build, as there are still some issues with it. There shouldn't be any major gamebreaking issues (assuming you set it up properly), but there are still features that don't work (such as head sabers and saber spinners).

However, 95% of the plugin is functioning as intended, and has proven to be stable enough to play. It is, however, very important that you follow the installation instructions.

The gamemode and technicolour panels are now located under "Player Settings" in the panel to the left of the song list. All other options are found in the main menu settings.

ChromaToggle for Beat Saber 0.12.2

It's finally here! I know you've missed me. I've missed you too. As colourless as your virtual world has been without me, my real world has been without you. But it's okay, I'm back now, and I've never stopped loving you...

Major Changes

• Updated to Beat Saber 0.12.2
• Rewrote a large portion of the custom note mechanics
  • Notes not only can have special colour mechanics now, but also special cut mechanics
  • These are stackable, so notes can have special colours AND special cuts
• Rewrote a large portion of the saber mechanics
  • This doesn't actually add any new features
    • In fact, it has less features (doesn't work on head or spinners)
      • But it had to be done for ChromaToggle to work at all...
• Nightmare gamemode overhauled
  • Not much different from the user end of things, but very different on the back end, which also makes a difference in custom gamemodes using Nightmare.
  • Nightmare now features bi-directional blocks and duochrome blocks

Additions

• A new block colour!
  • Duochrome (currently purple as a stand-in colour) requires being hit by two sabers.
    • It doesn't matter what colour these sabers are, you need to hit it with TWO OF THEM.
    • Except for Super Sabers, which still get good cuts no matter what
    • These can be mapped by stacking a right slash bomb on a note
• Two new block mechanics!
  • Bi-directional Notes
    • These blocks can be cut in either arrow direction!
    • Effectively a half-way point between dot notes and arrow notes.
    • These can be mapped by stacking a left slash bomb on a note
  • Deflect Notes
    • Oval sprite is temporary
    • These notes require you to "block" them, not cut them
      • Place the flat of your blade in front of them, matching the direction of the oval.
    • These can be mapped by stacking an up-right slash bomb on a note
• The CT Settings menu now has an option to hide all other CT menus
• Custom Gamemode Options
  • AltColourIntermediaryGreys
    • Used in Controlled randomization style for alternate colours
    • Adds in x grey notes between colour changes
  • RandomBidirectionalChance
    • Applies Bidirectional cut to arrow notes with x chance
  • RandomDeflectChance
    • Applies Deflect cut to arrow notes with x chance
  • RandomDuochromeBlocksChance
    • Applies Duochrome colour to arrow notes with x chance
  • RandomDuochromeBlocksAvoidDoubles
    • Prevents RandomDuochromeBlocksChance from affecting double hits

Changes

• Pentamaul
  • No longer has randomly placed grey notes
  • Grey notes are now inserted between colour changes (eg blue to green)
  • This is experimental, give me feedback!
• All official and custom gamemode leaderboards disabled
  • Only normal game leaderboards exist, for now.

Bug Fixes

• Too many to list! Check the #changelogs channel in the discord if you're interested in this!

READ THE {{{ IMPORTANT }}} SECTION AT THE TOP BEFORE USING THIS VERSION

ChromaLite

Public pre-release of ChromaLite! A brand new offshoot for 0.12!

ChromaLite is effectively the custom lighting (to include RGB events) taken straight out of ChromaToggle. RGB Lighting and Special Map Events are all it does - this does not contain any of ChromaToggle's gamemode features.

Enjoy that sweet sweet colourful goodness!

If you're interested in mapping RGB, MediocreMapper is recommended. You can find a link to it in this guide for ChromaToggle mapping events

On a side note, ChromaToggle for 0.12 is ~80% completed. A CBT version will be released very soon.

Stuff!

• Particles

  • Added particle options
  • Particle colour now matches specialized block colour

• Time Control Improvements

  • Influences lighting, debris, and particles
  • Time Fluctuation special custom gamemode feature

• Nuke Improvement

  • Audio ducking effect, proper sound file, much more badass

• Technicolour

  • Added stronger Technicolour customization

• Insanity Mode

  • Added and customizeable. Requires safety agreement.

• Head Sabers

  • They finally exist!
  • Unicorn mode is now a real thing.
  • Requires safety agreement.

• Saber Spinners

  • You can now make Fidget Saber Spinners
  • Full X/Y/Z rotation-per-second customization

• Fixed gamebreaking issue with removing or otherwise disabling a gamemode that was the last one selected

• Safety Warning Update

  • You'll need to re-read and agree to the safety warning

Hotfix

Adds barrier colour options, and fixes AltA and AltB colours matching (whoops)

Read the 0.6.8 release below

The Customization Sensation!

IMPORTANT: Delete your ChromaToggle settings in UserPrefs.ini! WE HAVE A UI THAT HANDLES THAT NOW!

Greetings from those of us at ChromaToggle™!

Today we bring you something special - a complete overhaul of the ChromaToggle engine!

The bad news? You have no idea how to use it anymore.
The good news? Using it is a lot more powerul now!

We offer you an in-game settings menu, MORE colour customization, the ability to create custom gamemodes, the ability to create custom colours to choose from, and more!

The changes in this version are massive. See the changelog channel in the discord for the changes between this and the last public build.

Additionally, those of you who have been ignoring the readme, sorry guys you're gonna need it now. The good news is, the readme is a lot better now. Though the readme could still be improved, you should read the readme so I don't have to tell you to read the readme when you get confused about things that are in the readme.

Release the RGB!

Welcome to a world of colour!

Remember to READ THE README if you want to know what things do!

Here at ChromaToggle® we value your eye-cone-thingies.
A recent trend of duochromitis has plagued the VR community these last few months, and we've decided to balance the playing field.

ChromaToggle® can bring you up from your sad, rainbowless life into a world of Pentachrome™ magic. If that's not enough for you, we even offer a cacophony of Technicolour© lightwaves!

Or, if you're the sort to prefer hand crafted perfection (hence Beat Saber), mappers can place lights of all the above types. But that's not all, ChromaToggle®™© even offers *full RGB control of lightmaps! Give Liquid's example map, Chromakey Lightshow a play and see how much more colourful your world can be!
(Play on Easy difficulty for just a lightshow, Expert for Pentachrome Toggle mode)

And of course, all the colours in the game can be customized!

Finally, if you're more averse to colours, we bring you Nightmare Mode for halloween! It's a dark cold world out there, and it wants to kill you, so maybe you should stay in here, where it's colourful...

Additions

UI, At Last!

• The GameOptions panel (same panel as no fail) now has some ChromaToggle options
• Scroll buttons above and below the options
• Currently only handles a couple important values
  • And some lolzy light values
  • More will be added to this soon

Light Magic!

• Maps can support not only custom blocks, but custom lights!
  • Custom lighting events rewire the red/blue (A/B) lights to different sets of colours
  • Custom lighting events do not "replace" base game lighting, meaning maps made with ChromaToggle lights will still play normally without ChromaToggle installed
  • List of custom light types added:
    • Default Lights
      • Restores lights to A/B colours
    • Alternate Lights
      • Set lights to AltA/AltB colours
    • White Lights
      • Set lights to White/HalfWhite
    • Technicolour Lights
      • Set lights to random values from Warm/Cold (A/B) technicolour palettes
    • Random Lights
      • Set lights to literally random colour values (similar to Rainbow Mod)
    • RGB Lights
      • Grants the mapper full control of the light colours, setting both lights to their desired colour!
      • Has over 16 million possible colours/shades to choose from!

Colour Customization

• Light colours can now be set independently of the block/saber colours.
• Ambient lights are now customizeable too
• Laser Pointer colour can be dictated separately from saber colours
• Technicolour now has a cold and warm palette (A/B)
  • This allows you to use Technicolour in two colour modes while still being possible to identify blocks properly.

Breaking Reality [REQUIRES READ SAFETY WARNING]

• NOT recommended
  • Seriously, don't do it.
    • It's not fun.
      • Fine, to break reality, while in the main menu hold the comma key while reloading the settings (backslash)
        • This will add an option to the menu (but you have to play and exit a song for it to do so)
• Remember this isn't actually a REAL feature, it was literally just a bug I decided to leave in.

Log File

• Requires debug mode enabled
• This will help with quashing bugs

Nightmare Mode [REQUIRES READ SAFETY WARNING]

• Not a finalized version
  • I just wanted something in place for Halloween
• Good Luck.
  • Hard difficulty is now Expert+++

Changes

• Adjusting saber colours now affects the pause and main menu sabers handles
• Default lightning now respects the base game properly
  • Custom Colours doesn't even do this!
• Sound files are no longer packaged inside the DLL. You can disable a sound by removing it.

Bug Fixes (The ones I remember anyway)

• Fixed issue with saber trail colours not matching customized saber colours
• Fixed issue with base game leaderboards while PartyOnly is enabled
• Fixed critical issue with tailored maps not loading correctly
• Fixed issue with loading settings when pressing play button.
  • This was fixed by removing it.
• Fixed mirror mode with Forced Single Saber (it's actually playable now)
• Fixed custom coloured note debris not matching

TINY NOTES TIME

IMPORTANT: The colour config uses 0-255 instead of 0-1 now, so you will have to reconfigure (or delete to reset) your colour settings, if you are updating from an older version.

Autoselection!

Gamemode 6 is nearing completion! Give it a good test for me!

Additionally, ChromaToggle built maps will now automagically select the correct gamemode for you. Additionally, party mode is no longer required!

Oculus is here!

WE HAVE OCULUS SUPPORT!

The config should understand whether you're oculus or vive and set it up by default for you, but if it doesn't, change the "isOculus" setting to fit your need.

This version also fixes an issue with ChromaToggle map reading.

IMPORTANT: If you are updating from an earlier version, your colour settings are going to break. There are two solutions to this:
A. Delete your colour settings so they are regenerated.
B. Change your colour settings so the four numbers are separate by semicolons ( ; ) instead of commas ( , )

Multicolour for everyone!

Also features an improvement to the custom haptics system. Still not perfect, but improved.