[MOD] Gun's GT Mod v1.0 ( a Lua-based mod for Gifting / Trading items in Victor Vran )

[gunpitchon]

Introduction

There have been many requests for trading in online co-op so I am releasing a mod that will allow players to gift items to one another.

• Hopefully this will allow some of you to share resources with one another and help each other with creating builds that have taken too long to grind in the past.
  
• It is also now possible to help your friends who are new to the game get started more quickly if you are already a veteran player with lots of loot to spare ( and noone to give to in the past ).
  
• The ability to share your loot will now make it much more meaningful for players to form parties to hunt bounties, search for treasure hunts and secrets, and do challenges together. Hopefully this will revive some interest in the co-op aspect of the game, something that makes Victor Vran such a great ARPG.

I sincerely request that everyone use this mod responsibly, in the spirit of giving, sharing and non-exploitation, to promote and encourage multiplayer interaction among the community.

Hope this mod benefits your gameplay and let you enjoy this game better with family and friends.

Installation and Usage

1. Download the mod file (see section Download Details below).
   
   
2. Place the downloaded mod file ( gtmod.hpk ) into Victor Vran's DLC folder. If you do not know where this is, open the Properties page of the game from your Steam client, select the LOCAL FILES tab, and click on the BROWSE LOCAL FILES button. This will open an Explorer window on your desktop where you can see the DLC folder.
   
   
3. Launch the game.
   
   
4. Select the items that you wish to gift to other players in the same map ( or hub ), and mark them as Favorite ( by pressing S on the keyboard, or by pushing in the left thumbstick on an Xbox controller ).
   
   
5. Sell the marked items to a vendor ( i.e.
   
   • Damian / Irene / Casimir at Castle Zagore, or
     
   • Geban at Cemetery Grounds / Merchant Quarters / Bottomless Pit / Cauldron of Chaos / Fractured World Hub, or
     
   • Geban / Lloyd at Motorhead Pub
     
   and they should drop as loot for any other players with this mod in the same map ( or hub ).
   
   NOTE: Players must be on the same map ( or hub ) as the gifter in order to receive any items.
   
   NOTE: Motorhead DLC items ( Guitars and Pistols ) can only be gifted at the Motorhead Pub, while Talisman DLC items ( i.e. Talismans ) can only be gifted at the Fractured World Hub. This is to prevent anyone from gifting DLC items to another player without them.
   
   NOTE: Items that are gifted with this mod will also no longer be available for buyback at the vendor, since they are meant to be given away.

Additional Requirements( with effect from 4th November 2019 )

With effect from 4th November 2019, users with the Steam version of Victor Vran Motorhead DLC will need to roll back to the previous build of Motorhead DLC in order for this trading mod to function. Please refer to the forum discussion below for the background history and detailed explanation of this issue.

At the moment, this issue is limited to users with the 4th November update of Motorhead DLC. Steam users without Motorhead DLC and all GOG versions of the game are not affected and do NOT require any roll back.

How to Roll Back to the Previous Build of Motorhead DLC on Steam

NOTE: These instructions for rolling back are only applicable to Steam users with Motorhead DLC who have applied the 4th November 2019 update.

To download a previous build of Motorhead DLC, follow the steps in the Steam Community Guide below:

How to Download Older Versions of a Steam Game (by Aevoa)

Motorhead App ID: 345180
Motorhead Depot ID: 462290
Motorhead Manifest ID: 5052358866078023302

1. Find and Download the Appropriate Motorhead Depot from Steam Console

Type the following command in the Steam Console: download_depot 345180 462290 5052358866078023302

OR

Alternatively, to open the Steam Console directly from Windows, you can also type in the following command from Windows command prompt: Start Steam://nav/console

And then type the following command in the Steam Console: download_depot 345180 462290 5052358866078023302

2. Move or Copy the Downloaded HPK File to Victor Vran's DLC Folder

After the download has completed, look for the motorhead.hpk file in the following directory:

<steam_dir>\SteamApps\content\app_345180\depot_462290\DLC

Be sure to backup the Nov 4th copy of motorhead.hpk before replacing it with the one you just downloaded. The Motorhead DLC is located in:

<steam_dir>\SteamApps\common\Victor Vran\DLC

FAQ

Q: Can I trade with friends who have not installed this mod?
A: No, only players who are using this same mod can trade with one another.

Q: Can I remove this mod after I have installed it?
A: Yes, simply delete the gtmod.hpk file from Victor Vran's DLC folder.

Q: Does this mod modify or change the file format of my saved games?
A: No. This mod does not make any changes to the current save file format.

Q: Does this mod work with the Motorhead and Talisman ( Fractured World ) DLCs?
A: Yes. However, do take note that you will only be able to gift or trade Talismans while you are at the Fractured World hub, and similarly, Guitars and Pistols can only be gifted or traded at the Motorhead pub.

Q: What can be gifted or traded through this mod?
A: Weapons, Potions, Bombs, Demon Powers, Destiny Cards, Power Stones, and Talismans.

Q: Why do I need to mark items as Favorites before gifting them?
A: This is a feature to prevent anyone from spamming their friends with unwanted loot when they do "Sell All" at a vendor. When you are using this mod, any item not marked as Favorite will not be gifted out but sold as per norm.

Q: Can I choose to gift an item to only one player in a room if there other players around?
A: No, any player with this mod will receive the item given out if they are in the same map ( or hub ) as the seller. However, you can invite your friends into a private game and trade just amongst yourselves if you wish.

Q: What if I gift or send the wrong item to my friend?
A: Try asking your friend to give it back to you?

Q: Does this mod work in Local Co-op mode?
A: You can use the in-game Private Stash to trade items between players in Local Co-op mode. There is no need to use this mod.

Q: Will this mod work with the GOG version of the game?
A: Yes, the mod will work on both the Steam and GOG versions of the game. Players on Steam will also be able to trade with players on GOG and vice-versa. Credits to evil, Sir Tomato, RicziO2 and others who have tested and reported their findings.

Q: Will this mod work on Linux and MacOS?
As far as I know, this mod has not been tested on Linux and MacOS. If you own Victor Vran on these platforms, you are welcome to try this out and let us all know. Thanks in advance.

Q: Will you continue to update this mod in future?
A: As long as I am still playing this game, I don't see why not. At the same time, I have no objections to anyone wishing to use or copy the code within for their own mods. In fact, I am hoping that the release of this mod will encourage more players to try their hand at creating mods for this game. For this reason, I have packaged this mod in plain text Lua files so anyone who is familiar with modding tools for similar games like Tropico or Surviving Mars will have no trouble retrieving the source code.

Download Details

Filename: gtmod.hpk
Version: 1.0
Date: 1-May-2019
Size: 1552 bytes
Checksums:
MD-5: A51784AA86E1AFD8F311B3B041E44B38
SHA-256: 3D93F4FCB910A17275CAD45558D85241B0DCA6EEBAE1626496C2B0379DE3BF90
VirusTotal Scan Report [www.virustotal.com]

Google Drive Download[drive.google.com]

[Sir.Tomato]

Thank you for the great modification :P. I own both Steam and GOG versions, so i will be happy to test it with both versions. Gunpitchon, feel free to add me to test it with the GOG release if you feel like it. Of course the offer for testing is open to whoever is interested as well.

cheers and happy gaming :P

[gunpitchon]

Thanks for your offer to test the mod on GOG. I am in offline mode most of the time but I'll see if I can host a game or two online later today. Feel free to join if you are available. Your feedback is most welcome. Cheers Bro.

[Sir.Tomato]

So gunpitchon and i just tested the mod with my GOG version and his Steam version of the game. The Mod works like a charm. Trading is fast, easy and very fluid. Awesome job gun!!!!! We tested it with trading demons powers, weapons, and talismans. So friends, LETS TRADE :D

[Riczio2]

Mod looks like is not working anymore, i making everything like in the description with my friend but it not work.

EDIT: ok i can confirm that, i tested with SirTomato on Steam version of the game and its not working. I can get items if someone playing on gog version but i can't drop nothing.

[gunpitchon]

Originally posted by RicziO2:

Mod looks like is not working anymore, i making everything like in the description with my friend but it not work.

EDIT: ok i can confirm that, i tested with SirTomato on Steam version of the game and its not working. I can get items if someone playing on gog version but i can't drop nothing.

RicziO2, thanks for reporting this and for testing the mod together with SirTomato. Your feedback has given me a good starting point for troubleshooting the issue.

Here's the good and bad news:

BAD NEWS:

1. The latest update of Victor Vran on November 4th did break the Steam version of the mod.

2. This is not something I can fix, and here's the reason why:

With the Nov 4th update, you can no longer replace existing functions in the game through mods. GT Mod works by patching( i.e. replacing ) and extending the SellItem function of the BuyBackVendor. This is no longer possible since the update now blocks the ability to patch any existing function.

3. I do not know if the above is intended by the developers, or if it is a bug in the update. We will need clarification from a developer regarding this. From my own testing, I have found this issue to be related to the Nov 4th update to Motorhead DLC.

GOOD NEWS:

1. The good news is that the existing gtmod.hpk will work if you roll back to the previous build of Motorhead DLC. No changes are required for the gtmod.hpk file.

2. To download a previous build of Motorhead DLC, follow the steps in the Steam Community Guide below:

How to Download Older Versions of a Steam Game (by Aevoa)

Motorhead App ID: 345180
Motorhead Depot ID: 462290
Motorhead Manifest ID: 5052358866078023302

Type the following command in the Steam Console: download_depot 345180 462290 5052358866078023302

OR

3. Alternatively, if you wish to open the Steam Console directly from Windows, you can also type in the following command from Windows command prompt: Start Steam://nav/console

And then type the following command in the Steam Console: download_depot 345180 462290 5052358866078023302

4. After the download has completed, look for the motorhead.hpk file in the following directory:

<steam_dir>\SteamApps\content\app_345180\depot_462290\DLC

5. Be sure to backup the Nov 4th copy of motorhead.hpk before replacing it with the one you just downloaded. The Motorhead DLC is located in:

<steam_dir>\SteamApps\common\Victor Vran\DLC

Happy Thanksgiving and have fun trading!

[evil]

Hey gunpitchon,
so I did some testing, seems there is a very easy fix for your mod. Just add a file named revisions.lua with contents "return 240888, 42382" and repack it. It works again.

[gunpitchon]

Originally posted by evil:

Hey gunpitchon,
so I did some testing, seems there is a very easy fix for your mod. Just add a file named revisions.lua with contents "return 240888, 42382" and repack it. It works again. :squirtyay:

@evil
Thanks for your reply. I have tried your suggestion( revisions.lua with "return 240888, 42382" ) but unfortunately without success. I also tested similarly with revisions.lua containing "return 250742, 42384" which did not work as well. My debug log shows( in both cases ):

1. autorun.lua was loaded
2. all local and public function calls ran and terminated successfully except for BuyBackVendor:SellItem()
3. replacing BuyBackVendor:SellItem() with SellVendorItem() or even OnMsg.VendorTransaction() also fails similarly

Currently, the only way I could make the mod work is to rollback to previous Motorhead build.

Could you post or send your copy of the HPK file that works? Thank you very much.

[Sir.Tomato]

Thank you gunpitchon for trying :). I really appriciate it :).

