Aetheria/Assets/Scripts/ServerShared/Behaviors/EnergyDraw.cs

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */

using System;
using System.Linq;
using MessagePack;
using Newtonsoft.Json;

[Inspectable, MessagePackObject, JsonObject(MemberSerialization.OptIn), RuntimeInspectable]
public class EnergyDrawData : BehaviorData
{
    [Inspectable, JsonProperty("draw"), Key(1), RuntimeInspectable]
    public PerformanceStat EnergyDraw = new PerformanceStat();
    
    [Inspectable, JsonProperty("perSecond"), Key(2)]
    public bool PerSecond;
    
    public override Behavior CreateInstance(EquippedItem item)
    {
        return new EnergyDraw(this, item);
    }
    
    public override Behavior CreateInstance(ConsumableItemEffect item)
    {
        return new EnergyDraw(this, item);
    }
}

public class EnergyDraw : Behavior, IPowerConsumer
{
    private EnergyDrawData _data;

    public EnergyDraw(EnergyDrawData data, EquippedItem item) : base(data, item)
    {
        _data = data;
    }

    public EnergyDraw(EnergyDrawData data, ConsumableItemEffect item) : base(data, item)
    {
        _data = data;
    }

    // Cut 3 (docs/stats-and-power-cut.md): the request PowerBus needs before Execute runs, in place of the
    // direct Entity.TryConsumeEnergy spend that used to happen inside Execute.
    //
    // Nominal-request ruling (docs/stats-and-power-cut.md, operator ruling 2026-09-19): EnergyDraw is a
    // registered request field (StatValidation.PowerRequestFields) -- read nominally, same reasoning as every
    // other IPowerConsumer in this cut.
    public float PowerRequest(float dt) => EvaluateNominalPower(_data.EnergyDraw) * (_data.PerSecond ? dt : 1);

    // Cut 5 (docs/stats-and-power-cut.md §1.3, PowerTiers.cs): Utility -- the generic/unclassified draw. An item
    // that declares power use without asking for a specific tier should not accidentally outrank a named one.
    public int DefaultPowerTier => PowerTiers.Utility;

    public override bool Execute(float dt)
    {
        // A consumable-hosted instance (Item null) has no PowerBus entry (§1.2's grants are keyed by
        // EquippedItem); named rather than silently assumed away, it always succeeds here, the same way every
        // other context-dependent factor a ConsumableItemEffect answers with the identity elsewhere in this cut.
        //
        // Cut 7 (docs/stats-and-power-target.md): unlike the other four continuous consumers, EnergyDraw has no
        // performance stat of its own to curve -- its Execute return value IS its whole effect, the gate that
        // decides whether the rest of its BehaviorGroup runs at all (Entity.cs's per-group Execute chain). There
        // is nothing here for a PowerSupply term to degrade continuously, so brownout is expressed the only way
        // this behaviour can express it: a partial grant still passes (no more flicking off at 80%), and only a
        // true zero grant closes the gate.
        return Item == null || Item.PowerSupply > 1e-4f;
    }
}