Cobblemon Expeditions

Экспедиции Булыжника

Отправляйте своих покемонов в временные экспедиции, чтобы заработать добычу, опыт и подняться по карьерной лестнице!

Cobblemon Expeditions — это мод Fabric и NeoForge для Minecraft 1.21.1, который добавляет в Cobblemon систему экспедиций. Игроки взаимодействуют с многоуровневыми досками экспедиций, чтобы отправлять своих компьютерных покемонов на запланированные миссии. Выбирайте свою команду с умом — типы матчей, IV, электромобили и экологические опасности — все это влияет на ваши шансы на успех.

Требуется как на клиенте, так и на сервере.

⚔️ Особенности

Основной игровой процесс

• 5 уровней досок — медь, железо, золото, алмаз и незерит. Более высокие уровни открывают более сложные экспедиции, пассивные бонусы и дополнительные режимы.
• 11 экспедиций — 8 стандартных экспедиций («Лесной корм», «Обследование береговой линии», «Раскопки в пещерах», «Сбор ягодной рощи», «Вулканическое исследование», «Глубоководное погружение», «Замерзшие руины», «Разлом Искажения») плюс 3 встречи с боссами.
• Система TEP — сила командной экспедиции рассчитывается на основе преимуществ типа, IV, EV, размера группы, снижения опасностей и бонусов дополнений.
• 4 уровня результатов — Экспедиции оцениваются как БОЛЬШИЕ, УСПЕШНЫЕ, ЧАСТИЧНЫЕ или НЕУДАЧНЫЕ — каждая из них имеет разное количество и качество добычи.
• Покемоны и опыт игрока — покемоны получают опыт, а игроки — ванильный опыт, получая награды.
• Денежное вознаграждение — Экспедиции могут выплачивать деньги в CobbleDollars или Impactor, в зависимости от того, какой сервер работает. Полностью настраиваемый, см. раздел «Поддержка эконом-класса» ниже.

Обновления платы

• Обновление на месте — обновите свою доску с медной до незеритовой, используя блочные материалы, не ломая ее. Весь мультиблок 3×2 преобразуется на месте.
• Уровневые бонусы — каждое улучшение дает пассивные бонусы: дополнительные слоты для экспедиций, более быстрые экспедиции, лучшую добычу, более высокие шансы на большой успех, улучшенное снижение опасностей и новые разблокированные режимы.
• Путь развития — Медь → Железо (8 железных блоков) → Золото (8 золотых блоков) → Алмаз (8 алмазных блоков) → Незерит (8 блоков незерита).

Экспедиции с боссами

• 3 встречи с боссами — «Легендарное наблюдение», «Логово Титана» и «Ультра-червоточина». Задания в финале с высоким риском и высокой наградой, требующие огромной командной силы.
• Входная стоимость — для начала экспедиций с боссами требуются предметы (по умолчанию: Зачарованное золотое яблоко). Настраивается для каждой экспедиции.
• Еженедельные периоды восстановления. Между попытками экспедиций на боссов время восстановления составляет 1 неделю.
• Эксклюзивная добыча — мастер-шары, нашивки способностей, предметы выбора, сферы жизни, фокусные кушаки, монетные дворы, звезды Пустоты и многое другое.

Система усталости

• Усталость покемонов — Покемоны утомляются после каждой экспедиции, уменьшая их вклад в TEP на 10% за уровень.
• Истощение — При максимальной усталости (5 уровень) покемоны истощаются и их нельзя отправлять в экспедиции, пока они не отдохнут.
• Естественное восстановление — усталость восстанавливается со скоростью 1 уровень в час. Экспедиции с боссами вызывают двойную усталость.
• Антиспам — предотвращает бесконечную отправку одних и тех же покемонов, поощряя разнообразие в составе.

Дополнения

• 5 покупаемых дополнений — покупайте улучшения с помощью ванильных предметов, а затем свободно их отключайте или включайте. Сложите несколько для пользовательских стратегий.
  • 🪶 Быстрое перо (16 перьев) — экспедиции на 15 % быстрее.
  • 🍀 Тамулет на удачу (4 кроличьи лапки) — +15% к качеству добычи, +10% к количеству добычи.
  • 💎 Кристалл силы (16 осколков аметиста) — +5 TEP за каждого покемона, +5% шанс на успех
  • 🔔 Успокаивающий колокольчик (1 колокольчик) — снижает прирост усталости на 1 за экспедицию.
  • 🔍 Линза учёного (1 Подзорная труба) — +25% получаемого опыта ранга.
