Basic Information of GD656Killicon Mod

• Bug Feedback Please log in to 656.flna.top to submit bug feedback. Feedback left in the comments section of my videos may not be seen in a timely manner!
• Current Document Date The last edit time of this document is October 2025. Some functions may not be mentioned or may have been changed! Please verify carefully.
• Compatibility List
• This mod is compatible with Ootifine HD Fix (RC4 and above).
• This mod conflicts with FancyMenu [Game crashes when opening the configuration interface] - Fix in progress.
• This mod conflicts with AutoHUD [Slight overlapping icons appear].
• This mod conflicts with AdvancedCompass [Overlapping icons appear].
• Copyright Issues This mod will consider being open-sourced! You can currently use this mod directly on your commercial/private servers.

GD656Killicon Mod Feature Checklist

I. Core Foundation Module

1.1 Mod Positioning and Core Objectives

• Positioning: A comprehensive tool mod focusing on competitive combat scoring and visual feedback in the game, covering the entire process of "score management - visual display - permission control - data synchronization".
• Core Objectives:
  • Meet the needs of ordinary players: score inquiry, leaderboard viewing, and personalized visual feedback.
  • Meet the needs of administrators: score adjustment, rule customization, entity management, and system configuration.
  • Adapt to scenarios: single-player games, multi-player servers (supports both PVP/PVE modes).

II. Score Management System

2.1 Score Calculation Mechanism (Dynamic Expression System)

2.1.1 Core Rules

• Scores are calculated based on "behavior type + custom expressions", supporting basic arithmetic operations (+, -, *, /).
• Expressions take effect in real time; no need to restart the mod/game after modification.
• Invalid expressions (including illegal characters, incorrect syntax) automatically fall back to default values.

2.1.2 Default Score Rules (Customizable)

Behavior Type	Command Keyword	Default Expression	Calculation Logic Description	Applicable Scenario
Kill	kill	health * 5	Score = Target entity's health × 5	Scoring when defeating monsters/players
Critical Strike Bonus	critical	killscore * 0.25	Score = Basic kill score × 25% (additional reward)	When landing a critical kill on the target
Long-Range Defeat	longrange	distance	Score = Kill distance (unit: blocks)	When defeating the target from a long distance
Inflict Damage	damage	damage	Score = Damage dealt in a single attack	When inflicting damage on the target but not killing it
Magic Damage	magic	damage	Score = Damage dealt by magic attacks	When attacking the target with magic skills
Unarmed Attack	hand	damage	Score = Damage dealt by unarmed attacks	When defeating the target without holding a weapon
Assist	assist	damagedealt * 5	Score = Total damage dealt to the target × 5	When assisting teammates in defeating the target
Combo Bonus	combobonus	combo * 8	Score = Number of consecutive kills × 8 (additional reward)	When defeating targets consecutively

2.1.3 Available Variables for Expressions

Variable Name	Meaning	Application Scenario Example
health	Current health of the target entity	The higher the health, the higher the kill score
distance	Distance between the player and the target (blocks)	Higher scores for long-range kills (greater distance)
damage	Damage dealt in a single attack	Additional points for high-damage critical strikes
damagedealt	Total damage dealt to the target	Scores for assists are calculated based on total damage
combo	Current number of consecutive kills	The more consecutive kills, the higher the score multiplier
killscore	Basic kill score	Serves as the base for derived scores such as critical strike bonuses

2.2 Score Operation Functions

2.2.1 Player Autonomous Operations (Permission Level 0, Available to All Players)

• Query Own Score: Command /gdscore - Returns real-time scores (including cumulative scores from kills, tasks, etc.) in the chat bar.
• Clear Own Cards: Command /gdscore cardclear - Resets all held score cards (e.g., consecutive kill reward cards).

2.2.2 Administrator Operations (Permission Level 2, Available to Operators/OPs)

Operation Type	Command Format	Function Description	Example	Restrictions
View Player Score	/gdscore get <Player Name>	View the current score of the specified player	/gdscore get Steve	Must enter the player name accurately
Add Player Score	/gdscore add <Player Name> <Score>	Append scores to the specified player	/gdscore add Alex 100	Score ≥ 1, no upper limit
Reduce Player Score	/gdscore reduce <Player Name> <Score>	Deduct scores from the specified player	/gdscore reduce Bob 50	Score ≥ 1, minimum score after deduction is 0 (negative scores not allowed)
Force Set Score	/gdscore set <Player Name> <Score>	Override the current score of the specified player to the target value	/gdscore set Charlie 1000	Score ≥ 0

2.3 Scoreboard Integration Function (Permission Level 2)

• Bind Vanilla Scoreboard:
  • Command: /gdscore scoreboard binding <Scoreboard ID> <Display Name>
  • Function: Create a Minecraft vanilla scoreboard to synchronize mod scores in real time.
  • Example: /gdscore scoreboard binding killpoints Kill Score (Generates a scoreboard with ID killpoints and display name "Kill Score").
