CS Mine - Deathmatch

CS Mine - Deathmatch

CS Mine is a Deathmatch mod for Minecraft Forge 1.20.1, designed to transform Minecraft maps into combat arenas inspired by classic FPS game modes, using Timeless and Classics Zero (TaCZ) as the foundation for weapons and combat.

Create multiple arenas, configure independent matches, choose your loadout, compete for eliminations, climb the rankings, and track your statistics — all integrated into Minecraft.

🎯 Main Features

⚔️ Deathmatch with TaCZ

Enter an arena, choose your loadout, and fight against other players during the match duration configured for that map.

Each arena has its own independent match and can be in one of the following states:

• WAITING
• STARTING
• RUNNING

This allows multiple maps to operate independently at the same time.

---

🗺️ Multiple Maps

Administrators can create multiple arenas using regions of the Minecraft world.

Each map has its own independent configuration, including:

• Match duration
• Respawn points
• Casual or Ranked mode
• Region protection
• Participants
• Timers
• Match scoreboard
• Mob blocking
• Bot difficulty
• Custom preview image
• Named locations

By using:

/cs join

players can choose which map they want to join.

---

🖼️ Advanced Map Selection and Custom Previews

Players who install CS Mine on the client receive an advanced /cs join screen with filters, a scrollable arena list, official match details, and map images.

Administrators can maintain a server-side preview gallery and associate a different image with each map. Preview files are validated by the server, transferred in limited chunks, and cached locally using their SHA-256 identity.

Supported preview files:

• PNG format
• Up to 1280×720
• Up to 1 MB
• Stored in config/csdeathmatch/map-previews/

Clients without CS Mine keep the fully functional vanilla map-selection menu.

---

🔫 Weapon Selection

When joining or respawning during a match, players can choose their loadout through an interface.

Loadouts can be configured by the server and use weapons from TaCZ.

After respawning, the player has 6 seconds to select a weapon.

After selecting a loadout, the player receives a short additional protection period that ends when they:

• move more than 0.08 blocks;
• jump;
• attack;
• or after approximately 1 second.

All validation is handled by the server.

---

🤖 Optional Combat Bots

Server operators can add artificial players to an arena for testing or filling matches.

Bots participate in the match flow, use real TaCZ weapons, ammunition, and reload behavior, react only to valid combat targets, and respect line of sight.

Each map stores one of three bot difficulty levels:

• Easy
• Medium
• Hard

Difficulty changes reaction time, aim control, target memory, and burst behavior without giving bots artificial damage, unlimited ammunition, or wall vision.

---

🛡️ Arena Protection

Registered arena regions remain protected even when no match is currently running.

Inside arenas, the following actions are blocked:

• Breaking blocks
• Placing blocks
• Using buckets
• Fire
• Explosions
• Moving blocks with pistons across arena boundaries

Elements required for map interaction continue to work normally, including:

• Doors
• Buttons
• Levers
• Containers

Administrators can also temporarily enable edit mode for an arena.

---

🐷 Mob Control

Arenas are kept free from creatures that could interfere with matches.

Monsters and animals cannot spawn inside registered regions through:

• Natural spawning
• Spawners
• Breeding
• Patrols and raids
• Spawn eggs
• Other spawning methods

Existing mobs are also removed when maps are loaded and when a match begins.

---

🏆 Ranking System

CS Mine includes its own competitive ranking system.

All players start with 1000 provisional RP, but must complete 5 placement matches before receiving their first visible rank.

During placement matches, progress is displayed as:

[0/5] → [4/5]

Provisional RP remains hidden until all placement matches are completed.

The system also includes:

• Individual rank
• Global ranking
• Top 10
• Player profiles
• Statistics
• Achievements

Player data is linked to the player's UUID and persisted in the world.

---

🎮 Ranked and Casual Maps

Each map can operate as:

RANKED

Match results affect:

• RP
• Rank
• Placement matches
• Global statistics

CASUAL

The match works normally, including the scoreboard and winner, but its results do not affect the competitive ranking system.

Maps are Ranked by default.

---

🎯 Headshots

Headshots are detected directly through the TaCZ integration.

They are displayed in the elimination system and have their own statistics, both:

• per match;
• and globally.

