Mods / Grenades!

Tags: #Technology #Weapons
Authors: LubieKakao1212, MrFlame
Side: Both
Created: Feb 10th 2025 at 12:48 PM
Last modified: Dec 22nd 2025 at 11:40 AM
Downloads: 3446
Follow Unfollow 77

Recommended download (for Vintage Story 1.21.0 - 1.21.6):
Grenades-v1.2.3.zip  1-click install


Version 1.2.0 changed how the config works, old config files will not work

 

A mod which adds throwable, explosive grenades.

Types of grenades:

  • Jug Bombs - Low damage with large blast radius
  • Jug Fire and Oil Bombs - Almost no direct damage but leaves flaming pieces on the ground
  • Glass Grenades - Medium damage with medium blast radius
  • Metal Grenades - High damage with low blast radius, damage depends on type of metal used

 

Grenade explosions do NOT destroy blocks, so they are safe to use at home : )

 

This mod may be a bit under/over-powered, balance needs testing.

If you have suggestions regarding balansing or anything else, feel free to post it.

 

 

How to tweak the config
This is an example config with additional comments, just don't use comments in your final config as they seem cause the json to not load properly.

 

{
  "overrides": [
    { // Override the damage of "blue" grenades [glass, jug bomb, jug fire bomb, jug oil bomb]
      "Key": "*blue*",
      "Value": {
        "damage": 100
      }
    },
    { // Override the damage, radius, and knockback of all grenades jug bombs
      "Key": "jug-bomb-*-standard",
      "Value": {
        "damage": 1, // Won't apply for jug-bomb-blue-standard because its damage was changed in the previous override
        "radius": 1,
        "knockback": 10
      }
    },
    { // Disable shrapnel of metal grenades
      "Key": "*-metal-*",
      "Value": {
        "shrapnel": {
          "enabled": false
        }
      }
    },
    { // Enable shrapnel for glass grenades (yes you can do that), and lower the fuse time
      "Key": "*-metal-*",
      "Value": {
        "fuse": 0.5,
        "shrapnel": {
          "enabled": true, // You most likely want to set all the parameters since they are not set for glass grenades
          "damage": 30,
          "amount": {
            "value": 32,
            "randomness": 2
          },
          "lifetime": {
            "value": 1,
            "randomness": 0.1
          },
          "velocity": {
            "value": 10,
            "randomness": 5
          },
          "velocityInheritance": 10,
          "directionPitchMin": -90,
          "directionPitchMax": 90
        }
      }
    },
    { // Reference of all the configurable values (Default values are in the item files on the repo)
      "Key": "*",
      "Value": {
        "fuse": 2, // Fuse time, in seconds
        "radius": 6, // Explosion radius, in blocks
        "innerRadius": 0.7, // Peak damage radius as a ratio of total radius, must be in range [0, 1]
        "damage": 9.5, // Peak damage
        "damageTier": 2, // Damage tier
        "knockback": 1, // Knockback
        "launchForce": 12, // Velocity of the grenade after throwing, in blocks per second
        "shrapnel": { //Regarding shrapnel
          "enabled": true, // Enable/Disable for shrapnel
          "damage": 2, // Damage dealt by the shrapnel pieces, damage per "tick" for flames
          "amount": { // Amount of shrapnel pieces
            "value": 8,
            "randomness": 2
          }, // Final Value is in range [value - randomness, value + randomness]
          "lifetime": { // Time until a piece despawns, in seconds
            "value": 1,
            "randomness": 0.1
          }, // Final Value is in range [value - randomness, value + randomness]
          "velocity": { // Speed of launched pieces, in blocks per second
            "value": 20,
            "randomness": 5
          }, // Final Value is in range [value - randomness, value + randomness]
          "velocityInheritance": 1, // How much the velocity of the shrapnel is affected by the velocity of the grenade at the time of detonation
          "directionPitchMin": -45, //Minimum allowed angle form the XZ plane at which the shrapnel will be launched
          "directionPitchMax": 45 //Maximum allowed angle form the XZ plane at which the shrapnel will be launched
        }
      }
    }
  ]
}

 

How to tweak the config (Old, before 1.2.0)
This is an example config with additional comments, just don't use comments in your final config as they seem cause the json to not load properly.

 

