Universal Graves

Universal Graves

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

Этот мод может работать чисто на серверах!

Этот мод работает только на Fabric и Quilt!

Если у вас есть вопросы, можете задать их в моём Discord

Также посмотрите мои другие моды и проекты, возможно, они вам пригодятся!

Используете 2.x/1.19.x или старше?

Нажмите здесь, чтобы посмотреть правильный readme!

Изображения

Команды (и права):

• /graves - Основная команда, показывает список могил игрока (universal_graves.list, доступна по умолчанию)
• `/graves player - Открывает gui со списком могил выбранного игрока (universal_graves.list_others`)
• `/graves modify - Открывает gui со списком могил исполнителя с возможностью их изменять (universal_graves.modify`)
• /graves reload - Перезагружает конфигурацию и стили (требуется universal_graves.reload)

Кроме того, имея право universal_graves.teleport, вы можете телепортироваться к любой могиле.

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

Основной файл конфигурации находится в ./config/universal-graves/config.json. Форматирование использует Simplified Text, документацию по которому можно найти здесь. Кроме того, каждый тип сообщения имеет несколько собственных локальных переменных, которые вы указываете как ${variable}. Большинство сообщений, специфичных для могил, поддерживают эти переменные: player, protection_time, break_time, xp, item_count, position, world, death_cause, minecraft_day, creation_date, since_creation, id.

Есть ещё несколько других типов данных:

• {/* PREDICATE */} - Использует формат предикатов, все поддерживаемые смотрите здесь.

• {/* COST */} - Формат для указания стоимости.

  {
  // Тип стоимости. Поддерживает "free", "creative", "item" и "level"
  "type": "",
  // Используется только для "item", описывает Item Stack
  "input": {/* ITEMSTACK */},
  // Количество стоимости.
  "count": 0
  }

• {/* ITEMSTACK */} - представляет предмет. Простой формат: "minecraft:skeleton_skull" Полный формат

  {
  "id": "minecraft:skeleton_skull",
  "Count": 1,
  // Необязательный nbt,
  "tag": {}
  }