• Unbind Scoreboard: Command /gdscore scoreboard unbind - Stops synchronization between the mod and the vanilla scoreboard.
• Core Features:
  • Real-time Synchronization: The vanilla scoreboard updates immediately when a player's score changes.
  • Vanilla Compatibility: Synchronized scores can be viewed/managed via Minecraft's native /scoreboard command.
  • Custom Display: Supports setting the scoreboard display name to improve readability.

2.4 Bonus Point Management (Permission Level 2)

• View All Bonus Rules: Command /gdscore bonuspoints list - Lists all current bonus expressions for entities/behaviors.
• Reset Bonus Rules: Command /gdscore bonuspoints reset - Restores all bonus items to default values (e.g., default health*5 for zombie kills).
• Customize Bonus Rules:
  • Command: /gdscore bonuspoints edit <Bonus Keyword> <Expression>
  • Example: /gdscore bonuspoints edit kill health * 10 (Changes the kill bonus rule to "Health × 10").
  • Supported Scenarios: Adjust the scoring logic for all behaviors such as kills, critical strikes, and assists.

III. Combat Visual Feedback System

3.1 Three Core Display Modes (One-Click Switchable)

Mode Name	Identification Color	Core Features	Applicable Scenario	Exclusive Effects
Scroll Mode	Red	Kill elements (icons, subtitles) scroll upward from the bottom of the screen, similar to bullet comments	Fast consecutive kills to avoid element overlap	Synchronized scroll animation (scaling + movement) with elements displayed sequentially
Combo Mode	Green	Elements are displayed at fixed positions, with dynamic style updates when consecutive kills accumulate	Highlight the sense of accomplishment from consecutive kills, suitable for competitive scenarios	Subtitles/icons flash and highlight when consecutive kills reach the threshold (color customizable); Consecutive kill timeout can be modified (default 3 seconds)
Card Mode	Yellow	Display kill information in the form of "cards", with a maximum of 5 cards displayed simultaneously in a fan/side-by-side layout	Pursue visual layering, suitable for both single-player/team play	Card entry/exit animation (scaling + rotation + transparency change); Supports "ACE Card" light effects (modern/vanilla style optional); Consecutive kill timeout is 60 seconds by default (modifiable)

3.2 Refined Configuration of Visual Elements

3.2.1 Kill Icon Configuration (KillIconConfigModule)

Configuration Item Name	Configurable Range	Function Description	Example Effect
Icon Animation Duration	100ms ~ 2000ms	Controls the duration of the icon appearance/disappearance animation	100ms (fast), 2000ms (slow and smooth)
Forced Hide Quantity	3 ~ 100	Automatically hides excess icons when exceeding this quantity to avoid interface clutter	When set to 5, the 6th icon is not displayed temporarily
Display Duration	20 ~ 200 ticks (1 tick ≈ 50ms)	The time a single icon stays on the screen	20 ticks (1 second, fast disappearance), 200 ticks (10 seconds, long-term viewing)
Icon Spacing	10 ~ 100 pixels	Horizontal/vertical spacing between multiple icons	10 pixels (compact), 100 pixels (sparse, anti-overlap)
Style Presets	Built-in multiple (minimalist/realistic/pixel art, etc.)	Unify the style of all kill icons	After switching to "pixel art", all icons become pixelated
Maximum Display Quantity	5 ~ 100	Maximum number of icons displayed on the screen simultaneously	When set to 10, only the latest 10 kill icons are retained
Visibility Toggle	Enable/Disable	Controls whether to display kill icons	No icons are displayed when killing after disabling
Size Adjustment	16 ~ 96 (pixels)	Adjusts icon size; default values vary by mode	32 pixels by default for Combo Mode, 48 pixels by default for Card Mode

3.2.2 Kill Subtitle Configuration (SubtitleConfigModule)

Configuration Item Name	Configurable Content	Function Description	Example Effect
Custom Assist Subtitle	Text input (max 200 characters, supports variable {player})	Customize the subtitle format for assist scenarios	Enter {player} Assisted! to display "Steve Assisted!" when assisting
Custom Elimination Subtitle	Text input (max 200 characters, supports variable {target})	Customize the subtitle format when defeating a target	Enter You defeated {target}! to display "You defeated Zombie!"
Critical Strike Text Color	Color code (RGB/hexadecimal, max 100 characters)	Customize the color of critical strike-related text	Enter #FF0000 to display critical strike text in red
Target Text Color	Color code (max 100 characters)	Customize the color of target names (e.g., monster/player names) in subtitles	Enter #0000FF to display target names in blue
Weapon Text Color	Color code (max 100 characters)	Customize the color of weapon names in subtitles	Enter #FFD700 to display weapon names in gold
Visibility Toggle	Enable/Disable	Controls whether to display kill subtitles	No text feedback is displayed when killing after disabling
Size Adjustment	50 ~ 200 (ratio)	Adjusts subtitle font size; shared configuration across all three modes	Set to 150 for 50% larger font than default
Animation Effect	Entry scaling (1.5x → 1x), brightness gradient (highlight → normal)	Enhances the visual impact of subtitles	Subtitles first zoom in and highlight, then return to normal size and brightness when killing

