Subscribe to download
[VScript] Custom Survivor Takeover

(This mod is not for spawning survivors)

This script tries to help with converting survivor skin replacers into their own survivor.
By changing the name and model of existing in-game survivors to custom ones at the start of the map, or manually.

I included the 4 Arcade survivors' custom models to use with this script to test. (with small edits to their qc files)
(Blake, Yusuke, Sara, and Haruka. Ports by Tiny King Trashmouth, AvengedDeathAlert, and FallFox)
Probably need to restart the game to see them though.

In the default settings, they are currently trying to takeover any clone survivors at the start.
So if you don't spawn clone survivors, you won't have any of the Arcade survivors.
But you can change that in the settings. You can set them to takeover random or specific survivors.
More info here:
https://steamhost.cn/steamcommunity_com/workshop/filedetails/discussion/3521730239/592902428426243132/

If you want to spawn survivors manually in the middle of the round and not at the start, then you have to do !takeover after that. (It only works if there are no custom survivors around, and there are valid targets to takeover)

==========================================================================

VScript Survivor Manager (VSSM) by Shadowysn is optional but recommended for spawning survivors.
Also for fixing many bugs (for example: fixUpgradePacks, restoreExtraSurvsItemsOnTransition, fixDefibrillator, etc...)
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=3006216183

Since the default settings have the Arcade survivors set to takeover clone survivors, you can try survCount = 12 in the VSSM settings, to see if the Arcade survivor skins takeover the 4 extra clones, and exist along with the 8 vanilla survivors.
Here is more info for the VSSM settings:
https://steamhost.cn/steamcommunity_com/workshop/filedetails/discussion/3006216183/7222135514705252606/

==========================================================================

Issues that keep me up at night:

• Not sure if this script is ready, needs more testing
  
• Custom survivors have no vgui and invisible first person viewmodel arms. Also no voice and emotions.
  
• So if you want to play as a custom character, third person is recommended.
  
• When you play as a custom character, portrait will be wrong.
  
• Sometimes the HUD didn't update and they will have wrong portraits
  
• Sometimes their weapon is not at the right attachment point.
  
• Maybe the model will revert when a player joins, leaves, or goes idle. Couldn't test that by myself.
  
• Multiplayer not recommended because players without the assets will just see ERROR.mdl.
  
• Also because guests with a different model list than the host will crash, because not precached. but that's just a theory
  
• Takeover would need to wait until cutscene is done before changing models
  
• VSSM can't !survswap to the custom suvivors
  
• I think when a survivor is talking halfway, and then changed to a custom skin, they will still continue with that voice until done. But I dont think they will have any voice again after that.
  
• wrong fall scream voice like in the xbox version
  
• Rarely crashing when trying to save persistent data (when saferoom transition) or restore persistent data (when restarting map)? idk too random
  
• char num 8 can't be defibbed? i dont get it
  
• survivor ragdolls not supported, idk how
  
• Sourcemod survivor spawners maybe wont work because of identity fix, or they spawn later than the auto takeover. idk yet

==========================================================================

You can also add more characters by editing other survivor replacer mods (like Shrek or Garfield for example)
Not a good tutorial:
https://steamhost.cn/steamcommunity_com/workshop/filedetails/discussion/3521730239/592902428426252787/

==========================================================================

Credits:

• VSCode - IDE
  
• marcinbar - VSCode Squirrel Ext
  
• Cold Front Mike code reference
  
• Taito - Arcade Survivors
  
• Theuaredead', 1cc - Arcade Survivor Assets
  
• Tiny King Trashmouth - Yusuke Port
  
• AvengedDeathAlert - Blake Port
  
• FallFox - Sara and Haruka Port