• Управление данными — администраторы сервера могут создавать собственные улучшения с любой комбинацией стоимости и эффекта предмета.

Режимы экспедиции

• 8 режимов. Каждый режим меняет правила экспедиции, внося существенные компромиссы. Свободно меняйтесь между экспедициями.
  • ⚡ Быстрое развертывание — на 15% быстрее, но -10% добычи.
  • 🔎 Глубокий поиск — +15% добычи, но на 15% медленнее.
  • 🛡️ Безопасные операции — снижение опасности на 50%, немного ниже отличный шанс.
  • 🎯 Специалист по контракту - +12% бонус типа (максимально 36%), -5% на несовпадающих покемонов
  • 📦 Оптовая логистика - +1 слот для экспедиций, -12% качество добычи.
  • 🏺 Охотники за реликвиями — +20% к редкой добыче, но на 20% медленнее, а успех ограничен 90%.
  • 📚 Детали обучения - +75% опыта покемонов, -15% добычи.
  • 💊 Полевая медицина - снижение опасности на 10%, добыча -5%.
• Уровень с ограничениями — режимы открываются постепенно по мере улучшения доски, создавая значимый цикл развития.

Опасности

• 7 типов опасностей: жара, холод, токсичность, обвал, водная, электрическая и темнота.
• Снижение типа — Каждой опасности противостоят определенные типы покемонов. Неустраненные опасности снижают ваш балл TEP.
• Управление данными — пользовательские опасности могут быть определены с помощью пользовательских типов сопротивления и значений штрафов.

Повышение ранга

• Опыт ранга экспедиции — зарабатывайте опыт, чтобы повысить свой ранг в экспедиции. Более высокие ранги открывают новые уровни досок и более сложный контент.
• Дополнительные слоты — более высокие ранги дают больше одновременных слотов для экспедиций.

Качество жизни

• Звуковые эффекты — Богатая звуковая обратная связь для начала экспедиций, получения наград, улучшения досок, покупки дополнений, ошибок и многого другого.
• Мультиблочные доски 3×2 — красивые блоки шириной 3 и высотой 2, которые можно изготовить, с текстурами, соответствующими уровню. Доски Diamond и Netherite оснащены анимированными экранными эффектами.
• Поиск и фильтр — Фильтруйте экспедиции по типу, ищите покемонов по имени и автоматически выбирайте лучшую команду.
• Переключение списка экспедиций — скрывайте экспедиции, которые ваш ранг еще не разблокировал, и переключайте сортировку между максимальной и минимальной мощностью. Записи с фиксированным рангом выделены серым цветом и сообщают вам необходимый ранг сразу, а не после того, как вы выбрали команду. Оба переключателя индивидуальны для каждого игрока и запоминаются между сеансами.
• Рецепты крафта — все 5 уровней досок можно изготовить из материалов, соответствующих уровню.

Кастомизация

• Полностью на основе данных — все экспедиции, таблицы добычи, режимы, опасности и дополнения определяются с помощью пакетов данных JSON и доступны для редактирования в игре.
• Внутриигровой редактор администратора — операторы могут создавать, редактировать и удалять экспедиции, таблицы добычи, режимы, опасности и дополнения в реальном времени — перезапуск не требуется.
• Командные награды — Записи о добыче могут запускать команду вместо того, чтобы выбрасывать предмет, поэтому работает любая экономическая или сторонняя система вознаграждений: жетоны, ключи от ящиков, разрешения и все что угодно. Команды выполняются только для игрока, подавшего заявку, с заполнителями {player}, {uuid} и {count}, и их можно редактировать в графическом интерфейсе администратора, как и любую другую награду.
• Широкие возможности настройки — десятки параметров конфигурации для расчета TEP, порогов успеха, масштабирования добычи, повышения ранга, уровня усталости, времени восстановления боссов, предотвращения злоупотреблений и многого другого.

💰 Поддержка экономики

За экспедиции можно выплачивать денежное вознаграждение в виде CobbleDollars или Impactor. Оба являются необязательными, и одновременно выплачивается только один, поэтому сумма, указанная на доске, остается верной. Impactor 5.3.5 для Minecraft 1.21.1 поддерживается в Fabric и NeoForge, и его необходимо установить только на сервер. Без любого мода экспедиции просто не дают денег.

