Bloodlines v0.2.1 - Alpha Release

Bloodlines v0.2.1 for Vampire Survivors v1.6.108 (Public Beta)

A Custom Character importer for Vampire Survivors

Join the official bloodlines discord Here!

v0.2.1 Changes

• [Bugfix] Character packs animations combining between games
• [Bugfix] Gems not being picked up, swirling around character
• [Feature] New option in skin objects: "alwaysAnimate" - When set to true, a character's animation will always run even when sitting still. Default is false.
• [Pack creation tool] Added always animate checkbox
• [Pack creation tool] Converted weapon names from ids to weapon names for easier use.

---

Warning

This is an alpha release, I give no guarantees what this will do to your game/save files. Keep backups!

Important

This mod does not work with the old engine skin mods. It shouldn’t be too hard to convert them though.

Character pack creation helper tool release!

The Character pack creator is a utility for helping people create packs

Just input the data you want, and hit download zip, and the character pack is created!

Mod Installation

1. Install Melonloader (This is required for all Vampire Survivors games)
2. Start the game to have melonloader fully install. (Not required if it's already installed)
3. Download and copy Bloodlines.dll into the <Vampire Survivors Location>/mods folder.
4. Start the game again to have <Vampire Survivors Location>/UserData/Bloodlines/* folders be created.
5. Install your custom character pack! Add the character zip file to <Vampire Survivors Location>/UserData/Bloodlines (Should be in the same folder as data.cfg). Do NOT extract the zip, this mod will do that for you.
   • Feel free to download Gus from this repo as an example.
6. Start the game, if you have the console enabled, you should see that bloodlines successfully imported the character and the zip file should then be deleted. If it wasn't deleted, the import wasn't successful. If you see any errors, please open an issue or ping me on discord with the console exception and everything in red text.

Skin Installation

Did you friend make a super cool custom character and they want to share it with you? All they have to do is share the character pack with you.

1. Download the zip file they send you (shared somewhere like discord)
2. copy the zip file to the <Vampire Survivors Location>/UserData/Bloodlines folder. No need to unzip
3. start the game.

Creating your own character packs!

Character packs contain two types of items:

1. A json file - This contains the character data: Starting weapon, which sprites to use, power level, etc.
2. png files - The character sprites. (These must be referenced by filename in the json file)

How to zip files together for a character pack

1. select the files you want to zip together - press ctrl + left-click each file you want, they should all be highlighted.
2. right click and select Send to > Compressed (zipped) folder
3. Rename the pack to whatever you want.
4. View the contents of the zip by opening it with windows explorer or a zip utility like 7zip.
   Note: There should be no folders in the zip file, just the json file and png files.

Known bugs/limitations

This mod is in very early in development stages, but I wanted to get testers as quickly as possible so I know what works and what doesn't with the packs and the mod.

1. Co-op isn't working
2. Sprite scaling doesn't work in game. Keep your sprites generally around 35x35 pixels no bigger than 200x200px or they will be obnoxious in game.
3. Custom character progress isn't saved.
4. Plenty of visual bugs
   • Legionnaire's sprites don't spawn correctly

Future plans

1. Spritesheet/Sprite atlas support (With a reference json file anyway)
2. Saving character progress (eggs, cleared stages, exp gained, etc)
3. Additional animation support

Bloodlines v0.2.0 - Alpha Release

Bloodlines v0.2.0 for Vampire Survivors v1.6.108 (Public Beta)

A Custom Character importer for Vampire Survivors

• Create custom character packs (zip files) that anyone with this mod can download and install.
• My end goal of this mod is to have custom characters as customizable as possible, while keeping it relatively intuitive to create and super simple to install.

Join the official bloodlines discord Here!

Warning

This is an alpha release, I give no guarantees what this will do to your game/save files. Keep backups!

Important

This mod does not work with the old engine skin mods. It shouldn’t be too hard to convert them though.

Changes

1. Walking animations are now supported! (See json changes for info on how to use)
2. Character pack creation tool released! - see section below
3. Character pack zip files are now saved after import. So you can still share them after installing. (The zip files will not be changed if you modify the characters after installation.)
   • See Vampire Survivors/UserData/Bloodlines/data/Installed Packs
4. Skins are now supported and usable in game.
5. End game recap character sprite is now visible.
6. Character json file format v0.2 is out!
   • version "0.1" -> "0.2"
   • Renamed character -> characters
   • characters.skins.frames - Names of each individual walking frame
   • characters.onEveryLevelUp - A statModifier object that effects the character every level.
   • characters.statModifiers - Moved initial stats from the base character object to this array. (Should have level: 1)
   • Multiple characters in one pack is probably supported but untested :)

Character pack creation helper tool release!

The Character pack creator is a utility for helping people create packs

Just input the data you want, and hit download zip, and the character pack is created!

Mod Installation

1. Install Melonloader (This is required for all Vampire Survivors games)
2. Start the game to have melonloader fully install. (Not required if it's already installed)
3. Download and copy Bloodlines.dll into the <Vampire Survivors Location>/mods folder.
4. Start the game again to have <Vampire Survivors Location>/UserData/Bloodlines/* folders be created.
5. Install your custom character pack! Add the character zip file to <Vampire Survivors Location>/UserData/Bloodlines (Should be in the same folder as data.cfg). Do NOT extract the zip, this mod will do that for you.
   • Feel free to download Gus from this repo as an example.
6. Start the game, if you have the console enabled, you should see that bloodlines successfully imported the character and the zip file should then be deleted. If it wasn't deleted, the import wasn't successful. If you see any errors, please open an issue or ping me on discord with the console exception and everything in red text.

Skin Installation

Did you friend make a super cool custom character and they want to share it with you? All they have to do is share the character pack with you.

1. Download the zip file they send you (shared somewhere like discord)
2. copy the zip file to the <Vampire Survivors Location>/UserData/Bloodlines folder. No need to unzip
3. start the game.

Creating your own character packs!

Character packs contain two types of items:

1. A json file - This contains the character data: Starting weapon, which sprites to use, power level, etc.
2. png files - The character sprites. (These must be referenced by filename in the json file)

How to zip files together for a character pack

1. select the files you want to zip together - press ctrl + left-click each file you want, they should all be highlighted.
2. right click and select Send to > Compressed (zipped) folder
3. Rename the pack to whatever you want.
4. View the contents of the zip by opening it with windows explorer or a zip utility like 7zip.
   Note: There should be no folders in the zip file, just the json file and png files.

Known bugs/limitations

This mod is in very early in development stages, but I wanted to get testers as quickly as possible so I know what works and what doesn't with the packs and the mod.

1. Sprite scaling doesn't work in game. Keep your sprites generally around 50x50 pixels no bigger than 200x200px or they will be obnoxious in game.
2. Custom character progress isn't saved.
3. Plenty of visual bugs
   • Legionnaire's sprites don't spawn correctly

Future plans

1. Spritesheet/Sprite atlas support (With a reference json file anyway)
2. Saving character progress (eggs, cleared stages, exp gained, etc)
3. Additional animation support

Bloodlines v0.1.0

Bloodlines v0.1.0 for Vampire Survivors v1.6.108 (Public Beta)

A Custom Character importer for Vampire Survivors

Warning

This is an in-development release, I give no guarantees what this will do to your game/save files. Keep backups!

Important

This mod does not work with the old engine skin mods. It shouldn’t be too hard to convert them though.

Features

• Create custom character packs (zip files) that anyone with this mod can download and install.
• My end goal of this mod is to have custom characters as customizable as possible, while keeping it relatively intuitive to create and super simple to install.

Install

1. Install Melonloader (This is required for all Vampire Survivors games)
2. Start the game to have melonloader fully install. (Not required if it's already installed)
3. Install Bloodlines.dll
4. Start the game again to have mod's folders be created.
5. Install your custom character pack! Add the character zip file to <Vampire Survivors Location>/UserData/Bloodlines (Should be in the same folder as data.cfg). Do NOT extract the zip, this mod will do that for you.
   • Feel free to download Gus from this repo as an example.
6. Start the game, if you have the console enabled, you should see that bloodlines successfully imported the character and the zip file should then be deleted. If it wasn't deleted, the import wasn't successful.

Creating your own character packs!

Character packs contain two types of items:

1. A json file - This contains the character data: Starting weapon, which sprites to use, power level, etc.
2. png files - The character sprites. (These must be referenced by filename in the json file)

Known bugs/limitations

This mod is in very early in development stages, but I wanted to get testers as quickly as possible so I know what works and what doesn't with the packs and the mod.

1. Sprites animations are not supported yet.
2. Sprite scaling doesn't work in game. Keep your sprites generally around 50x50 pixels no bigger than 200x200px or they will be obnoxious in game.
3. Custom character progress isn't saved.
4. Plenty of visual bugs
   • End of game sprite isn't working
   • Legionnaire's sprites don't spawn correctly
5. Alternate skins aren't visible in game. (You can see them in the character select though)