跳至主要內容

4. 英雄角色系统

EVOCOSMOS2026/4/15大约 5 分钟

4. 英雄角色系统：创建你的英雄

4.1 英雄数据结构

每个英雄有一套基础属性，用 Godot 的 Resource 来定义：

C#
// HeroData.cs
using Godot;
using System.Collections.Generic;

[GlobalClass]
public partial class HeroData : Resource
{
    [Export] public string HeroName { get; set; } = "";
    [Export] public string HeroClass { get; set; } = ""; // "warrior", "mage", "marksman"
    [Export] public Texture2D Portrait { get; set; }

    // 基础属性
    [Export] public float MaxHp { get; set; } = 1000;
    [Export] public float MaxMp { get; set; } = 500;
    [Export] public float AttackDamage { get; set; } = 50;
    [Export] public float AbilityPower { get; set; } = 0;
    [Export] public float Armor { get; set; } = 30;      // 物理防御
    [Export] public float MagicResist { get; set; } = 30; // 法术防御
    [Export] public float AttackSpeed { get; set; } = 0.8f; // 每秒攻击次数
    [Export] public float MoveSpeed { get; set; } = 5.0f;
    [Export] public float AttackRange { get; set; } = 2.0f; // 攻击距离

    // 成长属性（每级增加多少）
    [Export] public float HpPerLevel { get; set; } = 100;
    [Export] public float AdPerLevel { get; set; } = 5;
    [Export] public float ArmorPerLevel { get; set; } = 3;

    // 技能ID列表
    [Export] public string[] SkillIds { get; set; } = new string[4]; // 被动+3个技能
}

4.2 英雄基类

所有英雄共享一套基础逻辑——移动、攻击、受伤、升级。我们用一个基类来统一管理：

C#
// HeroBase.cs
using Godot;

public partial class HeroBase : CharacterBody3D
{
    // 英雄数据
    protected HeroData _data;
    protected int _level = 1;
    protected float _currentHp;
    protected float _currentMp;
    protected float _exp = 0;
    protected float _expToLevel = 100;

    // 状态
    public enum HeroState { Idle, Moving, Attacking, Casting, Dead }
    protected HeroState _state = HeroState.Idle;
    protected Node3D _target;
    protected bool _isInBush = false;
    protected int _teamId = 0; // 0=蓝方, 1=红方

    // 组件引用
    protected NavigationAgent3D _navAgent;
    protected AnimationPlayer _animPlayer;

    // 升级经验表
    private static readonly float[] ExpTable = {
        100, 200, 350, 550, 800, 1100, 1500, 2000, 2600, 3300,
        4100, 5000, 6000, 7200, 8500
    };

    public override void _Ready()
    {
        _navAgent = GetNode<NavigationAgent3D>("NavigationAgent3D");
        _animPlayer = GetNode<AnimationPlayer>("AnimationPlayer");

        _currentHp = _data.MaxHp;
        _currentMp = _data.MaxMp;

        AddToGroup("heroes");
    }

    public override void _PhysicsProcess(double delta)
    {
        switch (_state)
        {
            case HeroState.Moving:
                MoveAlongPath((float)delta);
                break;
            case HeroState.Attacking:
                PerformAttack((float)delta);
                break;
            case HeroState.Dead:
                // 死亡状态不做任何事
                break;
        }
    }

    protected void MoveAlongPath(float delta)
    {
        if (_navAgent.IsNavigationFinished())
        {
            _state = HeroState.Idle;
            return;
        }

        var nextPos = _navAgent.GetNextPathPosition();
        var direction = (nextPos - GlobalPosition).Normalized();
        Velocity = direction * GetCurrentMoveSpeed();
        LookAt(new Vector3(nextPos.X, GlobalPosition.Y, nextPos.Z), Vector3.Up);
        MoveAndSlide();
    }

    // 计算当前移动速度（含装备加成）
    protected virtual float GetCurrentMoveSpeed()
    {
        return _data.MoveSpeed; // 后续章节加入装备加成
    }

    // 受伤
    public virtual void TakeDamage(float damage, string damageType, Node3D source)
    {
        if (_state == HeroState.Dead) return;

        // 根据伤害类型计算实际伤害
        float actualDamage = damageType == "physical"
            ? CalculatePhysicalDamage(damage)
            : CalculateMagicDamage(damage);

        _currentHp -= actualDamage;

        if (_currentHp <= 0)
        {
            _currentHp = 0;
            Die(source);
        }
    }

    // 物理伤害计算（扣除护甲减伤）
    protected float CalculatePhysicalDamage(float rawDamage)
    {
        float armor = _data.Armor + _data.ArmorPerLevel * (_level - 1);
        float reduction = armor / (armor + 100); // 简化公式
        return rawDamage * (1 - reduction);
    }

