Просмотр кода страницы Настройка whitelist и управления игроками на Bedrock

= Настройка whitelist и управления игроками на Bedrock =

== 1. Подготовка ==

* Убедитесь, что Bedrock сервер установлен и находится в `/opt/bedrock`.
* Имейте права доступа для редактирования конфигурационных файлов.
* Знайте XUID игроков для добавления в whitelist.
* Рекомендуется использовать Ubuntu 24.04 LTS.

== 2. Включение whitelist ==

=== Активация через server.properties ===

1. Отредактируйте конфигурацию:
<pre>cd /opt/bedrock
nano server.properties</pre>

2. Включите whitelist:
<pre>white-list=true</pre>

3. Перезапустите сервер:
<pre>sudo systemctl restart minecraft-bedrock</pre>

4. Проверьте статус:
<pre>sudo systemctl status minecraft-bedrock</pre>

=== Активация через консоль сервера ===

1. Подключитесь к консоли:
<pre>screen -r minecraft-bedrock</pre>

2. Включите whitelist:
<pre>whitelist on</pre>

3. Выйдите из консоли:
<pre>Ctrl+A, затем D</pre>

== 3. Работа с allowlist.json ==

=== Структура файла ===

1. Файл `allowlist.json` находится в директории сервера:
<pre>cd /opt/bedrock
cat allowlist.json</pre>

2. Базовая структура:
<pre>[
  {
    "name": "PlayerName",
    "xuid": "1234567890123456"
  }
]</pre>

=== Получение XUID игрока ===

1. '''Метод 1: Через консоль сервера'''
* Попросите игрока попытаться подключиться
* В логах сервера появится его XUID