3.2.3 Score Subtitle Configuration (ScoreConfigModule)

Configuration Item Name	Configurable Content	Function Description	Example Effect
Score Flash Color	Color code (RGB/hexadecimal, max 100 characters)	Customize the flash color when scores change	Enter #FFFF00 to make score numbers flash yellow when gaining points
High Score Color	Color code (max 100 characters)	Text color when a single score exceeds the threshold (threshold implicit)	Enter #9932CC to display scores exceeding 100 in purple
Visibility Toggle	Enable/Disable	Controls whether to display score subtitles	No numerical feedback is displayed when scores change after disabling
Size Adjustment	100 ~ 200 (ratio)	Adjusts score font size; independent configuration for different modes	Set to 200 (2x zoom) for Combo Mode, 120 for Scroll Mode
High Score Highlight	Enable/Disable + color customization (gold by default)	Automatically highlights high scores	When enabled, scores exceeding 200 are highlighted in gold by default

3.2.4 Bonus Point Subtitle Configuration (BonusConfigModule)

Configuration Item Name	Configurable Content	Function Description	Example Effect
Subtitle Line Spacing	1 ~ 60 pixels	Controls the vertical spacing between multiple bonus subtitles	Set to 10 pixels (compact), 30 pixels (sparse, anti-overlap)
Assist Kill Display Name	Text input (max 200 characters)	Customize the display name for assist bonus points	Enter "Assist Score" to display "Assist Score +50" when assisting
Combo Display Name	Text input (max 200 characters)	Customize the display name for combo bonus points	Enter "Combo Reward" to display "Combo Reward +100" when getting consecutive kills
Critical Strike Bonus Display Name	Text input (max 200 characters)	Customize the display name for critical strike bonus points	Enter "Lethal Strike Bonus" to display "Lethal Strike Bonus +30" when landing a critical strike
Damage Infliction Display Name	Text input (max 200 characters)	Customize the display name for damage bonus points	Enter "Damage Output Bonus" to display "Damage Output Bonus +10" when inflicting damage
Unarmed Attack Display Name	Text input (max 200 characters)	Customize the display name for unarmed bonus points	Enter "Unarmed Reward" to display "Unarmed Reward +20" when getting an unarmed kill
Creature Defeat Display Name	Text input (max 200 characters)	Customize the display name for creature defeat bonus points	Enter "Monster Reward" to display "Monster Reward +15" when defeating a creature
Long-Range Defeat Display Name	Text input (max 200 characters)	Customize the display name for long-range kill bonus points	Enter "Snipe Reward" to display "Snipe Reward +50" when getting a long-range kill
Magic Damage Display Name	Text input (max 200 characters)	Customize the display name for magic damage bonus points	Enter "Spell Damage Bonus" to display "Spell Damage Bonus +25" when using magic attacks
Visibility Toggle	Enable/Disable	Controls whether to display bonus subtitles	No text feedback is displayed when gaining bonus points after disabling
Size Adjustment	50 ~ 200 (ratio)	Adjusts bonus subtitle font size	Set to 180 for 80% larger bonus text than default

3.2.5 Card Icon Configuration (CardIconConfigModule)

Configuration Item Name	Configurable Content	Function Description	Example Effect
Card Style Presets	Built-in multiple (cartoon/dark/flat, etc.)	Unify the style of all card icons	After switching to "dark style", all cards become dark-themed
Card Width/Height	Custom pixel values	Adjusts card size	Set to 80×120 pixels for wider and taller cards
Light Effect Transparency

GD656Killicon模组基本信息

• bug反馈 请登录656.flna.top进行Bug反馈，在我的视频下方做出的反馈可能无法被我及时看到！
• 当前文档日期 此文档最后编辑时间为2025年10月，部分功能可能尚未提及或已被更改！请注意甄别
• 兼容性列表
• 本模组已经兼容Ootifine高清修复 (RC4及以上)
• 本模组会与FancyMenu冲突 [打开配置界面时游戏崩溃] 正在修复
• 本模组会与AutoHUD冲突 [出现轻微的多层图标]
• 本模组会与AdvancedCompass冲突 [出现多层图标]
• 版权问题 本模组会考虑开源！您现在可以直接在你的商业/私人服务器使用此模组

GD656Killicon模组功能项目清单

一、核心基础模块

1.1 模组定位与核心目标

