Skip to content

Home

Jump to bottom
sannier3 edited this page Jul 26, 2022 · 35 revisions

BeatSaberPlus (BS+) | French version

Discord https://discord.gg/63ebPMC (Download, Support, Testing, Early releases and cool new mods coming soon)

Patreon https://www.patreon.com/BeatSaberPlus if you want to support this project development!

Current version : 4.6.1

IMPORTANT All modules are disabled by default, you can enable then in BeatSaberPlus -> Settings
IMPORTANT When you enable Chat module, it will open a page in your browser for configuring it
IMPORTANT When you enable Multiplayer+ module, you can setup then in BeatSaberPlus -> Multiplayer+. To use the Multiplayer+ mod, don't use the Online button but use the Multiplayer+ button on the left panel !

1 - Features

  • Chat: (Documentation)
    • Display in game your twitch chat (FFZ & BTTV support).
    • Emotes cache system to save bandwidth on game start!
    • See subscriptions, follow, raid, bits events, channel point reward reedeming and Hype Trains !
    • See predictions and pools too
    • See next to chat if you are online or not and the actual viewer count.
    • Hide/show messages started with "!"
    • Lot of customization options (Color, Size, Filter TTS messages, hide specific events...).
  • ChatEmoteRain: (Documentation)
    • See emotes used in chat raining in game!
    • Support GIF / APNG / PNG files.
    • Support animated emotes from BTTV.
    • Custom emote rain when someone subscribe to your Twitch channel.
    • Advanced configuration options.
  • ChatRequest: (Documentation)
    • New chat request system that allow your viewers to make requests with https://beatsaver.com/ website like "!bsr key".
    • Display information about all difficulties for a song including NPS/Offset.
    • Display song description, votes, upload date when you select a song.
    • Buttons to send information about current selected song to your chat or open it in beatsaver.com.
    • History & blacklist tab that let you see your request history and manage your blacklist.
    • An intelligent "!link" command that show current played song or last one and provide a link to beatsaver.com if the map is public, the command also works outside of request and in multiplayer!
  • ChatIntegration: (Documentation)
    • Make some differents actions with events
    • Events can use -> Chat events / Level status / VoiceAttackCommands(plugin install requied)
    • Conditions -> Chat Request / Event enabled ? / Playing map ? / Cooldown / OBS Status
    • Actions -> Camera2 / Chat / EmoteRain / Event / GamePlay / Misc(waiting events) / NoteTweaker(profile changing) / OBS interact / SongChartVisualizer / Twitch
    • Inputs with the physical keyboard are available to change commands or channel point informations
  • GameTweaker: (Documentation)
    • Can remove note debris even with the Liv capture.
    • Can remove cut particles, obstacles particles, floor burn particles, floor burn effects, saber clash particles, world particles.
    • Can remove BTS/LinkinPark assets in a play environment, FullCombo loss animation, Editor button on the main menu, Promotional content from the menu.
    • Can remove fake 360 like levels in standard ones.
    • Can re-order player options menu for better accessibility.
    • Add an override light intensity option that let you boost/dim lights from 0% to 2000% (also work in static lights).
    • Can automatically clean all old logs entry from your game folder to keep it clean.
    • Can add keyboard bindings to pause/continue/restart/exit a song in FPFC mode.
  • MenuMusic: (Documentation)
    • Replace menu ambient sounds with music!
    • Play any songs from your custom levels or you own selection of music!
    • Player interface shows in the menu on left with Prev/Random/Play/Pause/Next buttons and with a volume selector.
    • Supports EGG/OGG files.
  • Multiplayer+: (Documentation) We are making a separate Multiplayer for Beat Saber. It can have some functionalities for players and streamers. This part of BS+ is under development, but players can now test and play it now. Stability and performance improvements have been seen for a better experience !
    • Functionalities work for Quick Play, Server creation, Joining code and room finding with basic search
    • In the rooms, you can change room code, hide and show the code, play up to 20 peoples (30 with one patreon present)
    • With your multiplayer+ setup, you can give permission to Moderator, Vip or user to show the code in chat with "!room" command
    • Custom Songs with BeatSaver support
    • ScoreSaber and BeatLeader support
    • Noodle & Chroma & 360/90 maps support
    • In game avatars & movement sync (Require a Patreon in the lobby)
  • NoteTeaker: (Documentation)
    • Profiles can be created and ChatIntegrations can switch it with your events
    • Changing any parts of notes like dots(with sliders or not), arrow, arcs, note or bomb scale
    • A preview of your changes is on the right panel
    • Hide/show dot on directional notes support
  • SongChartVisualizer: (Documentation)
    • Preview map difficulty with a nice and beautiful graph in game that illustrate NPS (Notes per second).
    • Support for 90 & 360 levels.
    • Lot of customization options (Colors, Legend, Dash lines...).

2 - How to Install

Before install the BeatSaberPlus mod, you must have the cores and libs dependencies listed at the bottom of this part. You can install dependencies with ModAssistant

  1. Join my Discord server by this link and go to the bsplus-releases channel to download the latest version of BeatSaberPlus !

Note : The file is a zip file and contain some files. It contain differents optionals modules but the modules depends BeatSaberPlus.dll file. Hot Fixes can be published in this channel. See the module usefulness and features on top

  1. Extract all files or most files you need in BeatSaber/Plugin folder

  2. Open Beat Saber and see the left panel that contain BeatSaberPlus mod. Click on them and you can see most of your modules disabled by default. Go to setting and enable your modules.

  3. If you are

Modules enabled by default

  • Chat
  • Chat Emote Rain
  • Chat Integration Actions
  • Chat Request
  • Multiplayer+
  • Song Overlay

Modules disabled by default

  • Chat Integration
  • Game Tweaker
  • Menu Music
  • Note Tweaker
  • Song Chart Visualizer

Dependences
- SongCore https://github.com/Kylemc1413/SongCore
- BeatSaberMarkupLanguage https://github.com/monkeymanboy/BeatSaberMarkupLanguage
Licenses

BSML

MIT License

Copyright (c) 2019 David L

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

ChatCore

MIT License

Copyright (c) 2020 Brian Weber

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

EnhancedStreamChat

MIT License

Copyright (c) 2020 brian91292

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Mirror

MIT License

Copyright (c) 2015, Unity Technologies Copyright (c) 2019, vis2k, Paul and Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Websocket-Sharp

MIT License

Copyright (c) 2020 Brian Weber

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

3 - Modules

Chat

See all events in the Twitch Chat like channel points, bits and more !

English Français

Chat Emote Rain

Create an emote rain in your game and customize it

English Français

Chat Request

The Chat Request module enables viewers to request maps to the streamer in their Twitch chat. When a request is carried out, it is added to the request queue. The streamer only has to open the waiting queue and click on the song to download it and play the map.

English Français

Chat Integrations

This plugin contain most events and actions for streamers. Viewers can do some interacts with you in chat and doing actions ingame

English Français

Game Tweaker

This module allow you to customize your game experience, customize and remove some base game features

English Français

Multiplayer Plus

Under development. A magic mod is coming

English Français

Menu Music

This module enables you to replace ambient noise with music from your custom songs or CustomMenuSongs folder.

English Français

Note Tweaker

This module enables you to do changes about any parts of notes(arrow, dots, bombs,...)

English Français

Song Chart Visualizer

This module make a little graph for you to see the map difficulty in time when you playing songs

English Français

Clone this wiki locally