TSManhunt

1. Mode Selection

Players can choose a game mode before starting the game.

Available Modes:

Normal Mode: The Runner gets basic items like stone tools (wooden sword, stone pickaxe, 24 bread). Hunters receive 24 bread and a wooden sword. In the menu, the wooden sword appears as a stone axe.

OP Mode: The Runner gets netherite axe, diamond sword, diamond pickaxe, and 34 steaks. Hunters get iron axe, iron sword, iron pickaxe, and 34 steaks.

Ultra OP Mode: The Runner gets enchanted netherite axe, enchanted diamond sword, enchanted diamond pickaxe, 64 steaks, and full diamond armor. Hunters receive enchanted diamond sword, enchanted diamond axe, enchanted diamond pickaxe, 64 steaks, and full iron armor.

2. Game Start Process & Mode Voting

At the start of the game, players can select a mode.

There is a vote for the mode selection. The mode with the most votes becomes active. If no mode is voted, the Normal Mode will be selected by default.

Players cannot start the game without selecting a mode.

3. Slot Usage & Menu

Slot 0: Queue to join the game

Slot 4: Mode Selection Menu (where players select the mode)

Slot 8: Leave the game

The mode selection can be done via a compass. Players click the compass to choose a mode.

4. Player and Runner Count

As the number of players increases, the number of Runners also increases:

15 players = 2 Runners

30 players = 3 Runners

Every 15 additional players adds 1 more Runner.

Runners cannot attack each other: PVP is disabled between Runners.

5. Compass Usage

Hunters can use the compass to follow the nearest Runner. This compass is only valid for Hunters.

6. Wait Time After Game Ends

There is a 10-second waiting period after the game ends. During this time, the winning team (Runner or Hunter) is decided.

7. Runner-Specific Features

The items for Runner players vary based on the selected mode (Normal, OP, Ultra OP).

Hunters receive different items, and the differences between Hunter and Runner are defined based on the selected mode.

8. Lobby Return

After the game ends, players automatically return to the lobby.

Additionally, spec mode is activated, and players return to survival mode after the game.

Technical Details:

Customizable Settings for the Game: The plugin's features can be customized using a configuration file, allowing the server admins to adjust a wide range of settings.

Placeholder API Support: There are placeholders available to display in-game statistics, game times, and more. This makes it easy to customize in-game text and data.

High Performance: The plugin is optimized to handle large player counts, ensuring smooth performance even with a significant number of players.

Extra Features:

Statistics Tracking: Players' wins, losses, kills, deaths, and total games played are tracked and displayed in-game.

Advanced Menu System: With user-friendly interfaces and menus, players can easily make their selections (such as choosing a mode, joining a game, etc.).

Flexible Configuration: The config file is designed to allow for complete customization, making it easy to change modes, items, PVP rules, and much more.

TSManhunt 1.1.0 Update is here!
- Mod Selection Menu
- +1 Runner for every 15 players
- Performance Improvements

When the Ender Dragon is killed, the game automatically ends and the winner is determined

The plugin is fully optimized for competitive gameplay and is suitable for public servers.

%tsmanhunt_games% → Total games played

%tsmanhunt_wins% → Total wins

%tsmanhunt_losses% → Total losses

%tsmanhunt_points% → Total points

%tsmanhunt_runner_wins% → Wins as Runner

%tsmanhunt_hunter_wins% → Wins as Hunter

%tsmanhunt_kills_as_hunter% → Kills made as Hunter

%tsmanhunt_runner_deaths% → Runner deaths

%tsmanhunt_dragon_kills% → Ender Dragon kills

%tsmanhunt_best_time% → Best win time
--------------------------
%tsmanhunt_top1%

%tsmanhunt_top2%

%tsmanhunt_top3%

Config

settings:
  startPlayers: 10        # kaç kişi olunca sayaç başlasın
  maxPlayers: 50         # sıraya en fazla kaç kişi girebilsin (oyun maksimum)
  countdownSeconds: 50
  headstartSeconds: 10

  # Tracker
  trackerUpdateSeconds: 1
  requireSameDimensionForCompass: true
  # Mode preset (NORMAL, OP, ULTRA_OP)
  defaultMode: NORMAL

  # Join behavior
  clearInventoryOnJoinGame: true
  teleportOnJoinGame: "lobby"

ui:
  display-name: "TSManhunt"   # menüde görünen isim
  menu-title: "&3TSManhunt"   # envanter menü başlığı