• 定位：专注于游戏内竞技化战斗评分与视觉反馈的综合性工具模组，覆盖“分数管理-视觉展示-权限管控-数据同步”全流程
• 核心目标：
  • 满足普通玩家：分数查询、排行榜查看、个性化视觉反馈需求
  • 满足管理员：分数调控、规则自定义、实体管理、系统配置需求
  • 适配场景：单机游戏、多人服务器（PVP/PVE模式均支持）

二、分数管理系统

2.1 分数计算机制（动态表达式系统）

2.1.1 核心规则

• 基于“行为类型+自定义表达式”计算分数，支持基础算术运算（+、-、*、/）
• 表达式实时生效，修改后无需重启模组/游戏
• 无效表达式（含非法字符、错误语法）自动回退至默认值

2.1.2 默认分数规则（可自定义修改）

行为类型	指令关键词	默认表达式	计算逻辑说明	适用场景
击杀	kill	health * 5	分数=目标实体生命值×5	击败怪物/玩家时计分
暴击加成	critical	killscore * 0.25	分数=击杀基础分×25%（额外奖励）	暴击击杀目标时
远距离击败	longrange	distance	分数=击杀距离（单位：方块）	远程击杀目标时
造成伤害	damage	damage	分数=单次造成的伤害值	对目标造成伤害但未击杀时
魔法伤害	magic	damage	分数=魔法攻击造成的伤害值	使用魔法技能攻击目标时
空手攻击	hand	damage	分数=空手攻击造成的伤害值	未持武器击败目标时
助攻	assist	damagedealt * 5	分数=对目标累计伤害值×5	协助队友击杀目标时
连击加成	combobonus	combo * 8	分数=连杀次数×8（额外奖励）	连续击杀目标时

2.1.3 表达式可用变量

变量名	含义	应用场景示例
health	目标实体的当前生命值	生命值越高，击杀得分越多
distance	玩家与目标的距离（方块）	远程击杀（距离远）加分更高
damage	单次攻击造成的伤害值	高伤害暴击额外加分
damagedealt	对目标的累计伤害值	助攻时按累计伤害计算分数
combo	当前连杀次数	连杀次数越多，加分倍率越高
killscore	击杀基础分数	作为暴击加成等衍生分数的基数

2.2 分数操作功能

2.2.1 玩家自主操作（权限等级0，所有玩家可用）

• 自身分数查询：命令/gdscore，聊天栏返回实时分数（含击杀、任务等累计得分）
• 清除自身卡牌：命令/gdscore cardclear，重置所有持有的分数卡牌（如连杀奖励卡牌）

2.2.2 管理员操作（权限等级2，操作员OP可用）

操作类型	命令格式	作用说明	示例	限制条件
查看玩家分数	/gdscore get <玩家名>	查看指定玩家的当前分数	/gdscore get Steve	需准确输入玩家名
增加玩家分数	/gdscore add <玩家名> <分数>	为指定玩家追加分数	/gdscore add Alex 100	分数≥1，无上限
减少玩家分数	/gdscore reduce <玩家名> <分数>	从指定玩家分数中扣除	/gdscore reduce Bob 50	分数≥1，扣除后最低为0（不允许负分）
强制设置分数	/gdscore set <玩家名> <分数>	覆盖指定玩家当前分数为目标值	/gdscore set Charlie 1000	分数≥0

2.3 计分板集成功能（权限等级2）

• 绑定原版计分板：
  • 命令：/gdscore scoreboard binding <计分板ID> <显示名称>
  • 作用：创建Minecraft原版计分板，实时同步模组分数
  • 示例：/gdscore scoreboard binding killpoints 击杀分数（生成ID为killpoints、显示名为“击杀分数”的计分板）
• 解除绑定：命令/gdscore scoreboard unbind，停止模组与原版计分板的同步
• 核心特点：
  • 实时同步：玩家分数变化时，原版计分板立即更新
  • 兼容原版：可通过Minecraft原生/scoreboard命令查看/管理同步后的分数
  • 自定义显示：支持设置计分板显示名称，提升可读性

2.4 加分项管理（权限等级2）

• 查看所有加分规则：命令/gdscore bonuspoints list，列出当前所有实体/行为的加分表达式
• 重置加分规则：命令/gdscore bonuspoints reset，恢复所有加分项为默认值（如击杀僵尸默认health*5）
• 自定义加分规则：
  • 命令：/gdscore bonuspoints edit <加分项关键词> <表达式>
  • 示例：/gdscore bonuspoints edit kill health * 10（将击杀加分规则改为“生命值×10”）
  • 支持场景：调整击杀、暴击、助攻等所有行为的计分逻辑

三、战斗视觉反馈系统

3.1 三大核心显示模式（可一键切换）

