NalulunaModAssistant
🕑 Added 2022-11-12 18:44:43 +0000 UTCBeat Saber versions currently supported:
1.29.1, 1.34.2, 1.37.1
1.39.1 (Mostly supported. Work in progress.)
1.40.6 (Partially supported. Work in progress.)
I will support latest version, but since there are so many, I'll start with the ones that seem to have the most users.
1.29.1, 1.34.2, 1.37.1 can be selected in the Store feature. I will support latest version, but since there are so many, I'll start with the ones that seem to have the most users.


----
This is a management tool for my mods, allowing you to install and uninstall mods and check for updates. Installation of the private mods requires login with your supporter Fanbox or Patreon account.
If there are any problems, please read the following and contact me with all the necessary information.
https://www.patreon.com/posts/95917478
* There was a problem with false virus detection in early versions, but there seems to be no problem so far in the newer versions. Don't worry, there is no actual virus in the software. I also check for viruses when uploading.
Requirements
The following runtimes are required. If NalulunaModAssistant does not start, please download and install them from the links below.
- Windows 10 (64bit) / Windows 11 (64bit)
- .NET 6.0 Desktop Runtime
- WebView2 Runtime (110.0.1587.57 or later)
https://go.microsoft.com/fwlink/p/?LinkId=2124703
Download
Agreement: What I offer on Fanbox and Patreon is a thank you to those who support me, so please do not redistribute mods or data.
The file is checked to ensure that it is not contaminated with viruses or malware.
If you get false positives, please set up an exclusion setting.
NalulunaModAssistant 1.4.0
(ATTACHMENT at the end of this page)
Install
Extract the downloaded zip file, place NalulunaModAssistant.exe in a location of your choice and launch it. If you place the file in a location where you do not have write permission, such as under Program Files, it may not work properly.
Uninstall
Remove the following files and directories.
- NalulunaModAssistant.exe
- NalulunaModAssistant.config
- NalulunaModAssistant.exe.WebView2
- Logs\NalulunaModAssistant
UI