Headshots do not directly affect RP calculations.

---

💀 Temporary Visual Bodies

When a player is eliminated during a match, CS Mine can temporarily display a visual representation of that player at the location of their death using their own skin.

This effect is purely visual and automatically disappears after a few seconds, without creating a real player entity or affecting match mechanics.

---

🎒 Protected Inventory

When entering a match, CS Mine saves the player's:

• Inventory
• Dimension
• Position
• Rotation

When the player leaves, the match ends, or the match is canceled, all of this information is restored.

The player returns exactly to the location they were at before entering the arena.

---

🔒 TaCZ Limited to Matches

The server controls the use of TaCZ weapons during CS Mine matches.

Players who are not participating in a match cannot use the TaCZ combat system through CS Mine.

Items obtained outside the arenas remain in the player's inventory normally, but combat-related actions are blocked by the server when necessary.

---

📊 Advanced Player Profile

Outside a match, /cs profile opens a dedicated profile screen for clients with CS Mine installed.

The profile includes:

• Current rank or placement progress
• RP and progress toward the next rank
• Matches and wins
• Kills, deaths, and headshots
• K/D and headshot percentage
• Best elimination streak
• Most lethal weapon
• Unlocked achievements
• The latest 20 completed matches

Achievements and Ranks use their own advanced screens and return to the profile through the Back button or ESC.

Secret locked achievements are not sent to the client, and provisional RP remains hidden until placement is completed.

---

🏁 Complete Post-Match Results

At the end of a match, the server freezes an official result snapshot containing:

• Map and mode
• Winner
• Final positions
• Kills and deaths
• K/D
• Headshots and headshot percentage
• Ranked RP changes when applicable

Clients with the advanced interface receive a scrollable results screen with player skins.

Clients without CS Mine receive a temporary vanilla sidebar that still includes their own placement when necessary.

The result display duration can be configured globally between 5 and 60 seconds.

---

🎛️ Optional Advanced HUD

Players who install CS Mine on the client can enable an FPS-inspired HUD while all gameplay calculations remain server-authoritative.

The advanced presentation includes:

• A responsive top bar with the timer and ordered player cards
• Player skins, eliminations, and local-player highlighting
• A visual kill feed with TaCZ weapon icons and headshot markers
• A custom TAB panel with K, D, HS, rank, and match status
• A compact bottom combat bar with health, TaCZ ammunition, and elimination streak
• Individual client options for HUD elements, scale, opacity, and animations

Players can enable or disable the advanced HUD through:

Options → Controls → CS Mine

Disabling it immediately restores the vanilla bossbar, sidebar, TAB, and chat kill feed.

Clients with and without the advanced HUD can play together in the same match.

---

📍 Named Map Locations

Administrators can register, edit, and remove named callouts for each arena directly from the map administration panel.

A location is captured from the administrator's current position and can have its own name and horizontal detection radius.

Locations use a narrow vertical range of 3 blocks above and 3 blocks below the recorded Y level, preventing callouts on overlapping floors from conflicting.

During a match, players entering the configured area see its name in the upper-left custom overlay.

Players without CS Mine installed on the client receive the same information as a standard Minecraft action-bar message.

Operators can also preview location detection outside a running match while configuring the map.

---

🖥️ Administrative Interface

Operators can use:

/cs admin

to access the administrative panel.

When CS Mine is also installed on the operator's client, an advanced administrative interface can be used.

The interface uses a single compact layout with the following categories:

• Maps
• Ranks
• Settings
• Diagnostics
• Discord

The selected content opens in the same right-side panel instead of replacing the entire screen.

The Maps area includes map information, per-map settings, spawn management, custom previews, and named locations.

The Ranks area displays the five highest-ranked players with their skin, rank, RP, highest RP, wins, matches, kills, deaths, and headshots.

For authorized operators with the advanced client, /cs ranks and /ranks open the administration panel directly on Ranks. Other players and clients without the advanced channel keep the vanilla rank interfaces.

Diagnostics provides read-only information about maps, simultaneous matches, participants, online players, and known HUD state. Data is sent only when requested.

Regular players do not need to install CS Mine on their client.

To participate in matches, players only need compatible versions of:

• Minecraft Forge 1.20.1
• TaCZ