模式名称	标识颜色	核心特点	适用场景	专属效果
滚动模式	红色	击杀元素（图标、字幕）从屏幕底部向上滚动，类似弹幕	快速连续击杀，避免元素重叠	同步滚动动画（缩放+移动），元素依次展示
连杀模式	绿色	元素固定位置显示，连杀数累积时动态更新样式	突出连杀成就感，适合竞技场景	连杀达阈值时字幕/图标闪烁高亮（颜色可自定义）；连杀超时时间可修改（默认3秒）
卡牌模式	黄色	以“卡牌”形式展示击杀信息，最多同时显示5张，呈扇形/并列排布	追求视觉层次感，单机/组队均适用	卡牌入场/退场动画（缩放+旋转+透明度变化）；支持“ACE卡牌”光效（现代风/vanilla风可选）；连杀超时时间默认60秒（可修改）

3.2 视觉元素精细化配置

3.2.1 击杀图标配置（KillIconConfigModule）

配置项名称	可配置范围	功能说明	示例效果
图标动画执行时间	100ms ~ 2000ms	控制图标出现/消失的动画时长	100ms（快速）、2000ms（缓慢流畅）
强制隐藏数量	3 ~ 100个	超过此数量时自动隐藏超出图标，避免界面拥挤	设为5时，第6个图标暂不显示
显示时长	20 ~ 200刻（1刻≈50ms）	单个图标在屏幕上的停留时间	20刻（1秒，快速消失）、200刻（10秒，长时查看）
图标间隔	10 ~ 100像素	多个图标间的横向/纵向间距	10像素（紧凑）、100像素（分散，防重叠）
风格预设	内置多种（简约/写实/像素风等）	统一所有击杀图标的风格	切换“像素风”后，所有图标变为像素化样式
最大显示数量	5 ~ 100个	屏幕最多同时显示的图标数	设为10时，仅保留最新10个击杀图标
可见性开关	启用/禁用	控制是否显示击杀图标	禁用后，击杀时不显示图标
大小调整	16 ~ 96（像素）	调整图标尺寸，不同模式默认值不同	连杀模式默认32像素，卡牌模式默认48像素

3.2.2 击杀字幕配置（SubtitleConfigModule）

配置项名称	可配置内容	功能说明	示例效果
自定义助攻字幕	文本输入（最长200字符，支持变量{player}）	自定义助攻场景的字幕格式	输入{player} 助攻！，助攻时显示“Steve 助攻！”
自定义淘汰字幕	文本输入（最长200字符，支持变量{target}）	自定义击败目标时的字幕格式	输入你击败了 {target}！，显示“你击败了僵尸！”
暴击文字颜色	颜色代码（RGB/十六进制，100字符内）	自定义暴击相关文字的颜色	输入#FF0000，暴击文字显示为红色
目标文字颜色	颜色代码（100字符内）	自定义字幕中目标名称（如怪物/玩家名）的颜色	输入#0000FF，目标名显示为蓝色
武器文字颜色	颜色代码（100字符内）	自定义字幕中武器名称的颜色	输入#FFD700，武器名显示为金色
可见性开关	启用/禁用	控制是否显示击杀字幕	禁用后，击杀时不显示文字反馈
大小调整	50 ~ 200（比例）	调整字幕字体大小，三模式共用配置	设为150时，字体比默认大50%
动画效果	入场缩放（1.5倍→1倍）、亮度渐变（高亮→正常）	增强字幕视觉冲击力	击杀时字幕先放大高亮，再恢复正常尺寸和亮度

3.2.3 分数字幕配置（ScoreConfigModule）

配置项名称	可配置内容	功能说明	示例效果
积分闪烁颜色	颜色代码（RGB/十六进制，100字符内）	自定义分数变化时的闪烁颜色	输入#FFFF00，得分时数字以黄色闪烁
积分高分颜色	颜色代码（100字符内）	单次得分超阈值时的文字颜色（阈值隐含）	输入#9932CC，单次得分超100时显示为紫色
可见性开关	启用/禁用	控制是否显示分数字幕	禁用后，分数变化不显示数字反馈
大小调整	100 ~ 200（比例）	调整分数字体大小，不同模式独立配置	连杀模式设为200（放大2倍），滚动模式设为120
高分高亮	启用/禁用+颜色自定义（默认金色）	高分时自动高亮显示	启用后，单次得分超200时以金色高亮显示

3.2.4 加分项字幕配置（BonusConfigModule）

