Downed Gun Lock v1.3.0

This update adds a match management system for organized games.

Servers can now control match flow using commands or command blocks, including match timers, team kill tracking, HUD displays, and automatic end-of-match actions.

Added Features

• Added match management system
• Added match start, pause, resume, and end controls
• Added match timer support
  • Countdown timer
  • Elapsed time mode
• Added team-based kill tracking
• Added top-right match HUD display
• Added chat notifications for match state changes
• Added match result display after the game ends
  • Center title display
  • Final result HUD
• Added automatic Minecraft command execution when a match ends
• Added match state saving to the world
• Added safe match restoration after server restart
• Added support for reconnecting and respawning during an active match

Match Commands

Settings

/gunlock match set name <match_name>
/gunlock match set time <0 | seconds>s | minutesm | hoursh
/gunlock match set end-command run <minecraft_command>
/gunlock match clear end-command
/gunlock match team add <team_name>
/gunlock match team remove <team_name>
/gunlock match team list
/gunlock match team clear
/gunlock match info
/gunlock match reset-settings

Match Control

/gunlock match start
/gunlock match pause
/gunlock match unpause
/gunlock match end
/gunlock match status

Commands require permission level 2 or higher, or can be executed from command blocks.

Match Timer

Examples:

90s = 90 seconds
10m = 10 minutes
1h  = 1 hour
0   = No time limit

When a time limit is set, the remaining time is displayed. When set to 0, elapsed time is displayed instead.

The timer and score remain visible while the match is paused.

Kill Tracking

Kills are counted based on PlayerRevive's final death state.

• The enemy team that dealt the last valid damage receives the kill
• Fall damage, self-damage, and environmental deaths are counted if the player was previously damaged by an enemy
• Deaths without recent enemy damage are not counted
• Friendly fire is ignored
• Damage records are cleared after revival, respawn, leaving/changing teams, or other state changes
• Forced deaths from team wipes follow the same rules
• Duplicate kill counting is prevented

Team wipe detection, automatic respawn, and downed weapon restrictions remain active regardless of match state.

Match End Handling

When the timer expires or /gunlock match end is executed:

1. Timer and kill tracking stop
2. Final results are saved
3. Results are displayed through chat, title, and HUD
4. The configured end command is executed once

The end command runs with command block level permissions.

HUD and Result Display

The HUD can display:

• Match name
• Remaining or elapsed time
• Pause status
• Team names and colors
• Team kill counts
• Final ranking and results

Default display duration:

• Center title: 5 seconds
• Final result HUD: 30 seconds

New Configuration

Added new settings in:

serverconfig/downedgunlock-server.toml

[match]
    defaultName = "Match"
    defaultTimeSeconds = 0
    defaultTeams = []
    defaultEndCommand = ""

[matchDisplay]
    endTitleDurationSeconds = 5
    resultHudDurationSeconds = 30

Match settings can also be changed in-game without restarting the server.

Security and Stability Improvements

• Restricted end commands to command block permission level
• Added limits for match names, team count, and command length
• Added validation for configuration, commands, saved data, and network data
• Improved handling of corrupted save data
• Rejected invalid team data received over the network
• Updated Gradle and build configuration
• Added SHA-256 verification for dependencies and online dependencies
• Added build support for Windows, Intel Mac, and Apple Silicon Mac

Important

Downed Gun Lock v1.3.0 must be installed on both the client and server.

This version adds new match HUD networking and is not compatible with v1.2.x.

Update the server and all clients to v1.3.0 at the same time.