CS Mine must be installed on the server or match host.

---

💬 Discord Rank Notifications

Administrators can configure a dedicated Discord webhook from:

/cs admin → Discord

The server can send notifications for official promotions and demotions after Ranked match results.

The webhook URL remains server-side and is stored per world. Delivery uses a limited asynchronous queue, timeouts, and finite retries so Discord cannot block matches or rank persistence.

---

📋 Player Commands

/cs join Selects an arena and joins the match.

/cs leave Leaves the current match.

/cs rank [player] Displays the player's rank or placement progress.

/cs ranks Opens the ranking interface.

/ranks Opens the ranking interface directly.

/cs profile Opens the advanced player profile outside a match.

/cs top Displays the top-ranked players.

/cs achievements Opens the achievement system.

/cs status [map] Displays information about a match.

---

🔧 Administrative Commands

/cs map pos1

/cs map pos2

/cs map create <name>

/cs map list

/cs map info <name>

/cs map remove <name>

/cs map edit <map>

/cs map time <map> <minutes>

/cs map ranked <map> on|off

/cs map preview list

/cs map preview reload

/cs map preview set <map> <image>

/cs map preview clear <map>

/cs spawn add <map>

/cs spawn list <map>

/cs spawn clear <map>

/cs spawn remove <map> <id>

/cs bot add <map> [name]

/cs bot remove [name]

/cs bot list

/cs bot difficulty <map> easy|medium|hard

/cs config tacz-damage <percent>

/cs config result-duration <seconds>

/cs cancel <map>

/cs diagnostics

/cs admin

Administrative commands require operator permissions.

---

📦 Requirements

Minecraft: 1.20.1
Mod Loader: Forge
Required Dependency: Timeless and Classics Zero (TaCZ) 1.1.8-hotfix or newer

Server / Host

Required:

• Forge
• TaCZ
• CS Mine

Players

Required:

• Forge
• TaCZ

Operators who want to use the advanced administrative interface

They can optionally also install:

• CS Mine on the client

---

🔧 Configuration

Loadouts are generated automatically on the first startup and can be customized by the server administrator.

Each map also keeps its own match settings, allowing administrators to create anything from small casual arenas to competitive maps with rankings enabled.

Loadouts are stored in config/csdeathmatch-loadouts.json.

Map preview images are stored in config/csdeathmatch/map-previews/.

Client HUD preferences are stored in config/csdeathmatch-hud-client.properties and affect only that client.

Map settings, ranks, profiles, named locations, and Discord configuration are persisted per world by the server.

---

🚧 Development

CS Mine is still under development, and new features, interfaces, and improvements are being added progressively.

Feedback, suggestions, and bug reports are welcome.

---

CS Mine — turn your Minecraft world into a Deathmatch arena powered by TaCZ.

---

🇧🇷 Português (Brasil)

CS Mine - Deathmatch

CS Mine é um mod de Deathmatch para Minecraft Forge 1.20.1, desenvolvido para transformar mapas do Minecraft em arenas de combate inspiradas em modos clássicos de FPS, utilizando o Timeless and Classics Zero (TaCZ) como base para armas e combate.

Crie múltiplas arenas, configure partidas independentes, escolha seu armamento, dispute eliminações, suba no ranking e acompanhe suas estatísticas — tudo integrado ao Minecraft.

🎯 Principais recursos

⚔️ Deathmatch com TaCZ

Entre em uma arena, escolha seu armamento e lute contra os outros jogadores durante o tempo configurado para o mapa.

Cada arena possui sua própria partida e pode estar em um dos estados:

• WAITING
• STARTING
• RUNNING

Isso permite que diferentes mapas funcionem de forma independente.

---

🗺️ Múltiplos mapas

Administradores podem criar diversas arenas utilizando regiões do próprio mundo.

Cada mapa possui configurações independentes, incluindo:

• Duração da partida
• Pontos de respawn
• Modo Casual ou Ranqueado
• Proteção da região
• Participantes
• Cronômetros
• Placar da partida
• Bloqueio de mobs
• Dificuldade dos bots
• Imagem personalizada
• Locais nomeados

Ao utilizar:

/cs join

o jogador pode escolher em qual mapa deseja entrar.

---