配置项名称	可配置内容	功能说明	示例效果
字幕行间距	1 ~ 60像素	控制多个加分项字幕的垂直间距	设为10像素（紧凑）、30像素（分散，防重叠）
助攻击败显示名称	文本输入（最长200字符）	自定义助攻加分的显示名称	输入“协助得分”，助攻时显示“协助得分 +50”
连杀显示名称	文本输入（最长200字符）	自定义连杀加分的显示名称	输入“连击奖励”，连杀时显示“连击奖励 +100”
暴击加成显示名称	文本输入（最长200字符）	自定义暴击加分的显示名称	输入“致命一击加分”，暴击时显示“致命一击加分 +30”
造成伤害显示名称	文本输入（最长200字符）	自定义伤害加分的显示名称	输入“输出加分”，造成伤害时显示“输出加分 +10”
空手攻击显示名称	文本输入（最长200字符）	自定义空手加分的显示名称	输入“徒手奖励”，空手击杀时显示“徒手奖励 +20”
击败生物显示名称	文本输入（最长200字符）	自定义击败生物加分的显示名称	输入“怪物奖励”，击败生物时显示“怪物奖励 +15”
远距离击败显示名称	文本输入（最长200字符）	自定义远程击杀加分的显示名称	输入“狙击奖励”，远程击杀时显示“狙击奖励 +50”
魔法伤害显示名称	文本输入（最长200字符）	自定义魔法伤害加分的显示名称	输入“法术伤害加分”，魔法攻击时显示“法术伤害加分 +25”
可见性开关	启用/禁用	控制是否显示加分项字幕	禁用后，加分时不显示文字反馈
大小调整	50 ~ 200（比例）	调整加分项字幕字体大小	设为180时，加分文字比默认大80%

3.2.5 卡牌图标配置（CardIconConfigModule）

配置项名称	可配置内容	功能说明	示例效果
卡牌风格预设	内置多种（卡通/暗黑/扁平化等）	统一所有卡牌图标的风格	切换“暗黑风”后，所有卡牌变为暗黑系样式
卡牌宽度/高度	自定义像素值	调整卡牌尺寸	设为80×120像素，卡牌更宽更高
光效透明度	0% ~ 100%	调整ACE卡牌光效的透明程度	设为50%，光效半透明，不遮挡卡牌内容
旋转角度	-30° ~ 30°	调整卡牌的倾斜角度	设为15°，卡牌向右轻微倾斜

四、实体管理系统（权限等级2）

4.1 实体爆分控制

操作类型	命令格式	作用说明	示例	数据存储
禁止特定实体爆分	/gdscore ban <实体ID>	设置指定实体被击杀后不产生分数	/gdscore ban minecraft:zombie（僵尸不爆分）	存储于gd656killicon_banlist.dat
允许特定实体爆分	/gdscore allow <实体ID>	解除实体爆分限制，恢复计分	/gdscore allow minecraft:skeleton（骷髅爆分）	实时更新Ban列表文件
禁止所有实体爆分	/gdscore ban all	批量禁止所有实体爆分（特殊命令）	-	覆盖Ban列表，标记“all”状态
允许所有实体爆分	/gdscore allow all	批量恢复所有实体爆分（特殊命令）	-	清空Ban列表“all”状态
查看Ban列表	/gdscore banlist	显示当前被禁止爆分的所有实体ID	输出“minecraft:zombie, minecraft:sheep”	读取Ban列表文件数据

4.2 实体ID格式规范

• 格式：minecraft:实体名称（遵循Minecraft原生实体ID规则）
• 常见示例：
  • 僵尸：minecraft:zombie
  • 骷髅：minecraft:skeleton
  • 绵羊：minecraft:sheep
  • 玩家：minecraft:player（通常不建议禁止，避免PVP计分失效）

五、排行榜功能

5.1 排行榜控制（权限等级3，服务器管理员可用）

• 开关控制：
  • 命令：/gdscore rule RankingList <true/false>
  • 作用：开启（true）/关闭（false）全服排行榜
  • 效果：关闭后，玩家使用/gdscore top提示“榜单已被管理员关闭”；仅隐藏显示，不影响分数计算与存储
  • 适用场景：玩家过多时减少服务器带宽占用，或临时隐藏排名

5.2 排行榜查看与同步（权限等级0，所有玩家可用）

• 查看方式：
  • 命令：/gdscore top（需在游戏内使用，主菜单使用提示“请在游戏内查看排行榜”）
  • 显示内容：玩家排名、昵称、分数，顶部标注当前页码与总页数
  • 特殊状态提示：
    • 首次加载：“正在加载排行榜数据...”
    • 无玩家数据：“暂无数据”
• 数据同步机制：
  • 客户端请求：打开排行榜时，客户端发送RankingDataRequestPacket请求数据
  • 服务端响应：服务端返回RankingDataResponsePacket（含玩家UUID、分数）
  • 实时更新：排行榜数据随玩家分数变化即时刷新，无需手动重载

5.3 状态存储

• 排行榜开关状态、玩家排名数据存储于gd656killicon_scores.dat
• 服务器重启后，保留上次设置的开关状态与排名数据

六、指令系统（全指令清单）

6.1 指令前缀说明

所有指令均以/gdscore为前缀，区分大小写（需严格按照小写格式输入）

6.2 按权限等级分类

6.2.1 权限等级0（所有玩家可用）

