English

Features

Hold a weapon or tool and right-click a grindstone to sharpen it. The final extra attack damage bonus is determined by your right-click frequency and duration — the faster you click and the longer you sharpen, the higher the damage bonus. Each sharpening also consumes durability.

During sharpening, there is a small chance of a critical hit event, indicated by a "ding" sound. It applies a multiplier (e.g., 1.5×) to your damage bonus, making the final bonus even higher.

Note: If the weapon or tool's durability is restored or increased in any way, the sharpening bonus will be lost. (After all, restoring durability basically means the blade gets dull again 😂)

Compatiblity

Compatible with any enchantments, including Unbreaking.

When you also have Particle Interactions installed, sharpening will produce spark particles for a more immersive experience.

🎵 Sound System

Dynamic Sound – The sound effect changes in real time based on your clicking frequency.
Pitch Variation – Faster clicking produces a higher pitch, creating a rhythmic feel.
Flexible Control – Can be disabled or adjusted in the config file.

⚙️ Configurable Parameters

A full JSON config system (config file: config/grindstonesharpener.json)

Sensitivity – Adjust the precision of click detection.
Damage Bonus Formula – Customize the base bonus, coefficient, and exponential growth.
Critical Hit Chance & Multiplier – Set the trigger chance and damage multiplier for critical hits.
Sound Properties – Adjust the pitch range and frequency mapping.
Particle Effects – Enable/disable or fully customize particle behavior.
Bonus Duration – Set how long the sharpness bonus lasts (permanent by default).

Example configuration:

{
  "cooldown_idle_ms": 500,
  "min_sharpening_duration": 2.0,
  "bonus_min": 2.0,
  "bonus_coefficient": 1.25,
  "crit_chance": 0.20,
  "crit_common_multiplier_range": [1.2, 1.5],
  "crit_rare_multiplier_range": [1.5, 2.5],
  "dynamic_sound_enabled": true,
  "dynamic_particles_enabled": true
}

Version Support

This mod is currently built for 1.21.4. I'll port it to higher versions when I play them, or sooner if there's enough community demand.

中文

功能描述

手持武器或工具右键砂轮即可磨刀，根据右键点击频率、点击时长决定最终的武器额外攻击加成。手速越快、磨刀越久，最终伤害越高。并且每次磨刀都会消耗耐久

同时，磨刀过程中会有小概率暴击事件，具体表现为叮的一声。会给你的伤害加成添加一个倍数，比如1.5，使得最终伤害加成更高。

注意，当武器或工具的耐久恢复或增长时，磨刀所带来的加成会消失。（毕竟耐久恢复就是变相的刀变钝了😂）

兼容

兼容任何附魔，包括耐久

当你同时安装了Particle Interactions时，磨刀会有火花粒子，更具沉浸感。

🎵 音效系统

动态音效：音效会根据你的点击频率实时变化
音高变化：点击速度快时音调更高，创造节奏感
灵活控制：可在配置文件中关闭或调整

⚙️可配置参数：

完整的JSON配置系统（配置文件位置：config/grindstonesharpener.json）

判定灵敏度：调整检测点击的精准度
伤害加成公式：自定义基础加成、系数和指数增长
暴击概率和倍率：设置暴击触发和伤害倍数
音效属性：调整音高范围和频率映射
粒子效果：启用/禁用或自定义粒子行为
加成持续时间：设置磨刀加成的有效期（默认永久）

示例配置选项：

{
  "cooldown_idle_ms": 500,
  "min_sharpening_duration": 2.0,
  "bonus_min": 2.0,
  "bonus_coefficient": 1.25,
  "crit_chance": 0.20,
  "crit_common_multiplier_range": [1.2, 1.5],
  "crit_rare_multiplier_range": [1.5, 2.5],
  "dynamic_sound_enabled": true,
  "dynamic_particles_enabled": true
}

其他版本支持：

我目前使用的是1.21.4，当我玩其他版本时会去迁移。当然如果需要的人多，我也会抽空往高版本迁移。