FunTalismans

FunTalismans - это плагин для серверов Minecraft на Paper/Purpur 1.21+, который даёт администраторам полный контроль над созданием кастомных талисманов, сфер и пассивного RPG-снаряжения. Всё настраивается через HOCON-конфиги: внешний вид, описание, атрибуты, зелья, редкость, текстуры голов, требования к экипировке и многое другое. Никакого программирования - только редактирование файлов и перезагрузка в игре.

Зачем это нужно? На любом сервере с RPG-уклоном рано или поздно встаёт вопрос: как сделать интересные предметы, которые дают пассивные бонусы, не захламляя инвентарь? FunTalismans решает эту проблему - вы можете создать талисман, который работает в конкретном слоте (например, в оффхенде или на голове), даёт зелье-эффекты, меняет атрибуты (здоровье, скорость, урон) и даже имеет свою редкость. Это идеально для серверов с классами, профессиями или просто для разнообразия геймплея.

Совместимость

• Серверное ПО: Paper / Purpur 1.21+
• Java: Java 21
• Формат конфигов: HOCON
• Зависимости: не требуется
• Опционально: WorldGuard и PlaceholderAPI
• Опциональный ресурспак: поддерживает клиенты Minecraft от 1.21.1 до 1.21.11

Ядро системы талисманов не требует NBTAPI.

Возможности

• Создание кастомных талисманов, сфер и экипировки.
• Пассивные зелье-эффекты в зависимости от слота.
• Модификаторы атрибутов: здоровье, урон, скорость, броня, скорость атаки, удача.
• Поддержка слотов: главная рука, оффхенд, броня, инвентарь.
• Настройка названий, описания, цветов (legacy, hex, градиенты).
• Текстуры голов через URL текстур Minecraft, base64: или сырые Base64.
• Custom Model Data для ресурспаков.
• Зачарования, свечение, неразрушимость, прочность, флаги предметов, persistent data.
• Настраиваемые редкости для прогрессии.
• Поддержка брони-тримов, красителей, фейерверков, козьих рогов, написанных книг.
• Ограничения по миру и региону (глобально или для каждого талисмана).
• Единые флаги WorldGuard - не создавать отдельный флаг для каждого талисмана.
• Перезагрузка талисманов и безопасное обновление предметов без перезапуска сервера.

Пассивные слоты

Эффекты могут работать, когда талисман находится в:

• mainhand
• offhand
• head
• chest
• legs
• feet
• armor
• hands
• any
• inventory

inventory работает только для пассивных эффектов. Модификаторы атрибутов требуют слоты экипировки: mainhand, offhand или слоты брони.

Поддержка WorldGuard

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

• fun-talismans-passive - разрешает или запрещает пассивные эффекты талисманов в регионе.
• fun-talismans-use - общий флаг для контроля использования талисманов.

Пример:

/rg flag <region> fun-talismans-passive deny

Обычные изменения конфигов талисманов перезагружаются в игре. Перезапуск сервера нужен только при изменении названий кастомных флагов WorldGuard в config.conf.

Перезагрузка и обновления

FunTalismans перезагружает определения талисманов без перезапуска сервера. Система обновления безопасно обновляет загруженные талисманы в:

• Инвентарях и экипировке игроков.
• Выброшенных предметах рядом с игроками.
• Рамках (Item Frame, Glow Item Frame).
• Открытых контейнерах, сундуках, шалкерах.
• Загруженных чанках (с ограничением по тику).

Это позволяет администраторам балансировать предметы, менять текстуры или атрибуты, не теряя производительность сервера.

Команды

/ftalismans give <player> <id> [amount]
/ftalismans reload
/ftalismans forceupdate

Алиасы:

/ft
/talisman
/tali
/talismans

Права:

funtalismans.give
funtalismans.reload
funtalismans.update

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

talismans {
  sphere-ikara {
    name: "<gradient:#FF0000:#FF6600>[★] Sphere of Ikar</gradient>"
    material: "player_head"
    texture: "http://textures.minecraft.net/texture/<texture-id>"
    rarity: "legendary"

    custom_model_data: 101

    unbreakable: false
    glow: true
    keepItemOnDeath: false

    lore: [
      "&7Сфера, выкованная для битвы.",
      "&7Наденьте её в оффхенд,",
      "&7чтобы активировать силу."
    ]

    effects {
      slot: "offhand"
      ambient: true
      particles: false
      icon: true
      list: [
        {
          type: "strength"
          amplifier: 0
        }
      ]
    }

    attributes: [
      {
        type: "max_health"
        amount: 4.0
        operation: "add_number"
        slot: "offhand"
      },
      {
        type: "movement_speed"
        amount: 0.10
        operation: "add_scalar"
        slot: "offhand"
      }
    ]

    nbt {
      talisman_id: "sphere-ikara"
      rarity: "legendary"
    }
  }
}

Для предметов player_head поле texture поддерживает URL текстуры Minecraft, значение с префиксом base64: или сырое Base64-значение.

Опциональный ресурспак

К FunTalismans прилагается опциональный ресурспак, который добавляет кастомные модели тотемов через Custom Model Data.

• Поддерживает клиенты Minecraft от 1.21.1 до 1.21.11.
• Включает поддержку legacy Custom Model Data для 1.21.1-1.21.3.
• Включает поддержку современных item-definition для 1.21.4+.
• Использует оптимизированные размеры отображения для первого лица, третьего лица, на земле и в GUI.

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

Важно знать

• Создайте резервную копию перед заменой конфигурационных файлов.
• Используйте /ftalismans reload после обычных изменений конфига.
• Используйте /ftalismans forceupdate для принудительного обновления уже загруженных талисманов.
• WorldGuard и PlaceholderAPI опциональны - плагин работает и без них.

FunTalismans даёт вашему серверу гибкую основу для RPG-прогрессии, кастомных боевых механик, коллекционных предметов и настраиваемого пассивного геймплея. Всё, что нужно - отредактировать конфиг и перезагрузить. Подходит как для небольших приватных серверов, так и для крупных проектов с сотнями уникальных талисманов.