Настройки находятся в разделе pokeDollars на config/cobblemon_expeditions.json. Запустите /expedition reload после редактирования.

| Настройка | Ценности | По умолчанию | Что он делает | | ------- | ------ | ------- | ------------ | | enabled | true или false | true | false отключает все денежные вознаграждения. | | provider | auto, cobbledollars, impactor, none | auto | Какая экономика получает зарплату. | | scale | число, 0 или более | 1.0 | Умножает деньги каждой экспедиции в соответствии с вашей экономикой. | | impactorCurrency | impactor:dollars, dollars или пусто | пустой | Только импактор. В какой валюте платить. В Empty используется основная валюта Impactor. | | failMultiplier | число | 0.0 | Доля денег, выплачиваемая в случае FAIL. | | partialMultiplier | число | 0.5 | Доля денег выплачивается ЧАСТИЧНО. | | successMultiplier | число | 1.0 | Доля денег, выплачиваемая за УСПЕХ. | | greatMultiplier | число | 1.5 | Доля денег выплачена на БОЛЬШОЙ. |

Выбор экономики

| provider | Платит | | ---------- | ---- | | auto | CobbleDollars, если он установлен, в противном случае Impactor. Серверы, уже использующие CobbleDollars, не видят никаких изменений. | | cobbledollars | Только Кобблдоллары. | | impactor | Только импактор. Используйте это, если вы используете оба мода и хотите Impactor. | | none | Никто. Никаких денежных вознаграждений. |

• Заглавные буквы и пробелы игнорируются. Значение с ошибкой или мод, который не установлен, ничего не платит и печатает предупреждение в журнале сервера при запуске.
• У каждой экспедиции своя базовая сумма (poke_dollars). Выплаченная сумма равна этой базе, умноженной на множитель результата, умноженной на scale, округленной в меньшую сторону.
• Покедоллар и доллар Impactor редко стоят одинаково, для чего и нужен scale. Например, 0.01 превращает награду босса в 45 000 в 450 в случае УСПЕХА. 0 ничего не платит, а отрицательное или нечисловое значение ничего не платит и предупреждает.
• impactorCurrency принимает полный ключ (impactor:dollars) или только имя (dollars). Если две валюты имеют одно и то же имя, используйте полный ключ. Неизвестная валюта ничего не платит и предупреждает.

Пример сервера Impactor, где деньги стоят в десять раз больше, чем покедоллар:

"pokeDollars": {
  "enabled": true,
  "provider": "impactor",
  "scale": 0.1,
  "impactorCurrency": "dollars"
}

Приятно знать

• Изменения касаются экспедиций, завершившихся после изменения. Награды, уже ожидающие в почтовом ящике игрока, сохраняют имеющуюся у него сумму.
• Если выплата не может быть доставлена ​​(другой мод отменил ее, на учетной записи достигнут максимальный баланс Impactor или Impactor недоступен), в журнале сервера записываются игрок, сумма и причина, и игрок получает сообщение в чате.
• На доске по-прежнему указывается сумма «Покедоллары», какую бы экономику вы ни использовали.

🌐 Мультисерверные сети

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

По умолчанию отключено. Один сервер вообще не требует настройки.

Настройка (общий каталог)

1. Установите на каждом сервере одну и ту же версию мода, с одинаковой экспедицией, таблицей добычи и режимом JSON.

2. Дайте каждому серверу один каталог, к которому они все могут получить доступ - монтирование привязки, экспорт NFS или на панели, такой как Pterodactyl, монтирование, прикрепленное как к узлу, так и к каждому серверу.

3. На каждом сервере отредактируйте config/cobblemon_expeditions.json:

"storage": {
  "backend": "shared_file",
  "sharedDirectory": "shared/cobblemon_expeditions",
  "autoSaveSeconds": 60
}

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

1. Перезапустите каждый сервер и убедитесь, что каждая консоль печатает один и тот же путь:

Shared expedition storage at .../shared/cobblemon_expeditions
Expedition storage backend 'shared_file' active; player records load on join

Если сервер по-прежнему говорит 'world' active, он не получил конфигурацию или не видит общий каталог — он будет молча продолжать использовать собственное сохранение мира.