{
  // Версия конфигурации. Никогда не изменяйте её, если не хотите рискнуть повреждением данных!
  "config_version": 3,
  "protection": {
    // Время, в течение которого могила защищена от других игроков. Установите -1, чтобы сделать бесконечной. В секундах
    "non_owner_protection_time": 900,
    // Время, после которого могила уничтожается сама. Установите -1, чтобы отключить. В секундах
    "self_destruction_time": 1800,
    // Заставляет могилу выпадать предметами после истечения срока/самоуничтожения
    "drop_items_on_expiration": true,
    // Позволяет атакующим получать доступ к могилам, полезно в случае серверов, ориентированных на pvp.
    "attackers_bypass_protection": false,
    // Заставляет могилу использовать реальное время вместо того, чтобы отсчитывать только когда мир/сервер запущен.
    "use_real_time": false
  },
  "interactions": {
    // Стоимость доступа к могиле после смерти, 
    "unlocking_cost": { /* COST */ },
    // Включает выдачу компаса смерти, который указывает на могилу игрока.
    "give_death_compass": true,
    // Заставляет клик по могиле открывать ui.
    "enable_click_to_open_gui": true,
    // Включает быстрый подбор при зажатии шифта и клике по могиле пустой рукой.
    "shift_and_use_quick_pickup": true,
    // Позволяет игрокам удалённо снимать защиту с могилы.
    "allow_remote_protection_removal": true,
    // Позволяет игрокам удалённо ломать могилу.
    "allow_remote_breaking": true,
    // Позволяет игрокам удалённо оплачивать стоимость разблокировки могилы.
    "allow_remote_unlocking": false
  },
  "storage": {
    // Выбирает, сколько опыта сохраняется. 
    // Доступные типы: "none", "vanilla", "drop", "percent_point", "percent_level"
    "experience_type": "percent_points",
    // Количество процентов, сохраняемых для типов "percent_X"
    "experience_percent:setting_value": 100.0,
    // Позволяет создавать могилы только с XP
    "can_store_only_xp": false,
    // Включает использование альтернативной сущности сферы опыта, чтобы предотвратить дублирование XP с некоторыми модами.
    "alternative_experience_entity": false,
    // Блокирует добавление предметов с зачарованиями в могилу.
    "blocked_enchantments": [
      "somemod:soulbound"
    ]
  },
  "placement": {
    // Ограничивает количество могил на игрока. -1 — без ограничений
    "player_grave_limit": -1,
    // Позволяет могиле заменять любой блок
    "replace_any_block": false,
    // Максимальное расстояние вокруг начальной позиции, используемое для поиска свободного места.
    "max_distance_from_source_location": 8,
    // Позволяет смещать начальную позицию при неудаче
    "shift_location_on_failure": true,
    // Максимальное количество смещений.
    "max_shift_tries": 5,
    // Расстояние, используемое для смещения.
    "max_shift_distance": 40,
    // Заставляет могилу генерироваться поверх жидкостей, а не внутри них.
    "generate_on_top_of_fluids": false,
    // Заставляет сломанные могилы восстанавливать заменённый блок.
    "restore_replaced_block": false,
    // Заставляет сломанные могилы восстанавливать заменённый блок после того, как игрок их сломает.
    "restore_replaced_block_after_player_breaking": true,
    // Типы урона, которые не создают могилы.
    "cancel_creation_for_damage_types": {
      "minecraft:fire": "... custom message or empty"
    },
    // Типы сущностей атакующих, предотвращающие создание могилы.
    "cancel_creation_for_ignored_attacker_types": {
      "minecraft:player": "... custom message or empty"
    },
    // Предикаты, блокирующие создание могил
    "blocking_predicates": [{/* PREDICATE */}],
    // Блокирует создание могил в модовых зонах привата.
    "block_in_protected_area": {
      "goml:claim_protection": true
    },
    // Блокирует создание могил во всех мирах.
    "blacklisted_worlds": [
      "dungeons:world"
    ],
    // Блокирует создание могил в областях.
    "blacklisted_areas": {
      "minecraft:overworld": [
        {
          "x1": -100,
          "y1": -200,
          "z1": -100,
          "x2": 100,
          "y2": 500,
          "z2": 100,
        }
      ]
    },
    // Сообщение по умолчанию при неудаче создания могилы.
    "creation_default_failure_text": "...",
    // Сообщение при неудаче создания могилы в привате.
    "creation_claim_failure_text": "..."
  },
  "teleportation": {
    // Стоимость телепортации
    "cost": {/* COST */},
    // Время до завершения телепортации.
    "required_time": 5,
    // Смещение по Y от местоположения могилы.
    "y_offset": 1.0,
    // Время, в течение которого игрок неуязвим.
    "invincibility_time": 2,
    // Позволяет игроку двигаться во время ожидания.
    "allow_movement_while_waiting": false,
    // Сообщения, отправляемые игроку
    "text": {
      "timer": "...",
      "timer_allow_moving": "...",
      "location": "...",
      "canceled": "..."
    }
  },
  "model": {
    // Имя файла модели по умолчанию
    "default": "default",
    // Альтернативы для получения модели могилы.
    "alternative": [
      {
        "require": {/* PREDICATE */},
        "model": "model_name"
      }
    ],
    // Включает обходной путь для игроков geyser, делая могилы похожими на черепа для них.
    "enable_geyser_workaround": true,
    // Базовый предмет для визуальной/контейнерной могилы.
    "gravestone_item_base": "minecraft:skeleton_skull",
    // NBT, добавляемый к предмету.
    "gravestone_item_nbt": {}
  },
  "ui": {/* UI DEFINITIONS, modify text, */},
  "text": {
    // Формат даты, используемый в плейсхолдерах. Использует https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html
    "date_format": "dd.MM.yyyy, HH:mm",
    // Переопределения для названий миров.
    "world_names": {
      "custom:world": "Custom World!"
    }
  }
}

## Модели могил
> Todo: Дописать этот раздел.

Модели могил хранятся в `config/universal-graves/models/`. По умолчанию там должен быть файл `example.json`, который является копией стиля по умолчанию.
Чтобы переопределить стиль могилы по умолчанию, скопируйте этот файл и переименуйте его в `default.json` или другое имя, указанное в конфиге, и задайте его стиль.
Вы также можете использовать другое имя и альтернативы, чтобы делать случайные/уникальные модели.