🖼️ Seleção avançada de mapas e imagens personalizadas

Jogadores que instalarem o CS Mine no cliente recebem uma tela avançada ao utilizar /cs join, com filtros, lista rolável de arenas, detalhes oficiais das partidas e imagens dos mapas.

Administradores podem manter uma galeria de imagens no servidor e associar uma imagem diferente a cada mapa. Os arquivos são validados pelo servidor, transferidos em partes limitadas e armazenados no cache local pela identidade SHA-256.

Imagens aceitas:

• Formato PNG
• Até 1280×720
• Até 1 MB
• Armazenadas em config/csdeathmatch/map-previews/

Clientes sem o CS Mine continuam utilizando normalmente o menu vanilla de seleção.

---

🔫 Seleção de armas

Ao entrar ou renascer durante uma partida, o jogador pode escolher seu armamento através de uma interface.

Os loadouts podem ser configurados pelo servidor e utilizam armas do TaCZ.

Após o respawn, o jogador possui 6 segundos para selecionar sua arma.

Depois da seleção, ainda recebe uma pequena proteção adicional que termina ao:

• se mover mais de 0,08 bloco;
• pular;
• atacar;
• ou após aproximadamente 1 segundo.

Toda a validação é feita pelo servidor.

---

🤖 Bots de combate opcionais

Operadores podem adicionar jogadores artificiais a uma arena para testar ou preencher partidas.

Os bots participam do fluxo da partida, usam armas, munição e recarga reais do TaCZ, reagem somente a alvos válidos e respeitam linha de visão.

Cada mapa armazena um dos três níveis de dificuldade:

• Fácil
• Médio
• Difícil

A dificuldade altera tempo de reação, controle de mira, memória do alvo e comportamento de rajada sem conceder dano artificial, munição ilimitada ou visão através de paredes.

---

🛡️ Proteção das arenas

As regiões cadastradas permanecem protegidas mesmo quando nenhuma partida está acontecendo.

Dentro das arenas são bloqueados:

• Quebra de blocos
• Colocação de blocos
• Baldes
• Fogo
• Explosões
• Movimentação de blocos por pistões através dos limites da arena

Elementos necessários para interação continuam funcionando normalmente, como:

• Portas
• Botões
• Alavancas
• Contêineres

Administradores também podem ativar temporariamente o modo de edição de uma arena.

---

🐷 Controle de mobs

As arenas são mantidas livres de criaturas que possam interferir nas partidas.

Monstros e animais não podem surgir dentro das regiões através de:

• Spawn natural
• Spawners
• Reprodução
• Patrols e raids
• Ovos
• Outras formas de criação

Mobs existentes também são removidos quando os mapas são carregados e quando uma partida começa.

---

🏆 Sistema de Rank

CS Mine possui um sistema próprio de classificação.

Todos os jogadores começam com 1000 RP provisórios, mas precisam completar 5 partidas classificatórias antes de receber seu primeiro rank visível.

Durante a classificação, o progresso aparece como:

[0/5] → [4/5]

O RP provisório permanece oculto até a conclusão das partidas classificatórias.

Também estão disponíveis:

• Rank individual
• Ranking global
• Top 10
• Perfis de jogadores
• Estatísticas
• Conquistas

Os dados são vinculados ao UUID do jogador e persistidos no mundo.

---

🎮 Mapas Ranqueados e Casuais

Cada mapa pode funcionar como:

RANQUEADO

Os resultados da partida afetam:

• RP
• Rank
• Partidas classificatórias
• Estatísticas globais

CASUAL

A partida funciona normalmente, incluindo placar e vencedor, mas seus resultados não alteram o sistema competitivo.

Os mapas são Ranqueados por padrão.

---

🎯 Headshots

Headshots são detectados diretamente através da integração com o TaCZ.

Eles aparecem no sistema de eliminações e possuem estatísticas próprias, tanto:

• por partida;
• quanto globalmente.

Headshots não alteram diretamente o cálculo de RP.

---

💀 Cadáver visual temporário

Quando um jogador é eliminado durante uma partida, o CS Mine pode exibir temporariamente sua representação no local da morte utilizando sua própria skin.

O efeito é apenas visual e desaparece automaticamente após alguns segundos, sem criar um jogador real ou alterar as mecânicas da partida.