[evil]

Okay, sorry about that. It seems I was too hasty and it was working because I had modified the motorhead.hpk to also have that revision number, then forgot to revert it. Actually that is somehow the real problem, nothing else has changed in the package. Also one other suggestion I've got is that any code should be loaded and run if its in a Lua.hpk that is packed as a DLC\whatever.hpk but couldn't make it work either. I'll see if we can do something else.

[gunpitchon]

Originally posted by Sir.Tomato:

Thank you gunpitchon for trying :). I really appriciate it :).

Thanks to you as well for testing the mod with RicziO2. I appreciate it.

[gunpitchon]

Originally posted by evil:

Okay, sorry about that. It seems I was too hasty and it was working because I had modified the motorhead.hpk to also have that revision number, then forgot to revert it. Actually that is somehow the real problem, nothing else has changed in the package. Also one other suggestion I've got is that any code should be loaded and run if its in a Lua.hpk that is packed as a DLC\whatever.hpk but couldn't make it work either. I'll see if we can do something else.

@evil
Thanks for your reply and for your assistance. Much appreciated.

I tried both your suggestions. Here are the results:

1. Pack autorun.lua as gtmod.lua into a Lua.hpk, and then packed the Lua.hpk into DLC\gtmod.hpk. This did not work on my side as well.

