HeadBreak
Smash the heads of your enemiesHeadBreak
HeadBreak expands Brutalistick VR's native limb-shattering system into a physics-driven head-crushing mechanic. Enemy skulls react to blunt trauma, wall smashes, kicks, and combos, shattering into pieces with blood and gore effects while leaving sharp and slashing weapons untouched.
Features & When It Works
- Wall & Floor Smashes (1-2 Hits): Grab an enemy and slam their head into any static surface (walls, floors, stairs, pillars) or throw them at high speed. A hard slam has a 60%-80% chance to shatter the skull on the 1st hit and 100% on the 2nd. Works only on static level geometry (ignores dynamic props) and supports WallClimb out of the box.
- Heavy Blunt Weapons & Thrown Props (1-3 Hits): Striking an enemy's head with blunt weapons (hammers, bats, crowbars, maces — vanilla or modded) or heavy thrown objects shatters the skull with a progressive chance (40% -> 70% -> 100%).
- Cumulative Trauma — Fists, Buttstocks & Headbutts (3-4 Hits): Enemy heads remember damage. A series of lighter strikes — bare fists, palms, firearm buttstocks, pistol grips, or headbutting the enemy with your own VR headset — builds up trauma until the skull bursts on the 3rd or 4th hit.
- Fatal Kick (1 Hit): Landing a direct kick to an enemy's head guarantees an instant 100% skull shatter.
- Blade Immunity: Swords, knives, katanas, claws, and stilettos are automatically filtered out so they keep their native slicing and stabbing behavior without exploding heads.
Configuration (UserData/MelonPreferences.cfg -> [HeadBreakerMod])
| Parameter | Type | Default | Valid Values | Description |
|---|---|---|---|---|
| Enabled | bool | true | true / false | Master switch to enable or disable the entire mod. |
| WallClimbMode | int | 0 | 0, 1, 2 | 0 = Auto-detect WallClimb, 1 = With WallClimb, 2 = Without WallClimb. |
| EnableCombinedDamage | bool | true | true / false | Sums damage progress across different hit types (e.g., punches + wall smash). |
| VerboseLogging | bool | true | true / false | Prints hit counts, chances, and trauma progress to the MelonLoader console. |
| EnableWallSmash | bool | true | true / false | Toggle head shattering against static walls, floors, and stairs. |
| EnableHeavyWeaponBreak | bool | true | true / false | Toggle head shattering from heavy blunt weapon strikes. |
| EnableLightWeaponBreak | bool | true | true / false | Toggle trauma buildup from light blunt weapon strikes. |
| EnableThrownObjectBreak | bool | true | true / false | Toggle head shattering from thrown objects and props. |
| EnableFistBreak | bool | true | true / false | Toggle head shattering from bare fists and palms. |
| EnableButtstockGripBreak | bool | true | true / false | Toggle head shattering from firearm buttstocks and pistol grips. |
| EnableHeadbuttBreak | bool | true | true / false | Toggle head shattering by headbutting with your VR headset. |
| EnableKickBreak | bool | true | true / false | Toggle head shattering from player kicks. |
| WallSmashMaxHits | int | 2 | 1+ (hits) | Number of wall smashes required to guarantee (100%) a head break if previous rolls fail. |
| WallSmashBaseChance | float | 0.60 | 0.0 - 1.0 | Base chance (60%) to shatter the head on the 1st wall smash. |
| WallSmashChanceAddPerHit | float | 0.40 | 0.0 - 1.0 | Chance percentage (+40%) added with each subsequent wall smash. |
| WallSmashHardBonusChance | float | 0.20 | 0.0 - 1.0 | Extra chance bonus (+20%) when impact speed exceeds WallSmashHardSpeed. |
| WallSmashGrabbedMinSpeed | float | 4.8 | 0.5+ (m/s) | Minimum head impact speed to register a wall smash while grabbing an enemy. |
| WallSmashHardSpeed | float | 6.8 | 0.5+ (m/s) | Speed threshold to trigger WallSmashHardBonusChance. |
| WallSmashGrabbedMinDelta | float | 2.6 | 0.2+ (m/s) | Minimum head deceleration required on wall impact while grabbed. |
| WallSmashFreeMinSpeed | float | 8.5 | 1.0+ (m/s) | Minimum speed for a wall smash in free flight. |
| WallSmashFreeMinDelta | float | 4.5 | 0.5+ (m/s) | Minimum deceleration for a wall smash in free flight. |
| WallContactRadius | float | 0.135 | 0.08 - 0.30 (m) | Max distance from head center to wall surface to count as physical contact. |
| HeavyWeaponMaxHits | int | 3 | 1+ (hits) | Number of heavy weapon hits required to guarantee (100%) a head break (e.g., 3, 5, 7). |
| HeavyWeaponBaseChance | float | 0.40 | 0.0 - 1.0 | Base chance (40%) to shatter the head on the 1st heavy weapon hit. |
| HeavyWeaponChanceAddPerHit | float | 0.30 | 0.0 - 1.0 | Chance percentage (+30%) added with each subsequent heavy weapon hit. |
| HeavyWeaponMinSpeed | float | 5.4 | 1.0+ (m/s) | Minimum swing speed at impact point for a heavy blunt strike. |
| HeavyWeaponMinDelta | float | 1.75 | 0.2+ (m/s) | Minimum head velocity change for a heavy blunt strike. |
| ThrownObjectHeavySpeed | float | 7.5 | 1.0+ (m/s) | Minimum speed of a thrown object to count as a heavy head hit. |
| LightHitMaxHits | int | 4 | 1+ (hits) | Number of light hits (fists/buttstock/headbutt) to guarantee (100%) a head break (e.g., 4, 5, 7). |
| LightHitStartChanceFromHit | int | 3 | 1+ (hit #) | Hit number from which random chance rolls begin for light hits. |
| LightHitBaseChance | float | 0.00 | 0.0 - 1.0 | Base chance on the 1st light hit (0% by default). |
| LightHitChanceAddPerHit | float | 0.25 | 0.0 - 1.0 | Chance percentage (+25%) added per light hit. |
| LightHitMinSpeed | float | 1.85 | 0.5+ (m/s) | Minimum hand/weapon speed to register a light hit. |
| LightHitMinDelta | float | 0.60 | 0.1+ (m/s) | Minimum head velocity change to register a light hit. |
| HeadbuttMinSpeed | float | 1.60 | 0.4+ (m/s) | Minimum closing speed between player head and enemy head for a headbutt. |
| HeadbuttRadius | float | 0.25 | 0.12 - 0.45 (m) | Contact radius around the player's VR camera for headbutts. |
| KickMaxHits | int | 1 | 1+ (hits) | Number of head kicks to guarantee a head break (1 = instant break). |
| KickBaseChance | float | 1.00 | 0.0 - 1.0 | Base chance (100%) to shatter the head on the 1st kick. |
| KickChanceAddPerHit | float | 1.00 | 0.0 - 1.0 | Chance percentage added per subsequent kick. |
| KickHeadMaxDistance | float | 0.38 | 0.15+ (m) | Max distance from kick impact point to the enemy's head. |
| AlsoFractureJaw | bool | true | true / false | Fractures the Jaw along with the Head so it does not float in mid-air. |
| EnableGoreParticles | bool | true | true / false | Spawns blood and flesh particles when a head shatters. |
| EnableMiniHitGore | bool | true | true / false | Spawns small blood splashes on survived hits. |
| ActiveCheckRadius | float | 14.0 | 3.0+ (m) | Distance culling radius around the player for FPS optimization. |
HeadBreak
HeadBreak превращает внутриигровую систему разрушения конечностей в полноценную физическую механику раскалывания черепов врагов. Головы противников реагируют на удары дробящим оружием, удары об стены, комбо кулаками, удары лбом и пинки, разлетаясь на осколки с эффектами крови и плоти.
Особенности и в каких ситуациях работает
- Удары головой об стены, пол и лестницы (1-2 удара): Схвати врага и ударь его головой о любую статическую поверхность (стену, пол, ступеньки, колонну) или с размаху брось в неё. Сильный удар раскалывает череп с шансом 60%-80% с 1-го раза и 100% — со 2-го. Работает строго об статику уровня (динамические пропы не вызывают ложных срабатываний) и полностью совместим с модом WallClimb.
- Тяжёлое дробящее оружие и брошенные предметы (1-3 удара): Сильные удары молотами, битами, монтировками, булавами (ванильными и модовыми), а также брошенными тяжёлыми предметами пробивают голову с прогрессивным шансом (40% -> 70% -> 100%).
- Накопление урона — кулаки, приклады, рукояти и удар головой (3-4 удара): Голова врага запоминает полученный урон. Серия слабых ударов — кулаками, ладонями, прикладами автоматов/дробовиков, рукоятями пистолетов или ударами головой врага о твой собственный VR-шлем (Headbutt) — накапливает травму и взрывает череп на 3-4 удар.
- Смертельный пинок ногой (1 удар): Прямой пинок ногой по голове врага гарантированно (100%) разносит её с первого удара.
- Иммунитет к клинкам и ножам: Катаны, ножи, мечи, когти, стилеты и бензопилы автоматически исключаются — они сохраняют стандартную механику порезов и уколов, не взрывая голову.
Настройки конфига (UserData/MelonPreferences.cfg -> [HeadBreakerMod])
| Параметр | Тип | По умолчанию | Допустимые значения | Описание |
|---|---|---|---|---|
| Enabled | bool | true | true / false | Полностью включает или выключает мод. |
| WallClimbMode | int | 0 | 0, 1, 2 | 0 = Авто-определение WallClimb, 1 = С модом WallClimb, 2 = Без мода WallClimb. |
| EnableCombinedDamage | bool | true | true / false | Суммирует прогресс урона от разных типов атак (например, кулаки + удар об стену). |
| VerboseLogging | bool | true | true / false | Выводит в консоль информацию о каждом ударе, текущем шансе и прогрессе. |
| EnableWallSmash | bool | true | true / false | Включает/выключает дробление головы от ударов об стены, пол и лестницы. |
| EnableHeavyWeaponBreak | bool | true | true / false | Включает/выключает дробление головы от сильных ударов дробящим оружием. |
| EnableLightWeaponBreak | bool | true | true / false | Включает/выключает накопление урона от слабых ударов дробящим оружием. |
| EnableThrownObjectBreak | bool | true | true / false | Включает/выключает дробление головы от брошенных в неё предметов. |
| EnableFistBreak | bool | true | true / false | Включает/выключает дробление головы серией ударов кулаками и ладонями. |
| EnableButtstockGripBreak | bool | true | true / false | Включает/выключает дробление головы ударами прикладом и рукоятью оружия. |
| EnableHeadbuttBreak | bool | true | true / false | Включает/выключает дробление головы ударами об голову (VR-шлем) игрока. |
| EnableKickBreak | bool | true | true / false | Включает/выключает дробление головы пинком ноги. |
| WallSmashMaxHits | int | 2 | 1+ (ударов) | На каком по счёту ударе об стену голова гарантированно (100%) лопнет, если предыдущие шансы не сработали. |
| WallSmashBaseChance | float | 0.60 | 0.0 - 1.0 | Базовый шанс (60%) расколоть голову с 1-го удара об стену. |
| WallSmashChanceAddPerHit | float | 0.40 | 0.0 - 1.0 | Процент (+40%), который прибавляется к шансу с каждым следующим ударом об стену. |
| WallSmashHardBonusChance | float | 0.20 | 0.0 - 1.0 | Дополнительный бонус к шансу (+20%) при очень сильном ударе об стену. |
| WallSmashGrabbedMinSpeed | float | 4.8 | 0.5+ (м/с) | Мин. скорость головы для зачёта удара об стену в захвате. |
| WallSmashHardSpeed | float | 6.8 | 0.5+ (м/с) | Скорость удара об стену для активации бонуса WallSmashHardBonusChance. |
| WallSmashGrabbedMinDelta | float | 2.6 | 0.2+ (м/с) | Мин. гашение скорости головы при ударе об стену в захвате. |
| WallSmashFreeMinSpeed | float | 8.5 | 1.0+ (м/с) | Мин. скорость головы для раскола об стену в свободном полёте. |
| WallSmashFreeMinDelta | float | 4.5 | 0.5+ (м/с) | Мин. гашение скорости головы при ударе об стену в свободном полёте. |
| WallContactRadius | float | 0.135 | 0.08 - 0.30 (м) | Макс. расстояние от центра головы до поверхности стены для регистрации контакта. |
| HeavyWeaponMaxHits | int | 3 | 1+ (ударов) | На каком сильном ударе оружием голова гарантированно (100%) лопнет (например: 3, 5 или 7). |
| HeavyWeaponBaseChance | float | 0.40 | 0.0 - 1.0 | Базовый шанс (40%) расколоть голову с 1-го сильного удара оружием. |
| HeavyWeaponChanceAddPerHit | float | 0.30 | 0.0 - 1.0 | Процент (+30%), который прибавляется к шансу с каждым следующим сильным ударом оружием. |
| HeavyWeaponMinSpeed | float | 5.4 | 1.0+ (м/с) | Мин. скорость ударной части дробящего оружия для сильного удара. |
| HeavyWeaponMinDelta | float | 1.75 | 0.2+ (м/с) | Мин. скачок скорости головы от сильного удара оружием. |
| ThrownObjectHeavySpeed | float | 7.5 | 1.0+ (м/с) | Мин. скорость брошенного предмета для зачёта сильного удара. |
| LightHitMaxHits | int | 4 | 1+ (ударов) | На каком слабом ударе (кулак/приклад/голова) череп гарантированно (100%) лопнет (например: 4, 5 или 7). |
| LightHitStartChanceFromHit | int | 3 | 1+ (удар №) | С какого по счёту слабого удара начинает проверяться рандомный шанс раскола до достижения лимита. |
| LightHitBaseChance | float | 0.00 | 0.0 - 1.0 | Базовый шанс расколоть голову на 1-м слабом ударе (по умолчанию 0%). |
| LightHitChanceAddPerHit | float | 0.25 | 0.0 - 1.0 | Процент (+25%), который прибавляется к шансу за каждый слабый удар. |
| LightHitMinSpeed | float | 1.85 | 0.5+ (м/с) | Мин. скорость руки/оружия для зачёта слабого удара. |
| LightHitMinDelta | float | 0.60 | 0.1+ (м/с) | Мин. отклик головы для зачёта слабого удара. |
| HeadbuttMinSpeed | float | 1.60 | 0.4+ (м/с) | Мин. встречная скорость сближения голов для удара об голову игрока. |
| HeadbuttRadius | float | 0.25 | 0.12 - 0.45 (м) | Радиус контакта вокруг головы (VR-камеры) игрока для удара лбом. |
| KickMaxHits | int | 1 | 1+ (ударов) | Сколько пинков ногой по голове гарантированно раскалывают череп (1 = с первого пинка). |
| KickBaseChance | float | 1.00 | 0.0 - 1.0 | Базовый шанс (100%) расколоть голову с 1-го пинка ногой. |
| KickChanceAddPerHit | float | 1.00 | 0.0 - 1.0 | Прибавка к шансу за каждый следующий пинок ногой. |
| KickHeadMaxDistance | float | 0.38 | 0.15+ (м) | Макс. расстояние от точки попадания пинка до центра головы врага. |
| AlsoFractureJaw | bool | true | true / false | Дробит челюсть (Jaw) вместе с головой (Head), чтобы она не висела в воздухе. |
| EnableGoreParticles | bool | true | true / false | Спавнит эффекты крови и кусков плоти при взрыве черепа. |
| EnableMiniHitGore | bool | true | true / false | Спавнит малые брызги крови при выдержанных ударах. |
| ActiveCheckRadius | float | 14.0 | 3.0+ (м) | Радиус вокруг игрока для проверки физики голов (оптимизация FPS). |

