Flectone LogoFlectonePulse

Кэш

Настройка размера и времени жизни кэша

Предупреждение

НЕЛЬЗЯ удалять какой-либо из кэшов, даже если ты думаешь, что он не будет использоваться, кэш должен быть создан как объект


Настройка

Путь config.yml → cache
cache:
  types:
    ANIMATION:
      invalidate_on_reload: true
      expire_after_write: false
      duration: 1
      time_unit: "MINUTES"
      size: 100000
    ARGUMENT:
      invalidate_on_reload: true
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 4096
    COOLDOWN:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 5
      time_unit: "HOURS"
      size: 5000
    DIALOG_CLICK:
      invalidate_on_reload: false
      expire_after_write: true
      duration: 1
      time_unit: "SECONDS"
      size: 100
    OFFLINE_PLAYERS:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 1
      time_unit: "HOURS"
      size: 1000
    MESSAGE_CONTEXT:
      invalidate_on_reload: true
      expire_after_write: true
      duration: 1
      time_unit: "SECONDS"
      size: 10000
    UNIFORM_MESSAGE:
      invalidate_on_reload: true
      expire_after_write: true
      duration: 10
      time_unit: "SECONDS"
      size: 10000
    MODERATION:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 1
      time_unit: "HOURS"
      size: 5000
    EXTERNAL_MODERATION:
      invalidate_on_reload: true
      expire_after_write: true
      duration: 5
      time_unit: "SECONDS"
      size: 5000
    ICU_MESSAGE:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 10000
    IMAGE_PIXELS:
      invalidate_on_reload: true
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 1000
    LEGACY_COLOR_MESSAGE:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 10000
    MENTION_MESSAGE:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 1000
    SWEAR_MESSAGE:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 10000
    REPLACEMENT_MESSAGE:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 10000
    REPLACEMENT_IMAGE:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 100
    TRANSLATE_MESSAGE:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 1
      time_unit: "HOURS"
      size: 5000
    PROFILE_PROPERTY:
      invalidate_on_reload: false
      expire_after_write: false
      duration: 1
      time_unit: "HOURS"
      size: 1000
    PLAYTIME:
      invalidate_on_reload: true
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 1000
    PLAYER_COLOR:
      invalidate_on_reload: true
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 1000
    PLAYER_SETTING:
      invalidate_on_reload: true
      expire_after_write: false
      duration: 10
      time_unit: "MINUTES"
      size: 1000
    PLAYER_IGNORE:
      invalidate_on_reload: true
      expire_after_write: false
      duration: 1
      time_unit: "HOURS"
      size: 1000

types

Список всех кэшов, которые используются в FlectonePulse. У каждого указано время жизни, но оно работает не как таймер «создался и через N секунд удалился». Вместо этого время отсчитывается заново при каждом обращении к кэшу. То есть если кэш постоянно нужен и к нему часто лезут – он никогда не удалится, даже если время жизни короткое.

ТипОписание
COOLDOWNДля хранения задержек, которые выдаются игрокам при использовании модуля. Например задержка сообщений в чат или в команде /me. Это место для хранения, а не включения задержки, каждая задержка включается внутри модуля отдельно
ANIMATIONДля хранения кадров анимации каждого игрока у модуля animation
ARGUMENTДля хранения разобранных аргументов тегов, чтобы не парсить одинаковые аргументы повторно
DIALOG_CLICKДля отслеживания количество кликов в кастомных диалогах, например у /chatsetting. Это позволяет закрывать диалог у людей, которые слишком часто в них кликают т.е. спамят
OFFLINE_PLAYERSДля хранения оффлайн игроков, которые вышли с сервера, но могут зайти обратно. А также здесь хранятся ники, которые могли бы быть игроками, например /tell Notch, очевидно Notch нет на сервере, но для поиска такого игрока FlectonePulse использует ряд операций и в конце обращается к базе данных, если он будет найден, то сохранится уже с этими данными, иначе будет неизвестным игроком. При следующих /tell Notch он сразу будет взят из кэша, избегая всех проверок
MESSAGE_CONTEXTДля хранения результатов форматирования итогого сообщения. Используется для того, чтобы не форматировать слишком часто одинаковые сообщения. Если время жизни кэша будет слишком большое, то будут проблемы с динамическими тегами (тпс, пинг, префикс и т.д.)
UNIFORM_MESSAGEДля хранения сообщений, которые уже отформатировал модуль uniform, чтобы не обрабатывать их повторно
MODERATIONДля хранения результатов модерации об игроках. Чаще всего используется, чтобы при входе игрока на сервер каждый раз не обращаться к базе данных
EXTERNAL_MODERATIONДля хранения результатов модерации об игроках из других плагинов с наказаниями
ICU_MESSAGEДля хранения результатов форматирования строк у интеграции ICU (Международные компоненты для Unicode)
IMAGE_PIXELSДля хранения сконвертированных изображений в пиксели, которые может увидеть игрок. Они используются в greeting и replacement модулях
LEGACY_COLOR_MESSAGEДля хранения результатов форматирования строк, содержащих устаревшее форматирование, например зачем каждый раз заменять &c на <red>, если это можно взять из кэша. Это необходимо, потому что для каждого игрока форматируется собственное сообщение, которые чаще всего одинаковые
MENTION_MESSAGEДля хранения результатов форматирования сообщений у модуля mention. Это необходимо, потому что для каждого игрока форматируется собственное сообщение, которые чаще всего одинаковые
SWEAR_MESSAGEДля хранения результатов форматирования сообщений у модуля swear. Это необходимо, потому что для каждого игрока форматируется собственное сообщение, которые чаще всего одинаковые
REPLACEMENT_MESSAGEДля хранения результатов форматирования сообщений у модуля replacement. Это необходимо, потому что для каждого игрока форматируется собственное сообщение, которые чаще всего одинаковые
REPLACEMENT_IMAGEДля хранения отформатированных изображений у модуля replacement
TRANSLATE_MESSAGEДля хранения сообщений, которые должны быть переведены
PROFILE_PROPERTYДля хранения профилей игроков с их скинами, чтобы каждый раз не обращаться к SkinsRestorer и не создавать их вручную
PLAYTIMEДля хранения результатов времени игры игроков. Нужно, чтобы каждый раз не обращаться к базе данных при подсчёте времени игры
PLAYER_COLORДля хранения загруженных цветов каждого игрока из базы данных
PLAYER_SETTINGДля хранения загруженных настроек каждого игрока из базы данных
PLAYER_IGNOREДля хранения загруженных игнорирований каждого игрока из базы данных
ПараметрОбъяснение
invalidate_on_reloadБудет ли этот кэш очищаться при перезагрузке с помощью /flectonepulse reload
expire_after_writeЕсли включено, то время жизни считается от момента записи в кэш.
Если выключено, то время жизни считается от последнего обращения к записи
durationВремя жизни неиспользуемого объекта в кэше, после которого он будет удалён
time_unitТип времени жизни неиспользуемого объекта кэша
sizeМаксимальный размер кэша
Последнее изменение 16 ноября 2026 г.
Редактировать на GitHub

На этой странице

Авторы страницы