指令	命令格式	作用说明	补充说明
自身分数查询	/gdscore	查看当前自身实时分数	聊天栏返回结果，含累计得分类型（如击杀、助攻）
排行榜查看	/gdscore top	打开全服排行榜界面	需在游戏内使用；依赖排行榜开关状态
清除自身卡牌	/gdscore cardclear	重置所有持有的分数卡牌（如连杀卡牌）	重置后卡牌效果与显示均消失
帮助中心查看	/gdscore help [页码]	查看模组所有指令与功能说明，支持分页	示例：/gdscore help 2（查看第2页帮助）

6.2.2 权限等级2（操作员OP可用）

指令分类	命令格式	作用说明	示例
分数管理	/gdscore get <玩家名>	查看指定玩家分数	/gdscore get Steve
	/gdscore add <玩家名> <分数>	增加指定玩家分数	/gdscore add Alex 100
	/gdscore reduce <玩家名> <分数>	减少指定玩家分数	/gdscore reduce Bob 50
	/gdscore set <玩家名> <分数>	强制设置指定玩家分数	/gdscore set Charlie 1000
实体管理	/gdscore ban <实体ID>	禁止特定实体爆分	/gdscore ban minecraft:zombie
	/gdscore allow <实体ID>	允许特定实体爆分	/gdscore allow minecraft:skeleton
	/gdscore ban all	禁止所有实体爆分	-
	/gdscore allow all	允许所有实体爆分	-
	/gdscore banlist	查看Ban列表中的实体ID	-
加分项管理	/gdscore bonuspoints list	列出所有加分项表达式	-
	/gdscore bonuspoints reset	重置加分项为默认值	-
	/gdscore bonuspoints edit <关键词> <表达式>	编辑加分项表达式	/gdscore bonuspoints edit kill health*10
计分板集成	/gdscore scoreboard binding <ID> <显示名>	绑定原版计分板	/gdscore scoreboard binding killpoints 击杀分数
	/gdscore scoreboard unbind	解除计分板绑定	-

6.2.3 权限等级3（服务器管理员可用）

指令	命令格式	作用说明	示例	补充说明
排行榜开关控制	/gdscore rule RankingList <true/false>	开启/关闭全服排行榜	/gdscore rule RankingList false（关闭排行榜）	仅管理员可操作，影响所有玩家查看权限
连杀判定时间调整	/gdscore rule CardComboKillDurationTime <秒数>	设置连杀判定时间（默认60秒）	/gdscore rule CardComboKillDurationTime 30（改为30秒）	范围0-3600秒，无效值自动回退默认60秒

七、权限控制体系

权限等级	对应角色	核心权限范围	不可操作内容
0级	所有玩家	自身分数查询、排行榜查看、清除自身卡牌、帮助中心查看	分数修改、实体管理、规则配置、加分项编辑
2级	操作员（OP）	玩家分数增删改查、实体爆分控制、加分项管理、计分板集成	排行榜开关、连杀判定时间调整（需3级权限）
3级	服务器管理员	全权限：含2级所有功能+核心规则配置（排行榜开关、连杀时间）	无（模组最高权限）

八、配置与数据同步

8.1 配置界面系统

8.1.1 主配置界面（ModConfigScreen）

• 进入方式：游戏内“选项-模组设置”→选择GD656Killicon模组；或从其他配置界面返回
• 核心功能：
  • 模式切换：右上角3个颜色按钮（红=滚动、绿=连杀、黄=卡牌），点击高亮当前模式
  • 元素拖动：直接拖动屏幕中的图标/字幕，调整位置（自动吸附屏幕边界，预留20像素边距）
  • 撤销操作：底部“撤销”按钮，支持最多10步拖动操作回退（可查看操作历史）
  • 菜单展开：左上角“≡”按钮，跳转详细配置、刷新分数等
  • 位置重置：底部“重置”按钮，长按3秒确认后恢复当前模式元素默认位置

8.1.2 元素配置界面（ElementConfigScreen）

• 进入方式：主配置界面中点击某一视觉元素（如图标、字幕）
• 配置内容：
  • 顶部标题：显示当前配置元素（如“元素配置：击杀图标”）
  • 基础设置：大小滑块（实时预览效果）、可见性开关
  • 模式专属设置：如卡牌模式的图标光效、滚动模式的动画速度
  • 底部按钮：“保存”（应用配置并返回）、“取消”（放弃修改）

8.1.3 详细配置界面（ConfigScreen）

• 进入方式：主配置界面右上角“详细配置”按钮
• 高级设置：
  • 加分项格式：单独编辑每种加分类型的显示文本（如“击败生物 +{score}”）
  • 颜色配置：输入16进制色值设置武器/目标/暴击/高分等文字颜色
  • 动画参数：调整滚动速度（默认20，值越大越快）、连杀超时时间
  • 音效开关：控制击杀/连杀时的音效启用/禁用
  • 重置默认值：底部“重置”按钮，长按3秒确认后恢复所有配置为初始状态

8.1.4 帮助中心界面

