Mod Features:

• Weapon Customization: Edit weapon parameters(area, amount etc), change their Limit Breaks and Level Ups values.
• Inventory Management: Adjust weapon and accessory counts, add or remove items.
• Player Options: Level up, gain XP and coins.
• Gameplay Effects: Enable invulnerability, trigger vacuum or gold fever, and spawn treasure chests.
• Visual Tweaks: Modify game speed, camera distance, weapon effects transparency, and color correction.
• Kill Tracking: Monitor kills over time.
• Eggs: Buy and remove.
• Caps: Editing weapons stats limit.
• Limit Break Selection: Prioritize Limit Breaks.
• Information Page
  

The mod is intended for people who have already beaten the game or want to fine-tune certain visuals. Or if they need a little help.

-

----------------------------------Installation Guide:----------------------------------

• If you don’t have them already, please install the following libraries:
  
  • Microsoft Visual C++ 2015-2019 Redistributable 64 Bit
  • .NET Desktop Runtime
    
• Locate the game folder:
  
  • Launch Steam and click on the “Library” tab at the top.
  • Right-click on Vampire Survivors on the left side.
  • Under “Manage,” select “Browse local files.”
  • VampireSurvivors.exe
    
• Download MelonLoader:
  
  • github - Releases - MelonLoader.Installer.exe 
  • Run MelonLoader.Installer.exe.
  • Click the SELECT button.
  • Select and Open the Game's EXE in your Game's Installation Folder.
  • Select which Version of MelonLoader to install using the Drop-Down List. (Select Latest Version)
  • Click the INSTALL or RE-INSTALL button.
    
• Run the Game:
  
  • Launch the game. Note that the initial startup may take some time.
  • Allow the game to load fully.
    
• Install the Mod:
  
  • Locate the “Mods” folder within the game directory.
  • Place your mod file (the one you want to install) into this folder.
    
• Play and Access the Mod:
  
  • Start the game.
  • To access your mod features, press F1 to open the ModMenu.
    

Vortex: If I understand correctly, Vortex now has VS support, but it requires an additional script download when you select the game in mod loader. There is also a Vortex download button on the mod page. However, steps 1-5 need to be completed regardless. I don’t use this feature, so any Vortex-related questions should be directed to the script creator.

----------------------------------Mod Guide:----------------------------------

• The ModMenu(F1) appears differently in the main menu compared to during gameplay.
• The ModMenu has several pages. You can switch between them by pressing the icons located in the special zone to the left of the mod menu.
• To interact with any number fields, simply click on them and type an integer or decimal number, then press Enter.
• In both ModMenus, you have the ability to adjust the maximum count for weapons and accessories. If you leave this setting unchanged, the mod will not modify the maximum count, which is indicated by a value of ‘-1’ in the main menu.
  

Main Menu:

Page 1:
Stats editing. To select a weapon, click on its icon. Some of the parameters:

• Rarity: This parameter determines the probability of the weapon appearing in level-up choices.
• Interval: Refers to the cooldown time between shots when the weapon fires.
• Repeat Interval: Indicates the time between shooting projectiles during weapon fire
  

Close the Mod Menu to apply changes, or use reset to reverse changes. All data automatically saves when you quit the game. However, if you want to ensure that your changes is saved to a file, you can manually trigger the save process.

Page 2:
On this page, you can bind specific functions to keys. Remember to use uppercase letters when specifying the keybindings. The success of these bindings can be tracked in the bottom log section.

Page 3:
This page provides information about the game items. 

Gameplay:

Page 1:
This page contains a bunch of different options and effects to trigger, as well as options to get or remove accessories.

• To get a weapon or accessory, simply click on its icon. If the item already exists, clicking on it will remove it. It’s important to note that removing an accessory does not undo any stats that were previously added by it. 
• Each button performs the action described on it.
  
  • All_Plus: This button grants all items, including those that the player doesn’t normally have in the base run.
  • ToggleInvul: Toggles invulnerability.
  • Hidden Weapon: Refers to a hidden weapon that certain characters have from the start.
    
