Compatibility
Minecraft: Java Edition
1.21.3–1.21.4
1.21–1.21.1
1.20.6
1.20.1–1.20.4
1.19.2
1.18.2
Platforms
Supported environments
Links
Creators
Details
Licensed Apache-2.0
Published 2 months ago
Updated 3 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 IDkillpoints
and 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
/scoreboard
command. - 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*5
for 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 top
will 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
RankingDataRequestPacket
to 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
/scoreboard
command.
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