• 进入方式：命令/gdscore help [页码]
• 功能：
  • 分类展示：左侧按钮切换“基础指令”“分数管理”“实体控制”等分类
  • 关键词搜索：顶部搜索框输入关键词（如“加分”）筛选相关命令
  • 滚动查看：支持鼠标滚轮/右侧滚动条浏览内容
  • 返回操作：右上角“返回”按钮回到上一界面

8.2 数据同步机制

8.2.1 服务器→客户端同步

同步内容	同步时机	同步方式	效果
连杀判定时间	玩家登录游戏时	CardComboKillDurationPacket数据包	客户端自动应用服务器设置的连杀时间（如30秒）
排行榜数据	客户端打开排行榜界面时	客户端发送RankingDataRequestPacket→服务端返回RankingDataResponsePacket	客户端实时显示最新排名
分数实时变化	玩家分数增减（如击杀、管理员操作）时	ScoreSyncPacket数据包	客户端立即更新分数显示（聊天栏/计分板）
Ban列表数据	玩家击杀实体时（按需同步）	读取服务端gd656killicon_banlist.dat	确保禁止爆分的实体不产生分数

8.2.2 数据存储位置（世界存档目录）

所有数据保存在世界存档/data/gd656killicon/目录下，服务器重启后不丢失：

文件名	存储内容	关联功能
gd656killicon_scores.dat	玩家分数、排行榜开关状态、连杀判定时间配置	分数管理、排行榜控制
gd656killicon_banlist.dat	被禁止爆分的实体ID列表	实体管理
gd656killicon_score_expressions.dat	自定义的分数计算表达式	加分项管理
gd656killicon_scoreboard_binding.dat	计分板绑定信息（ID、显示名称）	计分板集成

九、兼容性与注意事项

9.1 兼容性支持

• 多人服务器：全功能支持，所有数据由服务端统一管理，确保PVP/PVE公平性（避免客户端作弊）
• 单机游戏：支持所有单人模式，配置与数据存储于本地世界存档
• 原版模组兼容：可与Minecraft原生模组协同，计分板同步功能兼容原版/scoreboard指令

9.2 安全与保护机制

• 权限保护：敏感操作（如修改分数、Ban实体、关闭排行榜）需对应权限等级，防止普通玩家滥用
• 表达式验证：自定义分数表达式仅支持字母、数字、基础运算符（+ - * / .），过滤恶意代码
• 默认值保护：连杀时间、分数表达式等配置若设为无效值（如负数、非法字符），自动回退至默认值

9.3 常见问题解决方案

问题现象	可能原因	解决方案
配置不生效	未点击“保存”按钮；部分设置需重启游戏	确认保存配置；重启游戏（如风格预设类设置）
颜色代码无效	格式错误（如缺少#、字符超范围）	按#RRGGBB格式输入（如#FF0000为红色）
字幕显示乱码	使用特殊符号；输入法编码问题	避免特殊符号；更换输入法重新输入
图标重叠	图标间隔过小；最大显示数量过多	增大“图标间隔”；降低“最大显示数量”
排行榜无数据	无玩家分数记录；排行榜已关闭	进行战斗获取分数；管理员开启排行榜

十、模组信息汇总

信息类别	具体内容	查看方式
模组版本	MenuManager.MOD_VERSION	模组设置界面顶部；模组文件属性
支持Minecraft版本	MenuManager.MINECRAFT_VERSION	模组下载页面；模组设置界面
开发者	MenuManager.DEVELOPER	模组设置界面“关于”页；模组说明文档
核心目标	竞技化战斗评分系统，满足玩家与管理员需求	模组功能概述；本清单核心基础模块

BUG反馈

• 若有任何模组的bug技术问题请发送邮件至mc_bug656@outlook.com

介绍视频

• 【【模组发布】它可以让你的MC手感爆炸！仿FPS游戏的击杀图标】 https://www.bilibili.com/video/BV1RTYsz8Eag/

使用注意事项

自定义配置文件汉化

#击杀图标设置
[kill_icon]

# 击杀图标显示时长（以游戏刻为单位）
# 取值范围：20 ~ 200（20 至 200）
duration = 40

# 淡出时间（以游戏刻为单位）
# 取值范围：10 ~ 60（10 至 60）
fadeTime = 20

# 击杀图标尺寸（以像素为单位）
# 取值范围：16 ~ 64（16 至 64）
size = 32


#文本颜色设置
[text_colors]

# 武器文本颜色（十六进制格式，例如 008080）
weaponColor = "008080"

# 目标文本颜色（十六进制格式，例如 FF0000）
targetColor = "008080"

自定义图标音效方法

1. 自定义图标路径为resources\assets\gd656killicon\textures\gui\kill_icon.png
2. 自定义音频路径为resources\assets\gd656killicon\sounds\kill_sound.ogg（我准备了三款游戏的音频，将文件名换成kill_sound.ogg即可）

需自行解包本模组的jar文件来制作资源包

版权问题

您可以在任何您的商业/私人服务器使用此模组