1. Протестируйте с одной учетной записью: начните экспедицию на одном сервере, перейдите на другой и убедитесь, что на доске указано, что она работает с тем же рангом. В shared/cobblemon_expeditions/players/ на каждого игрока должен быть ровно один файл .dat — два файла для одного человека означают, что их UUID различается на разных серверах, обычно это несовпадение online-mode.

Чтобы выключить его, установите везде "backend": "world" и перезапустите. Каждый сервер возвращается в свой мир сохранения, в котором все еще хранится все, что было раньше.

Уже используете Redis, Mongo или SQL?

Уровень хранения является подключаемым. Напишите небольшой дополнительный мод, реализующий интерфейс ExpeditionDataStore, зарегистрируйте его во время инициализации мода с помощью ExpeditionDataStores.register("mongo") { ... } и установите "backend": "mongo" в конфигурации. Экспедиционные доски затем читают и записывают прямо из базы данных, которую вы уже используете.

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

Полное руководство по интеграции, включая рабочую реализацию Mongo, которую вы можете начать с: https://github.com/ZIPender/cobblemon_expeditions_doc/blob/main/storage-api.md.

Он охватывает весь интерфейс, порядок сериализации записи (он проходит через NBT, поэтому вы никогда не трогаете внутренние компоненты), требование атомарного утверждения, которое не позволяет двум серверам дважды предоставлять одно и то же вознаграждение, предостережения по надежности Redis и контрольный список тестирования.

Приятно знать

• Переключение на общий бэкэнд начинается с пустых записей. Автоматического импорта нет — когда прогресс уже разошелся по серверам, нет правильного ответа, какая копия победит. Сначала создайте резервную копию своих миров.
• Экспедиция, таблица добычи и режим JSON остаются для каждого сервера. Развертывайте одинаковый контент повсюду и вносите изменения в графический интерфейс администратора в одном месте, иначе они будут дрейфовать.
• При этом синхронизируются данные экспедиции, а не данных покемонов**. Приставки Party и PC остаются задачей уровня синхронизации вашей сети.

🖥️ Графический интерфейс доски

Щелкните правой кнопкой мыши доску экспедиции, чтобы открыть графический интерфейс. Просматривайте доступные экспедиции, выбирайте покемонов на своем компьютере, проверяйте шансы на успех, управляйте улучшениями и отправляйте их!

🛠️ Графический интерфейс администратора

Операторы могут открыть панель администратора для редактирования экспедиций, таблиц добычи, режимов, опасностей и дополнений в режиме реального времени. Все изменения мгновенно сохраняются в папке config/cobblemon_expeditions/.

📋 Команды

| Команда |Разрешение |Описание | | -------------------------------- |---------- |------------------------------------------------------------------------------------ | | /проверка экспедиции |Все |Перечислите свои активные экспедиции с указанием оставшегося времени, количества покемонов и шансов на успех. | | /награды за экспедицию |Все |Составьте список наград, ожидающих получения на доске. | | /завершение экспедиции <игрок> |OP Уровень 2 |Мгновенно завершить все активные экспедиции игрока. | | /expedition reload |OP Level 2 |Перезагрузить файл конфигурации с диска без перезапуска сервера. Также повторно применяется настройка экономики. | | /expedition xp <игрок> <количество> |OP Уровень 2 |Присвойте игроку опыт экспедиционного ранга (автоматическое повышение ранга). | | /expedition admin |OP Level 2 |Откройте внутриигровой графический интерфейс администратора, чтобы редактировать экспедиции, таблицы добычи, режимы и опасности. |

📦 Установка

Ткань

1. Установите Fabric Loader (≥ 0.16.0) для Minecraft 1.21.1.
2. Установите Fabric API, Fabric Language Kotlin (≥ 1.13.0) и Cobblemon (≥ 1.7.0).
3. Поместите банку ткани (cobblemon-expeditions-fabric-*.jar) в папку mods/.

НеоФордж

1. Установите NeoForge 21.1.95+ для Майнкрафт 1.21.1.
2. Установите Kotlin для Forge (≥ 5.7.0) и Cobblemon (≥ 1.7.0).
3. Поместите jar NeoForge (cobblemon-expeditions-neoforge-*.jar) в папку mods/.

Дополнительно, за денежное вознаграждение: CobbleDollars или Impactor 5.3.5. Impactor должен быть только на сервере.

Требуется как на клиенте, так и на сервере.