• The ‘LB Priority’ option enables automatic Limit Break selection based on the priority set in the fields below. Keep in mind that this option doesn’t influence the proposed choices themselves; it only affects what can be selected from them due random Limit Break selection is enabled. A smaller number indicates a more preferred option. Cooldown added for completeness only, no weapons have this option yet.
• Below the original kill counter, you now have an additional counter that tracks kills per second. You can hide it if you want.
• Eggs: "Egg Cost" - if the mod buy an egg its uses this price. All "Eggs" buttons works per currently playing character and applies changes immediately (you don't need reenter a stage). "Auto Eggs" automatically triggers "Buy_All_Eggs" every second.
  

Page 2:  
You can adjust the transparency and correct the appearance of weapon effects. Most weapons work, but not all. In this case, try the "MORE!" button.
In short, you can view each image as a combination of three color channels: red, green, and blue. All options on this page allow you to edit the image or its channels separately. You may need to 'Google' for more information based on the details provided below.

• “HSV”: Hue, Saturation, Value
• “Hue”: Two another Hue shifts. Ranges from 0 to 360.
• “+” (Addition): Modifies color values by adding a specified amount.
• “Contr”: contrast.
• “*” (Multiply): Adjusts the gain of color values.
• Gamma: gamma.
• “Grey”: set 0 for Unity-style greyscale. 
• “inv” (Inverse): Inverts color values.
• “Alpha”: transparency.
  

Changes take effect only after closing the Mod Menu window or pressing "Apply" button, but the preview image updates immediately after adjusting the fields.
Effects order: description order above.
Values with R,G,B colors allows editing per color channel, color represented in the range from 0 to 1.
The “MORE!” button allows you to pick up additional weapon sprites (even not intended). If you need this effect again, just press the button once more.
Page 3: 

• You can edit player passive stats. 
• You can change limits for weapon stats, but you need to press the ‘Do Caps’ button once per game launch to activate these fields. This action patches and replaces the weapon stats calculation function with a custom one. During my tests, I didn’t find any difference between the custom calculations and the original ones. However, if you don’t need this feature,  avoid using it.
  

Page 4: 
This page provides information about the game items. 

----------------------------------Important:----------------------------------

• Be Reasonable with Field Values: I don’t clamp their range, so use sensible values.
• Avoid testing any strange edge cases: For example, pressing the ‘START’ button while the Mod Menu is open (in this case, changes won’t be saved).
• Do not spam key-bound features. You will hardlock the game if you press a button for a menu that is already active but not yet resolved. For example, summoning the Arcana selection menu when you haven't chosen an Arcana in the current menu.
• In-Gameplay Usage of Mod Menu: Only use the Mod Menu when no other menus are on the screen (such as level-up options). You can select something through the Mod Menu or can’t interact with buttons or fields, simply close the Mod Menu(F1) and reopen it when no other menus are visible.
• Item Removal: While most items remove correctly, be aware that some removals (like Sole Solution) may not behave as expected.
• Players cannot obtain items from DLCs they have not purchased.
• The mod dynamically creates an items list, and after game updates, there is a possibility of new weapons or accessories appearing that are not supposed to be in this list (its not about DLC items). For example, it could be a new power-up (like ‘Karoma’s Mana’), a placeholder for a future weapon, or something akin to a ‘Candybox.’ To maintain accuracy, I manually add these new items to the mod filter. But their existence do no harm.
• While most future weapons can be color-corrected without requiring a mod update, there are exceptions. For instance, if a new weapon is based on trail projectiles (like ‘Silver Wind’), utilizes character, item, or enemy sprites for attacks, or some strange decision on the developer’s side (I don't even want talk about this, and now its x2), I’ll need to update the mod specifically for that weapon.
• Creating this mod took significant time and effort, and my courage has its limits. As a result, some decisions may appear unconventional or less polished.
  

----------------------------------QA:----------------------------------

Q: Sometimes I can see some projectiles appear without changed transparency.
A: This can occur when the game generates a large number of projectiles for weapon. However, mod quickly adjusts their transparency after short period of time.
Q: What about performance impact?
A: The performance impact is close to zero. Most of the mod’s functions are called only when necessary, not every frame.
Q: Some weapon effects are not affected by color correction.
A: Certain weapons have a white base that gets multiplied by specific colors (such as “Bloody Tear”). You are editing this white base. Additionally, some weapons are modified by one color, but I haven’t added editing field for that color. Most weapons work fine. For precise color editing, I’d need to address problematic weapons individually.
Q: Problems with MelonLoader.Installer.exe.
A: Download MelonLoader.x64.zip,  extract the zip file you just downloaded to the Game's Installation Folder.

----------------------------------Bug report:----------------------------------

• Describe the Bug:
  
  • Please provide a brief summary of the issue you’re encountering. What seems to be going wrong?
    
• Steps to Recreate the Bug:
  
  • To help diagnose the problem, I’ll need the exact steps you take to encounter the bug. Describe the clicks, key presses, and selections you make that lead to the issue.
    
• Console Logs:
  
  • When you run the game, the console will appear. The mod already logs some information about its execution, but I updated it for better visual clarity.
  • You don’t need to provide all the logs. Instead, look for a big red chunk of text or any other red indicators after the message indicating that the mod is loaded.