Character

The Character System is the central entity framework for all characters in Townskeep. It uses Paragon's subsystem/component composition pattern to assemble characters from modular, serializable components — motor, controller, camera, animator, interactor, inventory, and network — all driven by factory-spawned data.

Architecture

Data Flow

Key Concepts

Concept	Description
Character	Central FactorableBehaviour that owns all components via IParagonSubsystem<Character>. Entry point for the entity.
CharacterData	Serializable data record passed during factory spawning. Contains the CharacterID.
CharacterComponent	Abstract base for all character components. Provides typed Character accessor to the owning character.
CharacterController	High-level command facade — translates input into motor, camera, interactor, and inventory calls.
CharacterMotor	Physics-driven movement and rotation. Manages velocity, acceleration, grounding, and collision via Unity's CharacterController.

Quick Start

Accessing Character Components

// All components are accessed via typed properties on Character
Character character = GetComponent<Character>();

CharacterMotor motor = character.Motor;
CharacterController controller = character.Controller;
CharacterCamera camera = character.Camera;

Commanding a Character (via Controller)

// Movement from input
character.Controller.MoveBy(inputVector);
character.Controller.Jump();
character.Controller.SetSprint(true);

// AI pathfinding target
character.Controller.MoveTo(targetPosition);
character.Controller.RotateTo(targetPosition);

Direct Motor Access

// Lower-level motor API
character.Motor.MoveBy(new Vector3(1, 0, 0), worldSpace: true);
character.Motor.RotateTowards(Vector3.forward);

// Read motor state
bool grounded = character.Motor.IsGrounded;
Vector3 velocity = character.Motor.Velocity;

Classes

Class	Description
Character	Central entity behaviour — owns components, delegates ticking, manages name and possession
CharacterData	Serializable data record for factory spawning
CharacterComponent	Abstract base for all character components
CharacterController	High-level command facade for input-driven and AI-driven character control
CharacterMotor	Physics-driven movement, rotation, jumping, and collision

See Also

• Scriptable Factory — factory/spawning system that creates Characters

• Objects — ParagonSubsystem and ParagonComponent base architecture