Gray △ next to version : Optional mods are not installed. If you intentionally did not install optional mods, there is no problem, but if you forgot to install them, please install them as well.
Red △ next to the version : Required mods are missing or mods that cannot be used at the same time exists. This is likely to cause problems.
Version numbers
Update x.0.0: major feature additions, major specification changes
Update 0.x.0: feature additions, specification changes, critical bug fixes, Beat Saber update support
Update 0.0.x: minor changes, bug fixes
Comments
nalulululuna
Sorry for the late reply. Were you able to connect before? Please contact me for a refund.
nalulululuna
Is the google-site unavailable in Kazakhstan? Please contact me for a refund.
AIFlowers
Connection failed - not working in Kazakhstan :(
Темирлан Какенов
"failed to get modlist pls try later"((( your program does not work in kazakhstan. the problem is with your server. via VPN the program opens the mod list, but does not allow to install. interestingly, i have been buying a subscription for a long time, but now i can not install mods(
awkward scone
I mostly use Avatars, Saber, Cat, SpaceCallibrator and Splat, and I currently use 1.34.2. However, I'm looking to upgrade the version soon and I would love for Naluluna to work with 1.38 too if possible 🥺
awkward scone
Hello! Some other Beat Saber modding people are telling us to use 1.38 as the best modding version, inckuding the Devs for BeatSaberPlus. Will you be modding 1.38 too?
nalulululuna
I apologize for not noticing your comment and for the delay in replying. I will be working on the latest version starting with the one that seems to have the most users.
WentTheFox
1.37.1 - 1.37.2 is the latest one listed as supported in the launcher's About > Override Version dropdown
Lumberjack462
Hi....can you tell me the latest version of Beat Saber that the Mod Assistant works on? I am on 1.34.2, but trying to see if I can upgrade.
Little Mouse
Are any of the mods up to date with the most recent version of beat saber? Upon openning the mod assistant and signing into my patreon, all I have available to download is the Utils, Retry and Counters.
nalulululuna
Please update the webview2 runtime. (install Evergreen Standalone Installer) https://developer.microsoft.com/en-us/microsoft-edge/webview2/ If it doesn't fix the issue, please send me the log.
Mousie Mute
I am having trouble loading the mod assistant. A fresh install of the assistant lets me log in from patreon but as soon as I go to click on a mod it crashes. When I reopen the assistant it gets 1/4 through initializing and then crashes. I am currently on 1.29.0
Kat
it started to work, so I think i'm ok!
nalulululuna
Can you send me the log via Message?
Kat
I can't get the Assistant to initialize despite trying a clean install, I've tried it on 1.29.1, 1.31.1. Is there something I'm missing? It stops initializing after maybe.... 1/3 of the bar is filled in the bottom.
HickeyChan
Thanks for your hard work
nalulululuna
I'm sorry. Currently, it seems only work for Non-SteamVR (Oculus, Pico, WMR) devices for 1.31. Index HMD doesn't seem to be working right in this situation. I'm writing a new OpenXR module to fix this, but it's more work than writing a new mod, so it will take some time.
HickeyChan
NalulunaAvatars - Game 1.31.0 I use SteamVR, Tracker 2.0 end Valve index, when I try to calibrate, nothing comes out normally, it feels like the trackers are somewhere very far from me. I move the leg or belt very little, but there is a horror happening, the avatar's legs or waist are far from the center I'm sorry, I don't know English well, but I decided to write to you, I wanted to upgrade to game version 1.31, but since your avatar mod doesn't work, I can't do it I tried a clean version of the game, with only the most necessary mods, but when calibrating, the trackers seem to be in the wrong place, although in SteamVR they are where they should be, and in VRChat everything is fine too
nalulululuna
I'm currently working on it. Please read this article. https://www.patreon.com/posts/51950684
Marin Nameki
Hey theres no selection to dl the Avatar on the new mod assistant :(
nalulululuna
Thank you for letting me know. I am currently updating for 1.31.0 one by one, but in the process I forgot to update the download location for 1.29.1. My apologies. It should be fixed now.
BTX
When i try to download NalulunaLut and NalulunaUtils it fails here is my logs: https://gofile.io/d/kNmt1K
melonz
mb, i meant 1.26.0
nalulululuna
Is it really 1.16.0 instead of 1.26.0? Unfortunately, NalulunaModAssistant doesn't support that old version. I can give you my very old archive of my mods for 1.16.0 but they are not many. Basically, when I make a new mod, I make it for the latest version at the time, and do not think of the older versions of beatsaber. So, many of my mods don't support 1.16.0.
melonz
When I try to open the mod assistant, it keeps saying "Beat saber mod environment is not set up after beat saber update. Please install core mods with ModAssistant, then start and exit Beat Saber once." I have everything installed, I'm on 1.16.0, I have the core mods installed and I'm using beat saber legacy launcher. Is there any way to fix this? (Edit: I got it working now)
kolorafa
Microsoft WPF probably will never be crossplatform, I see that there are alternatives like AvaloniaUI but it's probably not a drop-in replacement. So the only last light of hope without changing the UI library would be to compile the app into static executable (with bundled deps) but still target windows, and run the .exe file using wine that have community created WPF api build-in.
kolorafa
Created a Windows VM and mounted the game over samba, the plugins did install, not ideal as I would probably need to redo the vm every few months, but better than nothing <3 :)
nalulululuna
I have the build above for now, but this one depends on the .net runtime. There was no runtime pack for Microsoft.WindowsDesktop.App.WPF available so a single, all-inclusive build for linux is not possible. Sorry for not distributing the dll in stand-alone form. It is a hassle, but I think the only way is to prepare a virtual environment. NalulunaModAssistant searches Beat Saber.exe and Beat Saber_Data\Managed\Main.dll. Beat Saber and BSIPA version is identified by the number in Beat Saber IPA.json in the UserData folder. So, you don't need to install all beat saber game there.
kolorafa
If the size would be the issue, I could provide you a file server.
kolorafa
Yes, but targeting linux runetime would bundle all needed dependencies to a staticly-build image that doesn't load any external code, so yes, it might get quite big but should run. It's like building for linux distro the resulting binary blob is small vs creating a appimage that bundles all the code, then the targeted distro build is like 20MB while the appimage for the same app could be even like 800MB depending on used libraries. So I think it would be worth trying, as I understand that other that the only way to acquire plugins for latest BS would be to ask for every plugin directly as they are no longer published?
nalulululuna
Looking at the error, it is not a problem within NalulunaModAssistant, but an error in the webview2 runtime, so I doubt that compiling with the linux runtime will fix it. I built it experimentally for now, but it probably won't work, and I don't know what will happen with automatic updates, etc. regarding this version. https://downloads.fanbox.cc/files/post/4732017/m0vCVw4ERKnLqzwSj63Xtq5N.zip
kolorafa
Could you build a version for Linux runtime? dotnet build ProjectFile.csproj --runtime linux-x64 Targeting linux runtime would bundle all the needed dependency into a file, it will be bigger but should work. Thanks The .exe version almost work with wine, it starts up, see Loading... but it gets stuck on: 022c:err:combase:RoGetActivationFactory Failed to find library for L"Windows.Security.Authentication.Web.Core.WebAuthenticationCoreManager" [552:556:0316/233230.739:ERROR:edge_auth_errors.cc(484)] EDGE_IDENTITY: wam_default_account_token_fetcher::StartFetchingTokenForImplicitSignin: FAILED at start: Error: Primary Error: kAccountProviderFe tchFailed, Secondary Error: kUnspecified, Platform error: -2147221164, hex:80040154, Error string:
kakugen
what is the about tab
nalulululuna
The mods corresponding to the version of Beat Saber (path shown in the About tab) recognized by NalulunaModAssistant will be installed automatically. If you are using 1.26, mods will be for 1.26.
TimberRise
Is there anyway to change the version you're running afterwards? I run 1.26 not 1.28
nalulululuna
If the error message still remains the same, please manually change the beat saber folder in the About tab.
TimberRise
Yeah I launched BeatSaber afterwards
nalulululuna
Did you launch BeatSaber after that? Just pressing the install button in modassistant will only download it to a temporary folder, it will not complete the installation. Once you start the beat saber, the installation is complete, and after that, you can use nalulunamodassistant.
nalulululuna
Thank you for using my mod!
TimberRise
Whenever I try to open the ModAssistant, I get the warning saying "Beat Saber mod environment is not found. Please install core mods with ModAssistant, then start and exit beat saber once" It doesn't make sense since I already have BeatSaberMarkupLanguage and BS Utils installed to my Beat Saber, and they're all up to date
nalulululuna
I just checked again and was able to download and extract the files without any problems. Please try again.
Axel Silverfang
I went to download the file and the zip file is empty.
Jebrone Kitty
That's fair. I just have a friend that does have a quest and I don't know how to help them as I don't have a quest either. So I've been doing some asking around so I can help them a little. Thank you 💖
nalulululuna
It is necessary to have Beat Saber IPA installed by ModAssisntant at first, and then Beat Saber need to be started once to be able to check the version. I think for some reason those things were not being finished.
nalulululuna
Unfortunately, I don't have Quest for now, and I don't have time to make a mod for Quest, so I don't have any plans to do so in the near future. I'm interested though....
Jebrone Kitty
Do the mods word for Quest?
Eddard Yang
Work well for me, the only issu is that I have to do a re-installation of BSIPA to let it recognized the version of the game correctly.
miso-vr
your mods helped me a lot .. thank you 💕
nalulululuna
Thank you! I'm glad you like my mods!
Flashy VR
I just bought this today because I saw it of frqb and I can definitely its crazy I love it
nalulululuna
Please describe your issue in more detail. Also, please upload your logs. If you can't connect completely, then some security software is blocking internet communication, so please set up an exclusion.
Riley Lindsay
ive tried a couple times over the past few days and still no luck signing in
nalulululuna
Thank you! I think it has become much more stable after repeated various tests.
SkyHighCharley
Been running this since the day you released it, and I haven't had any issues, I'm glad your doing this, and Thank You!
nalulululuna
When it is loading for a long time, the hosting site is no longer responding. At that time, the mod cannot be downloaded either. How about checking after some time? I'm using google site, but it doesn't seem very reliable... Maybe I should change it since it sometimes stops responding...
Riley Lindsay
downloading mods will give an error and logging into patreon just gives an infinite loading screen
nalulululuna
I made the exe to a different form in 0.0.5, so I want to say yes, but I can't say for sure because I can't be responsible for the failures of antivirus softwares.
Sharkacuga
So in v5 is it fixed?
nalulululuna
I tried to address this issue in 0.0.5. The tool I had been using called for false positives, so I fundamentally changed the way to build the executing file.
nalulululuna
I tried to address this issue in 0.0.5. The tool I had been using called for false positives, so I fundamentally changed the way to build the executing file.
Br3uker
Same here. Cant even download or run it with windows defender enabled at all. Also login for Patreon just keeps loading without completing the login.
Sharkacuga
I believe v3
nalulululuna
Which version is it?
Sharkacuga
Note it mess up with some antivirus (mcaffee)
nalulululuna
Thank you for the report. It takes into account the case where multiple beat saber folders are used at the same time. Actually, I made it work wherever it is placed. When it looks for beat saber, it searches the same directory as itself as the first priority, and if it doesn't find it there, it checks the registry.
xedlock
Oh.. one more thing that worked fine: my .\UserData and .\NalalunaAvatars folders in Beat Saber home are symlinked to another folder -- and NalalunaModAssistant didn't seem to care and followed the symlinks like a proper application should (I wish everyone did that).
xedlock
Works well, even when I didn't read the instructions and ran it outside of the Beat Saber folder which is in a (very) nonstandard place.. I'm not sure how it found it, to be honest... but it still found it and upgraded the two mods correctly. It also works when a symlink is created in Beat Saber home to point to NalulunaModAssistant.exe in another folder (I have 6+ different beat saber installs, so I use symlinked directories/files to reduce disk space use).