mdbd/PLAN.md

DBD Plugin — План разработки

Архитектурные принципы

• KISS: Нет абстракций ради абстракций. Простые классы с одной ответственностью.
• DRY: Общая логика в утилитах, не копипаста.
• SOLID: SRP, OCP, LSP, ISP, DIP. Max 150 строк/файл.

---

Статус реализации

✅ Этап 0: Скелет проекта

• build.gradle (Paper 1.21.1, Java 21)
• plugin.yml с пермишнами
• DBDPlugin.java — onEnable/onDisable
• ConfigManager — загрузка yaml без перезаписи
• LocationsConfig — координаты объектов
• GameConfig — все балансные цифры (BossBar, carry, heal limits, lobby timers, sizes, kick cooldown, sabotage)

✅ Этап 1: Core Game Loop

• GameState enum
• GameSession — хранит игроков, фазу, таймер; передаёт GateManager и collapseSeconds в EndgamePhase
• Phase interface
• LobbyPhase — таймер 45 сек при 4 игроках, 15 сек при 5, min-players=4, анонс на ключевых секундах
• RoleAssigner + RoleQueue — выбор киллера; применяет GENERIC_SCALE через Attribute API
• RoleAssignPhase — телепорты, задержка 5 сек
• GameplayPhase — полная логика (см. ниже)
• EndgamePhase — collapseSeconds из конфига, таймер в Sidebar, GateManager из сессии, Adventure API title
• /dbd join, /dbd leave, /dbd forcestart, /dbd stop, /dbd reload, /dbd lobby, /dbd setlobby

✅ Этап 2: Игроки и состояния

• BasePlayer, Survivor, Killer
• PlayerState: HEALTHY, INJURED, DOWNED, HOOKED, CARRIED, DEAD, ESCAPED
• StateMachine — переходы с валидацией
• PlayerManager — map UUID → BasePlayer
• SpawnPosition — телепорт из конфига
• Перевод в GameMode.SPECTATOR при PlayerState.DEAD (в GameplayPhase.checkWinConditions и HookSacrifice)
• Размеры через Attribute.GENERIC_SCALE: Survivor=1.0, Killer=1.5 (в RoleAssigner и GameplayPhase)

✅ Этап 3: Киллер

• KillerController — без дублирующей регистрации AttackListener
• KillerAttack — ЛКМ, кулдаун 2.5 с, hitbox
• HitValidator — line of sight, расстояние
• DamageHandler — Healthy→Injured, Injured→Downed
• KillerCarry — побег через спам пробела (PlayerJumpListener), шкала в ActionBar, Speed I при побеге
• KillerMovement — скорость из конфига, замедление после удара
• GeneratorKick — Shift 3 сек → −20% прогресса, кулдаун 30 сек, progress bar
• BossBarManager — BossBar с градиентом по дистанции до маньяка, читает все параметры из конфига

✅ Этап 4: Выживший

• SurvivorController — передаёт GameConfig в SurvivorHealing
• SurvivorMovement — sprint, exhaustion
• SurvivorHealing — таймеры из конфига (other=15 сек, self=30 сек), лимит 4 лечений из конфига, sneak-check, range-check
• Downed movement — crawl 30% скорости

✅ Этап 5: Генераторы

• Generator — setUnderRegression(bool, ticks), wasKicked()
• GeneratorManager — getCompletedCount() считает живое состояние
• GeneratorRepair — ПКМ, прогресс в ActionBar; при фейле skillcheck: setUnderRegression + компас маньяку на compass-duration-seconds
• GeneratorRegression — скорость полностью из конфига (regression-rate, kick-regression-rate), без хардкодированных констант
• SkillCheck + SkillCheckUI — QTE система

✅ Этап 6: Крюки

• Hook — поле disabled + isDisabled()/setDisabled()
• HookManager — maxHooks из конфига, tryHookSurvivor проверяет лимит → при превышении сразу DEAD; findNearestUnoccupiedHook и findAvailableHook учитывают isDisabled()
• HookStage — Stage 1 (60 с), Stage 2 (60 с)
• HookStruggle — struggleIntervalTicks из конфига (hooks.struggle-interval)
• HookRescue — 60 тиков (3 сек из конфига), sneak-check, range-check, Speed I после спасения
• HookSacrifice — смерть + SPECTATOR mode
• HookSabotage — выживший держит Shift 10 сек → крюк отключён, восстановление 60 сек (всё из конфига), progress bar, broadcast

✅ Этап 7: UI

