Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Tags
Creators
Details
Hello, this is a small array of changes I deemed neccesary for my modpack!
List of changes (All tweaks are configurable in the json file.)
Custom Disarm + Stun (Can be toggled both seperately)
"enableCustomDisarm": true,
"playStunOnDisarm": false ,
When you run out of stamina with custom disarm, and get hit during a block, your weapon will fly out of your hand, and (by default) you can immediately try to recover it.
You can enable stun on disarm, but this is probably massively unfair to players, as it would both stun them and drop their weapon.
Stamina regeneration interruption (Toggle : true/false)
This is simply a true/false if any damage can interrupt stamina regen. If you get poisoned / wither for example, you wouldnt be able to regen stamina at all, despite doing everything else correctly, I just found this edge case to be annoying.
Stamina gain on hit (Can be toggled : true/false)
- This is directly proportional to the determined weight. If a weapon weight is 5.0 and you hit an entity, you will gain 5.0 stamina back, +0.5 extra.
Jump Cost (self explanatory)
"jumpCost": 0.25,
Passive stamina drain on held block (Can be configured numerically)
- Holding block by default drains stamina by 0.1 every tick. You can set this to practically any useful value, even something tiny like 0.01.
Or, if you want to disable it, just set it to 0.
Max Attack up & down Angle (0 - 90)
This is pretty simple, and is connected to "enableVerticalAim": true,
It just lets you choose how far up and down you can aim swings, and this enables vertical aiming with ANY attack, so stabs, even from other addons, can be aimed up and down.
I dont recommend 90 degrees, because it just looks very visually bad.
if you want to disable this completely, just set "enableVerticalAim": true, to false.
Max Stun Ticks
Just the maximum amount of time you can be stunned before the game forces a bailout, this was just to help prevent some bugs with very long stuntimes with some weapons.
Stamina drain on swing (Can be toggled : true/false) for all weapons.
- This is on a per-weapon basis dictated in the config file. If the weapon used is not found in the config file, the mod will default to a "weight" of 1.0. (1.0 stamina drain per swing)
Example: Format is "weapon_id": "weight value",
"weaponCosts": {
"minecraft:wooden_sword": 0.5,
"minecraft:stone_sword": 0.5,
},
This will make a wooden sword and stone sword drain 0.5 stamina per swing.
Stamina gain on parry/ Parry Effectiveness (Can be toggled : true/false)
- This is again proportional to weight. But, there's a secondary value called "Parry effectiveness" in the config.
The parry reward is (weight + 2.5) x (effectiveness x0.10) This simply means every 1.0 increase in parry effectiveness means 10% more stamina gained back on parry. a value of 10 means your stamina gain on parry is doubled.
This also works with negative values , so you can make a weapon less effective at parrying.
Here's an example.
"parryEffectiveness": {
"minecraft:golden_sword": 5.0,
"minecraft:iron_sword": 1.0
}
The iron sword will have a 10% increase in the output of its stamina regain on parry. Meanwhile, the golden sword will have a 50% boost in the stamina increase.
Block Stamina Penalty
Again, this is another value that is tied directly to a weapon's weight.
Stamina Drain=[1.0+(EnemyDamage×0.05)]×[1.0−(Weight×0.10)]
Every 1.0 higher weight reduces the block stamina drain by 10%.
"disableSweepAttacks": true,
Self-explanatory : disables sweep attacks.
"enableCustomCrits": true,
If true, dash and air attacks will always do 1.5x base damage. Even if its a custom datapacked animation set.


