![\"KineticDamage](\"https:\/\/github.com\/o7q\/KineticDamage\/blob\/main\/assets\/images\/banner\/banner.png?raw=true\")
<\/p>\n<\/p>\n
—<\/p>\n
# KineticDamage
\n**An easy-to-use, highly-configurable Minecraft mod that brings more realism to combat by scaling damage and knockback with kinetic energy.** <\/p>\n
***This mod is still in development and lots of new features are still being planned! This is my first ever mod, I hope you find it useful!***
\n**If you have a feature request or find a bug please create an issue or message me on Discord! (username: o7q) \ud83d\ude0a** <\/p>\n
—<\/p>\n
# \u2728 Features<\/p>\n
– ## \u2694\ufe0f Damage scaling
\n > This mod features a highly configurable damage scaling system that changes how Minecraft deals damage to mobs.
\n ![\"Falling](\"https:\/\/github.com\/o7q\/KineticDamage\/blob\/main\/assets\/images\/gifs\/1.gif?raw=true\")
\n ![\"Speed](\"https:\/\/github.com\/o7q\/KineticDamage\/blob\/main\/assets\/images\/gifs\/2.gif?raw=true\")
<\/p>\n
—<\/p>\n
– ## \ud83d\udca8 Knockback scaling
\n > You can also configure how energy is transferred from yourself to other entities.
\n ![\"Pig](\"https:\/\/github.com\/o7q\/KineticDamage\/blob\/main\/assets\/images\/gifs\/3.gif?raw=true\")
<\/p>\n
—<\/p>\n
> Highly compatible with other mods, here are some examples with **ULTRACRAFT**
\n ![\"Pig](\"https:\/\/github.com\/o7q\/KineticDamage\/blob\/main\/assets\/images\/gifs\/4.gif?raw=true\")
\n ![\"Pig](\"https:\/\/github.com\/o7q\/KineticDamage\/blob\/main\/assets\/images\/gifs\/5.gif?raw=true\")
<\/p>\n
—<\/p>\n
> Example with **BetterCombat**
\n ![\"Wither](\"https:\/\/github.com\/o7q\/KineticDamage\/blob\/main\/assets\/images\/gifs\/6.gif?raw=true\")
<\/p>\n
—<\/p>\n
> Example with an elytra
\n ![\"Wither](\"https:\/\/github.com\/o7q\/KineticDamage\/blob\/main\/assets\/images\/gifs\/7.gif?raw=true\")
<\/p>\n
—<\/p>\n
# \ud83d\udcdc Commands
\n– **`\/kineticdamage reload` *reloads the config***<\/p>\n
That’s it! For now… \ud83d\ude42<\/p>\n
—<\/p>\n
# \u2699\ufe0f Configuration
\nThis is the default configuration file for KineticDamage. It contains an explanation for every configurable option and acts as the guide.
\n“`properties
\n# KineticDamage config
\n# Comment out ‘version’ with ‘#’ if you do not want the config to regenerate on version change
\nversion=1.0.0_beta1<\/p>\n
# Damage multipliers
\n# These values will be multiplied with the calculated damage values
\ndamage-multiplier-vertical=1.0
\ndamage-multiplier-horizontal=2.0<\/p>\n
# Specify the max amount of damage that can be done
\n# Negative numbers will uncap the damage
\ndamage-max-vertical=50.0
\ndamage-max-horizontal=-1.0<\/p>\n
# Knockback multipliers
\n# Scales the knockback with attacker’s incoming velocity
\nknockback-multiplier-x=2.0
\nknockback-multiplier-y=1.0
\nknockback-multiplier-z=2.0<\/p>\n
# Action multipliers
\n# Scales damage and knockback depending on the attacker’s action
\naction-sprinting-multiplier=1.5
\naction-swimming-multiplier=0.75
\naction-sneaking-multiplier=0.5
\naction-crawling-multiplier=0.25<\/p>\n
# Use player fall distance for damage
\n# The farther the player falls the more damage they will do
\n# Also, this damage will be added on top of the damage already done by the player’s velocity
\nplayer-use-fall-distance=true<\/p>\n
# Use the direct attack register rather than the standard attack callback (calculated client-side using a mixin)
\n# This option is useful if you are having mod compatibility issues (ex. BetterCombat, or other combat based mods that may interfere with KineticDamage)
\n# This option should usually be enabled, but in the case you are having issues, try disabling it
\nplayer-use-direct-hit-register=true<\/p>\n
# Use player head rotation vector for math
\n# This will use the player’s head rotation instead of body velocity to calculate values
\n# If enabled, the server will always use the players head rotation vector to calculate knockback vectors instead of the velocity vector of the player itself
\n# In other words, the knockback will always occur in the direction the player is looking, this is not as realistic but it can be very fun
\nplayer-use-head-rotation=false<\/p>\n
# Should the entity’s velocity be completely overwritten by the new calculated velocity?
\n# By default, the new calculated velocity is added to the entities original velocity, this is much more realistic
\n# If enabled, all original entity velocity will be ignored and overwritten by the new calculated velocity
\nentity-ignore-original-velocity=false<\/p>\n
# ADVANCED OPTIONS
\n# Damping function for player fall distance
\n# This option will make the fall distance damage and knockback scale more slowly the longer the player falls
\n# This is to make it so a player can’t just jump off of a mountain and 1 tap any mob
\n# I’ve also included some options to increase the damage the longer you fall (inverse-damping options)
\n#
\n# If you don’t want to use any damping functions specify: none
\n# DAMPING OPTIONS (by increasing strength): linear, sqrt, log_e, log, tanh
\n# INVERSE-DAMPING OPTIONS (by increasing strength): quadratic, cubic
\n# Note: ‘none’ is the same as ‘linear’, except that linear will use the coefficient and constant values in it’s calculation
\nplayer-fall-distance-damping-function=sqrt
\n# This value is multiplied to the fall distance before going into the damping function, it will be ignored if ‘none’ is set for the damping function
\nplayer-fall-distance-damping-coefficient=10.0
\n# Horizontal shift factor, example: f(x) = FUNC(AX + K1 <-) + K2\nplayer-fall-distance-damping-constant-1=0.0\n# Vertical shift factor, example: f(x) = FUNC(AX + K1) + K2 <-\nplayer-fall-distance-damping-constant-2=0.0\n# Auto clamp square root function\n# This ensures that the y of f(x) = sqrt(ax) is never bigger than the y of f(x) = ax\n# Turning this off can produce strange values when a player crits a mob after falling a small distance\n# This value is ONLY used when 'sqrt' is used for the damping function\n# When enabled, the 'constant-1' and 'constant-2' values will be ignored\nplayer-fall-distance-damping-sqrt-auto-clamp=true\n# This value is multiplied to the fall distance that's used to calculate downwards knockback\n# Lower values means lower downwards knockback\nplayer-fall-distance-downwards-knockback-coefficient=0.05\n\n# Debug\n# Logs debug messages to the chat (per player)\ndebug-chat-log=false\n```\n\n---\n\n**\ud83e\udd70 The idea and name for this mod came from my friend **weeg**.**\n\n---\n\n![\"KineticDamage](\"https:\/\/github.com\/o7q\/KineticDamage\/blob\/main\/assets\/images\/banner\/icon_shadow.png?raw=true\"){kind=icon}
<\/p>\n
**KineticDamage**
\nWritten in Java for Minecraft Fabric<\/p>\n","protected":false},"excerpt":{"rendered":"
A highly-configurable Minecraft mod that scales damage and knockback with kinetic energy.<\/p>\n","protected":false},"featured_media":90441,"template":"","meta":{"_minecraft_slug":"kineticdamage","_minecraft_project_id":"zDpPF65y","_minecraft_author":"o7q","_minecraft_license":"MIT","_minecraft_downloads":2654,"_minecraft_follows":27,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"kineticdamage.zip","_minecraft_size_bytes":36152,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T17:59:01.887120Z","_minecraft_date_created":"2024-01-10T03:33:03.451350Z","_minecraft_date_modified":"2024-01-07T04:46:45.377200Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/kineticdamage","_minecraft_icon_attachment_id":90441,"_minecraft_imported_at":"2026-06-05T03:54:30+00:00","_minecraft_import_hash":"52bea3aad9b53181f303ee59911b4fc4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,89,92],"mod_loader":[99],"minecraft_version":[59,36,60,93,94],"class_list":["post-90440","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-game-mechanics","mod_category-utility","mod_loader-fabric","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4"],"yoast_head":"\n