Event Rewards

Мод сервера Sansara: награды за ивенты. Администратор выдаёт игроку-победителю обычный ванильный предмет с меткой «Дар асов». У игроков с установленным модом такой предмет даёт дополнительные бонусы (вес, скорость, регенерация выносливости, расход выносливости на бег, здоровье, урон в бою, прочность блока щита, уровень инструмента для рубки деревьев, а также свойство «словно пёрышко» — как у плаща из перьев: медленное падение и сниженный урон от падения; с 0.5.3 — сопротивления урону, ванильные эффекты предметов вроде «Дужки» и «Света светлячка» и двойной прыжок; с 0.5.4 — магия: запас и восстановление эйтра, дешевле заклинания эйтром и здоровьем, прибавка к уровню и росту навыков, урон атак выбранным навыком; с 0.5.5 — адреналин: быстрее набор шкалы, адреналин за попадание по врагу, а у наград-украшений — ниже порог шкалы, дольше эффект полной шкалы и дополнительные эффекты вроде «Ветрокрылого» при полной шкале; силы боссов без таймера, пока предмет надет, скорость корабля и награды без ремонта; с 0.5.6 — еда и медовухи: восстановление здоровья, сила и медленное выдыхание еды, дольше, чаще и сильнее медовухи, постоянные эффекты медовух вроде сопротивления морозу; с 0.5.7 — строительство: меньше выносливости на молот, мотыгу и культиватор и большая дальность строительства; с 0.5.8 — судьба награды при смерти: по умолчанию остаётся у игрока, может выпадать как обычно или пропадать; с 0.5.9 — броня самого предмета-награды; с 0.5.10 — меньше урона от падения; с 0.5.12 — увеличенная прочность самого предмета-награды и неразрушимые награды; с 0.5.13 — экономия ресурсов: меньше материалов на изготовление и улучшение, шанс сберечь стрелу, больше стрел за изготовление). У игроков без мода предмет остаётся обычным ванильным предметом — ни ошибок, ни потери предмета.

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

Совместимость: Valheim 1.0.16, Jotunn 2.30.2. Версия мода у клиента должна совпадать с версией на сервере по минорному номеру (например, 0.5.x; клиенты 0.4.x нужно обновить) — иначе подключиться не получится.

Для администраторов сервера — команды eventreward list, eventreward give, eventreward reload; каталог наград хранится в BepInEx/config/sansara.EventRewards.rewards.json на сервере. С 0.5.1 — серверный ивент «Охота на искателей» и команды eventhunt setchest | start | stop | status (только администратор). С 0.5.14 — изъятие выданных наград по решению администратора: eventreward revoke <id>[,<id>...] @<код> или … all, eventreward revoke list, eventreward unrevoke #<№> (у игроков с модом вещь пропадает из инвентаря с сообщением «Суд Форсети…», сервер убирает её из сундуков, повозок, кораблей, надгробий и с земли). С 0.5.11 — список игроков с короткими кодами и очередь доставки: eventreward players, eventreward give <id>[,<id>...] @<код> (награда появится у ног персонажа, когда он в игре, — видно и без мода), eventreward queue, eventreward cancel, eventreward players unbind (запись игрока привязана к платформе первого входа); автовыдача награды участникам «Охоты» после победы.

English

Event reward mod (required on the server, optional on clients) for the Sansara Valheim server. Admins tag a plain vanilla item as an event reward; players who have this mod installed get extra stat bonuses (carry weight, move speed, stamina regen, run stamina drain, health, damage, shield block power, minimum tool tier, plus "like the feather cape": slow fall and reduced fall damage; since 0.5.3 damage resistances, vanilla item effects such as Wishbone or Demister, and a double jump; since 0.5.4 magic: max eitr, eitr regen, cheaper spells in eitr and health, skill level and skill gain bonuses, damage bonus for a chosen skill; since 0.5.5 adrenaline: faster gain, adrenaline per hit on enemies and, for reward trinkets, a lower bar threshold, a longer full-adrenaline effect and extra vanilla effects such as Wind Run when the bar fills; boss powers without a timer while worn, ship speed and non-repairable rewards; since 0.5.6 food and meads: health regen, stronger and slower-draining food, longer, more frequent and stronger meads, permanent mead effects such as frost resistance; since 0.5.7 building: cheaper hammer, hoe and cultivator stamina and a longer build reach; since 0.5.8 what happens to a reward on death: by default it stays with the player instead of dropping into the tombstone; it can also drop normally or be destroyed; since 0.5.9 a stronger armor value of the reward item itself; since 0.5.10 less fall damage; since 0.5.12 a higher max durability of the reward item itself and indestructible rewards; since 0.5.13 resource economy: fewer materials for crafting and upgrading, a chance to keep an arrow, more arrows per craft) while wearing/holding it. Players without the mod keep a normal vanilla item — no errors, nothing lost. The mod is only needed on the client to receive the bonuses; the reward catalog lives on the server. Client and server must match on the minor version number to connect. Since 0.5.11 the server keeps a player roster with short codes and a persistent delivery queue: an admin queues a reward for a player (eventreward give <id> @<code>) and the server drops it at the character's feet when they are online — vanilla clients just pick it up. Since 0.5.14 admins can revoke reward items (eventreward revoke <id> @<code>|all, revoke list, unrevoke #<n>): modded clients lose them from their inventory with a server-wide message, the server removes them from chests, carts, ships, tombstones and the ground, and a revoked reward gives no bonuses any more.

Лицензия / License

MIT.