Staged SMP

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 — обратное сопоставление ников с оригинальными именами