• ActionBar — статус, прогресс-бары
• Sidebar — сердца ♥ (по hooksTaken), цвета ников по состоянию, GeneratorManager (живой счёт), таймер коллапса
• TitleUI, ProgressBar, StatusIcons
• BossBarManager — BossBar для каждого выжившего, градиент по дистанции
• Шкала wiggle в KillerCarry.showWiggleProgress() (ActionBar)

✅ Этап 8: Паллеты и окна

• Pallet, PalletManager, PalletDrop, PalletBreak, PalletStun
• Window, WindowManager, WindowVault, WindowFastVault

✅ Этап 9: Ворота и люк

• ExitGate — savedProgress + getSavedProgress()/saveProgress()/restoreProgress()/setProgressDirect(); reset() чистит savedProgress
• GateManager — activateEndgame() только включает питание, без авто-открытия
• GateOpening — линейный прогресс (setProgressDirect), сохраняет/восстанавливает прогресс при уходе/возврате игрока
• Hatch, HatchCondition, HatchEscape

✅ Этап 10: Звук

• TerrorRadiusSound — terrorRadius параметр конструктора (из конфига), дефолт 32
• SoundManager, GeneratorSound, SoundLevels

✅ Этап 11: Слушатели

• PlayerJumpListener — прыжки для wiggle при переноске
• PlayerInteractListener — setOnKillerSneak + PlayerToggleSneakEvent (маньяк → GeneratorKick, выживший → HookSabotage)
• PlayerMoveListener, PlayerQuitListener, DamageListener

✅ Этап 12: Данные и хранение

• DataStorage, YamlStorage, SQLiteStorage, PlayerStats, MatchResult

---

❌ Не реализовано (следующие этапы)

Пользовательские лобби

• LobbySession — пользовательское лобби (пароль, владелец, приватность)
• LobbyRegistry — реестр серверных и пользовательских лобби, YAML persistence
• /dbd create <name> [password] [private] — для обычных игроков (сейчас требует mdbd.admin)
• /dbd join <name> — вход в конкретное лобби

Механики крюков

• HookRecovery — самостоятельное слезание с крюка на Stage 2

Перки

• IPerk интерфейс, PerkRegistry
• Survivor: SelfCarePerk, DeadHardPerk, SprintBurstPerk, BorrowedTimePerk
• Killer: HexRuinPerk, CorruptInterventionPerk, BBQChiliPerk

Предметы из конфига

• ChestLoot — читать веса и типы предметов из game.yml (сейчас захардкожено)

---

Конфиги (game.yml) — актуальные ключи

lobby:
  min-players: 4
  max-players: 5
  countdown-4-players: 45
  countdown-5-players: 15
  role-assign-delay: 5

players:
  survivor-scale: 1.0
  killer-scale: 1.5

generators:
  total-count: 7
  required-count: 5
  repair-seconds: 90
  regression-rate: 0.25
  kick-regression-rate: 2.5
  kick-regression-percent: 20.0
  kick-duration-seconds: 30
  kick-cooldown-seconds: 30
  kick-charge-seconds: 3
  interaction-range: 3.0

hooks:
  stage1-seconds: 60
  stage2-seconds: 60
  struggle-interval: 2
  max-hooks: 3
  interaction-range: 3.0
  rescue-seconds: 3
  sabotage-seconds: 10
  sabotage-recovery-seconds: 60

healing:
  other-heal-seconds: 15
  self-heal-seconds: 30
  medkit-bonus: 0.5
  interrupt-on-move: true
  max-heals-per-match: 4
  heal-range: 3.0

carry:
  escape-jumps: 15
  escape-speed-seconds: 3
  jump-fill-percent: 6.67

killer:
  attack-cooldown: 2.5
  attack-range: 3.0
  pallet-stun-seconds: 2.0
  pallet-break-seconds: 3.0
  terror-radius: 32
  pallet-interaction-range: 3.0

bossbar:
  enabled: true
  title: "<red>☠ МАНЬЯК РЯДОМ ☠</red>"
  color: RED
  style: SOLID
  appear-range: 32
  full-range: 8

endgame:
  gate-open-seconds: 20
  collapse-seconds: 120
  chest-open-seconds: 3
  gate-interaction-range: 3.0

killer-notification:
  compass-duration-seconds: 5

scoreboard:
  show-hearts: true
  heart-symbol: "♥"
  color-healthy: "WHITE"
  color-injured: "RED"
  color-healing: "GREEN"
  color-hooked: "DARK_RED"