A lightweight CS2 hitmark plugin that renders particle hitmarks and particle damage digits at crosshair with per-player toggles.
- Based on refactoring and modifications of cs2-HealthBar-HitMark-GoldKingZ
- Particle usage approach inspired by cs2-store
- Particle HitMark: Headshot/bodyshot particles at crosshair
- Particle Damage Digits: Compose damage numbers using digit particles (0-9)
- Per-Player Toggles: Players can toggle hitmarks and sounds separately
- Configurable Durations: Separate timings for headshot and bodyshot effects
- Performance Guard: Optional max active particles per player
- Download the latest release
- Extract to
game/csgo/addons/counterstrikesharp/plugins - Start the server once to generate config
- Edit config and restart the server
Important
Particle resources are not bundled with this plugin. You must upload the particle assets to your own Workshop addon and precache them yourself.
Config path:
addons/counterstrikesharp/configs/plugins/cs2-HitMark/cs2-HitMark.json
{
"version": 1, // Do not change
"mute_default_headshot_bodyshot": true, // Mute default hit sounds if custom sounds exist
"hitmark_enabled": true, // Enable hitmark particles
"hitmark_headshot_particle": "particles/.../head.vpcf",
"hitmark_bodyshot_particle": "particles/.../body.vpcf",
"hitmark_headshot_duration": 0.3, // Headshot particle lifetime (sec)
"hitmark_bodyshot_duration": 0.25, // Bodyshot particle lifetime (sec)
"hitmark_distance": 60, // Distance in front of view (used when no impact position)
"hitmark_input": "Start", // Optional input, use empty or NONE to skip
"damage_digits_enabled": true, // Enable particle damage digits
"damage_digit_particles": [ // Bodyshot digits (0-9)
"particles/.../num_0.vpcf",
"particles/.../num_1.vpcf",
"particles/.../num_2.vpcf",
"particles/.../num_3.vpcf",
"particles/.../num_4.vpcf",
"particles/.../num_5.vpcf",
"particles/.../num_6.vpcf",
"particles/.../num_7.vpcf",
"particles/.../num_8.vpcf",
"particles/.../num_9.vpcf"
],
"damage_digit_particles_headshot": [ // Optional headshot digits (0-9). Leave empty to reuse body list
"particles/.../headshot/num_0_headshot.vpcf",
"particles/.../headshot/num_1_headshot.vpcf",
"particles/.../headshot/num_2_headshot.vpcf",
"particles/.../headshot/num_3_headshot.vpcf",
"particles/.../headshot/num_4_headshot.vpcf",
"particles/.../headshot/num_5_headshot.vpcf",
"particles/.../headshot/num_6_headshot.vpcf",
"particles/.../headshot/num_7_headshot.vpcf",
"particles/.../headshot/num_8_headshot.vpcf",
"particles/.../headshot/num_9_headshot.vpcf"
],
"damage_headshot_duration": 0.4, // Headshot digits lifetime (sec)
"damage_bodyshot_duration": 0.4, // Bodyshot digits lifetime (sec)
"damage_height": -75, // Extra Z offset from spawn position
"damage_spacing": 13, // Digit spacing along view-right (world units)
"damage_offset_x": 0, // Horizontal offset (world units)
"damage_offset_y": 0, // Vertical offset (world units)
"damage_input": "Start", // Optional input, use empty or NONE to skip
"max_active_particles_per_player": 30, // 0 = unlimited
"headshot_sounds": [
"sounds/.../headshot.vsnd"
],
"bodyshot_sounds": [
"sounds/.../bodyhit.vsnd"
],
"debug": false,
"mysql": {
"enabled": false,
"host": "127.0.0.1",
"port": 3306,
"database": "",
"username": "",
"password": "",
"table": "cs2_hitmark_settings"
}
}Note
Particle paths must be precached by another plugin or system This plugin does not precache resources
Enable the mysql section to persist per-player hitmark/sound toggles across sessions.
css_hitmark- Toggle hitmark particles for yourselfcss_hitsound- Toggle hitmark sounds for yourselfcss_hitmark_particle_test- Spawn a test particle at crosshair (optional)
Issues and pull requests are welcome
一个轻量级 CS2 HitMark 插件：使用粒子在准星位置显示击中标记与伤害数字，支持玩家本地开关。
- 基于 cs2-HealthBar-HitMark-GoldKingZ 的重构与修改
- 粒子应用方法参考 cs2-store
- 粒子 HitMark：爆头/身体命中不同粒子特效
- 数字粒子拼接：使用 0-9 粒子组合显示伤害
- 玩家开关：独立开关 HitMark 与声音
- 独立时间：爆头与身体命中时长分别配置
- 性能保护：可限制玩家活跃粒子数量
- 下载最新版本
- 解压到
game/csgo/addons/counterstrikesharp/plugins - 启动服务器生成配置文件
- 修改配置后重启服务器
Important
本插件不包含任何粒子资源，请自行将粒子资源上传至创意工坊并完成预载。
配置路径：
addons/counterstrikesharp/configs/plugins/cs2-HitMark/cs2-HitMark.json
{
"version": 1, // 请勿修改
"mute_default_headshot_bodyshot": true, // 有自定义音效时静音默认命中音效
"hitmark_enabled": true, // 启用 HitMark 粒子
"hitmark_headshot_particle": "particles/.../head.vpcf",
"hitmark_bodyshot_particle": "particles/.../body.vpcf",
"hitmark_headshot_duration": 0.3, // 爆头时长(秒)
"hitmark_bodyshot_duration": 0.25, // 身体时长(秒)
"hitmark_distance": 60, // 准星前方距离(世界单位)
"hitmark_input": "Start", // 可选输入，留空或 NONE 跳过
"damage_digits_enabled": true, // 启用数字粒子
"damage_digit_particles": [
"particles/.../0.vpcf",
"particles/.../1.vpcf",
"particles/.../2.vpcf",
"particles/.../3.vpcf",
"particles/.../4.vpcf",
"particles/.../5.vpcf",
"particles/.../6.vpcf",
"particles/.../7.vpcf",
"particles/.../8.vpcf",
"particles/.../9.vpcf"
],
"damage_digit_particles_headshot": [
"particles/.../headshot/num_0_headshot.vpcf",
"particles/.../headshot/num_1_headshot.vpcf",
"particles/.../headshot/num_2_headshot.vpcf",
"particles/.../headshot/num_3_headshot.vpcf",
"particles/.../headshot/num_4_headshot.vpcf",
"particles/.../headshot/num_5_headshot.vpcf",
"particles/.../headshot/num_6_headshot.vpcf",
"particles/.../headshot/num_7_headshot.vpcf",
"particles/.../headshot/num_8_headshot.vpcf",
"particles/.../headshot/num_9_headshot.vpcf"
],
"damage_headshot_duration": 0.4, // 爆头数字时长(秒)
"damage_bodyshot_duration": 0.4, // 身体数字时长(秒)
"damage_height": -75, // 受击者上方高度(世界单位)
"damage_spacing": 13, // 数字间距(世界单位)
"damage_offset_x": 0, // 横向偏移
"damage_offset_y": 0, // 纵向偏移
"damage_input": "Start", // 可选输入，留空或 NONE 跳过
"max_active_particles_per_player": 30, // 0 = 不限制
"headshot_sounds": [
"sounds/.../headshot.vsnd"
],
"bodyshot_sounds": [
"sounds/.../bodyhit.vsnd"
],
"debug": false,
"mysql": {
"enabled": false,
"host": "127.0.0.1",
"port": 3306,
"database": "",
"username": "",
"password": "",
"table": "cs2_hitmark_settings"
}
}Note
粒子资源需要由其他插件或系统进行预载，本插件不负责预载
将 mysql 设置为 true 来使用数据库持久化储存玩家设置
!hitmark- 开关 HitMark 特效!hitsound- 开关 HitMark 声音
欢迎提交 Issue 或 Pull Request