Skip to content
This repository has been archived by the owner on Oct 21, 2023. It is now read-only.

Bloodlines v0.2.1 - Alpha Release

Latest
Compare
Choose a tag to compare
@nwfistere nwfistere released this 28 Aug 13:08
· 4 commits to main since this release
70331a1

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