{
  "damage": [
    {
      //You can use wildcards in keys
      "Key": "jug-bomb-*",
      "Value": 3.0
    }
  ],
  "damageTier": [],
  "radius": [],
  "fullDamageRadius": [],
  "fuse": [
    {
      //Changes fuse of all grenades to 3s
      "Key": "*",
      "Value": 3.0
    }
  ],
  //entries are checked from top to bottom
  "throwingForce": [
    {
      //Changes the throwing force of gold grenade (this is a very large value)
      "Key": "*-metal-gold",
      "Value": 1
    },
    {
      //Changes the throwing force of every other metal grenade except gold (gold was already assigned a value of 1 in the previous entry)
      "Key": "*-metal-*",
      "Value": 0.25
    }
  ]
}

 

Known issues:

Game not loading when config was changed Fixed in 1.2.1

 

Thats a terrible thumbnail, I know : (

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.2.3 grenades
1.21.0 - 1.21.6
541 Dec 22nd 2025 at 11:40 AM Grenades-v1.2.3.zip 1-click install

Balance changes - Metal grenades are more wothwile

Added balance compatibility with smithing plus

 

  • All metal grenades recived a damage buff:
    • Copper:  8 -> 11
    • Bronze: 9 -> 15
    • Iron: 10 -> 20
    • Meteoric iron: 10.5 -> 22
    • Steel damage -> 12 -> 30
    • "Holy" grenades -> 9.5 -> 29
  • Jug Fire/Oil Bomb ember damage: 2 -> 1
  • Affected area radius of "Holy" grenades also recived a buff:
    • 6 -> 10
  • "Holy" grenade casing amont/ingot: 8 -> 1
  • Other metal grenades casing amount/ingot:
    • With Smithing Plus: 8-> 6
      • Changed to accomodate for bit refund when using "split"
    • Without Smithing Plus: no change (8)
  • Glass grenade crafting:
    • Yield: 1 -> 6
    • Blasting powder: 1 -> 4
1.2.2 grenades
1.21.2 - 1.21.4
687 Oct 7th 2025 at 8:05 PM Grenades-v1.2.2.zip 1-click install

Updated to 1.21.x (thanks MrFlame)

added creative tab

added more translations

1.2.1 grenades
816 Jul 14th 2025 at 10:37 PM Grenades-v1.2.1.zip 1-click install

Fixed config crash

1.2.0 grenades
32 Jul 14th 2025 at 8:14 PM Grenades-v1.2.0.zip 1-click install

1.2.0
- Added shrapnel (and flame)
- Added "Jug Fire Bomb" and "Jug Oil Bomb" (may be unbalanced)
- Tweaked throwing range (may be unbalanced)
- Rewritten Config (old config files will NOT work!!!)

1.1.0 grenades
892 Feb 13th 2025 at 2:34 PM Grenades-v1.1.0.zip 1-click install

Added config

1.0.4 grenades
114 Feb 12th 2025 at 6:38 PM Grenades-v1.0.4.zip 1-click install

Lowered particle count and duration

1.0.3 grenades
103 Feb 11th 2025 at 6:12 PM Grenades-v1.0.3.zip 1-click install

Apparently previous version had a game breaking bug, so that is fixed now

1.0.2 grenades
59 Feb 11th 2025 at 3:11 PM Grenades-v1.0.2.zip 1-click install

Fixed grenades not doing correct damage on direct hits

1.0.1 grenades
62 Feb 11th 2025 at 11:41 AM Grenades-v1.0.1.zip 1-click install

Grenades now deal much more damage:

  • Jug Bomb: 3 -> 5 (Kills Chickens and Hares)
  • Glass: 4.5 -> 6.5
  • Copper: 5.5 -> 8
  • Bronze: 6.5 -> 9
  • Iron: 7.5 -> 10
  • Meteoric Iron: 8.5- > 10.5
  • Steel -> 12 (Kills Surface Drifter)

Improveed damage calculations, should be more consistent

Known Issues:

  • Damage delt is still inconsistent on direct hits (maybe also on indirect ones)
1.0.0 grenades
140 Feb 10th 2025 at 12:59 PM Empty Grenades-v1.zip 1-click install

33 Comments (oldest first | newest first)

livetonFNV, Dec 16th 2025 at 8:19 AM

@LubieKakao1212 I saw a comment that said "Grenades current damage values seem low except if used in a player vs player setting" and misremebered and thought it was your account that said it, the PVE scaling was regarding this comment.

I made those damage numbers well before I actually got to use the mod as I was testing them out in a solo world to see if I wanted to grab the mod and just wanted to see what the configuration could do so the damage values are a bit ridicoulus after thinking on and actually playing it. I love the mod and would love to help make it better in anyway that I could.

 

I've sent a discord freind request to the account of the same name (LubieKakao1212) on discord if that is correct the request will be from a "livetonFNV".

If it didn't work can you post a direct link to your discord here?

LubieKakao1212 , Dec 15th 2025 at 8:24 PM

livetonFNV thanks for feedback.

I don't fully understand what you mean by "file with PVE scalable damage", but regarding the damage value changes, I will consider a general buff but the exactchanges you propose are a bit extreme compering to current values I will have to think more about it.

Also the gold, silver and electrum grenades are intended more as an easter egg/reference then a real tier, and I deffinitly don't think they should be more powerfull then steel.

 

If you want to elaborate on that discussion, you can message me on discord

livetonFNV, Dec 15th 2025 at 11:27 AM

Can you possible make an additonal file with a PVE scalable damage as we are playing on a server hosting platform and in turn can't adjust the config file for some reason. I really want to like this mod but as it stands the golden grenade does like 4 damage more than thrown copper spear. I've adjust the damage (Maybe a bit overtuned on the higher end but the damage on the lower tiers of the grenades are still much better). I would greatly appreciate this change and would be willing to help further if it's needed:

 

jug-bomb.json:

Spoiler
{
    code: "jug-bomb",
class: "grenades.ThrownExplosive",
creativeinventory: { "general": ["*"], "construction": ["*"], "grenades": ["*"] },
    shape: { base: "item/jug-bomb" },
maxStackSize: 16,
    variantgroups: [
{ code: "color", states: ["blue", "fire", "black", "brown", "cream", "gray", "orange", "red", "tan", ] },
{ code: "type", states: ["standard", /*"fragment",*/ "fire", "fire-2"] }
],
    textures: {
        ceramic: {
            "base": "game:block/clay/hardened/{color}",
            "blendedOverlaysByType": {
"*-fire": [
{ base: "game:block/clay/overlay/jug", blendmode: "Normal" },
{ base: "overlay/jug-fire", blendmode: "Multiply" }
],
"*-fire-2": [
{ base: "game:block/clay/overlay/jug", blendmode: "Normal" },
{ base: "overlay/jug-oil", blendmode: "Multiply" }
],
"*-fragment": [
{ base: "game:block/clay/overlay/jug", blendmode: "Normal" }
],
"*": [
{ base: "game:block/clay/overlay/jug", blendmode: "Normal" }
]
}
        }
},
    attributes: {
explosive: {
fuse: 2,
damageByType: {
"*-standard": 20,
"*-fragment": 5,
"*-fire*": 5
},
damageTier: 1,
radiusByType: {
"*-standard": 5,
"*-fragment": 7,
"*-fire*": 7
},
innerRadius: 0.7,
knockbackByType: {
"*-standard": 5,
"*-fragment": 0.3,
"*-fire*": 0
},
launchForce: 20,
shrapnel: {
enabledByType: {
"*-standard": false,
"*-fragment": true,
"*-fire*": true
},
damageByType: {
"*-fire":5,
"*-fire-2": 2,
"*-fragment": 4,
"*": 0
},
damageTier: 1,
amount: {
value: 24,
randomness: 6
},
lifetime: {
valueByType: {
"*-fire": 5,
"*-fire-2": 15,
},
randomness: 1
},
velocityInheritance: 1.5,
velocity: {
value: 5,
randomness: 2.5
},
directionPitchMin: 30,
directionPitchMax: 90
}
},
projectileByType: {
"*-fire*" : "jug-bomb-{color}-flame",
"*": "jug-bomb-{color}-fragment"
}
    },
    guiTransform: {
translation: { x: 2, y: 4, z: 0 },
rotation: { x: 180, y: 42, z: -42 },
origin: { x: 0.5, y: 0.27, z: 0.5 },
scale: 1.86
},
"fpHandTransform": {
rotation: { x: -19, y: -45, z: 0 },
scale: 1.2
},
tpHandTransform: {
translation: { x: -1.1, y: -0.8, z: -1 },
rotation: { x: 0, y: 0, z: -89 },
origin: { x: 0.5, y: 0.25, z: 0.5 },
scale: 0.5
},
groundTransform: {
scale: 2.5
}
}

 

grenade.json:

Spoiler
{
    code: "grenade",
class: "grenades.ThrownExplosive",
variantgroups: [
{
code: "glass",
states: ["metal", "plain", "quartz", "green", "blue", "violet", "red", "yellow", "brown", "vintage", "smoky", "pink" ]
},
{
code: "metal",
states: ["glass", "copper", "tinbronze", "bismuthbronze", "blackbronze", "gold", "silver", "iron", "meteoriciron", "steel", "electrum" ]
}
],
skipVariants: [
    "*-metal-glass"
],
allowedVariants: [
"*-metal-*",
"*-glass",
],
creativeinventory: { "general": ["*"], "construction": ["*"], "grenades": ["*"] },
attributes: {
        projectile: "grenades:grenade-{glass}-{metal}",
explosive: {
fuse: 2,
radiusByType: {
"*-glass": 6.5,
"*-copper": 5,
"*-*bronze": 5,
"*-iron": 5,
"*-meteoriciron": 5.5,
"*-steel": 5.5,
"*-gold": 6,
"*-silver": 6,
"*-electrum": 10
},
innerRadius: 0.7,
damageByType: {
"*-glass": 25,
"*-copper": 30,
"*-*bronze": 35,
"*-iron": 40,
"*-meteoriciron": 55,
"*-steel": 65,
"*-gold": 80,
"*-silver": 75,
"*-electrum": 100
},
damageTierByType: {
"*-glass": 2,
"*-copper": 1,
"*-*bronze": 2,
"*-iron": 3,
"*-meteoriciron": 3,
"*-steel": 4,
"*-gold": 2,
"*-silver": 2,
"*-electrum": 2
},
knockbackByType: {
"*-glass*": 1.5,
"*": 1
},
launchForceByType: {
"*-glass*": 20,
"*": 12
},
 
shrapnel: {
enabledByType: {
"*-glass*": false,
"*": true
},
damageByType: {
"*-copper": 4,
"*-*bronze": 4.5,
"*-iron": 5,
"*-meteoriciron": 5.25,
"*-steel": 6,
"*-gold": 2,
"*-silver": 2,
"*-electrum": 2
},
amount: {
value: 8,
randomness: 2
},
lifetime: {
value: 1,
randomness: 0.1
},
velocity: {
value: 20,
randomness: 5
},
velocityInheritance: 1,
directionPitchMin: -45,
directionPitchMax: 45,
}
}
    },
    shape: { base: "item/glass-grenade" },
textures: {
casing: {
baseByType: {
"*-metal-*": "game:block/metal/ingot/{metal}",
"*-glass": "game:block/glass/{glass}",
}
},
},
maxStackSize: 16,
    guiTransform: {
translation: { x: 2, y: 0, z: 0 },
rotation: { x: 142, y: -12, z: -13 },
origin: { x: 0.5, y: 0.27, z: 0.5 },
scale: 2.52
},
"fpHandTransform": {
rotation: { x: -19, y: -45, z: 0 },
scale: 1.2
},
tpHandTransform: {
translation: { x: -1.1, y: -0.8, z: -1 },
rotation: { x: 0, y: 0, z: -89 },
origin: { x: 0.5, y: 0.25, z: 0.5 },
scale: 0.5
},
groundTransform: {
translation: { x: 0, y: 0, z: 0 },
rotation: { x: 0, y: 0, z: 0 },
origin: { x: 0.5, y: -0, z: 0.5 },
scale: 4
}
}
LubieKakao1212 , Jul 15th 2025 at 2:55 PM

SovietSwede

Recipes are available in the handbook, and stats are in item tooltips.

SovietSwede, Jul 15th 2025 at 12:15 PM

Hey!
Looks like a great mod!

would you mind posting the recipes and damage values here on the mod page? 

AgentOfChaos, Jul 15th 2025 at 4:07 AM

thanks for the update man!

Maxilos33, Apr 26th 2025 at 8:44 PM

I figured the problem out, the small and medium explosion sound files are in stereo, while the large explosion in in mono wich lets it sound correctly. just convert the sounds to mono and it will behave as intended

 

Maxilos33, Apr 20th 2025 at 2:52 AM

The medium and small explosion sounds seem to always play on the player position. they dont get quieter nor can you make out the direction where they are coming from, whereas the large explosion sound does seem to be placed correctly in the world but seems to be just very quiet and is very underwhelming. otherwise great mod, feels like something that should have been in the base game to begin with.

also the mod works otherwise fine on 1.20.7

LubieKakao1212 , Apr 18th 2025 at 3:31 PM

AgentOfChaos

Haven't tested it on that version yet

You can try it anyway (It shouldn't break anything)

 

I will test it when I will have time, however I currently have a lot of personal stuff to sort out

 

If you decide to try it, I would appreciate if you report any issues you encounter (if any)

AgentOfChaos, Apr 18th 2025 at 6:41 AM

does it work on 1.20.4?

 

Fred_Undead, Mar 7th 2025 at 2:59 PM

Wonderful mod i needed more ranged options and this is perfect !

LubieKakao1212 , Feb 20th 2025 at 5:03 PM

LunaGore

Block destruction is currently not implemented at all, however it is o my roadmap for when I have time.

Sorry

LunaGore, Feb 19th 2025 at 6:34 PM

I know you said you won't be adding anymore features for awhile but I'd like a config option (if there isn't already one) to toggle block destruction similar to current bombs.

DUCATISLO, Feb 15th 2025 at 7:06 PM

based

LubieKakao1212 , Feb 14th 2025 at 10:24 AM

I have to take a break from adding features to this mod, I have another mod in the works. After that I have university, so less time.

I will still do bugfixes though.

Sorry : (

LubieKakao1212 , Feb 14th 2025 at 10:20 AM

zackadiax24

I will consider it.

LubieKakao1212 , Feb 14th 2025 at 10:19 AM

012phuong

I like both ideas.

zackadiax24, Feb 14th 2025 at 1:24 AM

Any chance of some mining grenades? not having to set up bombs in exchange for a smaller blast radius would be nice.

LubieKakao1212 , Feb 13th 2025 at 3:14 PM

Ourcasula

I added a config file

012phuong, Feb 13th 2025 at 10:54 AM

Awesome mod mate! The grenade works wonderfully. It would be nice if you and Maltiez could work together. Imagine a crossbow or musket that fires grenade rounds. Also are you planning to add some kind of medieval molotov, considering jug bomb exist and we have stuff life Aqua Vitae.

CKitt, Feb 12th 2025 at 10:55 PM

The particles, both the density and the duration, are far better now! Well done.

LubieKakao1212 , Feb 12th 2025 at 8:49 PM

Ourcasula

Good Idea, I will look into that tomorrow

Ourcasula, Feb 12th 2025 at 8:19 PM

Is the damage in a config file/config lib? That would make it really easy for individual servers to balance it how they like it, or if you have different damage/armor mods you can tune the grenade damage to account for those

 

Thanks for the mod!

LubieKakao1212 , Feb 12th 2025 at 6:42 PM

CKitt

I agree.

It should be better now

 

Edit: Apparently I did not make this comment in time

CKitt, Feb 12th 2025 at 6:41 PM

Thank you for humoring me, I'll give v1.0.4 a spin later today!

DoorlessCat, Feb 11th 2025 at 11:41 PM

Thank You!

CKitt, Feb 11th 2025 at 7:18 PM

~15 seconds for the glowing fragments/embers to stick around is too long, in my opinion. Cut that to ~1/2 that time, for a start.

Otherwise, I'm digging it!

Osaka, Feb 11th 2025 at 11:03 AM

M60 grenade launcher when? 😁

LubieKakao1212 , Feb 11th 2025 at 9:09 AM

DoorlessCat

That's what I thought,

The idea to base the jug bomb damage on small animals hp may be good

I will make an update today

DoorlessCat, Feb 11th 2025 at 3:20 AM

I like the mod but after some short and quick testing I noticed several things I found odd.

  • Grenades current damage values seem low except if used in a player vs player setting.
  • Grenades do much less damage if they are a direct hit on an enemy.
  • It took multpile copper grenades to kill a single surface drifter.
  • A single jug or glass grenade could not kill an adult hare.

I do not know much about mod making so my only suggestion for balancing is to make all grenades do more damage. 

Michaloid , Feb 10th 2025 at 5:10 PM

The true scrap bombs we needed.

LubieKakao1212 , Feb 10th 2025 at 1:16 PM

DanaCraluminum

It does calculate how much the entity is covered by blocks, but I was thinking about adding more accurate shrapnel simulation in the future

DanaCraluminum, Feb 10th 2025 at 1:08 PM

Does it use rays for shrapnel simulation or just boring AOE damage?

update: Ok I looked into the code and it looks like it is the first mod ever to use rays for grenades.

This is amazing! Best mod ever!