loki5512344
89dc9eb00d
- Add HookSabotage system for survivors to disable hooks temporarily - Add GeneratorKick killer ability to regress generator progress - Add PlayerJumpListener to track survivor jump actions - Add BossBarManager for displaying game state and objectives - Update generator regression logic to support killer kick mechanic - Update KillerController to integrate generator kick ability - Update PlayerInteractListener to handle new interaction types - Refactor game phases to use BossBarManager for UI updates - Update .gitignore to exclude compiled bin/ directory - Simplify PLAN.md documentation for easier maintenance
206 lines
9.6 KiB
Markdown
206 lines
9.6 KiB
Markdown
# DBD Plugin — План разработки
|
||
|
||
## Архитектурные принципы
|
||
|
||
- **KISS**: Нет абстракций ради абстракций. Простые классы с одной ответственностью.
|
||
- **DRY**: Общая логика в утилитах, не копипаста.
|
||
- **SOLID**: SRP, OCP, LSP, ISP, DIP. Max 150 строк/файл.
|
||
|
||
---
|
||
|
||
## Статус реализации
|
||
|
||
### ✅ Этап 0: Скелет проекта
|
||
- [x] `build.gradle` (Paper 1.21.1, Java 21)
|
||
- [x] `plugin.yml` с пермишнами
|
||
- [x] `DBDPlugin.java` — onEnable/onDisable
|
||
- [x] `ConfigManager` — загрузка yaml без перезаписи
|
||
- [x] `LocationsConfig` — координаты объектов
|
||
- [x] `GameConfig` — все балансные цифры (BossBar, carry, heal limits, lobby timers, sizes, kick cooldown, sabotage)
|
||
|
||
### ✅ Этап 1: Core Game Loop
|
||
- [x] `GameState` enum
|
||
- [x] `GameSession` — хранит игроков, фазу, таймер; передаёт `GateManager` и `collapseSeconds` в `EndgamePhase`
|
||
- [x] `Phase` interface
|
||
- [x] `LobbyPhase` — таймер **45 сек при 4 игроках**, **15 сек при 5**, min-players=4, анонс на ключевых секундах
|
||
- [x] `RoleAssigner` + `RoleQueue` — выбор киллера; применяет `GENERIC_SCALE` через Attribute API
|
||
- [x] `RoleAssignPhase` — телепорты, задержка 5 сек
|
||
- [x] `GameplayPhase` — полная логика (см. ниже)
|
||
- [x] `EndgamePhase` — `collapseSeconds` из конфига, таймер в `Sidebar`, `GateManager` из сессии, Adventure API title
|
||
- [x] `/dbd join`, `/dbd leave`, `/dbd forcestart`, `/dbd stop`, `/dbd reload`, `/dbd lobby`, `/dbd setlobby`
|
||
|
||
### ✅ Этап 2: Игроки и состояния
|
||
- [x] `BasePlayer`, `Survivor`, `Killer`
|
||
- [x] `PlayerState`: HEALTHY, INJURED, DOWNED, HOOKED, CARRIED, DEAD, ESCAPED
|
||
- [x] `StateMachine` — переходы с валидацией
|
||
- [x] `PlayerManager` — map UUID → BasePlayer
|
||
- [x] `SpawnPosition` — телепорт из конфига
|
||
- [x] Перевод в `GameMode.SPECTATOR` при `PlayerState.DEAD` (в `GameplayPhase.checkWinConditions` и `HookSacrifice`)
|
||
- [x] Размеры через `Attribute.GENERIC_SCALE`: Survivor=1.0, Killer=1.5 (в `RoleAssigner` и `GameplayPhase`)
|
||
|
||
### ✅ Этап 3: Киллер
|
||
- [x] `KillerController` — без дублирующей регистрации `AttackListener`
|
||
- [x] `KillerAttack` — ЛКМ, кулдаун 2.5 с, hitbox
|
||
- [x] `HitValidator` — line of sight, расстояние
|
||
- [x] `DamageHandler` — Healthy→Injured, Injured→Downed
|
||
- [x] `KillerCarry` — побег через **спам пробела** (PlayerJumpListener), шкала в ActionBar, Speed I при побеге
|
||
- [x] `KillerMovement` — скорость из конфига, замедление после удара
|
||
- [x] `GeneratorKick` — Shift 3 сек → −20% прогресса, кулдаун 30 сек, progress bar
|
||
- [x] `BossBarManager` — BossBar с градиентом по дистанции до маньяка, читает все параметры из конфига
|
||
|
||
### ✅ Этап 4: Выживший
|
||
- [x] `SurvivorController` — передаёт `GameConfig` в `SurvivorHealing`
|
||
- [x] `SurvivorMovement` — sprint, exhaustion
|
||
- [x] `SurvivorHealing` — таймеры из конфига (other=15 сек, self=30 сек), лимит **4 лечений** из конфига, sneak-check, range-check
|
||
- [x] Downed movement — crawl 30% скорости
|
||
|
||
### ✅ Этап 5: Генераторы
|
||
- [x] `Generator` — `setUnderRegression(bool, ticks)`, `wasKicked()`
|
||
- [x] `GeneratorManager` — `getCompletedCount()` считает живое состояние
|
||
- [x] `GeneratorRepair` — ПКМ, прогресс в ActionBar; при фейле skillcheck: `setUnderRegression` + **компас маньяку** на `compass-duration-seconds`
|
||
- [x] `GeneratorRegression` — скорость полностью из конфига (`regression-rate`, `kick-regression-rate`), без хардкодированных констант
|
||
- [x] `SkillCheck` + `SkillCheckUI` — QTE система
|
||
|
||
### ✅ Этап 6: Крюки
|
||
- [x] `Hook` — поле `disabled` + `isDisabled()`/`setDisabled()`
|
||
- [x] `HookManager` — `maxHooks` из конфига, `tryHookSurvivor` проверяет лимит → при превышении сразу `DEAD`; `findNearestUnoccupiedHook` и `findAvailableHook` учитывают `isDisabled()`
|
||
- [x] `HookStage` — Stage 1 (60 с), Stage 2 (60 с)
|
||
- [x] `HookStruggle` — `struggleIntervalTicks` из конфига (`hooks.struggle-interval`)
|
||
- [x] `HookRescue` — 60 тиков (3 сек из конфига), sneak-check, range-check, Speed I после спасения
|
||
- [x] `HookSacrifice` — смерть + **SPECTATOR mode**
|
||
- [x] `HookSabotage` — выживший держит Shift **10 сек** → крюк отключён, восстановление **60 сек** (всё из конфига), progress bar, broadcast
|
||
|
||
### ✅ Этап 7: UI
|
||
- [x] `ActionBar` — статус, прогресс-бары
|
||
- [x] `Sidebar` — сердца ♥ (по `hooksTaken`), цвета ников по состоянию, `GeneratorManager` (живой счёт), таймер коллапса
|
||
- [x] `TitleUI`, `ProgressBar`, `StatusIcons`
|
||
- [x] `BossBarManager` — BossBar для каждого выжившего, градиент по дистанции
|
||
- [x] Шкала wiggle в `KillerCarry.showWiggleProgress()` (ActionBar)
|
||
|
||
### ✅ Этап 8: Паллеты и окна
|
||
- [x] `Pallet`, `PalletManager`, `PalletDrop`, `PalletBreak`, `PalletStun`
|
||
- [x] `Window`, `WindowManager`, `WindowVault`, `WindowFastVault`
|
||
|
||
### ✅ Этап 9: Ворота и люк
|
||
- [x] `ExitGate` — `savedProgress` + `getSavedProgress()`/`saveProgress()`/`restoreProgress()`/`setProgressDirect()`; `reset()` чистит `savedProgress`
|
||
- [x] `GateManager` — `activateEndgame()` только включает питание, **без авто-открытия**
|
||
- [x] `GateOpening` — **линейный прогресс** (`setProgressDirect`), сохраняет/восстанавливает прогресс при уходе/возврате игрока
|
||
- [x] `Hatch`, `HatchCondition`, `HatchEscape`
|
||
|
||
### ✅ Этап 10: Звук
|
||
- [x] `TerrorRadiusSound` — `terrorRadius` параметр конструктора (из конфига), дефолт 32
|
||
- [x] `SoundManager`, `GeneratorSound`, `SoundLevels`
|
||
|
||
### ✅ Этап 11: Слушатели
|
||
- [x] `PlayerJumpListener` — прыжки для wiggle при переноске
|
||
- [x] `PlayerInteractListener` — `setOnKillerSneak` + `PlayerToggleSneakEvent` (маньяк → GeneratorKick, выживший → HookSabotage)
|
||
- [x] `PlayerMoveListener`, `PlayerQuitListener`, `DamageListener`
|
||
|
||
### ✅ Этап 12: Данные и хранение
|
||
- [x] `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) — актуальные ключи
|
||
|
||
```yaml
|
||
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"
|
||
```
|