    // 法术伤害计算（扣除魔抗减伤）
    protected float CalculateMagicDamage(float rawDamage)
    {
        float mr = _data.MagicResist;
        float reduction = mr / (mr + 100);
        return rawDamage * (1 - reduction);
    }

    // 死亡处理
    protected virtual void Die(Node3D killer)
    {
        _state = HeroState.Dead;

        // 给击杀者经验和金币
        if (killer.IsInGroup("heroes"))
        {
            killer.Call("GainExp", 150 + _level * 30);
            killer.Call("GainGold", 200 + _level * 20);
        }

        // 开始复活倒计时
        float respawnTime = 5 + _level * 2; // 复活时间随等级增长
        GetTree().CreateTimer(respawnTime).Timeout += () => Respawn();
    }

    // 复活
    protected virtual void Respawn()
    {
        _state = HeroState.Idle;
        _currentHp = GetMaxHp();
        _currentMp = _data.MaxMp;
        // 传送到基地
        var spawnPos = _teamId == 0
            ? new Vector3(-45, 1, 0)
            : new Vector3(45, 1, 0);
        GlobalPosition = spawnPos;
    }

    // 获得经验
    public void GainExp(float amount)
    {
        _exp += amount;
        while (_exp >= _expToLevel && _level < 15)
        {
            _exp -= _expToLevel;
            LevelUp();
        }
    }

    // 升级
    protected virtual void LevelUp()
    {
        _level++;
        _expToLevel = _level < ExpTable.Length ? ExpTable[_level - 1] : _expToLevel * 1.2f;

        // 升级提升属性
        _currentHp = GetMaxHp(); // 升级回满血
        _currentMp = _data.MaxMp;
    }

    // 获得金币
    public void GainGold(float amount)
    {
        // 由 EconomySystem 管理，这里发送信号
        EmitSignal(SignalName.GoldChanged, amount);
    }

    // 获取当前最大生命值（含等级加成）
    public float GetMaxHp()
    {
        return _data.MaxHp + _data.HpPerLevel * (_level - 1);
    }

    // 移动到指定位置
    public void MoveTo(Vector3 target)
    {
        _navAgent.TargetPosition = target;
        _state = HeroState.Moving;
    }

    // 进入/离开草丛
    public void SetInBush(bool inBush)
    {
        _isInBush = inBush;
    }

    [Signal]
    public delegate void GoldChangedEventHandler(float amount);
}

4.3 英雄状态机

英雄在同一时间只能做一件事：移动、攻击、施法、死亡。用一个简单的状态机来管理：

┌───────┐  点击移动  ┌─────────┐
│ Idle  │ ─────────→│ Moving  │
│ 待机   │           │ 移动中   │
└───┬───┘           └────┬────┘
    ↑                     │
    │  目标死亡            │ 到达攻击范围
    │                     ↓
┌───┴───┐           ┌──────────┐
│ Dead  │ ←──────── │ Attacking │
│ 死亡   │  生命归零  │ 攻击中    │
└───────┘           └────┬─────┘
                         │ 按技能键
                         ↓
                    ┌──────────┐
                    │ Casting  │
                    │ 施法中    │
                    └──────────┘

4.4 血条显示

每个英雄头顶需要一个血条，让玩家直观看到生命值：

C#
// HealthBar3D.cs
using Godot;

public partial class HealthBar3D : SubViewportContainer
{
    private ProgressBar _healthBar;
    private ProgressBar _manaBar;
    private Label _levelLabel;
    private float _maxHp;

    public override void _Ready()
    {
        // 在 SubViewport 中创建 UI 元素
        var viewport = GetNode<SubViewport>("SubViewport");
        var root = viewport.GetNode<Control>("Root");

        _healthBar = root.GetNode<ProgressBar>("HealthBar");
        _manaBar = root.GetNode<ProgressBar>("ManaBar");
        _levelLabel = root.GetNode<Label>("LevelLabel");
    }

    public void UpdateHealth(float current, float max)
    {
        _maxHp = max;
        _healthBar.MaxValue = max;
        _healthBar.Value = current;
    }

    public void UpdateMana(float current, float max)
    {
        _manaBar.MaxValue = max;
        _manaBar.Value = current;
    }

    public void UpdateLevel(int level)
    {
        _levelLabel.Text = $"Lv.{level}";
    }
}

章节导航

上一章下一章
← 3. 地图与分路系统5. 战斗与技能系统 →
最近更新:
贡献者: bobokaka
EVOCOSMOS
Copyright © 2026 EVOCOSMOS