MurderCraft

MurderCraft

Многопользовательский мод для Minecraft, вдохновлённый режимом Murder, придуманным Squeezie & Théodore Bonnet (который, в свою очередь, основан на Garry's Mod Murder). Блеф. Паранойя. Нож в темноте. Окунись в напряжённую вечеринку подозрений: скрытые убийцы крадутся в толпе, одинокий детектив пытается вовремя их заметить, а у невиновных одна задача — выжить. Всего один вооружённый защитник, по две пули на пистолет и один скрытый пистолет, за которым идёт охота посреди раунда — каждый матч превращается в тугую спираль страха, обвинений и решений за доли секунды. ⚠ Важная атрибуция: набор правил в этом моде следует варианту, придуманному Squeezie & Théodore Bonnet (2 убийцы, которые не знают друг друга напрямую, скрытый пистолет посреди игры, дружественный огонь = навсегда теряешь оружие, 4 раунда по 15 минут, механика раскрытия через задания с 3-го раунда, 2 пули на пистолет). Он не воспроизводит точные правила оригинального Garry's Mod Murder.

✦ Концепция

В начале каждого раунда каждому игроку тайно назначается одна из трёх ролей. Никто не знает, кто есть кто — и в этом весь смысл.

Роль	Количество	Оружие	Цель
☠ Убийца	2	Нож (убивает с одного удара)	Незаметно устранить всех невиновных. Двое убийц не знают друг друга напрямую — но могут заметить друг друга по едва уловимым частицам пламени души, видимым только им. Убийцы не могут подобрать пистолет — он автоматически вылетает с полной скоростью.
⚭ Детектив	1	Пистолет (2 пули)	Опознать убийц и застрелить их. Выстрел в невиновного навсегда лишает тебя оружия (пистолет падает на землю с оставшимися патронами, подобрать его могут только невиновные).
☺ Невиновный	Все остальные	Нет	Выжить. Наблюдать. Шептать предупреждения детективу. Найти скрытый пистолет, который появляется посреди игры, чтобы стать новым Детективом.

Условия победы

• Невиновные и Детектив побеждают, если оба убийцы устранены ИЛИ если время вышло.
• Убийцы побеждают, если убьют всех, кроме убийц, до истечения времени.

---

🏆 Структура сессии (4 раунда)

Полная сессия — это 4 раунда длительностью до 15 минут каждый. Побеждает команда с наибольшим числом побед в раундах. Между раундами — 15-секундная пауза, чтобы перевести дух, после чего роли перемешиваются и начинается следующий раунд.

🗺 Случайный спавн с неуязвимостью

В начале каждого раунда:

• Все участники телепортируются на случайные допустимые позиции на земле в пределах настраиваемого радиуса (по умолчанию 200 блоков) от спавна мира (/setworldspawn).
• Океан, реки и глубокий океан исключены — никто не появляется в воде.
• Игроки появляются в 25 блоках над землёй и получают 8 секунд полной неуязвимости к урону (настраивается). Это предотвращает урон от падения, смерть в лаве и мгновенные убийства в хаосе начала раунда.
• Соблюдается минимальная дистанция между игроками (зависит от числа игроков): 60 блоков для 4 игроков, 30 для 16, 20 для 32+. Точки спавна разбросаны, а не скучены.
• В строке действий отображается отсчёт неуязвимости: 🛡 Damage immunity: 5s..., а после её окончания — ⚠ You are no longer invulnerable!.
• Все участники автоматически переводятся в режим выживания для честной игры.

Квадратная граница мира

В начале сессии автоматически устанавливается настраиваемая квадратная граница мира с центром на спавне мира. Размер по умолчанию: 500 блоков в поперечнике. Это заставляет действие происходить в определённой зоне — больше никаких невиновных, убегающих прятаться за 5000 блоков. Исходная конфигурация границы мира сохраняется и восстанавливается по окончании сессии.

🎯 Задания (с 3-го раунда)

Начиная с 3-го раунда, в каждом раунде появляется одно задание:

• Исследование — Рядом появляется светящийся сундук с Тайным жетоном. Побеждает тот, кто первым схватит жетон.
• Крафт — Объявляется случайный рецепт (факел, лестница, хлеб, бумага и т. д.). Побеждает тот, кто первым его скрафтит. Победитель задания получает 30-секундное окно, чтобы использовать `/murder task reveal ` и лично узнать роль этого игрока. Делиться ли этой информацией в голосовом чате — полностью на усмотрение игрока; мод просто показывает роль.

---

🔫 Система оружия

Пистолет (только у Детектива)

• 2 пули на пистолет (набор правил Squeezie). Когда патроны кончаются, пистолет превращается в бесполезную кликалку.
• Патроны сохраняются при выпадении и подборе: пистолет, из которого выстрелили один раз, сохраняет 1 патрон, когда его подбирает кто-то другой.
• Видимое количество патронов в подсказке предмета (зелёное, когда заряжен, красное, когда пуст) и в строке действий после каждого выстрела.
• Звук щелчка при попытке выстрелить из пустого пистолета.
• Многослойный звук выстрела с частицами вспышки (дым + пламя).
• Дальность до 64 блоков, 1 секунда перезарядки между выстрелами.

Скрытый пистолет

• Появляется в случайном месте поблизости через 60 секунд (настраивается) после начала каждого раунда.
• Всегда светится жёлтым, чтобы оставаться заметным до подбора (никогда не исчезает).
• Подобрать его могут только невиновные — если на него наступит убийца, он автоматически вылетит с ускорением и 3-секундной задержкой на подбор.
• Когда невиновный подбирает его, он автоматически повышается до Детектива с оставшимися патронами пистолета.

Нож (только у Убийцы)

• Убивает любого игрока с одного удара.
• Не может использоваться не-убийцами (вместо этого обычный удар с 1 уроном).
• Комбо из звука удара трезубцем и ломания шерсти с частицами брызг крови.

Защита от гриферства

Все кастомные предметы (нож, пистолет, скрытый пистолет, тайный жетон) нельзя выбросить вручную. Нажатие Q или перетаскивание из инвентаря мгновенно возвращает предмет с чётким сообщением в строке действий. Это предотвращает случайную потерю в лаве, падение со скал и т. п., а также не даёт игрокам сломать игру, намеренно избавляясь от своих ролевых предметов.

✨ Визуальная и звуковая полировка

• Кинематографичные титры на экране при назначении роли («Your role: Murderer»), начале раунда («Round 2/4»), баннеры конца раунда с накопленным счётом и завершении задания.
• Осведомлённость убийц: над другими убийцами появляются едва уловимые частицы пламени души, видимые только собратьям-убийцам — координируйтесь, не раскрывая себя остальным.

• Звуки брифинга по ролям: ambient wither для убийц (хоррор-атмосфера), колокол для детектива (официально), тост для невиновных.
• Звуки конца раунда: триумфальная фанфара при победе невиновных, смерть wither при победе убийц.
• HUD с таблицей очков справа с золотыми рамками, показывающий раунд, роль и таймер — чисто и не мешает.
• Многослойные звуки оружия и частицы для приятной боевой отдачи.

⚙ Требования

• Minecraft: 1.21.1
• Загрузчик: Fabric
• Java: 21+
• Должен быть установлен и на сервере, и на каждом клиенте.

Только для мультиплеера. Мод загружается в одиночной игре, но не может запустить матч в одиночку. Требуется минимум 4 игрока (по умолчанию: 5 для лучшего баланса, поддерживается до 32).

🎮 Команды

Команда	Описание	Права
/murder join	Присоединиться к лобби	Всем
/murder leave	Покинуть лобби	Всем
/murder status	Показать текущее состояние игры	Всем
`/murder task reveal `	Раскрыть роль (после выполнения задания)	Всем
/murder start	Запустить сессию	OP
/murder stop	Остановить текущую игру	OP
/murder config show	Вывести текущий конфиг	OP
`/murder config minPlayers `	Изменить минимальное число игроков	OP
`/murder config duration `	Изменить длительность раунда	OP
`/murder kick `	Убрать игрока	OP

---

🔐 Два варианта сборки

Сборка	Отладочные команды	Урон от мобов	Применение
PUBLIC (эта)	ВЫКЛ (нельзя включить обратно)	ВЫКЛ	Реальные серверы, публичная игра
DEBUG (только в релизах на GitHub)	ВКЛ	ВКЛ	Одиночное тестирование мейнтейнером

Администраторы серверов могут доверять публичной сборке — она ведёт себя предсказуемо, без скрытых читерских возможностей: отладочные флаги принудительно отключены, даже если в файле конфигурации указано иное, с предупреждением в консоли при обнаружении.

🛠 Настройка

Все настройки сохраняются в config/murdercraft.json и могут быть изменены на лету через Mod Menu:

• Игра: минимум/максимум игроков, длительность игры, отсчёт до старта, задержка скрытого пистолета, раундов за сессию, задержка между раундами
• Роли: количество убийц, количество детективов
• Геймплей: переключатель одного удара ножом, переключатель наказания за дружественный огонь
• Спавн: случайный спавн, радиус, высота, длительность иммунитета, включение границы мира, размер границы мира
• UI: переключатель кастомного HUD, переключатель субтитров

---

🗺 План развития

• [x] Система трёх ролей (Убийца / Детектив / Невиновный)
• [x] Сессии из 4 раундов с раундами по 15 минут
• [x] Пистолет с 2 пулями и сохраняющимися патронами
• [x] Правила выпадения пистолета (смерть, дружественный огонь, автоизъятие у убийцы)
• [x] Автоматическое повышение при скрытом пистолете
• [x] Система заданий с приватным раскрытием роли
• [x] Частицы осведомлённости убийцы
• [x] Случайный спавн с иммунитетом к урону
• [x] Настраиваемая граница мира
• [x] Защита кастомных предметов от выпадения
• [x] Титры-оверлеи + HUD с таблицей очков справа
• [x] Варианты сборок Public/Debug с флагами безопасности
• [ ] Кастомные звуковые файлы OGG (сейчас используются ванильные звуки)
• [ ] Постоянная статистика (убийства, победы, MVP)
• [ ] Интеграция с выделенными картами
• [ ] Поддержка Forge / NeoForge через Architectury

---

💬 Сообщество и обратная связь

Это публичная бета — всё ещё нужно реальное тестирование в мультиплеере, поэтому любая обратная связь ценна. Вот куда можно обратиться:

• 🐛 Сообщить о баге или краше → используйте ссылку Issues в боковой панели этой страницы, чтобы открыть issue на GitHub. Пожалуйста, укажите версию мода (0.5.0-beta.7), версию Minecraft (1.21.1), шаги воспроизведения и любой лог краша или видео.
• 💡 Предложить функцию или поделиться идеей по геймплею → заполните форму предложений MurderCraft. Все заявки читаются и рассматриваются для будущих обновлений.
• 📖 Прочитать исходный код → используйте ссылку Source в боковой панели, чтобы просмотреть репозиторий на GitHub. Вклад через Pull Request приветствуется. Спасибо за помощь в развитии MurderCraft!

---

📜 Лицензия

Выпущено под MIT License (см. файл LICENSE в репозитории исходного кода) — форкайте, изменяйте, распространяйте свободно с указанием авторства.

🙌 Благодарности

• Прямое вдохновение для правил: игровой режим "Murder", созданный Squeezie & Théodore Bonnet. Конкретные правила, реализованные здесь, следуют их варианту.
• Истоки жанра: Garry's Mod — Murder
• Другие источники вдохновения по геймплею: UHC, UHC Werewolves, Hypixel Murder Mystery
• Дизайн и разработка мода: Remilulz_91