[![Mod Assistant](https://cdn.assistant.moe/images/ModAssistant/Icons/Banner.svg?v=5)](https://github.com/Assistant/ModAssistant/releases/latest)
[![Download here!](https://cdn.assistant.moe/images/ModAssistant/Icons/Download.svg)](https://github.com/Assistant/ModAssistant/releases/latest)
Mod Assistant is a PC mod installer for Beat Saber. It uses mods from [BeatMods](https://beatmods.com/).
* [Features](#Features)
* [Usage](#Usage)
* [Themes](#Themes)
* [Custom Themes](#Custom-Themes)
* [Built In](#Built-In)
* [Packaged `.mat` Files](#Packaged-mat-Files)
* [Loose Folder Themes](#Loose-Folder-Themes)
* [Overriding Themes](#Overriding-Themes)
* [Common Issues](#Common-Issues)
## Features
Mod Assistant boasts a rich feature set, some of which include:
* Dependency resolution
* Installed mod detection
* Mod uninstallation
* OneClick™ Install support
* Complex theming engine
* Localization support
* Headpats and Hugs
## Usage
Download the newest installer from the release section and run it. This application auto-updates when launched, there is no need to download a new release each time.
1. **Run the game at least once before trying to mod the game!** This applies to reinstalling your game too. All mods are moved into an `Old X.X.X Plugins` folder on first launch to avoid version mismatches, so make sure to do this before installing mods on a fresh version.
2. Once that's done, simply check off the mods that you wish to install and click the <kbd>Install or Update</kbd> button. Likewise, click the <kbd>Uninstall</kbd> button to remove any mods.
3. Mods are installed to `IPA/Pending` until the game is run. Boot the game to complete mod installation.
## Themes
<details>
<summary><b>Light</b></summary>
<div>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Light/Intro.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Light/Mods.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Light/About.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Light/Options.png" /></p>
</div>
</details>
<details>
<summary><b>Dark</b></summary>
<div>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Dark/Intro.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Dark/Mods.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Dark/About.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Dark/Options.png" /></p>
</div>
</details>
<details>
<summary><b>BSMG</b></summary>
<div>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/BSMG/Intro.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/BSMG/Mods.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/BSMG/About.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/BSMG/Options.png" /></p>
</div>
</details>
<details>
<summary><b>Light Pink</b></summary>
<div>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Light Pink/Intro.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Light Pink/Mods.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Light Pink/About.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Light Pink/Options.png" /></p>
</div>
</details>
<details>
<summary><b>Your own!</b></summary>
<div>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Custom/Intro.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Custom/Mods.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Custom/About.png" /></p>
<p><img src="https://cdn.assistant.moe/images/ModAssistant/Themes/Custom/Options.png" /></p>
</div>
</details>
### Custom Themes
Custom themes are located in a folder called `Themes` in the same folder as `ModAssistant.exe`. Mod Assistant can load themes from one of three sources.
### Built In
These come with the program and you can't change them, however you can overwrite them by creating one of the other two theme types with the same name.
If you have a particularly popular theme, you can submit a [Pull Request](https://github.com/Assistant/ModAssistant/pulls) to add your theme as a built-in theme.
### Packaged `.mat` Files
These are pre-packaged theme files. Under the hood they are renamed`.zip` files, and the file structure is the same as that of `Folders` themes. These will be overwritten by `Folders` themes with the same name.
To create one follow the instructions on `Folders` themes, and zip the files up into a zip archive, and rename it to `<themeName>.mat`.
### Loose Folder Themes
These will overwrite all other themes, and are loaded from a folder named after the theme. There are 4 types of files you can include:
* `Theme.xaml`
* This file determines the colors and styling of the theme.
* The filename isn't important, but the `.xaml` file extension is.
* To see an example of this file press the <kbd>Export Template</kbd> button in the `Options` page. It will create a folder in `Themes` called `Ugly Kulu-Ya-Ku`. You can open that file to use as a template for your own themes, or just use it.
* `Waifu.png`
* This will be loaded as the background image.
* It will be centered, and you can pick how to stretch it in the associated `.xaml` file.
* The filename isn't important, but the `.png` file extension is.
* `Waifu.side.png`
* This will be loaded as the left side image.<br />It will be left aligned, and you can pick its vertical alignment in the associated `.xaml` file.
* The filename isn't important, but the `.side.png` file extension is.
* `Video.{mp4, webm, mkv, avi, m2ts}`
* This will be loaded as a background video, with sound.
* The filename isn't important, but the file extension must be supported (`.mp4`, `.webm`, `.mkv`, `.avi`, `.m2ts`)
* Whether the file works or not will depend on what codecs the file has, and whether those are available on your machine.
### Overriding Themes
You can mix and match parts from different themes by giving them the same name.
The priority in which they will be used is `Loose Folder Themes` > `Packaged .mat files` > `Built in`. Overriding themes will only change the files that are included.
Examples:
* Adding `/Themes/Dark.mat` which includes `.png` and `.xaml` files will override both those aspects of the `Dark` theme.
* Adding `/Themes/Dark/image.png` will use that image as the background for the `Dark` theme, overriding both the built in theme and `Dark.mat` if it exists.
## Common Issues
**I hit install but I don't see anything in game!**
Double check that you followed the [Usage](#usage) instructions correctly.
Make sure you're looking in the right place. Sometimes mod menus move as modding libraries/practices change.
**I don't see a certain mod in the mods list!**
Mod Assistant uses mods from [BeatMods](https://beatmods.com/) and shows whatever is available for download. If you need to install a mod manually, please refer to the [Beat Saber Modding Group Wiki](https://bsmg.wiki/pc-modding.html#manual-installation).
**I hit install but now my game won't launch, I can't click any buttons, I only see a black screen, etc**
Please visit the [Beat Saber Modding Group](https://discord.gg/beatsabermods) `#pc-help` channels. Check the pinned messages or ask for help and see if you can work out things out.
## Credits
semver by Max Hauser
https://github.com/maxhauser/semver
没有合适的资源?快使用搜索试试~ 我知道了~
ModAssistant:简单的Beat Saber Mod安装程序
共84个文件
xaml:42个
cs:28个
md:2个
需积分: 50 3 下载量 137 浏览量
2021-04-29
21:37:24
上传
评论
收藏 194KB ZIP 举报
温馨提示
Mod Assistant是Beat Saber的PC mod安装程序。 它使用mod。 特征 Mod Assistant具有丰富的功能集,其中包括: 依赖解析 安装的mod检测 Mod卸载 OneClick:trade_mark:安装支持 复杂的主题引擎 本地化支持 头巾和拥抱 用法 从发行版部分下载最新的安装程序并运行它。 该应用程序在启动时会自动更新,无需每次都下载新版本。 在尝试修改游戏之前,请至少运行一次游戏! 这也适用于重新安装游戏。 首次启动时,所有mod都会移至“ Old XXX Plugins文件夹中,以避免版本不匹配,因此请确保在新版本上安装mod之前执行此操作。 完成后,只需勾选要安装的模块,然后单击“安装”或“更新”按钮。 同样,单击“卸载”按钮以删除所有模块。 在游戏运行之前,将Mods安装到IPA/Pending 。 引导游戏以完成mod安装。 主题 光 黑暗的 BSMG
资源推荐
资源详情
资源评论
收起资源包目录
ModAssistant-master.zip (84个子文件)
ModAssistant-master
LICENSE 1KB
ModAssistant.sln 1KB
.github
FUNDING.yml 139B
workflows
dotnet.yml 1KB
tools
generate_translation_stubs.py 4KB
README.md 391B
README.md 8KB
ModAssistant
App.xaml 3KB
Resources
Icons.xaml 7KB
icon.ico 121KB
Pages
Options.xaml 13KB
Loading.xaml.cs 1KB
Mods.xaml.cs 29KB
Loading.xaml 3KB
Invalid.xaml.cs 1002B
Intro.xaml 4KB
About.xaml.cs 2KB
Mods.xaml 7KB
About.xaml 11KB
Invalid.xaml 4KB
Intro.xaml.cs 2KB
Options.xaml.cs 17KB
App.xaml.cs 9KB
Classes
OneClickInstaller.cs 5KB
External Interfaces
BeatSaver.cs 15KB
Utils.cs 3KB
Playlists.cs 5KB
ModelSaber.cs 1KB
Utils.cs 18KB
Http.cs 1KB
Themes.cs 22KB
Updater.cs 5KB
Languages.cs 3KB
HyperlinkExtensions.cs 1KB
Diagnostics.cs 2KB
Mod.cs 1KB
Promotions.cs 447B
Themes
Light.xaml 6KB
Default Scrollbar.xaml 1KB
Ugly Kulu-Ya-Ku.xaml 8KB
BSMG.xaml 7KB
Dark.xaml 7KB
Light Pink.xaml 5KB
BSMG
Sidebar.png 6KB
OneClickStatus.xaml 5KB
ModAssistant.csproj 11KB
Localisation
zh.xaml 17KB
it.xaml 18KB
fr.xaml 18KB
de.xaml 17KB
sv.xaml 17KB
nb.xaml 17KB
en-DEBUG.xaml 14KB
en.xaml 16KB
nl.xaml 17KB
ru.xaml 22KB
ko.xaml 18KB
Libs
semver
IntExtensions.cs 2KB
SemVersion.cs 25KB
MainWindow.xaml 9KB
Styles
ComboBox.xaml 6KB
TextBlock.xaml 358B
ListViewItem.xaml 2KB
Menu.xaml 509B
CheckBox.xaml 5KB
MenuItem.xaml 6KB
Label.xaml 990B
ComboBoxItem.xaml 6KB
ScrollBar.xaml 15KB
RepeatButton.xaml 3KB
Thumb.xaml 1KB
ToggleButton.xaml 5KB
ListView.xaml 419B
GridViewColumnHeader.xaml 3KB
Button.xaml 5KB
App.config 3KB
OneClickStatus.xaml.cs 2KB
Properties
AssemblyInfo.cs 2KB
Settings.Designer.cs 8KB
Resources.resx 5KB
Settings.settings 2KB
Resources.Designer.cs 3KB
MainWindow.xaml.cs 12KB
.editorconfig 312B
共 84 条
- 1
资源评论
洋林
- 粉丝: 28
- 资源: 4575
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功