# Team Deathmatch Plugin
\n
\n
\n
\n
\n
\n<\/p>\n
A competitive Team Deathmatch plugin for Minecraft Paper 1.21.1 featuring class-based combat, multiple game modes, and comprehensive scoring systems.<\/p>\n
## Overview<\/p>\n
Team Deathmatch brings fast-paced PvP action to your server with support for both classic 4v4 team battles and free-for-all matches with up to 10 color-coded teams. Players choose from unique combat classes, compete for kills and assists, and track their performance on a live scoreboard.<\/p>\n
## Game Modes<\/p>\n
### 4v4 Mode
\nClassic Red vs Blue team battles with automatic team balancing. Perfect for organized competitive matches.<\/p>\n
### Free-For-All Mode
\nSupport for up to 10 color-coded teams (Red, Blue, Green, Yellow, Purple, Orange, Aqua, Gray, White, Black). Admins can enable\/disable specific teams through the admin GUI to customize the match size.<\/p>\n
## Player Commands<\/p>\n
### Joining a Match ### Class Selection ## Combat Classes<\/p>\n ### Sharpshooter ### Berserker ### Knight ### Glass Cannon And more…<\/p>\n ## Scoring System<\/p>\n ### Points ### Headshots ### Assists ### Kill Streaks ### Scoreboard ## Match Flow<\/p>\n 1. **Activation**: An admin activates a match though the admin GUI or `\/tdm activate` (FFA) or `\/tdm activate 4v4` ## Admin Commands<\/p>\n – `\/tdm activate [4v4]` – Activate a new match – `\/tdm start` – Manually start the activated match<\/p>\n – `\/tdm end` – End the current match immediately and display final statistics<\/p>\n – `\/tdm setspawn – `\/tdm gui` – Open the admin control panel ## Configuration<\/p>\n The plugin is highly configurable through `config.yml`. Key settings include:<\/p>\n ### Game Settings ### Team Settings ### Scoring ### Game Rules ### Damage Multipliers ### Headshot Detection ### Sounds “`yaml To add a new class: The plugin will automatically load all enabled classes from the config and display them in the class selection GUI.<\/p>\n ## Features<\/p>\n – Multiple game modes (4v4 and FFA) ## Permissions<\/p>\n – `tdm.admin` – Access to admin commands and GUI (default: op)<\/p>\n ## Requirements<\/p>\n – Minecraft Server: Paper 1.21.1 or compatible fork ## Installation<\/p>\n 1. Download the plugin JAR file A plugin to facilitate easy Team Deathmatch minigames<\/p>\n","protected":false},"featured_media":152446,"template":"","meta":{"_minecraft_slug":"teamdeathmatch","_minecraft_project_id":"9z4EEwDT","_minecraft_author":"i_c0de","_minecraft_license":"CC-BY-SA-4.0","_minecraft_downloads":19,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"teamdeathmatch.zip","_minecraft_size_bytes":131318,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:34:51.406651Z","_minecraft_date_created":"2026-03-04T22:01:07.350040Z","_minecraft_date_modified":"2026-04-01T11:36:58.335017Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/teamdeathmatch","_minecraft_icon_attachment_id":152446,"_minecraft_imported_at":"2026-06-09T05:16:44+00:00","_minecraft_import_hash":"f21746386053dc50d4c31e17e59d9b38","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[866,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-152445","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-minigame","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– A clickable chat message is broadcast to players
\n– `\/tdm join` – Automatically assigns you to the team with the fewest players for balance
\n – If all enabled teams have equal players, picks a random team
\n – If random-only mode is enabled by admin, always picks randomly from enabled teams
\n– `\/tdm join
\n – Available teams: red, blue, green, yellow, purple, orange, aqua, gray, white, black
\n – Tab completion shows currently enabled teams<\/p>\n
\nWhen you join a match, you’ll see a GUI to select your combat class. Choose wisely based on your playstyle!<\/p>\n
\nLong-range specialist with precision weaponry
\n– Bow with 20 arrows
\n– Leather armor (lightweight for mobility)
\n– Best for: Players who prefer ranged combat and positioning<\/p>\n
\nAggressive melee fighter with high damage output
\n– Iron axe (high damage)
\n– Chainmail armor
\n– Shield for defense
\n– Best for: Aggressive players who like close combat<\/p>\n
\nBalanced warrior with solid defense
\n– Iron sword
\n– Full iron armor
\n– Shield for blocking
\n– Best for: Players who want durability and versatility<\/p>\n
\nHigh-risk, high-reward ranged attacker
\n– Crossbow with Quick Charge II enchantment
\n– 3 tipped arrows (harming) for devastating damage
\n– 10 regular arrows
\n– No armor (vulnerable but deadly)
\n– Best for: Skilled players who can land shots while avoiding damage<\/p>\n
\n– Kill: 20 points
\n– Assist: 10 points
\n– Headshot Bonus: +5 points <\/p>\n
\nLand projectile or melee hits on the upper portion of an enemy to score bonus headshot points. The game detects headshots based on hit location.<\/p>\n
\nIf a kill is awarded to a person you damaged in the last 10 seconds you will recieve a bonus for assisting the kill<\/p>\n
\nBuild up consecutive kills without dying to trigger special announcements:
\n– 3 kills: Kill streak announcement
\n– 5 kills: Dominating announcement
\n– 10 kills: Legendary status
\n– Your streak ends when you die, and the server announces who ended it<\/p>\n
\nA live sidebar scoreboard displays:
\n– Team scores (first to reach the win threshold wins)
\n– Your personal points
\n– Your kills, assists, and headshots
\n– Real-time updates throughout the match<\/p>\n
\n2. **Joining**: Players see a clickable broadcast message or can join with `\/tdm join
\n3. **Class Selection**: Each player chooses their combat class from the GUI
\n4. **Start**: Once enough players join, an admin starts the match by clicking the broadcast link or running `\/tdm start`
\n5. **Combat**: Fight to reach the target kill count (default: 30 team kills)
\n6. **Respawn**: When you die, you spectate for a countdown (default: 5 seconds) before respawning
\n7. **Victory**: First team to reach the kill threshold wins, and detailed statistics are displayed
\n8. **Individual points** are also awarded for events such as kill and headshot and an individual winner is announced.<\/p>\n
\n – No argument: Free-for-all mode
\n – `4v4`: Classic red vs blue mode
\n – Broadcasts clickable join links to all players
\n – Sends clickable start link to admins only<\/p>\n
\n – Stand where you want the spawn point and run the command
\n – Works for all 10 team colors
\n – Spawn locations are saved to config.yml<\/p>\n
\n – Activate matches
\n – View team rosters
\n – Move players between teams
\n – Toggle team availability (FFA mode)
\n – Configure game settings<\/p>\n
\n– `wins-needed`: Kills required to win (default: 3)
\n– `respawn-time`: Respawn countdown in seconds (default: 5)
\n– `min-players`: Minimum players to start (default: 2)
\n– `max-players`: Maximum players allowed (default: 20)
\n– `auto-balance-teams`: Enable automatic team balancing<\/p>\n
\nEnable or disable specific teams for FFA mode:
\n“`yaml
\nteams:
\n enabled:
\n red: true
\n blue: true
\n green: false
\n # … etc
\n“`<\/p>\n
\nCustomize point values for kills, assists, and headshots:
\n“`yaml
\nscoring:
\n kill-points: 20
\n assist-points: 10
\n headshot-bonus: 5
\n“`<\/p>\n
\n– `friendly-fire`: Allow team damage (default: false)
\n– `fall-damage`: Enable fall damage (default: true)
\n– `spectator-death`: Keep dead players in spectator mode until respawn (default: true)<\/p>\n
\nFine-tune damage values:
\n– `global-damage-multiplier`: Multiply all damage
\n– `fall-damage-multiplier`: Adjust fall damage
\n– `projectile-damage-multiplier`: Adjust arrow\/crossbow damage
\n– `melee-damage-multiplier`: Adjust sword\/axe damage<\/p>\n
\n– `head-region-percentage`: Fraction of entity height considered “head” (default: 0.20 = top 20%)<\/p>\n
\nEnable\/disable sound effects and adjust volume\/pitch:
\n“`yaml
\nsounds:
\n death-sound: true
\n kill-sound: true
\n victory-sound: true
\n sound-volume: 1.0
\n“`
\n### Class Customization
\nEach class can be fully customized in `config.yml`. You can modify existing classes or add new ones:<\/p>\n
\nclasses:
\n # Class identifier (used internally)
\n sharpshooter:
\n enabled: true
\n name: “Sharpshooter” # Display name in GUI
\n helmet: LEATHER_HELMET
\n chestplate: LEATHER_CHESTPLATE
\n leggings: LEATHER_LEGGINGS
\n boots: LEATHER_BOOTS
\n weapon: BOW
\n off-hand: NONE # or SHIELD, etc.
\n extra-items:
\n – “ARROW:20” # Format: “MATERIAL:AMOUNT”
\n enchantments:
\n – “BOW:POWER:1” # Format: “ITEM:ENCHANTMENT:LEVEL”
\n health-bonus: 0 # Additional hearts (2 = 1 heart)
\n armor-bonus: 0 # Additional armor points
\n“`<\/p>\n
\n1. Copy an existing class section in `config.yml`
\n2. Change the class identifier (e.g., `my_custom_class`)
\n3. Customize the name, armor, weapons, and items
\n4. Set `enabled: true`
\n5. Reload the server or restart<\/p>\n
\n– 4 unique combat classes with distinct playstyles
\n– Headshot detection for bonus points
\n– Kill streak tracking and announcements
\n– Live scoreboard with detailed statistics
\n– Respawn countdown system
\n– Assist tracking (damage contributors get credit)
\n– Admin GUI for easy match management
\n– Clickable chat messages for quick joining
\n– Configurable spawn points per team
\n– Team balancing options
\n– Comprehensive end-game statistics
\n– Sound effects for game events
\n– Tab completion for commands
\n– Highly configurable through config.yml<\/p>\n
\n– Java: 21 or higher<\/p>\n
\n2. Place it in your server’s `plugins` folder
\n3. Restart your server
\n4. Configure spawn points with `\/tdm setspawn
\n5. Customize settings in `plugins\/TeamDeathmatch\/config.yml`
\n – Reload with `\/reload confirm` or restart the server
\n6. Run `\/tdm gui` to configure matches<\/p>\n","protected":false},"excerpt":{"rendered":"