Repacker

Thanks a lot to daso132 for improving and compiling this repacker.

👉 DOWNLOAD HERE 👈

⚠️ IMPORTANT NOTE: If you try to repack audio mod and see the tool works, it's fake. UnityPy doesn't support audio repacking yet. Also, this tool cannot repack swap mods.

Overview

Doro Repacker is a comprehensive tool for repacking NIKKE game mods. It supports various types of mods including character mods, lobby/burst mods, and event mods.

Key Features

Version History & Features

1.0 Initial Release

New Features:

  • Repack burst/lobby mod and event mod

Workflow Changes:

  • No need to copy mods to "Modded Bundles_Rename Step" folder
  • No need to create shortcut for NAU.exe
  • Changed name format for lobby/burst mod to NLBMM format
  • Can repack multiple mods in one run

Other Changes:

  • Added feature to sort mods by name
  • Original mod files are categorized and moved to correct folders
  • Removed redundant scripts: "B___rename_moddedbundles_renamestep.py", "C___move_renamestepfiles_to_renamedbundlesformatch.py", "D___copy_raw_files_matches_to_originalbundles_showprogress.py"
  • Added "1.2_OPTIONAL_CLEAN_FOLDERS.bat"

1.1 Enhanced Asset Support

New Features:

  • Ability to repack most mods with "TextAsset" or "Texture2D" assets
  • Support for mods lookupable in "catalog_db.json" and "core_other.json"

Test Status:

  • Audio mod: Not supported yet (UnityPy limitation)
  • Spine physics mod: Tested successfully
  • Texture mod: Should work (untested)
  • Other types: Not tested yet

1.2 Standalone Executable

New Features:

  • Packed into single .exe file
  • No Python installation required

Other Changes:

  • Added .exe build instructions

How to Use

Setup (For Python Version)

NOTE: If you're using the .exe version, skip the setup steps.
  1. Install Python: Download from python.org
  2. During installation, check "Add python.exe to PATH"
  3. Run SETUP_INSTALL_REQUIREMENTS.bat

Name Format Requirements

Character Mods (aim/cover/standing):

[id]_[skin_code]_[type]_[Author]_[ModName]

Example: c281_01_standing_Catalyzer_MoranNudeSkin

Lobby/Burst Mods:

[id]-[skin_code]-[type]-[Author]-[ModName]

Event Mods:

[ID]-[type]-[Author]-[ModName]
Important: Don't confuse "-" and "_". The naming structure is based on NMM for character mods and NLBMM for lobby/burst/event mods.

Using the .exe Version

  1. Put all repackable mods in the "Modded Bundles" folder
  2. Run repacker.exe
  3. Follow the prompts (you'll be asked about deleting temporary files)
  4. Find your repacked mods in the "Repacked" folder

Using Python Scripts

  1. Put all repackable mods in the "Modded Bundles" folder
  2. Run 1.0__GET_RAW_FILES.bat
  3. Run 1.1__PY_RUN_REPACKER.bat
  4. Repacked mods will be in the "Repacked" folder
  5. Optional: Run 1.2_OPTIONAL_CLEAN_FOLDERS.bat to clean up for next repack

Build Tutorial (Creating .exe)

Prerequisite: You must complete the setup steps including installing Python and required modules before starting the build.
  1. Open the project folder in your code editor (e.g., Visual Studio Code)
  2. Install Nuitka and dependencies: 
    pip install nuitka zstandard ordered-set
  3. Find your Python installation directory: 
    where python
  4. Run the Nuitka build command (replace <your python installation directory> with your path): 
    nuitka --onefile --standalone --mingw64 --enable-plugin=tk-inter --assume-yes-for-downloads --include-package=UnityPy --include-package=UnityPy.resources --include-data-dir="<your python installation directory>\Lib\site-packages\UnityPy\resources=UnityPy/resources" --include-data-dir="<your python installation directory>\Lib\site-packages\archspec=archspec" --user-package-configuration-file=my.nuitka-package.config.yml mainScript.py
  5. Wait approximately 30 minutes for the build to complete
⚠️ WARNING: This tool is designed to repack mods supported by NMM or NLBMM. It may not work with mods designed for other mod managers. It cannot repack swap mods.

Happy modding! ^‿^

Support on Ko-fi