46 lines
1.9 KiB
C#
46 lines
1.9 KiB
C#
|
using Theriapolis.Core.Rules.Character;
|
||
|
|
using Theriapolis.Core.Util;
|
||
|
|
|
||
|
|
namespace Theriapolis.Core.Entities;
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Base actor record. Position is in world-pixel space and is meaningful in
|
||
|
|
/// both the world-map view and the tactical view (see Section 5 of the
|
||
|
|
/// implementation plan — one canonical coordinate system).
|
||
|
|
///
|
||
|
|
/// Phase 5 adds the optional <see cref="Character"/> attachment carrying all
|
||
|
|
/// gameplay state (stats, inventory, HP, conditions). The renderer layer
|
||
|
|
/// stays ignorant of the gameplay layer — Camera2D doesn't need to know HP.
|
||
|
|
/// </summary>
|
||
|
|
public class Actor
|
||
|
|
{
|
||
|
|
/// <summary>Stable id assigned by <see cref="ActorManager"/>.</summary>
|
||
|
|
public int Id { get; init; }
|
||
|
|
|
||
|
|
/// <summary>World-pixel position. Reused at both zoom scales.</summary>
|
||
|
|
public Vec2 Position { get; set; }
|
||
|
|
|
||
|
|
/// <summary>Facing angle in radians (0 = east, π/2 = south).</summary>
|
||
|
|
public float FacingAngleRad { get; set; }
|
||
|
|
|
||
|
|
/// <summary>Continuous-time travel speed on the world map, in world pixels per real second.</summary>
|
||
|
|
public float SpeedWorldPxPerSec { get; set; } = C.PLAYER_TRAVEL_PX_PER_SEC;
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// Phase 5: gameplay state. Null when this actor isn't combat-capable
|
||
|
|
/// (cosmetic NPCs, future-phase additions). PlayerActor and NpcActor
|
||
|
|
/// always carry one.
|
||
|
|
/// </summary>
|
||
|
|
public Character? Character { get; set; }
|
||
|
|
|
||
|
|
/// <summary>Whose side this actor is on. Drives encounter triggering and AI targeting.</summary>
|
||
|
|
public Allegiance Allegiance { get; set; } = Allegiance.Neutral;
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// True if this actor still has positive HP (or is downed but not dead).
|
||
|
|
/// Subclasses (e.g. <see cref="NpcActor"/>) override to use direct HP
|
||
|
|
/// fields instead of a <see cref="Character"/> reference.
|
||
|
|
/// </summary>
|
||
|
|
public virtual bool IsAlive => Character is null ? true : Character.IsAlive;
|
||
|
|
}
|