Объединяемые предметы

Делаем предметы объединяемыми

Просто реализуйте интерфейс IItemCombinable в классе вашего предмета:

MyCombinableItem.cs

public class MyCombinableItem : CustomItem, IItemCombinable
{
    public bool CombineFilter(InvItem other) { /* ... */ }
    public bool CombineItems(InvItem other) { /* ... */ }
    public CustomTooltip CombineTooltip(InvItem other) { /* ... */ }
    public CustomTooltip CombineCursorText(InvItem other) { /* ... */ }
}

Плюс, тип предмета должен быть "Combine":

    public override void SetupDetails()
    {
        Item.itemType = ItemTypes.Combine;
        /* ... */
    }

CombineFilter определяет какие предметы будут подсвечиваться, при объединении текущего предмета.

CombineItems объединяет текущий предмет с другим. Возвращаемое значение определяет успешно ли были предметы объединены или нет. Обычно, если предметы не могут быть объединены, проигрывается звук "CantDo". Возврат true также проигрывает анимацию.

CombineTooltip определяет текст подсказки в левом верхнем углу слота инвентаря. Text выставленный на null определится как пустая строка, и Color выставленный на null определится как

#FFED00

. Смотрите инструмент ниже.

CombineCursorText определяет текст возле курсора над выбранным предметом. Text выставленный на null определится как "Объединить", и Color выставленный на null определится как

#FFFFFF

.

Превью слота инвентаря

Хотите увидеть как ваш CombineTooltip будет выглядеть в игре? Зацените этот маленький инструмент:

$123

Примеры

Центрифуга

Простой пример, обращающий эффекты в Шприцах.

using System.Collections.Generic;
using System.Linq;

namespace RogueLibsCore.Test
{
    public class Centrifuge : CustomItem, IItemCombinable
    {
        [RLSetup]
        public static void Setup()
        {
            /*
            RogueLibs.CreateCustomItem<Centrifuge>()
                .WithName(new CustomNameInfo("Centrifuge"))
                .WithDescription(new CustomNameInfo("Combine with a syringe to invert its effect."))
                .WithSprite(Properties.Resources.Centrifuge)
                .WithUnlock(new ItemUnlock
                {
                    UnlockCost = 10,
                    LoadoutCost = 5,
                    CharacterCreationCost = 3,
                    Prerequisites = { VanillaItems.Antidote },
                });
            */
        }

        public override void SetupDetails()
        {
            Item.itemType = ItemTypes.Combine;
            Item.itemValue = 8;
            Item.initCount = 10;
            Item.stackable = true;
            Item.hasCharges = true;
        }

        private static readonly Dictionary<string, string> invertDictionary = new Dictionary<string, string>
        {
            [VanillaEffects.Poisoned] = VanillaEffects.RegenerateHealth,
            [VanillaEffects.Slow] = VanillaEffects.Fast,
            [VanillaEffects.Weak] = VanillaEffects.Strength,
            [VanillaEffects.Acid] = VanillaEffects.Invincible,
            [VanillaEffects.Confused] = VanillaEffects.Invisible,
        };
        static Centrifuge()
        {
            foreach (KeyValuePair<string, string> pair in invertDictionary.ToArray())
                invertDictionary.Add(pair.Value, pair.Key);
        }

        public bool CombineFilter(InvItem other) => other.invItemName == VanillaItems.Syringe
            && other.contents.Count > 0 && invertDictionary.ContainsKey(other.contents[0]);
        public bool CombineItems(InvItem other)
        {
            if (!CombineFilter(other)) return false;

            other.contents[0] = invertDictionary[other.contents[0]];

            Count--;
            gc.audioHandler.Play(Owner, VanillaAudio.CombineItem);
            return true;
        }
        public CustomTooltip CombineCursorText(InvItem other) => default;
        public CustomTooltip CombineTooltip(InvItem other) => default;
    }
}

Стойка со специями

Простой пример, со специальными хуками для отслеживания приправленной еды.

using UnityEngine;

namespace RogueLibsCore.Test
{
    [ItemCategories(RogueCategories.Food, RogueCategories.Health)]
    public class SpiceRack : CustomItem, IItemCombinable
    {
        [RLSetup]
        public static void Setup()
        {
            RogueLibs.CreateCustomItem<SpiceRack>()
                .WithName(new CustomNameInfo("Spice Rack"))
                .WithDescription(new CustomNameInfo("Combine with any food item to increase its healing properties."))
                .WithSprite(Properties.Resources.SpiceRack)
                .WithUnlock(new ItemUnlock
                {
                    UnlockCost = 10,
                    LoadoutCost = 3,
                    CharacterCreationCost = 2,
                    Prerequisites = { VanillaItems.FoodProcessor },
                });

            SeasonCursorText = RogueLibs.CreateCustomName("SeasonItem", NameTypes.Interface, new CustomNameInfo("Season"));
        }
        private static CustomName SeasonCursorText = null!;