actionbar:
  enabled: true
  prefix: "&bTSManhunt&r"
  countdown: "&6{prefix} &7• &eBaşlıyor: &f{seconds}s &7• &eSıra: &f{count}&7/&f{max}"
  headstartRunner: "&a{prefix} &7• &2KAÇ! &7({seconds}s)"
  headstartHunter: "&c{prefix} &7• &4BEKLE! &7({seconds}s)"
  runningHunter: "&b{prefix} &7• &eRUNNER: &f{runner} &7• &eMesafe: &f{distance}m"
  runningRunner: "&a{prefix} &7• &2KAÇIYORSUN &7• &eHunter: &f{hunters}"


  # Placeholder: {count} {start} {max} {seconds} {runner}
  titleCountdown: "&6Oyun başlıyor: &e{seconds}s"
  titleHeadstart: "&eHeadstart: &a{seconds}s"
  titleRunning: "&bRunner: &a{runner} &7| &eTakip aktif"

arenaReset:
  enabled: true
  # Reset worlds after game ends. Use DEDICATED arena worlds only!
  # If worlds is empty -> arena world + suffixes
  worlds: []
  netherSuffix: "_nether"
  endSuffix: "_the_end"
  denyJoinWhileResetting: true

# Spawns (use /tsmanhunt setlobby and /tsmanhunt setarena)
spawns:
  lobby: ""
  arena: ""

lobbyProtection:
  enabled: true
  blockBreak: true
  blockPlace: true
  pvp: true
  mobSpawn: true

titles:
  enabled: true
  runnerWin:
    title: "&a{player}"
    subtitle: "&eOyunu Kazandı!"
  huntersWin:
    title: "&cHunterlar!"
    subtitle: "&eOyunu Kazandı!"

messages:
  start_sound: \"ENTITY_PLAYER_LEVELUP\"
  prefix: "&b[TSManhunt]&r "

  join_game: "&aTSManhunt'e katıldın!"
  already_joined: "&eZaten TSManhunt'tesin."
  need_join_first: "&cÖnce menüden oyuna gir!"
  leave_to_lobby: "&eLobiye döndün."

  queue_joined: "&aSıraya girdin. (&e{count}&7/&e{max}&a)"
  queue_left: "&eSıradan çıktın. (&e{count}&7/&e{max}&e)"
  queue_full: "&cSıra dolu! (&e{max}&c)"

  mode_voted: "&d{player} &7mod için oy verdi: &f{mode}"
  mode_selected_final: "&6Oylama bitti! Seçilen mod: &f{mode}"

  countdown_start: "&6{start} kişi tamam! Geri sayım başladı: &e{seconds}&6 saniye"
  countdown_cancel: "&cYeterli oyuncu kalmadı. Geri sayım iptal!"

  runner_title: "&aRUNNER"
  runner_subtitle: "&e{seconds} saniye kaç!"
  hunter_title: "&cHUNTER"
  hunter_subtitle: "&e{seconds} saniye bekle!"
  start_title: "&6BAŞLA!"
  start_subtitle: "&7Runner'ı yakala!"

  runner_left: "&cRunner oyundan çıktı! Hunter kazandı."
  runner_dead: "&cRunner öldü! Hunter kazandı."
  dragon_dead: "&aEnder Dragon öldü! Runner kazandı."
  reset: "&7Oyun sıfırlandı."

  no_permission: "&cYetkin yok."
  spawn_set_lobby: "&aLobby spawn ayarlandı."
  spawn_set_arena: "&aArena spawn ayarlandı."
  spawn_missing: "&cSpawn ayarlı değil. /tsmanhunt setlobby ve /tsmanhunt setarena kullan."

  arena_resetting: "&eArena sıfırlanıyor, lütfen bekle..."
  arena_reset_done: "&aArena sıfırlandı!"

# --- Stats / Leaderboard ---
stats:
  storage: sqlite   # sqlite | yaml
  leaderboardSize: 10
  points:
    runnerWin: 3
    hunterWin: 1
  titlesEnabled: true

Start.bat

@echo off
title TSManhunt Server 1.20.4
color a

echo ===============================
echo   TSManhunt 1.20.4 Sunucu
echo ===============================

:: RAM AYARI
set MIN_RAM=2G
set MAX_RAM=4G

:: Paper jar adı
set JAR=paper-1.20.4.jar

:: eula kontrol
if not exist eula.txt (
echo eula=true > eula.txt
echo EULA kabul edildi.
)

:START
echo Sunucu baslatiliyor...
java -Xms%MIN_RAM% -Xmx%MAX_RAM% -jar %JAR% nogui

echo.
echo Sunucu kapandi. 5 saniye sonra yeniden baslatiliyor...
timeout /t 5
goto START

/tsmanhunt stats [player] - statistics
/tsmanhunt top 
/tsmanhunt setlobby - Set spawn point for lobby
/tsmanhunt setarena - Set spawn point for arena
/tsmanhunt stop - stop the game
/tsmanhunt status - debug status
/tsmanhunt resetme - It resets itself in the lobby.
/tsmanhunt reload - config reload
/tsmanhunt resetstats [player] - stats zeros
/tsmanhunt help