---

🎒 Inventário protegido

Ao entrar em uma partida, o CS Mine salva:

• Inventário
• Dimensão
• Posição
• Rotação

Quando o jogador sai, a partida termina ou é cancelada, todas essas informações são restauradas.

O jogador retorna exatamente ao local onde estava antes de entrar na arena.

---

🔒 TaCZ limitado às partidas

O servidor controla o uso das armas do TaCZ durante o CS Mine.

Jogadores que não estão participando de uma partida não podem utilizar o sistema de combate do TaCZ através do CS Mine.

Itens encontrados fora das arenas continuam no inventário normalmente, mas ações de combate relacionadas ao sistema são bloqueadas pelo servidor quando necessário.

---

📊 Perfil avançado do jogador

Fora de uma partida, /cs profile abre uma tela própria para clientes com o CS Mine instalado.

O perfil inclui:

• Rank atual ou progresso classificatório
• RP e progresso até o próximo rank
• Partidas e vitórias
• Eliminações, mortes e headshots
• K/D e porcentagem de headshots
• Melhor sequência de eliminações
• Arma mais letal
• Conquistas desbloqueadas
• As últimas 20 partidas concluídas

Conquistas e Patentes utilizam telas avançadas próprias e retornam ao perfil através do botão Voltar ou ESC.

Conquistas secretas bloqueadas não são enviadas ao cliente, e o RP provisório permanece oculto até o fim das classificatórias.

---

🏁 Resultado completo da partida

Ao final da partida, o servidor congela um resultado oficial contendo:

• Mapa e modo
• Vencedor
• Posições finais
• Eliminações e mortes
• K/D
• Headshots e porcentagem de headshots
• Alterações de RP quando aplicáveis

Clientes com a interface avançada recebem uma tela rolável com as skins dos jogadores.

Clientes sem o CS Mine recebem uma sidebar vanilla temporária que também inclui sua própria colocação quando necessário.

A duração da apresentação do resultado pode ser configurada globalmente entre 5 e 60 segundos.

---

🎛️ HUD avançado opcional

Jogadores que instalarem o CS Mine no cliente podem ativar um HUD inspirado em jogos FPS. Todos os cálculos da partida continuam sendo autoritativos no servidor.

A apresentação avançada inclui:

• Barra superior responsiva com cronômetro e cartões ordenados dos jogadores
• Skins, eliminações e destaque do jogador local
• Kill feed visual com ícones das armas TaCZ e marcadores de headshot
• TAB personalizado com K, D, HS, rank e estado da partida
• Barra de combate inferior compacta com vida, munição TaCZ e sequência de eliminações
• Opções individuais de elementos, escala, opacidade e animações

O HUD pode ser ativado ou desativado em:

Opções → Controles → CS Mine

Ao desativá-lo, bossbar, sidebar, TAB e kill feed no chat são restaurados imediatamente.

Clientes com e sem o HUD avançado podem jogar juntos na mesma partida.

---

📍 Locais nomeados nos mapas

Administradores podem cadastrar, editar e remover callouts em cada arena diretamente no painel administrativo do mapa.

O local é capturado na posição atual do administrador e pode receber nome e raio horizontal próprios.

Cada local utiliza uma faixa vertical restrita a 3 blocos acima e 3 blocos abaixo do nível Y registrado. Isso evita conflitos entre nomes de andares posicionados um sobre o outro.

Durante a partida, ao entrar na área configurada, o jogador vê o nome no canto superior esquerdo através do overlay personalizado.

Quem não possui o CS Mine no cliente recebe a mesma informação como texto padrão na action bar do Minecraft.

O operador também pode testar a detecção dos locais fora de uma partida enquanto configura o mapa.

---

🖥️ Interface administrativa

Operadores podem utilizar:

/cs admin

para acessar o painel administrativo.

Quando o CS Mine também está instalado no cliente do operador, uma interface administrativa avançada pode ser utilizada.

A interface utiliza um único layout compacto com as categorias:

• Mapas
• Ranks
• Configurações
• Diagnóstico
• Discord

O conteúdo selecionado aparece no mesmo painel direito, sem substituir toda a tela.