        public override void SetupDetails()
        {
            Item.itemType = ItemTypes.Combine;
            Item.itemValue = 4;
            Item.initCount = 10;
            Item.rewardCount = 15;
            Item.stackable = true;
            Item.hasCharges = true;
        }
        public bool CombineFilter(InvItem other)
        {
            if (other.itemType != ItemTypes.Food || other.healthChange is 0
                || !other.Categories.Contains(RogueCategories.Food)) return false;

            SpicedHook? hook = other.GetHook<SpicedHook>();
            return hook is null || hook.Spiciness < 3;
        }
        public bool CombineItems(InvItem other)
        {
            if (!CombineFilter(other)) return false;

            SpicedHook hook = other.GetHook<SpicedHook>() ?? other.AddHook<SpicedHook>();
            hook.IncreaseSpiciness();

            Count--;
            gc.audioHandler.Play(Owner, VanillaAudio.CombineItem);
            return true;
        }
        public CustomTooltip CombineCursorText(InvItem other) => SeasonCursorText;
        public CustomTooltip CombineTooltip(InvItem other)
        {
            if (!CombineFilter(other)) return default;

            SpicedHook? hook = other.GetHook<SpicedHook>();
            int bonus = hook is null ? (int)Mathf.Ceil(other.healthChange / 4f) : hook.HealthBonus;
            return new CustomTooltip($"+{bonus}", Color.green);
        }

        private class SpicedHook : HookBase<InvItem>
        {
            protected override void Initialize()
                => HealthBonus = (int)Mathf.Ceil(Instance.healthChange / 4f);

            public int HealthBonus { get; private set; }
            public int Spiciness { get; private set; }

            public void IncreaseSpiciness()
            {
                if (Spiciness is 3) return;

                Spiciness++;
                Instance.healthChange += HealthBonus;
            }
        }
    }
}

Ящик с боеприпасами

Довольно сложный пример с кучей математики.

using UnityEngine;

namespace RogueLibsCore.Test
{
    [ItemCategories(RogueCategories.Technology, RogueCategories.GunAccessory, RogueCategories.Guns)]
    public class AmmoBox : CustomItem, IItemCombinable
    {
        [RLSetup]
        public static void Setup()
        {
            RogueLibs.CreateCustomItem<AmmoBox>()
                .WithName(new CustomNameInfo("Ammo Box"))
                .WithDescription(new CustomNameInfo("Combine with any refillable weapon to refill it. Limited ammo."))
                .WithSprite(Properties.Resources.AmmoBox)
                .WithUnlock(new ItemUnlock
                {
                    UnlockCost = 10,
                    LoadoutCost = 5,
                    CharacterCreationCost = 3,
                    Prerequisites = { VanillaItems.KillAmmunizer },
                });
        }

        public override void SetupDetails()
        {
            Item.itemType = ItemTypes.Combine;
            Item.itemValue = 4;
            Item.initCount = 100;
            Item.rewardCount = 200;
            Item.hasCharges = true;
            Item.stackable = true;
        }
        public bool CombineFilter(InvItem other) => other.itemType == ItemTypes.WeaponProjectile && !other.noRefills;
        public bool CombineItems(InvItem other)
        {
            if (!CombineFilter(other))
            {
                gc.audioHandler.Play(Owner, VanillaAudio.CantDo);
                return false;
            }
            if (other.invItemCount >= other.maxAmmo)
            {
                Owner!.SayDialogue("AmmoDispenserFull");
                gc.audioHandler.Play(Owner, VanillaAudio.CantDo);
                return false;
            }

            int amountToRefill = other.maxAmmo - other.invItemCount;
            float singleCost = (float)other.itemValue / other.maxAmmo;
            if (Owner!.oma.superSpecialAbility && Owner.agentName is VanillaAgents.Soldier or VanillaAgents.Doctor)
                singleCost = 0f;

            int affordableAmount = (int)Mathf.Ceil(Count / singleCost);
            int willBeBought = Mathf.Min(affordableAmount, amountToRefill);
            int willBeReduced = (int)Mathf.Min(Count, willBeBought * singleCost);

            Count -= willBeReduced;
            other.invItemCount += willBeBought;
            Owner.SayDialogue("AmmoDispenserFilled");
            gc.audioHandler.Play(Owner, VanillaAudio.BuyItem);
            return true;
        }

        public CustomTooltip CombineTooltip(InvItem other)
        {
            if (!CombineFilter(other)) return default;

            int amountToRefill = other.maxAmmo - other.invItemCount;
            if (amountToRefill == 0) return default;

            float singleCost = (float)other.itemValue / other.maxAmmo;
            if (Owner!.oma.superSpecialAbility && Owner.agentName is VanillaAgents.Soldier or VanillaAgents.Doctor)
                singleCost = 0f;
            int cost = (int)Mathf.Floor(amountToRefill * singleCost);
            int canAfford = (int)Mathf.Ceil(Count / singleCost);

            return "+" + Mathf.Min(amountToRefill, canAfford) + " (" + Mathf.Min(cost, Count) + ")";
        }

        public CustomTooltip CombineCursorText(InvItem other) => gc.nameDB.GetName("RefillGun", NameTypes.Interface);
        // it's one of the vanilla dialogues, so there's no need to define it in the mod
    }
}