Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Creators
Details
Licensed Apache-2.0
Published 2 months ago
Updated 4 days ago
注意！本模组不兼容Optifine！请使用Embedium组合！
注意！本模组需要搭配Forge47.4.4以上版本使用！
GD656Killicon Mod Function Project List
1. Core Foundation Module
1.1 Mod Positioning and Core Objectives
- Positioning: A comprehensive tool mod focused on competitive combat scoring and visual feedback in games, covering the full workflow of "score management - visual display - permission control - data synchronization".
- Core Objectives:
- For regular players: Meet needs for score query, leaderboard viewing, and personalized visual feedback.
- For admins: Meet needs for score adjustment, rule customization, entity management, and system configuration.
- Adapt to scenarios: Single-player games, multiplayer servers (supports both PVP and PVE modes).
1.2 Basic Information
- Version Identification: The mod version is subject to
MenuManager.MOD_VERSION(refer to the mod's actual information for the specific version). - Supported Game Version: Compatible with the Minecraft version corresponding to
MenuManager.MINECRAFT_VERSION. - Developer Information:
MenuManager.DEVELOPER - Core Dependencies: No additional third-party mod dependencies; can run independently.
2. Score Management System
2.1 Score Calculation Mechanism (Dynamic Expression System)
2.1.1 Core Rules
- Scores are calculated based on "action type + custom expression", supporting basic arithmetic operations (
+,-,*,/). - Expressions take effect in real time; no mod/game restart is required after modification.
- Invalid expressions (including illegal characters and syntax errors) automatically fall back to default values.
2.1.2 Default Score Rules (Customizable)
| Action Type | Command Keyword | Default Expression | Calculation Logic Description | Applicable Scenario |
|---|---|---|---|---|
| Kill | kill |
health * 5 |
Score = Target entity's health × 5 | Scoring when defeating mobs/players |
| Critical Bonus | critical |
killscore * 0.25 |
Score = Base kill score × 25% (additional reward) | When landing a critical kill on the target |
| Long-Range Kill | longrange |
distance |
Score = Kill distance (unit: blocks) | When killing the target from a distance |
| Damage Dealt | damage |
damage |
Score = Damage dealt in a single attack | When dealing damage to the target without killing it |
| Magic Damage | magic |
damage |
Score = Damage dealt by magical attacks | When attacking the target with magical 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 accumulated damage to the target × 5 | When assisting teammates in killing the target |
| Combo Bonus | combobonus |
combo * 8 |
Score = Number of consecutive kills × 8 (additional reward) | When killing targets consecutively |
2.1.3 Variables Available for Expressions
| Variable Name | Meaning | Application Example |
|---|---|---|
health |
Current health of the target entity | Higher health = higher kill score |
distance |
Distance between player and target (in blocks) | Longer kill distance = higher bonus score |
damage |
Damage dealt in a single attack | Higher critical damage = additional bonus |
damagedealt |
Total accumulated damage to the target | Assist score calculated based on accumulated damage |
combo |
Current number of consecutive kills | More consecutive kills = higher bonus multiplier |
killscore |
Base kill score | Serves as the base for derived scores like critical bonuses |
2.2 Score Operation Functions
2.2.1 Player-Self Operations (Permission Level 0, Available to All Players)
- Check Own Score: Command
/gdscore; returns real-time scores (including accumulated scores from kills, tasks, etc.) in the chat box. - Clear Own Cards: Command
/gdscore cardclear; resets all held score cards (e.g., consecutive kill reward cards).
2.2.2 Admin Operations (Permission Level 2, Available to Operators/OPs)
| Operation Type | Command Format | Function Description | Example | Restrictions |
|---|---|---|---|---|
| Check Player's Score | /gdscore get <Player Name> |
View the specified player's current score | /gdscore get Steve |
Must enter the player's name correctly |
| Add Player's Score | /gdscore add <Player Name> <Score> |
Add scores to the specified player | /gdscore add Alex 100 |
Score ≥ 1, no upper limit |
| Reduce Player's 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 specified player's current score to the target value | /gdscore set Charlie 1000 |
Score ≥ 0 |
2.3 Scoreboard Integration (Permission Level 2)
- Bind Vanilla Scoreboard:
- Command:
/gdscore scoreboard binding <Scoreboard ID> <Display Name> - Function: Creates a Minecraft vanilla scoreboard that synchronizes with mod scores in real time.
- Example:
/gdscore scoreboard binding killpoints Kill Score(Generates a scoreboard with IDkillpointsand display name "Kill Score").
- Command:
- 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 the player's score changes.
- Vanilla Compatibility: The synchronized scores can be viewed/managed via Minecraft's native
/scoreboardcommand. - Custom Display: Supports setting the scoreboard's display name to improve readability.
2.4 Bonus Item Management (Permission Level 2)
- View All Bonus Rules: Command
/gdscore bonuspoints list; lists all current bonus expressions for entities/actions. - Reset Bonus Rules: Command
/gdscore bonuspoints reset; restores all bonus items to default values (e.g., the defaulthealth*5for zombie kills). - Customize Bonus Rules:
- Command:
/gdscore bonuspoints edit <Bonus Keyword> <Expression> - Example:
/gdscore bonuspoints edit kill health * 10(Modifies the kill bonus rule to "Health × 10"). - Supported Scenarios: Adjusts the scoring logic for all actions such as kills, critical hits, and assists.
- Command:
3. Combat Visual Feedback System
3.1 Three Core Display Modes (One-Click Switchable)
| Mode Name | Marker 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 | Rapid consecutive kills, avoiding element overlap | Synchronized scrolling animation (scaling + movement), elements displayed in sequence |
| Combo Mode | Green | Elements displayed at fixed positions; style dynamically updates as 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 | Displays kill information in the form of "cards"; up to 5 cards displayed simultaneously in a fan/side-by-side arrangement | Pursues visual layering, suitable for single-player/team play | Card entry/exit animations (scaling + rotation + transparency change); supports "ACE Card" light effects (modern style/vanilla style optional); consecutive kill timeout defaults to 60 seconds (modifiable) |
3.2 Refined Configuration of Visual Elements
3.2.1 Kill Icon Configuration (KillIconConfigModule)
| Configuration Item | Configurable Range | Function Description | Example Effect |
|---|---|---|---|
| Icon Animation Duration | 100ms ~ 2000ms | Controls the duration of icon appearance/disappearance animations | 100ms (fast), 2000ms (slow and smooth) |
| Forced Hide Count | 3 ~ 100 | Automatically hides excess icons when this count is exceeded to avoid interface clutter | When set to 5, the 6th icon is temporarily hidden |
| Display Duration | 20 ~ 200 ticks (1 tick ≈ 50ms) | Duration that a single icon stays on the screen | 20 ticks (1 second, fades quickly), 200 ticks (10 seconds, long viewing) |
| Icon Spacing | 10 ~ 100 pixels | Horizontal/vertical spacing between multiple icons | 10 pixels (compact), 100 pixels (spaced out, anti-overlap) |
| Style Presets | Multiple built-in (minimalist/realistic/pixel style, etc.) | Unifies the style of all kill icons | After switching to "pixel style", all icons become pixelated |
| Maximum Display Count | 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 kill icons are displayed | No icons are displayed when disabled |
| Size Adjustment | 16 ~ 96 (pixels) | Adjusts icon size; default values vary by mode | Default 32 pixels for Combo Mode, 48 pixels for Card Mode |
3.2.2 Kill Subtitle Configuration (SubtitleConfigModule)
| Configuration Item | Configurable Content | Function Description | Example Effect |
|---|---|---|---|
| Custom Assist Subtitle | Text input (max 200 characters, supports variable {player}) |
Customizes the subtitle format for assist scenarios | Enter {player} Assisted!, displays "Steve Assisted!" when assisting |
| Custom Elimination Subtitle | Text input (max 200 characters, supports variable {target}) |
Customizes the subtitle format for defeating targets | Enter You defeated {target}!, displays "You defeated Zombie!" |
| Critical Hit Text Color | Color code (RGB/hexadecimal, max 100 characters) | Customizes the color of critical hit-related text | Enter #FF0000, critical hit text displays in red |
| Target Text Color | Color code (max 100 characters) | Customizes the color of target names (e.g., mob/player names) in subtitles | Enter #0000FF, target names display in blue |
| Weapon Text Color | Color code (max 100 characters) | Customizes the color of weapon names in subtitles | Enter #FFD700, weapon names display in gold |
| Visibility Toggle | Enable/Disable | Controls whether kill subtitles are displayed | No text feedback is displayed when disabled |
| Size Adjustment | 50 ~ 200 (scale ratio) | Adjusts subtitle font size; shared across all three modes | When set to 150, the font is 50% larger than default |
| Animation Effects | Entry scaling (1.5x → 1x), brightness fade (highlight → normal) | Enhances the visual impact of subtitles | When a kill occurs, the subtitle first zooms in and highlights, then returns to normal size and brightness |
3.2.3 Score Subtitle Configuration (ScoreConfigModule)
| Configuration Item | Configurable Content | Function Description | Example Effect |
|---|---|---|---|
| Score Flash Color | Color code (RGB/hexadecimal, max 100 characters) | Customizes the flash color when scores change | Enter #FFFF00, score numbers flash yellow when scoring |
| High Score Text Color | Color code (max 100 characters) | Text color for single scores exceeding the threshold (threshold is implicit) | Enter #9932CC, scores over 100 display in purple |
| Visibility Toggle | Enable/Disable | Controls whether score subtitles are displayed | No numerical feedback is displayed when disabled |
| Size Adjustment | 100 ~ 200 (scale ratio) | Adjusts score font size; independent configuration for each mode | Set to 200 (2x magnification) for Combo Mode, 120 for Scroll Mode |
| High Score Highlight | Enable/Disable + custom color (default gold) | Automatically highlights high scores | When enabled, scores over 200 display in highlighted gold |
3.2.4 Bonus Subtitle Configuration (BonusConfigModule)
| Configuration Item | 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 (spaced out, anti-overlap) |
| Assist Kill Display Name | Text input (max 200 characters) | Customizes the display name for assist bonuses | Enter "Assist Score", displays "Assist Score +50" when assisting |
| Combo Display Name | Text input (max 200 characters) | Customizes the display name for combo bonuses | Enter "Combo Reward", displays "Combo Reward +100" for combos |
| Critical Bonus Display Name | Text input (max 200 characters) | Customizes the display name for critical bonuses | Enter "Critical Strike Bonus", displays "Critical Strike Bonus +30" for critical hits |
| Damage Dealt Display Name | Text input (max 200 characters) | Customizes the display name for damage bonuses | Enter "Damage Output Bonus", displays "Damage Output Bonus +10" when dealing damage |
| Unarmed Attack Display Name | Text input (max 200 characters) | Customizes the display name for unarmed bonuses | Enter "Unarmed Reward", displays "Unarmed Reward +20" for unarmed kills |
| Mob Kill Display Name | Text input (max 200 characters) | Customizes the display name for mob kill bonuses | Enter "Mob Reward", displays "Mob Reward +15" for mob kills |
| Long-Range Kill Display Name | Text input (max 200 characters) | Customizes the display name for long-range kill bonuses | Enter "Snipe Reward", displays "Snipe Reward +50" for long-range kills |
| Magic Damage Display Name | Text input (max 200 characters) | Customizes the display name for magic damage bonuses | Enter "Magic Damage Bonus", displays "Magic Damage Bonus +25" for magic attacks |
| Visibility Toggle | Enable/Disable | Controls whether bonus subtitles are displayed | No text feedback is displayed when disabled |
| Size Adjustment | 50 ~ 200 (scale ratio) | Adjusts bonus subtitle font size | When set to 180, the bonus text is 80% larger than default |
3.2.5 Card Icon Configuration (CardIconConfigModule)
| Configuration Item | Configurable Content | Function Description | Example Effect |
|---|---|---|---|
| Card Style Presets | Multiple built-in (cartoon/dark/flat design, etc.) | Unifies the style of all card icons | After switching to "dark style", all cards adopt a dark-themed design |
| Card Width/Height | Custom pixel values | Adjusts card size | Set to 80×120 pixels for wider and taller cards |
| Light Effect Transparency | 0% ~ 100% | Adjusts the transparency of ACE Card light effects | Set to 50% for semi-transparent light effects that do not block card content |
| Rotation Angle | -30° ~ 30° | Adjusts the tilt angle of cards | Set to 15° for a slight right tilt of cards |
4. Entity Management System (Permission Level 2)
4.1 Entity Score Drop Control
| Operation Type | Command Format | Function Description | Example | Data Storage |
|---|---|---|---|---|
| Forbid Score Drop from Specific Entities | /gdscore ban <Entity ID> |
Sets specified entities to not drop scores when killed | /gdscore ban minecraft:zombie (Zombies do not drop scores) |
Stored in gd656killicon_banlist.dat |
| Allow Score Drop from Specific Entities | /gdscore allow <Entity ID> |
Removes the score drop restriction for entities, restoring scoring | /gdscore allow minecraft:skeleton (Skeletons drop scores) |
Updates the Ban list file in real time |
| Forbid Score Drop from All Entities | /gdscore ban all |
Batch-forbids score drops from all entities (special command) | - | Overwrites the Ban list, marking "all" status |
| Allow Score Drop from All Entities | /gdscore allow all |
Batch-restores score drops for all entities (special command) | - | Clears the "all" status in the Ban list |
| View Ban List | /gdscore banlist |
Displays all entity IDs currently forbidden from dropping scores | Outputs "minecraft:zombie, minecraft:sheep" | Reads data from the Ban list file |
4.2 Entity ID Format Specification
- Format:
minecraft:entity_name(follows Minecraft's native entity ID rules). - Common Examples:
- Zombie:
minecraft:zombie - Skeleton:
minecraft:skeleton - Sheep:
minecraft:sheep - Player:
minecraft:player(usually not recommended to forbid to avoid PVP scoring failure).
- Zombie:
5. Leaderboard Function
5.1 Leaderboard Control (Permission Level 3, Available to Server Admins)
- Toggle Control:
- Command:
/gdscore rule RankingList <true/false> - Function: Enables (
true) / disables (false) the server-wide leaderboard. - Effect: After disabling, players using
/gdscore topwill see "Leaderboard disabled by admin"; only hides the display, does not affect score calculation and storage. - Applicable Scenario: Reduces server bandwidth usage when there are too many players, or temporarily hides rankings.
- Command:
5.2 Leaderboard Viewing and Synchronization (Permission Level 0, Available to All Players)
- Viewing Method:
- Command:
/gdscore top(must be used in-game; using it in the main menu prompts "Please view the leaderboard in-game"). - Display Content: Player ranking, nickname, score; current page number and total pages marked at the top.
- Special Status Prompts:
- First load: "Loading leaderboard data..."
- No player data: "No data available"
- Command:
- Data Synchronization Mechanism:
- Client Request: When opening the leaderboard, the client sends a
RankingDataRequestPacketto request data. - Server Response: The server returns a
RankingDataResponsePacket(including player UUID and score). - Real-time Update: Leaderboard data refreshes immediately as player scores change; no manual reload is required.
- Client Request: When opening the leaderboard, the client sends a
5.3 State Storage
- Leaderboard toggle status and player ranking data are stored in
gd656killicon_scores.dat. - After the server restarts, the previously set toggle status and ranking data are retained.
6. Command System (Full Command List)
6.1 Command Prefix Description
All commands use /gdscore as the prefix and are case-sensitive (must be entered in lowercase strictly).
6.2 Categorization by Permission Level
6.2.1 Permission Level 0 (Available to All Players)
| Command | Command Format | Function Description | Supplementary Notes |
|---|---|---|---|
| Check Own Score | /gdscore |
Views current real-time score | Returns the result in the chat box, including accumulated score types (e.g., kills, assists) |
| View Leaderboard | /gdscore top |
Opens the server-wide leaderboard interface | Must be used in-game; depends on the leaderboard toggle status |
| Clear Own Cards | /gdscore cardclear |
Resets all held score cards (e.g., combo cards) | After reset, card effects and display disappear |
| View Help Center | /gdscore help [Page Number] |
Views descriptions of all mod commands and functions, supports pagination | Example: /gdscore help 2 (views page 2 of help) |
6.2.2 Permission Level 2 (Available to Operators/OPs)
| Command Category | Command Format | Function Description | Example |
|---|---|---|---|
| Score Management | /gdscore get <Player Name> |
Views the specified player's score | /gdscore get Steve |
/gdscore add <Player Name> <Score> |
Adds scores to the specified player | /gdscore add Alex 100 |
|
/gdscore reduce <Player Name> <Score> |
Deducts scores from the specified player | /gdscore reduce Bob 50 |
|
/gdscore set <Player Name> <Score> |
Force-sets the specified player's score | /gdscore set Charlie 1000 |
|
| Entity Management | /gdscore ban <Entity ID> |
Forbids score drops from specific entities | /gdscore ban minecraft:zombie |
/gdscore allow <Entity ID> |
Allows score drops from specific entities | /gdscore allow minecraft:skeleton |
|
/gdscore ban all |
Forbids score drops from all entities | - | |
/gdscore allow all |
Allows score drops from all entities | - | |
/gdscore banlist |
Views entity IDs in the Ban list | - | |
| Bonus Management | /gdscore bonuspoints list |
Lists all bonus expressions | - |
/gdscore bonuspoints reset |
Resets bonus items to default values | - | |
/gdscore bonuspoints edit <Keyword> <Expression> |
Edits bonus item expressions | /gdscore bonuspoints edit kill health*10 |
|
| Scoreboard Integration | /gdscore scoreboard binding <ID> <Display Name> |
Binds a vanilla scoreboard | /gdscore scoreboard binding killpoints Kill Score |
/gdscore scoreboard unbind |
Unbinds the scoreboard | - |
6.2.3 Permission Level 3 (Available to Server Admins)
| Command | Command Format | Function Description | Example | Supplementary Notes |
|---|---|---|---|---|
| Leaderboard Toggle Control | /gdscore rule RankingList <true/false> |
Enables/disables the server-wide leaderboard | /gdscore rule RankingList false (disables the leaderboard) |
Only admins can operate; affects all players' viewing permissions |
| Adjust Consecutive Kill Judgment Time | /gdscore rule CardComboKillDurationTime <Seconds> |
Sets the consecutive kill judgment time (default 60 seconds) | /gdscore rule CardComboKillDurationTime 30 (changes to 30 seconds) |
Range: 0-3600 seconds; invalid values automatically fall back to the default 60 seconds |
7. Permission Control System
| Permission Level | Corresponding Role | Core Permission Scope | Unauthorized Operations |
|---|---|---|---|
| Level 0 | All Players | Check own score, view leaderboard, clear own cards, view help center | Modify scores, manage entities, configure rules, edit bonus items |
| Level 2 | Operators (OPs) | Add/delete/modify/check player scores, control entity score drops, manage bonus items, integrate scoreboards | Leaderboard toggle, adjust consecutive kill judgment time (requires Level 3 permission) |
| Level 3 | Server Admins | Full permissions: includes all Level 2 functions + core rule configuration (leaderboard toggle, consecutive kill time) | None (highest permission for the mod) |
8. Configuration and Data Synchronization
8.1 Configuration Interface System
8.1.1 Main Configuration Interface (ModConfigScreen)
- Access Method: In-game "Options - Mod Settings" → select the GD656Killicon mod; or return from other configuration interfaces.
- Core Functions:
- Mode Switch: 3 color buttons in the top right corner (red=Scroll, green=Combo, yellow=Card); click to highlight the current mode.
- Element Drag: Directly drag icons/subtitles on the screen to adjust positions (automatically snaps to screen borders, with a 20-pixel margin reserved).
- Undo Operation: "Undo" button at the bottom; supports up to 10 steps of drag operation rollback (operation history is viewable).
- Menu Expansion: "≡" button in the top left corner; jumps to detailed configuration, score refresh, etc.
- Reset Position: "Reset" button at the bottom; hold for 3 seconds to confirm and restore the default positions of current mode elements.
8.1.2 Element Configuration Interface (ElementConfigScreen)
- Access Method: Click a visual element (e.g., icon, subtitle) in the main configuration interface.
- Configuration Content:
- Top Title: Displays the current configuration element (e.g., "Element Configuration: Kill Icon").
- Basic Settings: Size slider (with real-time preview), visibility toggle.
- Mode-Specific Settings: e.g., icon light effects for Card Mode, animation speed for Scroll Mode.
- Bottom Buttons: "Save" (applies the configuration and returns), "Cancel" (discards changes).
8.1.3 Detailed Configuration Interface (ConfigScreen)
- Access Method: "Detailed Configuration" button in the top right corner of the main configuration interface.
- Advanced Settings:
- Bonus Format: Edit the display text for each bonus type individually (e.g., "Mob Kill +{score}").
- Color Configuration: Enter a hex color code to set text colors for weapons, targets, critical hits, high scores, etc.
- Animation Parameters: Adjust scroll speed (default 20; higher value = faster), consecutive kill timeout.
- Sound Toggle: Enable/disable sounds for kills/consecutive kills.
- Reset to Default: "Reset" button at the bottom; hold for 3 seconds to confirm and restore all configurations to their initial state.
8.1.4 Help Center Interface
- Access Method: Command
/gdscore help [Page Number]. - Functions:
- Categorized Display: Buttons on the left switch between categories such as "Basic Commands", "Score Management", and "Entity Control".
- Keyword Search: Enter keywords (e.g., "bonus") in the top search box to filter related commands.
- Scroll View: Supports mouse wheel/right scroll bar to browse content.
- Return Operation: "Back" button in the top right corner returns to the previous interface.
8.2 Data Synchronization Mechanism
8.2.1 Server → Client Synchronization
| Synchronized Content | Synchronization Timing | Synchronization Method | Effect |
|---|---|---|---|
| Consecutive Kill Judgment Time | When the player logs into the game | CardComboKillDurationPacket data packet |
The client automatically applies the consecutive kill time set by the server (e.g., 30 seconds) |
| Leaderboard Data | When the client opens the leaderboard interface | Client sends RankingDataRequestPacket → server returns RankingDataResponsePacket |
The client displays the latest rankings in real time |
| Real-time Score Changes | When player scores increase/decrease (e.g., kills, admin operations) | ScoreSyncPacket data packet |
The client updates the score display immediately (chat box/scoreboard) |
| Ban List Data | When the player kills an entity (synchronized on demand) | Reads the server's gd656killicon_banlist.dat |
Ensures entities forbidden from dropping scores do not generate scores |
8.2.2 Data Storage Location (World Save Directory)
All data is saved in the world save directory /data/gd656killicon/ and will not be lost after the server restarts:
| File Name | Stored Content | Associated Function |
|---|---|---|
gd656killicon_scores.dat |
Player scores, leaderboard toggle status, consecutive kill judgment time configuration | Score management, leaderboard control |
gd656killicon_banlist.dat |
List of entity IDs forbidden from dropping scores | Entity management |
gd656killicon_score_expressions.dat |
Customized score calculation expressions | Bonus item management |
gd656killicon_scoreboard_binding.dat |
Scoreboard binding information (ID, display name) | Scoreboard integration |
9. Compatibility and Notes
9.1 Compatibility Support
- Multiplayer Servers: Full function support; all data is managed uniformly by the server to ensure PVP/PVE fairness (prevents client cheating).
- Single-Player Games: Supports all single-player modes; configurations and data are stored in local world saves.
- Vanilla Mod Compatibility: Can work with Minecraft native mods; the scoreboard synchronization function is compatible with the vanilla
/scoreboardcommand.
9.2 Security and Protection Mechanisms
- Permission Protection: Sensitive operations (e.g., modifying scores, banning entities, disabling the leaderboard) require corresponding permission levels to prevent abuse by ordinary players.
- Expression Verification: Custom score expressions only support letters, numbers, and basic operators (
+,-,*,/,.) to filter malicious code. - Default Value Protection: If configurations such as consecutive kill time and score expressions are set to invalid values (e.g., negative numbers, illegal characters), they automatically fall back to default values.
9.3 Common Issue Solutions
| Issue Phenomenon | Possible Cause | Solution |
|---|---|---|
| Configuration Not Taking Effect | Did not click the "Save" button; some settings require a game restart | Confirm the configuration is saved; restart the game (e.g., for style preset settings) |
| Invalid Color Code | Format error (e.g., missing #, out-of-range characters) |
Enter the code in #RRGGBB format (e.g., #FF0000 for red) |
| Subtitle Garbled Display | Using special symbols; input method encoding issue | Avoid special symbols; switch input methods and re-enter |
| Icon Overlap | Icon spacing too small; maximum display count too high | Increase "Icon Spacing"; decrease "Maximum Display Count" |
| Leaderboard No Data | No player score records; leaderboard disabled | Engage in combat to earn scores; admins enable the leaderboard |
10. Mod Information Summary
| Information Category | Specific Content | Viewing Method |
|---|---|---|
| Mod Version | MenuManager.MOD_VERSION |
Top of the mod settings interface; mod file properties |
| Supported Minecraft Version | MenuManager.MINECRAFT_VERSION |
Mod download page; mod settings interface |
| Developer | MenuManager.DEVELOPER |
"About" page in the mod settings interface; mod description document |
| Core Objective | A competitive combat scoring system to meet the needs of players and admins | Mod function overview; Core Foundation Module in this list |
Mod Animation Description
- All animations adopt a linear style, ensuring absolute comfort, naturalness, and crispness.
Bug Reporting
- For any technical bugs or issues related to the mod, please send an email to mc_bug656@outlook.com.
Introduction Video
- 【【模组发布】它可以让你的MC手感爆炸！仿FPS游戏的击杀图标】 https://www.bilibili.com/video/BV1RTYsz8Eag/
Usage Notes
Localization of Custom Configuration File
#Kill Icon Settings
[kill_icon]
# Display duration of the kill icon (in game ticks)
# Range: 20 ~ 200 (20 to 200)
duration = 40
# Fade-out time (in game ticks)
# Range: 10 ~ 60 (10 to 60)
fadeTime = 20
# Size of the kill icon (in pixels)
# Range: 16 ~ 64 (16 to 64)
size = 32
#Text Color Settings
[text_colors]
# Color for weapon text (hexadecimal format, e.g. 008080)
weaponColor = "008080"
# Color for target text (hexadecimal format, e.g. FF0000)
targetColor = "008080"
Method for Customizing Icon and Sound Effect
- The file path for custom icons is resources\assets\gd656killicon\textures\gui\kill_icon.png
- The file path for custom audio is resources\assets\gd656killicon\sounds\kill_sound.ogg (Three audio files from different games are provided; simply rename the desired file to "kill_sound.ogg" to use it).
You need to unpack the mod's JAR file yourself to create a resource pack.
Copyright Information
Using this mod on any commercial server requires prior approval from the author! Please send an email to mc_bug656@outlook.com for permission.
GD656Killicon模组功能项目清单
一、核心基础模块
1.1 模组定位与核心目标
- 定位：专注于游戏内竞技化战斗评分与视觉反馈的综合性工具模组，覆盖“分数管理-视觉展示-权限管控-数据同步”全流程
- 核心目标：
- 满足普通玩家：分数查询、排行榜查看、个性化视觉反馈需求
- 满足管理员：分数调控、规则自定义、实体管理、系统配置需求
- 适配场景：单机游戏、多人服务器（PVP/PVE模式均支持）
1.2 基础信息
- 版本标识：模组版本以
MenuManager.MOD_VERSION为准（具体版本需查看模组实际信息） - 支持游戏版本：适配
MenuManager.MINECRAFT_VERSION对应的Minecraft版本 - 开发者信息：
MenuManager.DEVELOPER - 核心依赖：无额外第三方模组依赖，可独立运行
二、分数管理系统
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"
自定义图标音效方法
- 自定义图标路径为resources\assets\gd656killicon\textures\gui\kill_icon.png
- 自定义音频路径为resources\assets\gd656killicon\sounds\kill_sound.ogg（我准备了三款游戏的音频，将文件名换成kill_sound.ogg即可）
需自行解包本模组的jar文件来制作资源包
版权问题
在任何商业服务器使用本模组需要经过作者本人同意！请发送邮件至mc_bug656@outlook.com