ServerReplay

Server Replay

English | 中文

Полностью серверная реализация Replay Mod и Flashback, этот мод позволяет записывать сразу нескольких игроков, находящихся онлайн, или области чанков на сервере. Это создаёт файлы реплеев, которые затем можно использовать с replay mod или flashback для рендеринга.

Почему серверная сторона?

По сравнению с клиентскими Replay Mod или Flashback, запись на серверной стороне имеет много преимуществ:

• Возможность записывать статичные чанки.

  • Можно указать точный размер чанка (не ограничен дальностью прорисовки сервера).
  • Записанные чанки могут быть выгружены без влияния на реплей.
  • Никакого мерцания чанков (от выгрузки и загрузки чанков).
  • Чанки также не будут загружаться рекордером (как, например, PCRC).
  • Приостанавливайте и возобновляйте запись в зависимости от того, загружаются ли чанки или есть ли игроки в чанках

• Возможность записывать отдельных игроков.

  • Игрокам не требуется устанавливать replay mod или flashback.
  • Можно записывать все POV одновременно.
  • Записи можно автоматизировать с помощью конфигурации.
• Записи могут быть запущены в любое время операторами (или любым, у кого есть права).

Однако есть и некоторые недостатки и известные проблемы:

• Некоторые функции не записываются в записях чанков, например, пользовательские boss bars.
• Записи игроков могут быть не на 100% совместимы с клиентским Replay Mod или Flashback.

• ServerReplay не особо рассчитан на серверы с большим количеством модов. Более сложные моды, реализующие собственные пакеты, могут быть несовместимы.

  • Если вы столкнётесь с проблемами совместимости, пожалуйста, создайте issue.

Использование

Этот мод требует fabric launcher, fabric-api и fabric-kotlin.

Есть два способа записи на сервере: вы можете настроить его на слежение и запись игроков от их лица. Либо вы можете записывать статичную область чанков.

Быстрый старт

Примечание: Эта документация предназначена для последней версии мода, для более старых версий мода смотрите другие ветки

Этот раздел документации кратко проведёт вас через базовую настройку. А также содержит некоторую важную информацию.

Игроки

Чтобы записать игрока на вашем сервере, выполните /replay start players <player(s)>, например:

/replay start players senseiwells
/replay start players @a
/replay start players @a[gamemode=survival]

Записи игроков привязаны к игроку и будут записываться с дальностью прорисовки сервера.

Если игрок выйдет или сервер остановится, запись автоматически остановится и сохранится.

Либо, если вы хотите остановить запись вручную, выполните /replay stop players <player(s)> <save?>, с помощью этой команды вы также можете остановить запись без сохранения, например:

/replay stop players senseiwells
/replay stop players @r
/replay stop players senseiwells false

Затем запись будет сохранена в указанное вами место "player_recording_path" в папке с uuid игрока. По умолчанию это будет `./recordings/players//.mcpr`.

Этот файл затем можно поместить в ./replay_recordings на вашем клиенте и открыть с помощью replay mod.

Предупреждение: Попытка записать carpet ботов или других ненастоящих игроков может привести к неожиданному поведению. Если вы хотите записать большую область чанков, пожалуйста, используйте запись чанков вместо этого!

Чанки

Примечание: Хотя мод запишет указанные вами чанки, клиент Minecraft не будет отрисовывать самые внешние чанки. Поэтому, чтобы записать область видимых чанков, вы должны добавить один чанк к вашей границе, например, для записи видимой области от -5, -5 до 5, 5 вы должны записывать между -6, -6 и 6, 6.

Чтобы записать область чанков на вашем сервере, выполните `/replay start chunks from to in <dimension?> named <name?>`, например:

/replay start chunks from -5 -5 to 5 5 in minecraft:overworld named MyChunkRecording
/replay start chunks from 54 67 to 109 124
/replay start chunks from 30 30 to 60 60 in minecraft:the_nether 

Либо вы можете указать чанк и радиус вокруг него для записи `/replay start chunks around radius in <dimension?> named <name?>`, например:

/replay start chunks around 0 0 radius 5
/replay start chunks around 67 12 radius 16 in minecraft:overworld named Perimeter Recorder

Записи чанков статичны и не могут перемещаться, они записывают указанные чанки. Важно отметить, что при запуске записи указанные чанки будут загружены (и сгенерированы при необходимости). Однако после этого запись чанков не загружает чанки.

Вы можете дополнительно настроить это с помощью параметра "chunk_recorder_load_radius", который задаст максимальный начальный радиус, который будет загружать запись чанков; любые чанки за пределами этого радиуса, которые записываются, должны быть загружены «естественно», чтобы быть записанными.

Если сервер остановится, запись автоматически остановится и сохранится.

Также, если вы хотите остановить запись вручную, вы можете остановить определённый рекордер, используя его имя, командой `/replay stop chunks named <save?>`, например:

/replay stop chunks named "Perimeter Recorder" false
/replay stop chunks named MyChunkRecording

Затем запись будет сохранена в вашу папку "chunk_recording_path", указанную в конфиге, в папке с именем рекордера чанков. По умолчанию это будет `./recordings/chunks//.mcpr`.

Этот файл затем можно поместить в ./replay_recordings на вашем клиенте и открыть с помощью replay mod.

Кодирование

ServerReplay поддерживает flashback (для более новых версий), а также записи replay mod.

По умолчанию все записи будут записываться в формате replay mod; однако вы можете изменить это, выполнив следующие команды в игре:

/replay encoding default set flashback
/replay encoding default set replay_mod

Примечание: Вы можете записывать перспективу игрока, используя flashback и replay-mod одновременно. Для этого установите кодирование по умолчанию на flashback, начните запись, затем установите кодирование на replay_mod и начните ещё одну запись.

То же самое можно сделать для записей чанков, но каждому рекордеру нужно дать уникальное имя.

Просмотр

После завершения записи вы можете полностью просмотреть запись на стороне сервера. Игрок, просматривающий запись, будет полностью удалён с реального сервера, пока смотрит запись, и будет считаться офлайн.

По сути, это просто "запускает" другой сервер, который отправляет клиенту пакеты. Это работает асинхронно от основного сервера, так что влияние на производительность минимально или отсутствует.

Когда запись завершится, вы можете кликнуть по зелёному тексту в чате, чтобы просмотреть только что завершённую запись. Команда для просмотра записей чанков: `/replay view chunks , а для игроков: /replay view players `, например:

/replay view player "d4fca8c4-e083-4300-9a73-bf438847861c" "2024-05-11--19-19-55"
/replay view chunks "Chunks (183, 166) to (203, 186)" "2024-05-11--19-19-55"

Затем вы будете телепортированы на новый "сервер", где начнётся воспроизведение записи. При просмотре записей вам будет доступен только ограниченный набор команд, включая:

• /replay view pause Приостанавливает воспроизведение текущей записи.
• /replay view unpause Возобновляет воспроизведение текущей записи.
• `/replay view speed ` Устанавливает скорость воспроизведения текущей записи.
• /replay view restart Перезапускает воспроизведение текущей записи.
• /replay view close Закрывает текущую запись и возвращает вас на сервер.
• /replay view progress <hide|show> Скрывает или показывает боссбар прогресса.

Если вы отключитесь во время просмотра записи, при входе вы вернётесь на сервер.

Скачивание

Вы можете скачать любую запись с сервера, если в конфиге включён параметр "allow_downloading_replays" и server-ip и порт для скачивания настроены правильно.

Вы можете использовать команду /replay download, чтобы получить URL для скачивания указанной записи, например:

/replay download players d4fca8c4-e083-4300-9a73-bf438847861c "2024-05-11--19-19-55"
/replay download chunks "Chunks (183, 166) to (203, 186)" "2024-05-11--19-19-55"

Вам придёт сообщение в чат; вы можете кликнуть по предоставленной ссылке, и файл скачается.

Команды

Примечание для всех команд: игроки должны либо иметь op (уровень 4), либо, если у вас есть мод на права (например, LuckPerms), игроки могут иметь право server-replay.commands.replay для доступа к этим командам.

• /replay start players <player(s)> Вручную начинает запись реплея для указанных игроков.
• `/replay start chunks from to in <dimension?> named <name?>` Вручную начинает запись реплея для указанной области чанков; если измерение не указано, будет использовано измерение отправителя команды, а имя определяет, куда будет сохранён файл реплея в папке записей.
• `/replay start chunks around radius in <dimension?> named <name?>` Делает то же, что и команда выше; однако вместо области можно указать радиус вокруг заданного чанка.
• /replay stop players <player(s)> <save?> Вручную останавливает запись реплея для указанных игроков, при желании можно указать, нужно ли сохранять реплей; по умолчанию — да.
• `/replay stop chunks from to in <dimension?> <save?>` Вручную останавливает запись реплея для указанной области чанков; если измерение не указано, будет использовано измерение отправителя команды, при желании можно указать, нужно ли сохранять реплей; по умолчанию — да.
• `/replay stop chunks named <save?>` Позволяет сделать то же, что и команда выше; однако область чанков можно указать по её имени.
• /replay stop [chunks|players] all <save?> Вручную останавливает все записи чанков или игроков; при желании можно указать, нужно ли сохранять реплей; по умолчанию — да.
• /replay status Отправляет сообщение о том, включена ли запись реплеев, а также список всех игроков и чанков, которые сейчас записываются, как долго идёт запись и размеры их файлов.
• /replay reload Перезагружает файл конфигурации для replay mod.
• `/replay encoding default set Задаёт тип записываемого реплея:flashbackилиreplay_mod`

Настройка

После запуска сервера по пути ./config/server-replay/config.json будет создан новый файл, по умолчанию он должен выглядеть так:

{
  "default_encoding": "replay_mod",
  "world_name": "World",
  "server_name": "Server",
  "chunk_recording_path": "./recordings/chunks",
  "player_recording_path": "./recordings/players",
  "player_recording_name": "{uuid}",
  "max_file_size": "0 B",
  "restart_after_max_file_size": false,
  "max_duration": "0s",
  "restart_after_max_duration": false,
  "recover_unsaved_replays": true,
  "delete_replays_after_duration": "0s",
  "log_deleted_replays": true,
  "chunk_recorder_load_radius": -1,
  "chunk_recording_strategy": "always",
  "pause_notify_players": true,
  "notify_admins_of_status": true,
  "include_resource_packs": true,
  "ignore_custom_payloads": false,
  "ignore_sound_packets": false,
  "ignore_light_packets": true,
  "ignore_chat_packets": false,
  "ignore_action_bar_packets": false,
  "ignore_scoreboard_packets": false,
  "optimize_explosion_packets": true,
  "optimize_entity_packets": false,
  "record_hotbar": false,
  "record_voice_chat": false,
  "replay_server_ip": null,
  "allow_downloading_replays": false,
  "automatically_record": false,
  "player_predicate": {
    "type": "none"
  },
  "chunks": []
}

Конфигурация чанков

Вы можете задать области чанков, которые будут записываться автоматически при запуске сервера или когда вы включаете ServerReplay.

Каждое определение чанка должно включать: "name", "dimension", "from_x", "to_x", "from_z" и "to_z". Например:

{
  // ...
  "chunks": [
    {
      "name": "My Chunks",
      "dimension": "minecraft:overworld",
      "from_x": -5,
      "from_z": -5,
      "to_x": 5,
      "to_z": 5
    },
    {
      "name": "My Nether Chunks",
      "dimension": "minecraft:the_nether",
      "from_x": 100,
      "from_z": 50,
      "to_x": 90,
      "to_z": 60
    }
    // ...
  ]
}

Конфигурация предикатов

Вы можете задать предикат, который определяет, какие игроки на вашем сервере будут записываться автоматически. Это можно сделать, указав, есть ли у игроков определённый uuid, имя, состоят ли они в определённой команде или являются ли они оператором.

После определения предиката вы должны выполнить /replay reload в игре, затем игроки должны перезайти, если они хотят записываться (и соответствуют критериям предиката).

Самый простой вариант — просто записывать всех игроков, для этого можно использовать:

{
  // ...
  "player_predicate": {
    "type": "all"
  }
}

Если вы хотите записывать только игроков с определёнными именами или uuid, можно сделать следующее:

{
  // ...
  "player_predicate": {
    "type": "has_name",
    "names": [
      "senseiwells",
      "foobar"
    ]
  }
}

{
  // ...
  "player_predicate": {
    "type": "has_uuid",
    "uuids": [
      "41048400-886d-497d-9d97-9fe7c9b63afa",
      "71266dbd-db0a-484a-b859-3f135590d7a9",
      "47d072ca-d7a2-467c-9b60-de501907e91d",
      "0e324e7f-e78e-4777-b501-7ae08a65b1eb",
      "7d9e24c2-9d0f-479f-81c7-27389624ebb2"
    ]
  }
}

Если вы хотите записывать только операторов:

{
  // ...
  "player_predicate": {
    "type": "has_op",
    "level": 4
  }
}

Если вы хотите записывать только игроков в определённых командах, это полезно, чтобы позволить игрокам добавляться и удаляться прямо в игре, так как вы можете просто добавить игроков в команду, и затем они перезайдут:

{
  // ...
  "player_predicate": {
    "type": "in_team",
    "teams": [
      "Red",
      "Blue",
      "Spectators"
    ]
  }
}

Вы также можете инвертировать предикаты с помощью 'not' и комбинировать их с помощью 'or' и 'and'. Например, если вы хотите записывать всех не-операторов, у которых также нет имени 'senseiwells' или которые не в красной команде:

{
  // ...
  "player_predicate": {
    "type": "and",
    "predicates": [
      {
        "type": "not",
        "predicate": {
          "type": "has_op",
          "level": 4
        }
      },
      {
        "type": "not",
        "predicate": {
          "type": "or",
          "predicates": [
            {
              "type": "has_name",
              "names": [
                "senseiwells"
              ]
            },
            {
              "type": "in_team",
              "teams": [
                "Red"
              ]
            }
          ]
        }
      } 
    ]
  }
}

Если вы используете carpet mod и у вас есть возможность спавнить фейковых игроков, возможно, вы захотите исключить их из записи.
Сделать это можно с помощью предиката `is_fake`:
```json5
{
  // ...
  "player_predicate": {
    "type": "not",
    "predicate": {
      "type": "is_fake"
    }
  }
}

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

Спасибо ExperimentalIdea за помощь в тестировании поддержки flashback!