A área de Mapas reúne informações, configurações individuais, gerenciamento de spawns, imagens personalizadas e locais nomeados.

A área de Ranks exibe os cinco melhores jogadores com skin, rank, RP, maior RP alcançado, vitórias, partidas, eliminações, mortes e headshots.

Para operadores autorizados com o cliente avançado, /cs ranks e /ranks abrem a administração diretamente em Ranks. Outros jogadores e clientes sem o canal avançado preservam as interfaces vanilla.

O Diagnóstico fornece informações somente leitura sobre mapas, partidas simultâneas, participantes, jogadores online e estado conhecido do HUD. Os dados são enviados apenas quando solicitados.

Jogadores comuns não precisam instalar o CS Mine no cliente.

Para participar das partidas, os clientes precisam apenas das versões compatíveis de:

• Minecraft Forge 1.20.1
• TaCZ

O CS Mine deve estar instalado no servidor ou host da partida.

---

💬 Notificações de rank no Discord

Administradores podem configurar um webhook exclusivo através de:

/cs admin → Discord

O servidor pode enviar notificações sobre promoções e rebaixamentos oficiais após resultados de partidas Ranqueadas.

A URL permanece somente no servidor e é persistida por mundo. Os envios utilizam fila assíncrona limitada, timeout e tentativas finitas para que o Discord não bloqueie partidas ou a persistência dos ranks.

---

📋 Comandos para jogadores

/cs join Seleciona uma arena e entra na partida.

/cs leave Sai da partida atual.

/cs rank [jogador] Exibe o rank ou progresso classificatório.

/cs ranks Abre a interface de ranks.

/ranks Abre diretamente a interface de ranks.

/cs profile Abre o perfil avançado fora de uma partida.

/cs top Exibe o ranking dos melhores jogadores.

/cs achievements Abre o sistema de conquistas.

/cs status [mapa] Mostra informações da partida.

---

🔧 Comandos administrativos

/cs map pos1

/cs map pos2

/cs map create <nome>

/cs map list

/cs map info <nome>

/cs map remove <nome>

/cs map edit <mapa>

/cs map time <mapa> <minutos>

/cs map ranked <mapa> on|off

/cs map preview list

/cs map preview reload

/cs map preview set <mapa> <imagem>

/cs map preview clear <mapa>

/cs spawn add <mapa>

/cs spawn list <mapa>

/cs spawn clear <mapa>

/cs spawn remove <mapa> <id>

/cs bot add <mapa> [nome]

/cs bot remove [nome]

/cs bot list

/cs bot difficulty <mapa> easy|medium|hard

/cs config tacz-damage <percentual>

/cs config result-duration <segundos>

/cs cancel <mapa>

/cs diagnostics

/cs admin

Os comandos administrativos exigem permissões de operador.

---

📦 Requisitos

Minecraft: 1.20.1
Mod Loader: Forge
Dependência obrigatória: Timeless and Classics Zero (TaCZ) 1.1.8-hotfix ou superior

Servidor / Host

Necessário:

• Forge
• TaCZ
• CS Mine

Jogadores

Necessário:

• Forge
• TaCZ

Operadores que desejam utilizar a interface administrativa avançada

Opcionalmente podem instalar também:

• CS Mine no cliente

---

🔧 Configuração

Os loadouts são gerados automaticamente na primeira inicialização e podem ser personalizados pelo administrador do servidor.

Cada mapa também mantém suas próprias configurações de partida, permitindo criar desde pequenas arenas casuais até mapas competitivos com ranking habilitado.

Os loadouts ficam em config/csdeathmatch-loadouts.json.

As imagens dos mapas ficam em config/csdeathmatch/map-previews/.

As preferências do HUD ficam em config/csdeathmatch-hud-client.properties e afetam somente aquele cliente.

Configurações dos mapas, ranks, perfis, locais nomeados e configuração do Discord são persistidos por mundo pelo servidor.

---

🚧 Desenvolvimento

CS Mine continua em desenvolvimento e novos recursos, interfaces e melhorias estão sendo adicionados progressivamente.

Feedbacks, sugestões e relatórios de problemas são bem-vindos.

---

CS Mine — transforme seu mundo Minecraft em uma arena de Deathmatch com TaCZ.