2. Repacked Nov 4th motorhead.hpk with revisions.lua containing "return 240888, 42382". The mod worked as you described, with no other changes to the Nov 4th motorhead.hpk, and no changes to gtmod.hpk as well.

3. Repacked Nov 4th talisman.hpk similarly as above. Mod did not work. So this problem seems to be related to motorhead.hpk only and no other dlc.

Not sure if this is helpful, but point 2 seems to indicate that there is some conditional code execution looking at lua_revision or asset_revision( that is either unloading or overwriting dlc lua ) which did not trigger in previous builds, but somehow got triggered by the latest revision numbers in motorhead.

[lukeh_ro]

gun, I'm not sure I understood...does the mods not load at all for you with latest motorhead or it does but not work?
For now I noticed that, strangely.... "return 250742, 42384, 42384, 42384" in mod's revisions.lua makes it load (4 values, not 2, not 3) without reverting to previous version of motorhead.
Look me up on discord to talk more about this...

[Thoscho]

Hello,

me and a buddy of mine wanted to try the trading function, especially since a few items have almost impossible low drop rates. But when I try to download it via the guide or when I manually look for the second last version of the Motorhead DLC, it seems it no longer is available for download.
If I try it via Steam console I get this error message:

download_depot 345180 462290 5052358866078023302
Depot download failed : Manifest not available

Any way to get the second last patch of the Motorhead DLC somewhere, so trading can be done?

[lukeh_ro]

Thoscho, you don't need to do that anymore. Try my manager (loader) https://www.nexusmods.com/victorvran/mods/1?tab=files
The version in "update" should support mods as hpk but I didn't tested it myself with gun's mods. The main version was tested with this mod but I unpacked the mod first, without the need to rollback motorhead.

[Riczio2]

Its not working again?