Valor's Ammo Utility

Custom Ammo Utility

Currently Hytale does not easily support the use of multiple types of ammo. For example Arrows. Only the crude arrow exists, and arrow based weapons ONLY look for crude arrows in your inventory.

VAU adds the ability to easily add more Arrows, Bullets, or any kind of custom ammunition to the game. As well as helping all similar projectile items easily use that ammunition.

This mod adds 6 new interactions into the Asset Editor. Allowing you to add new ammo without needing to modify every single item that may use it.

Valor's Ammo Utiliy Github

How to use VAU, Tutorials

Example Mod

I have made a Pack as an example of how to utilize this Utility. Valor's Arrows

Contacts

If you have any questions, bug reports, or just need to contact me. Please message me on discord , my username is "whatahooda"

Using VAU Interactions

Weapons or Items that Use Ammo

Weapons or Items that will be using custom ammo will need these interactions to function and support them.

NOTE Any weapons/items that reload or store ammo before firing are not currently supported. I will be working to support reloading in a future version.

1) AmmoModifyInventory

Use this Interaction when looking for ammunition in the player inventory. You must specifiy Ammo Tags to look for in an item under Tags To Find. This will check against ALL tags on an item.

For example, base arrows have Keys "Type" and "Family", with "Arrow" under "Family". You can simply add "Arrow" as a tag to find for your interaction. Or you can add new tags if you want to be more specific.

2) AmmoProjectile

AmmoProjectile will create a new projectile using information from the ammo consumed in AmmoModifyInventory. Treat this as a Projectile interaction, needing a Projectile Config to create your projectile.

3) AmmoOnHit & AmmoOnMiss

These interactions MUST be added into the projectile configs OnHit or OnMiss interactions to apply the ammo interaction effects. These can be added directly into the projectile config, or into later interactions such as DamageEntityParent.

4) AmmoDespawn

This must be used to despawn the ammo projectile, instead of using the RemoveEntity interaction. This is needed due to a strange bug where interaction Effects won't trigger. I personally override Common_Projectile_Despawn and instert AmmoDespawn instead of RemoveEntity.

Ammo Items

These are the items that will be used as ammo. You will need to add a new tag, and some interactions for onHit and onMiss effects.

1) Ammo Tag

All ammo must contain some tag to identify it as such. This can be an existing tag on the item, or you can create a new tag under any Tag Key. These will be checked for by the AmmoModifyInventory interaction.

2) Ammo Info Var

Under the Ammo Item's Interaction Vars, you must create a new var that points to a AmmoInfo interaction. This is what holds your projectile model Id, on miss and on hit interaction Ids.

The On Hit and Miss interaction Ids must point to RootInteractions which contain your desired on hit or miss effects. This can be extra damage, VFX, or anything you can achieve through interactions.

Cross Mod and Multi Item Support

After setting up your projectile item, it should support and use any item with the ammo tag it searches for. This includes other mods that add ammunition of a similar type.

Currently the only issue is supporting vanilla items, as you need to override or patch these items to support using multiple ammo types. Which could possibly lead to issue if multiple mods attempt to override the same item.

Otherwise, new custom projectile weapons/items should be able to use other modded ammunition that utilizes VAU. As long as their Ammo Tag is the same.