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 [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

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

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).
• Соответствие ников и оригинальных имён сохраняется между перезапусками.
• Применение: назначение персонажных имён для ролевых серий; быстрый сброс имён между эпизодами.

Команды

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

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

Файл: config/stagedsmp.json

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

Параметры

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

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

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

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

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

Файлы данных

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