Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/meguminsama/discord-modloader-legacy

An in-memory, multi-instance Discord Modloader
https://github.com/meguminsama/discord-modloader-legacy

betterdiscord discord discord-mod memory-injection replugged vencord

Last synced: about 11 hours ago
JSON representation

An in-memory, multi-instance Discord Modloader

Awesome Lists containing this project

README 

        
# Discord ModLoader



An in-memory mod loader for discord that works without modifying Discord's files.



You can create a profile for each mod you use, and create desktop shortcuts for easy access.



You can customise the user data directory for each profile, isolating each instance completely.



![](assets/DiscordModLoader_oe47GnVQI7.png)



# Where do I download it?



You should probably download from releases, but you can also clone & build it yourself if you know how.



# How to



When creating a new profile, you're presented with a few options. Make sure to read all the documentation below if you get lost. It seems complicated at first, but it's all fairly easy to configure.



## Name



The name of your profile - this is unimportant and can be whatever you want.



## Description



The description of your profile - this is also unimportant.



## Original ASAR Name



When you normally install a Discord mod, it renamed `app.asar` to something else so that it can make it's own fake `app.asar`. This should be the new name of the `app.asar`. For example, with Vencord, this value should be `_app.asar`. With Replugged, this should be `app.orig.asar`, etc.



# Mod Entrypoint



This is the first JS file of the mod that gets run. If you aren't sure what this value should be, see what your mod's `app.asar/index.js` normally requires. With vencord, this should point to your `dist\patcher.js` file.



# Custom User Directory Name



Use this option if you want to isolate your profile data. This is the "user data" folder for your profile. If you leave it blank, it will use your discord instance's default directory. If you put something in here, e.g. `Testing01`, it will go to `%AppData%\DiscordModHook\AppData\Testing01`.



# ASAR Hook Toggle Query



Terribly named, CaSe sensitive, and usually not necessary, this is the string that gets checked when the injector needs to unhook the app.asar proxy. This needs to match the **end** of the path being loaded. By default, this string will just be the same as your mod entrypoint. It's very unlikely that you will need to change this.



As an example, if your mod entrypoint is `C:\Users\megu\Vencord\dist\patcher.js`, you would probably want this value to be at minimum, `Vencord\dist\patcher.js`.



# Troubleshooting



This will be updated as things get found



1. Don't try using this with an already-modded client. This is designed to be used with a vanilla client, with the mods getting injected by ModHook.



# How do I get a profile running on system startup?



1. Stop Discord from starting up with your system in Discord settings.

2. Create a shortcut using the Discord ModLoader GUI.

3. Press Win+R, and type in `shell:startup` and hit enter. Explorer will open in a folder.

4. Copy and paste your newly created shortcut into the folder.

5. The mod will now load on system startup. 



# To Do



- [ ] Re-enable the `--mullti-instance` Discord flag after some testing

- [ ] Clean out root files - there are too many

- [ ] Clean out dependencies - why did I use electron 😿

- [ ] Automatic mod downloading (this is already supported in libmodhook, just needs adding to the GUI)

- [ ] Make an installer for Discord ModLoader

- [ ] Linux Support (looking for sponsor)

- [ ] MacOS Support (looking for sponsor)

- [ ] Perhaps register a URI scheme to load profiles instead of pointing directly to the EXE. This would pair well with an installer.



# Questions?



Open a GitHub issue



# Where do the `.dll` files come from?



https://github.com/meguminsama/discord-modhook