English

StagedSMP — server-side toolkit for scripted SMPs

A server-side mod for Fabric. Provides controllable mechanics for recording scripted hardcore series, staged events, and roleplay projects. All features are managed via commands and configuration with hot-reloading. No client installation required.

The mod is aimed at server owners filming narrative-driven SMPs. It allows on-the-fly management of death consequences, chat message visibility, and player names — without stopping recording or restarting the server.

Core Features

Death Ban

• Automatic player ban upon death.
• Global enable/disable via config.
• /immortal <player> [true|false] — granting or revoking immortality for individual players without disabling the system for others.
• Use case: protecting operator accounts and the filming crew while keeping the ban for participants.

Proximity Messages

• Death, join, and leave messages are visible only to players within a set radius.
• distance — visibility radius in blocks.
• enabled — global system disable, reverting to normal global messages.
• Use case: multi-perspective recording where different groups are in different locations and should not overlap in chat.

Nickname System

• Assigning display names via /nick set.
• Resetting nicks — individually or in bulk via /nick reset and /nick reset all.
• Optional nickname display in chat (features.chatFormat).
• Nickname-to-original-name mapping is preserved between restarts.
• Use case: assigning character names for roleplay series; quick name resets between episodes.

Commands

Command	Description
/immortal <player>	Toggle immortality mode
/immortal <player> <true|false>	Explicitly set immortality mode
/nick set <player|nick> <new_nick>	Assign a nickname to a player
/nick reset <player|nick>	Reset nickname to original name
/nick reset all	Reset all nicknames on the server
/stagedsmp reload	Reload configuration

All commands require operator permissions.

Configuration

File: config/stagedsmp.json

{
  "deathBan": {
    "enabled": true
  },
  "proximityMessages": {
    "enabled": true,
    "distance": 500
  },
  "features": {
    "nick": {
      "enabled": false
    },
    "chatFormat": {
      "enabled": false
    }
  }
}

Parameters

Parameter	Default	Description
deathBan.enabled	true	Enables automatic ban on death
proximityMessages.enabled	true	Enables local visibility for death/join/leave messages
proximityMessages.distance	500	Message visibility radius in blocks
features.nick.enabled	false	Enables the nickname system and /nick command
features.chatFormat.enabled	false	Displays nicknames in chat (requires features.nick.enabled: true)

Hot-Reloading

Applied instantly via /stagedsmp reload or upon automatic file change:

• deathBan.enabled
• proximityMessages.enabled
• proximityMessages.distance

Require a server restart:

• features.nick.enabled
• features.chatFormat.enabled

Data Files

• config/stagedsmp_nicks.json — current nickname assignments
• config/stagedsmp_original_names.json — reverse mapping of nicknames to original names

Русский

StagedSMP — серверный набор инструментов для постановочных SMP

Серверный мод для Fabric. Предоставляет управляемые механики для записи постановочных хардкор-серий, срежиссированных событий и ролевых проектов. Все функции управляются командами и конфигурацией с горячей перезагрузкой. Установка на клиент не требуется.

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

Основные возможности

Бан за смерть

• Автоматический бан игрока при смерти.
• Глобальное включение/отключение через конфиг.
• /immortal <игрок> [true|false] — выдача или отзыв бессмертия для отдельных игроков без отключения системы для остальных.
• Применение: защита операторских аккаунтов и съёмочной группы при сохранении бана для участников.

Локальные сообщения

• Сообщения о смерти, входе и выходе видны только игрокам в заданном радиусе.
• distance — радиус видимости в блоках.
• enabled — глобальное отключение системы с возвратом к обычным глобальным сообщениям.
• Применение: многоперспективная запись, где разные группы находятся в разных локациях и не должны пересекаться по чату.

Система ников

• Назначение отображаемых имён через /nick set.
• Сброс ников — индивидуально или массово через /nick reset и /nick reset all.
• Опциональное отображение ников в чате (features.chatFormat).
• Соответствие ников и оригинальных имён сохраняется между перезапусками.
• Применение: назначение персонажных имён для ролевых серий; быстрый сброс имён между эпизодами.

Команды

Команда	Описание
/immortal <игрок>	Переключить режим бессмертия
/immortal <игрок> <true|false>	Установить режим бессмертия явно
/nick set <игрок|ник> <новый_ник>	Назначить игроку ник
/nick reset <игрок|ник>	Сбросить ник до оригинального имени
/nick reset all	Сбросить все ники на сервере
/stagedsmp reload	Перезагрузить конфигурацию

Все команды требуют прав оператора.

Конфигурация

Файл: config/stagedsmp.json

{
  "deathBan": {
    "enabled": true
  },
  "proximityMessages": {
    "enabled": true,
    "distance": 500
  },
  "features": {
    "nick": {
      "enabled": false
    },
    "chatFormat": {
      "enabled": false
    }
  }
}

Параметры

Параметр	По умолчанию	Описание
deathBan.enabled	true	Включает автоматический бан при смерти
proximityMessages.enabled	true	Включает локальную видимость сообщений о смерти/входе/выходе
proximityMessages.distance	500	Радиус видимости сообщений в блоках
features.nick.enabled	false	Включает систему ников и команду /nick
features.chatFormat.enabled	false	Отображает ники в чате (требует features.nick.enabled: true)

Горячая перезагрузка

Применяются мгновенно через /stagedsmp reload или при автоматическом изменении файла:

• deathBan.enabled
• proximityMessages.enabled
• proximityMessages.distance

Требуют перезапуска сервера:

• features.nick.enabled
• features.chatFormat.enabled

Файлы данных

• config/stagedsmp_nicks.json — текущие назначения ников
• config/stagedsmp_original_names.json — обратное сопоставление ников с оригинальными именами