NIKKE Lobby/Burst Mod Manager

Introduction

A tool that uses a modified version of anosu Spine Viewer to view NIKKE Spine animations from modded bundles, and manages your lobby/burst mods. The tool replaces original files with a copy of your modded files when you "activate" the mod, and restores the original file when you "deactivate" it.

c010-00-lobby-Swapper-EVESkin03SwapOverRapi
c162-01-lobby-Na0h-MiharaCake
c470-00-burst-Hiccup-RedHoodClothesLess
c470-00-lobby-Hiccup-RedHoodClothesLess
eventtitle_neverland_02-lobby-Na0h-NudeWaifusOnsen

Requirements for the scripts

• Download and install Microsoft C++ Build Tools, then install dependencies following this video guide.
• Install Python 3.13.2+ if not already installed.
• Double-click _install_requirements.bat to install required modules.
• Double-click GD_DOWNLOADER.bat to download the Spine Viewer.

Note: The requirements in requirements.txt are only for the GUI script. If you want to build the Spine Viewer yourself, you'll need Electron, Node.js, etc. Otherwise, the manager will automatically download a portable ready‑to‑use viewer.

Usage

1. Go to your "mods" folder and create a new folder "lobby_burst".
2. Move your renamed mods (following the naming structure above) into "lobby_burst".

3. Double-click NLBMM.exe to launch the manager.
4. The manager will ask for the path to your "lobby_burst" folder and the "naps" folder. Click OK.

5. You will see the main GUI:

6. Click Browse... next to "Mods Folder", navigate to your "lobby_burst" folder and select it.
7. Click Browse... next to "naps Folder", navigate to your "naps" folder and select it.
8. The manager will display your mods list:

9. The first time you set the paths, the buttons may appear buggy. Just close and relaunch the manager to fix it:

10. You're all set! Optionally, double-click CREATE_SHORTCUT.bat to create a desktop shortcut.

✨ New Features

• Multi‑select: Activate/deactivate multiple mods at once using checkboxes. Preferences are saved to modslist.json for faster reactivation after game updates.

• Presets: Save and load presets of active mods.

• Other mods support: Now works with character effects, minigame mods, and more.

• Remove read‑only: A new button to remove the read‑only attribute from the naps folder – useful if you forgot to deactivate mods before updating.

Note: On first launch of the day, the manager will cache your entire naps folder to speed up mod status reloading. Just wait until it finishes.

📁 How to Add “Other” Mods

1. Create a new folder "other" inside "lobby_burst".
2. Create subfolders for each mod type (e.g., effects, minigame).

Example for effects mods:

Example for minigame mods:

The renaming format is simpler: open AddressablesJSON/core_other.json with Notepad to see the required names (without the .bundle extension).

🔘 Buttons

• Preview: Open the Spine viewer to load the animation.
• Refresh Mods List: Update the list after renaming, moving, or deleting mods.
• Clear: Clear the search bar.
• Activate Selected: Activate the checked mods.
• Deactivate Selected: Deactivate the checked mods.
• Select All / Deselect All: Check/uncheck all checkboxes.
• Save Preset: Save the current active mods as a preset.
• Load Preset: Load a preset (checks the mods that were active; you then click Activate Selected).
• Open Mods Folder / Open naps Folder: Open the respective folders.
• Search bar: Filter mods by author, name, etc.

⚠️ Important Notes

• For aim/cover/standing/chibi/portrait/favorite item/physics/background mods, you need to use the standard NMM, not this manager.
• NAU requires .NET SDK 8 to work.

📅 Update December 2025

It seems possible to leave mods active now without needing to deactivate before launching, as the game’s file change detection no longer forces a redownload on every startup.