2. '''Метод 2: Через логи'''
<pre>grep "PlayerName" logs/*.log | grep xuid</pre>

3. '''Метод 3: Попросить игрока'''
* XUID можно найти в файлах игры на устройстве игрока
* Или через специальные инструменты

=== Добавление игрока в whitelist ===

1. '''Способ 1: Через консоль сервера'''
<pre>screen -r minecraft-bedrock
whitelist add PlayerName</pre>

2. '''Способ 2: Редактирование allowlist.json'''
<pre>cd /opt/bedrock
nano allowlist.json</pre>

3. Добавьте игрока:
<pre>[
  {
    "name": "Player1",
    "xuid": "1234567890123456"
  },
  {
    "name": "Player2",
    "xuid": "9876543210987654"
  }
]</pre>

4. Перезагрузите whitelist:
<pre>screen -r minecraft-bedrock
whitelist reload</pre>

=== Примеры конфигураций ===

1. '''Базовый whitelist (1 игрок)''':
<pre>[
  {
    "name": "MyFriend",
    "xuid": "1234567890123456"
  }
]</pre>

2. '''Расширенный whitelist (несколько игроков)''':
<pre>[
  {
    "name": "AdminUser",
    "xuid": "1234567890123456"
  },
  {
    "name": "TrustedPlayer1",
    "xuid": "2345678901234567"
  },
  {
    "name": "TrustedPlayer2",
    "xuid": "3456789012345678"
  },
  {
    "name": "TrustedPlayer3",
    "xuid": "4567890123456789"
  }
]</pre>

3. '''Whitelist с комментариями (используйте отдельный файл для заметок)''':
<pre>\# allowlist.json
[
  {
    "name": "Owner",
    "xuid": "1234567890123456"
  }
]

\# whitelist-notes.txt (создайте отдельный файл)
\# Owner - Владелец сервера
\# TrustedPlayer1 - Проверенный игрок
\# TrustedPlayer2 - Модератор</pre>

== 4. Управление через консоль ==

=== Базовые команды ===

1. '''Просмотр списка whitelist''':
<pre>screen -r minecraft-bedrock
whitelist list</pre>

2. '''Добавление игрока''':
<pre>whitelist add PlayerName</pre>

3. '''Удаление игрока''':
<pre>whitelist remove PlayerName</pre>

4. '''Включение whitelist''':
<pre>whitelist on</pre>

5. '''Выключение whitelist''':
<pre>whitelist off</pre>

6. '''Перезагрузка whitelist из файла''':
<pre>whitelist reload</pre>

=== Примеры использования ===

1. '''Добавление нескольких игроков''':
<pre>whitelist add Friend1
whitelist add Friend2
whitelist add Friend3
whitelist list</pre>

2. '''Временное отключение whitelist''':
<pre>whitelist off
\# Сервер доступен всем
whitelist on
\# Только whitelist игроки</pre>

3. '''Обновление whitelist из файла''':
<pre>\# Отредактировали allowlist.json вручную
whitelist reload
\# Изменения применены</pre>

== 5. Автоматизация управления ===

=== Создание скрипта добавления ===

1. Создайте скрипт:
<pre>sudo nano /usr/local/bin/bedrock-whitelist-add.sh</pre>

2. Добавьте содержимое:
<pre>\#!/bin/bash

if [ -z "$1" ]; then
    echo "Usage: $0 <player-name> [xuid]"
    exit 1
fi

PLAYER_NAME="$1"
XUID="$2"
ALLOWLIST_FILE="/opt/bedrock/allowlist.json"
BACKUP_FILE="/opt/bedrock/allowlist.json.backup"

\# Создание резервной копии
cp "$ALLOWLIST_FILE" "$BACKUP_FILE"

\# Если XUID не указан, используем временный
if [ -z "$XUID" ]; then
    XUID="0"
fi

\# Добавление игрока через консоль
screen -S minecraft-bedrock -X stuff "whitelist add $PLAYER_NAME$(printf \\r)"

echo "Player $PLAYER_NAME added to whitelist"
echo "Reloading whitelist..."
screen -S minecraft-bedrock -X stuff "whitelist reload$(printf \\r)"</pre>

3. Сделайте исполняемым:
<pre>sudo chmod +x /usr/local/bin/bedrock-whitelist-add.sh</pre>

4. Использование:
<pre>sudo /usr/local/bin/bedrock-whitelist-add.sh PlayerName
sudo /usr/local/bin/bedrock-whitelist-add.sh PlayerName 1234567890123456</pre>

=== Создание скрипта удаления ===

1. Создайте скрипт:
<pre>sudo nano /usr/local/bin/bedrock-whitelist-remove.sh</pre>

2. Добавьте содержимое:
<pre>\#!/bin/bash

if [ -z "$1" ]; then
    echo "Usage: $0 <player-name>"
    exit 1
fi

PLAYER_NAME="$1"
ALLOWLIST_FILE="/opt/bedrock/allowlist.json"
BACKUP_FILE="/opt/bedrock/allowlist.json.backup"

\# Создание резервной копии
cp "$ALLOWLIST_FILE" "$BACKUP_FILE"

\# Удаление игрока
screen -S minecraft-bedrock -X stuff "whitelist remove $PLAYER_NAME$(printf \\r)"

echo "Player $PLAYER_NAME removed from whitelist"
echo "Reloading whitelist..."
screen -S minecraft-bedrock -X stuff "whitelist reload$(printf \\r)"</pre>

3. Сделайте исполняемым:
<pre>sudo chmod +x /usr/local/bin/bedrock-whitelist-remove.sh</pre>

4. Использование:
<pre>sudo /usr/local/bin/bedrock-whitelist-remove.sh PlayerName</pre>

=== Создание скрипта просмотра ===

1. Создайте скрипт:
<pre>sudo nano /usr/local/bin/bedrock-whitelist-list.sh</pre>

2. Добавьте содержимое:
<pre>\#!/bin/bash

ALLOWLIST_FILE="/opt/bedrock/allowlist.json"

if [ ! -f "$ALLOWLIST_FILE" ]; then
    echo "Allowlist file not found!"
    exit 1
fi

echo "=== Whitelist Players ==="
cat "$ALLOWLIST_FILE" | grep -o '"name": "[^"]*"' | sed 's/"name": "//;s/"//' | nl</pre>

3. Сделайте исполняемым:
<pre>sudo chmod +x /usr/local/bin/bedrock-whitelist-list.sh</pre>

4. Использование:
<pre>sudo /usr/local/bin/bedrock-whitelist-list.sh</pre>

== 6. Массовое управление ===

=== Импорт из текстового файла ===

1. Создайте файл со списком игроков:
<pre>nano /tmp/players.txt</pre>

2. Добавьте список (по одному на строку):
<pre>Player1
Player2
Player3
Player4</pre>

3. Создайте скрипт импорта:
<pre>sudo nano /usr/local/bin/bedrock-whitelist-import.sh</pre>

4. Добавьте содержимое:
<pre>\#!/bin/bash

if [ -z "$1" ]; then
    echo "Usage: $0 <players-file.txt>"
    exit 1
fi

PLAYERS_FILE="$1"

if [ ! -f "$PLAYERS_FILE" ]; then
    echo "File not found: $PLAYERS_FILE"
    exit 1
fi

while IFS= read -r player; do
    if [ ! -z "$player" ]; then
        echo "Adding $player to whitelist..."
        screen -S minecraft-bedrock -X stuff "whitelist add $player$(printf \\r)"
        sleep 1
    fi
done < "$PLAYERS_FILE"

echo "Reloading whitelist..."
screen -S minecraft-bedrock -X stuff "whitelist reload$(printf \\r)"
echo "Import completed!"</pre>

5. Сделайте исполняемым:
<pre>sudo chmod +x /usr/local/bin/bedrock-whitelist-import.sh</pre>

6. Использование:
<pre>sudo /usr/local/bin/bedrock-whitelist-import.sh /tmp/players.txt</pre>

=== Экспорт в текстовый файл ===

1. Создайте скрипт экспорта:
<pre>sudo nano /usr/local/bin/bedrock-whitelist-export.sh</pre>

2. Добавьте содержимое:
<pre>\#!/bin/bash

ALLOWLIST_FILE="/opt/bedrock/allowlist.json"
OUTPUT_FILE="/tmp/bedrock-whitelist-export.txt"

if [ ! -f "$ALLOWLIST_FILE" ]; then
    echo "Allowlist file not found!"
    exit 1
fi

\# Извлечение имен игроков
cat "$ALLOWLIST_FILE" | grep -o '"name": "[^"]*"' | sed 's/"name": "//;s/"//' > "$OUTPUT_FILE"

echo "Whitelist exported to: $OUTPUT_FILE"
cat "$OUTPUT_FILE"</pre>

3. Сделайте исполняемым:
<pre>sudo chmod +x /usr/local/bin/bedrock-whitelist-export.sh</pre>

4. Использование:
<pre>sudo /usr/local/bin/bedrock-whitelist-export.sh</pre>

== 7. Управление игроками в игре ==

=== Базовые команды управления ===

1. '''Список онлайн игроков''':
<pre>screen -r minecraft-bedrock
list</pre>

2. '''Информация об игроке''':
<pre>screen -r minecraft-bedrock
\# Используйте команды для просмотра информации</pre>

3. '''Кик игрока''':
<pre>kick PlayerName</pre>

4. '''Бан игрока''':
<pre>ban PlayerName</pre>

5. '''Разбан игрока''':
<pre>pardon PlayerName</pre>

=== Работа с операторами ===

1. '''Добавление оператора''':
<pre>op PlayerName</pre>

2. '''Удаление оператора''':
<pre>deop PlayerName</pre>

3. '''Список операторов''':
<pre>screen -r minecraft-bedrock
\# Проверьте permissions.json или используйте команды</pre>

== 8. Интеграция с permissions.json ==

=== Связь whitelist и permissions ===

1. Проверьте permissions.json:
<pre>cd /opt/bedrock
cat permissions.json</pre>

2. Пример конфигурации:
<pre>[
  {
    "permission": "operator",
    "xuid": "1234567890123456"
  },
  {
    "permission": "member",
    "xuid": "2345678901234567"
  }
]</pre>

3. Добавление оператора в permissions:
<pre>[
  {
    "permission": "operator",
    "xuid": "1234567890123456"
  }
]</pre>

=== Уровни разрешений ===

1. '''visitor''' - только просмотр
2. '''member''' - стандартные права игрока
3. '''operator''' - права администратора

== 9. Мониторинг подключений ===

=== Логирование подключений ===

1. Проверьте логи:
<pre>tail -f /opt/bedrock/logs/*.log</pre>

2. Фильтрация по событиям:
<pre>grep "connected" /opt/bedrock/logs/*.log
grep "disconnected" /opt/bedrock/logs/*.log
grep "whitelist" /opt/bedrock/logs/*.log</pre>

=== Создание скрипта мониторинга ===

1. Создайте скрипт:
<pre>sudo nano /usr/local/bin/bedrock-player-monitor.sh</pre>

2. Добавьте содержимое:
<pre>\#!/bin/bash

LOG_FILE="/var/log/bedrock-players.log"
DATE=$(date '+%Y-%m-%d %H:%M:%S')

\# Получение списка онлайн игроков через консоль
screen -S minecraft-bedrock -X stuff "list$(printf \\r)"
sleep 1

\# Анализ whitelist
WHITELIST_COUNT=$(cat /opt/bedrock/allowlist.json | grep -c '"name"')

echo "[$DATE] Whitelist players: $WHITELIST_COUNT" >> $LOG_FILE</pre>

3. Сделайте исполняемым:
<pre>sudo chmod +x /usr/local/bin/bedrock-player-monitor.sh</pre>

== 10. Безопасность whitelist ===

=== Защита файла ===

1. Установите права доступа:
<pre>sudo chmod 644 /opt/bedrock/allowlist.json
sudo chown bedrock:bedrock /opt/bedrock/allowlist.json</pre>

2. Создайте резервную копию:
<pre>sudo cp /opt/bedrock/allowlist.json /opt/bedrock/allowlist.json.backup</pre>

=== Валидация данных ===

1. Проверьте формат JSON:
<pre>cat /opt/bedrock/allowlist.json | python3 -m json.tool</pre>

2. Если есть ошибки, исправьте:
<pre>nano /opt/bedrock/allowlist.json</pre>

== 11. Примеры использования ===

=== Сценарий 1: Приватный сервер для друзей ===

1. Включите whitelist:
<pre>white-list=true</pre>

2. Добавьте друзей:
<pre>whitelist add Friend1
whitelist add Friend2
whitelist add Friend3</pre>

3. Проверьте список:
<pre>whitelist list</pre>

=== Сценарий 2: Публичный сервер с временным доступом ===

1. Создайте скрипт временного доступа:
<pre>sudo nano /usr/local/bin/bedrock-temp-access.sh</pre>

2. Добавьте временного игрока и автоматическое удаление через cron

=== Сценарий 3: Сервер с модерацией ===

1. Используйте whitelist для контроля доступа
2. Добавьте модераторов в permissions.json как operators
3. Модераторы могут управлять игроками через команды

== 12. Устранение неполадок ===

=== Игрок не может подключиться ===

1. Проверьте whitelist:
<pre>whitelist list
grep "PlayerName" /opt/bedrock/allowlist.json</pre>

2. Проверьте XUID:
* Убедитесь, что XUID правильный
* Проверьте правильность написания имени

3. Перезагрузите whitelist:
<pre>whitelist reload</pre>

=== Проблемы с форматом JSON ===

1. Проверьте синтаксис:
<pre>python3 -m json.tool /opt/bedrock/allowlist.json</pre>

2. Исправьте ошибки:
<pre>nano /opt/bedrock/allowlist.json</pre>

3. Восстановите из резервной копии при необходимости:
<pre>sudo cp /opt/bedrock/allowlist.json.backup /opt/bedrock/allowlist.json</pre>

== Заключение ==

Настройка whitelist и управление игроками на Bedrock сервере позволяет контролировать доступ к серверу и обеспечивать безопасность. Правильная настройка whitelist и использование команд управления обеспечит комфортную работу сервера.

'''Для размещения ваших Bedrock серверов на надежном хостинге рекомендуем воспользоваться услугами [ARK-HOSTER.RU](https://ark-hoster.ru):'''

* '''[Выделенные серверы](https://ark-hoster.ru/dedicated/)''' - для высоконагруженных Bedrock серверов
* '''[VPS/VDS серверы](https://ark-hoster.ru/vpsgame/)''' - для небольших и средних серверов

Наши специалисты помогут с настройкой Bedrock серверов и управлением игроками!