yeziuku/FunGame-Core
1
0
Fork 0
forked from project-redbud/FunGame-Core
Code Pull Requests Activity

特效、队列底层机制加强 (#135)

Browse Source 
* 在 Effect 类中添加精准控制状态栏显示的属性

* 特效、队列底层机制加强
This commit is contained in:
milimoe 2025-05-10 22:35:05 +08:00 committed by GitHub
parent 290b9fe26b
commit f8f7df94b7
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
14 changed files with 271 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
Entity/Item/Item.cs
View File

@ -248,7 +248,7 @@ namespace Milimoe.FunGame.Core.Entity
{
foreach (Skill skill in Skills.Passives)
{
List<Effect> effects = [.. Character.Effects.Where(e => e.Skill == skill && e.Level > 0 && !e.IsBeingTemporaryDispelled)];
List<Effect> effects = [.. Character.Effects.Where(e => e.Skill == skill && e.IsInEffect)];
foreach (Effect e in effects)
{
Character.Effects.Remove(e);

14
Entity/Skill/Effect.cs
View File

@ -55,15 +55,25 @@ namespace Milimoe.FunGame.Core.Entity
/// </summary>
public virtual bool DurativeWithoutDuration { get; set; } = false;
/// <summary>
/// 附属于某个特效
/// </summary>
public Effect? ParentEffect { get; set; } = null;
/// <summary>
/// 是否是某个特效的附属
/// </summary>
public virtual bool IsSubsidiary { get; set; } = false;
public bool IsSubsidiary => ParentEffect != null;
/// <summary>
/// 是否强制在状态栏中隐藏
/// </summary>
public virtual bool ForceHideInStatusBar { get; set; } = false;
/// <summary>
/// 是否显示在状态栏
/// </summary>
public bool ShowInStatusBar => Skill.Item is null || (Durative && Duration > 0) || DurationTurn > 0 || DurativeWithoutDuration || IsSubsidiary;
public bool ShowInStatusBar => !ForceHideInStatusBar && !IsSubsidiary && (Skill.Item is null || (Durative && Duration > 0) || DurationTurn > 0 || DurativeWithoutDuration);
/// <summary>
/// 特效是否生效

44
Entity/Skill/NormalAttack.cs
View File

@ -18,6 +18,11 @@ namespace Milimoe.FunGame.Core.Entity
/// </summary>
public string Description => $"对目标敌人造成 {(1.0 + 0.05 * (Level - 1)) * 100:0.##}% 攻击力 [ {Damage:0.##} ] 点{(IsMagic ? CharacterSet.GetMagicDamageName(MagicType) : "物理伤害")}。";
/// <summary>
/// 普通攻击的通用说明
/// </summary>
public string GeneralDescription => $"对目标敌人造成基于 100（+5/Lv）% 攻击力的{(IsMagic ? CharacterSet.GetMagicDamageName(MagicType) : "物理伤害")}。";
/// <summary>
/// 所属的角色
/// </summary>
@ -53,6 +58,16 @@ namespace Milimoe.FunGame.Core.Entity
/// </summary>
public MagicType MagicType => _MagicType;
/// <summary>
/// 是否可用
/// </summary>
public bool Enable { get; set; } = true;
/// <summary>
/// 是否在持续生效，为 true 时不允许再次使用。普通攻击始终为 false
/// </summary>
public bool IsInEffect => false;
/// <summary>
/// 无视免疫类型
/// </summary>
@ -93,6 +108,31 @@ namespace Milimoe.FunGame.Core.Entity
/// </summary>
public double CanSelectTargetRange { get; set; } = 0;
/// <summary>
/// 普通攻击没有魔法消耗
/// </summary>
public double RealMPCost => 0;
/// <summary>
/// 普通攻击没有吟唱时间
/// </summary>
public double RealCastTime => 0;
/// <summary>
/// 普通攻击没有能量消耗
/// </summary>
public double RealEPCost => 0;
/// <summary>
/// 普通攻击没有冷却时间
/// </summary>
public double RealCD => 0;
/// <summary>
/// 普通攻击没有冷却时间
/// </summary>
public double CurrentCD => 0;
/// <summary>
/// 获取可选择的目标列表
/// </summary>
@ -129,6 +169,10 @@ namespace Milimoe.FunGame.Core.Entity
/// <param name="enemys"></param>
public void Attack(IGamingQueue queue, Character attacker, params IEnumerable<Character> enemys)
{
if (!Enable)
{
return;
}
foreach (Character enemy in enemys)
{
if (enemy.HP > 0)

12
Entity/Skill/SkillTarget.cs
View File

@ -1,8 +1,20 @@
namespace Milimoe.FunGame.Core.Entity
{
/// <summary>
/// 技能和它的目标结构体
/// </summary>
/// <param name="skill"></param>
/// <param name="targets"></param>
public struct SkillTarget(Skill skill, List<Character> targets)
{
/// <summary>
/// 技能实例
/// </summary>
public Skill Skill { get; set; } = skill;
/// <summary>
/// 技能的目标列表
/// </summary>
public List<Character> Targets { get; set; } = targets;
}
}

12
FunGame.Core.csproj
View File

@ -23,7 +23,17 @@
<Description>FunGame.Core: A C#.NET library for turn-based games.</Description>
<PackageTags>game;turn-based;server;framework;dotnet;csharp;gamedev</PackageTags>
<PackageReleaseNotes>
- Initial release candidate 1 (1.0.0-rc.1)
- Initial release candidate 1 (1.0.0-rc.1-0428)
- Abstract ActionQueue as GamingQueue, and separate the original Mix / Team modes into two queue types: MixGamingQueue and TeamGamingQueue. (1.0.0-rc.1-0502)
- In the Effect class, added ParentEffect and ForceHideInStatusBar properties for more precise control of the status bar display. (1.0.0-rc.1-0509)
- Added helper methods IsTeammate and GetIsTeammateDictionary to GamingQueue for determining if someone is a teammate, IGamingQueue also. This facilitates the skill effects to determine whether the target is a teammate. (1.0.0-rc.1-0509)
- Added more properties (such as Name, RealCD) to the ISkill interface. Both NormalAttack and Skill inherit from ISkill, thus implementing these properties, although some properties are not meaningful for NormalAttack. (1.0.0-rc.1-0509)
- Added corresponding text for EffectTypes Lifesteal and GrievousWound. (1.0.0-rc.1-0509)
- Added EffectTypes: WeakDispelling and StrongDispelling, representing DurativeWeak and DurativeStrong of DispelType. (1.0.0-rc.1-0509)
- Added underlying processing support for continuous dispelling in the TimeLapse method. (1.0.0-rc.1-0509)
- Fixed an issue where the effect's shield hook provided incorrect parameters. (1.0.0-rc.1-0509)
- Fixed an issue where the result of pre-hooks for evade and critical hit checks always deferred to the result of the last effect. It should be that if any effect prevents the check, it is skipped. (1.0.0-rc.1-0509)
- Added comments for some code. (1.0.0-rc.1-0509)
</PackageReleaseNotes>
<RepositoryUrl>https://github.com/project-redbud/FunGame-Core</RepositoryUrl>
<PackageProjectUrl>https://github.com/project-redbud</PackageProjectUrl>

16
Interface/Base/IGamingQueue.cs
View File

@ -168,6 +168,22 @@ namespace Milimoe.FunGame.Core.Interface.Base
/// <returns></returns>
public Task<List<Character>> SelectTargetsAsync(Character character, NormalAttack attack, List<Character> enemys, List<Character> teammates);
/// <summary>
/// 判断目标对于某个角色是否是队友
/// </summary>
/// <param name="character"></param>
/// <param name="target"></param>
/// <returns></returns>
public bool IsTeammate(Character character, Character target);
/// <summary>
/// 获取目标对于某个角色是否是队友的字典
/// </summary>
/// <param name="character"></param>
/// <param name="targets"></param>
/// <returns></returns>
public Dictionary<Character, bool> GetIsTeammateDictionary(Character character, IEnumerable<Character> targets);
/// <summary>
/// 检查角色是否在 AI 控制状态
/// </summary>

15
Interface/Entity/Base/IBaseEntity.cs
View File

@ -2,10 +2,25 @@
{
public interface IBaseEntity : IEquatable<IBaseEntity>
{
/// <summary>
/// 实体的数字标识符
/// </summary>
public long Id { get; }
/// <summary>
/// 实体的唯一标识符
/// </summary>
public Guid Guid { get; }
/// <summary>
/// 实体的名称
/// </summary>
public string Name { get; }
/// <summary>
/// 获取实体的 Id.Name
/// </summary>
/// <returns></returns>
public string GetIdName();
}
}

65
Interface/Entity/Typical/ISkill.cs
View File

@ -2,8 +2,41 @@
namespace Milimoe.FunGame.Core.Interface.Entity
{
public interface ISkill
/// <summary>
/// ISkill 是技能的通用接口，包含一些基本属性，实现类：<see cref="NormalAttack"/> 和 <see cref="Skill"/>
/// </summary>
public interface ISkill : IBaseEntity
{
/// <summary>
/// 此技能所属的角色
/// </summary>
public Character? Character { get; }
/// <summary>
/// 技能描述
/// </summary>
public string Description { get; }
/// <summary>
/// 技能的通用描述
/// </summary>
public string GeneralDescription { get; }
/// <summary>
/// 技能等级，等于 0 时可以称之为尚未学习
/// </summary>
public int Level { get; }
/// <summary>
/// 是否可用 [ 此项为高优先级 ]
/// </summary>
public bool Enable { get; }
/// <summary>
/// 效果持续生效中 [ 此项为高优先级 ] [ 此项设置为true后不允许再次释放，防止重复释放 ]
/// </summary>
public bool IsInEffect { get; }
/// <summary>
/// 可选取自身
/// </summary>
@ -28,6 +61,36 @@ namespace Milimoe.FunGame.Core.Interface.Entity
/// </summary>
public double CanSelectTargetRange { get; }
/// <summary>
/// 实际魔法消耗 [ 魔法 ]
/// </summary>
public double RealMPCost { get; }
/// <summary>
/// 实际吟唱时间 [ 魔法 ]
/// </summary>
public double RealCastTime { get; }
/// <summary>
/// 实际能量消耗 [ 战技 ]
/// </summary>
public double RealEPCost { get; }
/// <summary>
/// 实际冷却时间
/// </summary>
public double RealCD { get; }
/// <summary>
/// 剩余冷却时间
/// </summary>
public double CurrentCD { get; }
/// <summary>
/// 实际硬直时间
/// </summary>
public double RealHardnessTime { get; }
/// <summary>
/// 获取可选择的目标列表
/// </summary>

8
Library/Constant/ConstantSet.cs
View File

@ -682,6 +682,10 @@ namespace Milimoe.FunGame.Core.Library.Constant
EffectType.SkilledImmune => "技能免疫",
EffectType.AllImmune => "完全免疫",
EffectType.EvadeBoost => "闪避提升",
EffectType.Lifesteal => "生命偷取",
EffectType.GrievousWound => "重伤",
EffectType.WeakDispelling => "持续性弱驱散",
EffectType.StrongDispelling => "持续性强驱散",
_ => "未知效果"
};
}
@ -710,6 +714,8 @@ namespace Milimoe.FunGame.Core.Library.Constant
EffectType.Petrify => DispelledType.Strong,
EffectType.SilenceMagic => DispelledType.Strong,
EffectType.Banish => DispelledType.Strong,
EffectType.AllImmune => DispelledType.Strong,
EffectType.StrongDispelling => DispelledType.Strong,
EffectType.Mark => DispelledType.Weak,
EffectType.Slow => DispelledType.Weak,
EffectType.Weaken => DispelledType.Weak,
@ -733,10 +739,10 @@ namespace Milimoe.FunGame.Core.Library.Constant
EffectType.PhysicalImmune => DispelledType.Weak,
EffectType.MagicalImmune => DispelledType.Weak,
EffectType.SkilledImmune => DispelledType.Weak,
EffectType.AllImmune => DispelledType.Strong,
EffectType.EvadeBoost => DispelledType.Weak,
EffectType.Lifesteal => DispelledType.Weak,
EffectType.GrievousWound => DispelledType.Weak,
EffectType.WeakDispelling => DispelledType.Weak,
_ => DispelledType.Weak
};
}

17
Library/Constant/TypeEnum.cs
View File

@ -228,6 +228,11 @@ namespace Milimoe.FunGame.Core.Library.Constant
/// <summary>
/// 注意：具有控制效果的特效，应该和技能本身的特效(一般此项为None)区分开来。此效果被赋值会改变一些判断的结果。
/// <para>关联方法：</para>
/// <para><see cref="SkillSet.GetCharacterStateByEffectType(EffectType)"/></para>
/// <para><see cref="SkillSet.GetDispelledTypeByEffectType(EffectType)"/></para>
/// <para><see cref="SkillSet.GetEffectTypeName(EffectType)"/></para>
/// <para><see cref="SkillSet.GetIsDebuffByEffectType(EffectType)"/></para>
/// </summary>
public enum EffectType
{
@ -464,7 +469,17 @@ namespace Milimoe.FunGame.Core.Library.Constant
/// <summary>
/// 重伤，目标受到的治疗效果降低
/// </summary>
GrievousWound
GrievousWound,
/// <summary>
/// 持续性弱驱散
/// </summary>
WeakDispelling,
/// <summary>
/// 持续性强驱散
/// </summary>
StrongDispelling
}
public enum ItemType

79
Model/GamingQueue.cs
View File

@ -8,6 +8,7 @@ namespace Milimoe.FunGame.Core.Model
{
/// <summary>
/// 提供一个基础的回合制游戏队列基类实现，可继承扩展
/// <para/>该默认实现为混战模式 <see cref="RoomType.Mix"/>
/// </summary>
public class GamingQueue : IGamingQueue
{
@ -577,12 +578,6 @@ namespace Milimoe.FunGame.Core.Model
List<Effect> effects = [.. character.Effects];
foreach (Effect effect in effects)
{
if (effect.IsBeingTemporaryDispelled)
{
effect.IsBeingTemporaryDispelled = false;
effect.OnEffectGained(character);
}
if (effect.Level == 0)
{
character.Effects.Remove(effect);
@ -595,6 +590,18 @@ namespace Milimoe.FunGame.Core.Model
effect.OnTimeElapsed(character, timeToReduce);
}
if (effect.IsBeingTemporaryDispelled)
{
effect.IsBeingTemporaryDispelled = false;
effect.OnEffectGained(character);
}
// 如果特效具备临时驱散或者持续性驱散的功能
if (effect.Source != null && (effect.EffectType == EffectType.WeakDispelling || effect.EffectType == EffectType.StrongDispelling))
{
effect.Dispel(effect.Source, character, IsTeammate(character, effect.Source));
}
// 自身被动不会考虑
if (effect.EffectType == EffectType.None && effect.Skill.SkillType == SkillType.Passive)
{
@ -1179,10 +1186,13 @@ namespace Milimoe.FunGame.Core.Model
await OnQueueUpdatedAsync(_queue, character, newHardnessTime, QueueUpdatedReason.Action, "设置角色行动后的硬直时间。");
LastRound.HardnessTime = newHardnessTime;
effects = [.. character.Effects.Where(e => e.IsInEffect)];
effects = [.. character.Effects];
foreach (Effect effect in effects)
{
effect.OnTurnEnd(character);
if (effect.IsInEffect)
{
effect.OnTurnEnd(character);
}
// 自身被动不会考虑
if (effect.EffectType == EffectType.None && effect.Skill.SkillType == SkillType.Passive)
@ -1410,7 +1420,7 @@ namespace Milimoe.FunGame.Core.Model
effects = [.. characters.SelectMany(c => c.Effects.Where(e => e.IsInEffect)).Distinct()];
foreach (Effect effect in effects)
{
if (!effect.BeforeShieldCalculation(actor, enemy, isMagicDamage, magicType, damage, shield, ref shieldMsg))
if (!effect.BeforeShieldCalculation(enemy, actor, isMagicDamage, magicType, damage, shield, ref shieldMsg))
{
change = true;
}
@ -1428,7 +1438,7 @@ namespace Milimoe.FunGame.Core.Model
effects = [.. characters.SelectMany(c => c.Effects.Where(e => e.IsInEffect)).Distinct()];
foreach (Effect effect in effects)
{
if (!effect.OnShieldBroken(actor, enemy, isMagicDamage, magicType, damage, shield, remain))
if (!effect.OnShieldBroken(enemy, actor, isMagicDamage, magicType, damage, shield, remain))
{
change = true;
}
@ -2035,7 +2045,10 @@ namespace Milimoe.FunGame.Core.Model
effects = [.. characters.SelectMany(c => c.Effects.Where(e => e.IsInEffect)).Distinct()];
foreach (Effect effect in effects)
{
checkEvade = effect.BeforeEvadeCheck(actor, enemy, ref throwingBonus);
if (!effect.BeforeEvadeCheck(actor, enemy, ref throwingBonus))
{
checkEvade = false;
}
}
if (checkEvade)
@ -2075,7 +2088,10 @@ namespace Milimoe.FunGame.Core.Model
effects = [.. characters.SelectMany(c => c.Effects.Where(e => e.IsInEffect)).Distinct()];
foreach (Effect effect in effects)
{
checkCritical = effect.BeforeCriticalCheck(actor, enemy, ref throwingBonus);
if (!effect.BeforeCriticalCheck(actor, enemy, ref throwingBonus))
{
checkCritical = false;
}
}
if (checkCritical)
@ -2145,7 +2161,10 @@ namespace Milimoe.FunGame.Core.Model
effects = [.. characters.SelectMany(c => c.Effects.Where(e => e.IsInEffect)).Distinct()];
foreach (Effect effect in effects)
{
checkEvade = effect.BeforeEvadeCheck(actor, enemy, ref throwingBonus);
if (!effect.BeforeEvadeCheck(actor, enemy, ref throwingBonus))
{
checkEvade = false;
}
}
if (checkEvade)
@ -2184,7 +2203,10 @@ namespace Milimoe.FunGame.Core.Model
effects = [.. characters.SelectMany(c => c.Effects.Where(e => e.IsInEffect)).Distinct()];
foreach (Effect effect in effects)
{
checkCritical = effect.BeforeCriticalCheck(actor, enemy, ref throwingBonus);
if (!effect.BeforeCriticalCheck(actor, enemy, ref throwingBonus))
{
checkCritical = false;
}
}
if (checkCritical)
@ -2218,6 +2240,35 @@ namespace Milimoe.FunGame.Core.Model
return Math.Min((a + Random.Shared.Next(30)) * b, max);
}
/// <summary>
/// 判断目标对于某个角色是否是队友
/// </summary>
/// <param name="character"></param>
/// <param name="target"></param>
/// <returns></returns>
public bool IsTeammate(Character character, Character target)
{
List<Character> teammates = GetTeammates(character);
return teammates.Contains(target);
}
/// <summary>
/// 获取目标对于某个角色是否是友方的字典
/// </summary>
/// <param name="character"></param>
/// <param name="targets"></param>
/// <returns></returns>
public Dictionary<Character, bool> GetIsTeammateDictionary(Character character, params IEnumerable<Character> targets)
{
Dictionary<Character, bool> dict = [];
List<Character> teammates = GetTeammates(character);
foreach (Character target in targets)
{
dict[target] = teammates.Contains(target);
}
return dict;
}
#endregion
#region 回合奖励

3
Model/MixGamingQueue.cs
View File

@ -3,6 +3,9 @@ using Milimoe.FunGame.Core.Library.Constant;
namespace Milimoe.FunGame.Core.Model
{
/// <summary>
/// 混战游戏队列，增强版混战模式 <see cref="RoomType.Mix"/>
/// </summary>
public class MixGamingQueue : GamingQueue
{
/// <summary>

3
Model/TeamGamingQueue.cs
View File

@ -3,6 +3,9 @@ using Milimoe.FunGame.Core.Library.Constant;
namespace Milimoe.FunGame.Core.Model
{
/// <summary>
/// 团队游戏队列，团队模式 <see cref="RoomType.Team"/>
/// </summary>
public class TeamGamingQueue : GamingQueue
{
/// <summary>

2
README.md
View File

@ -36,6 +36,8 @@ git clone -b latest https://github.com/project-redbud/FunGame-Core.git
我们维护了一份 API 文档，如有需要请随时查阅：[FunGame 开发文档](https://project-redbud.github.io/)。
文档内容会随着本项目的更改而变化，但是我们不保证能够及时更新文档。
也欢迎查阅由 `DeepWiki` 提供的 AI 生成的文档：[DeepWiki 文档](https://deepwiki.com/project-redbud/FunGame-Core)，此 AI 工具从头到尾分析了整个项目的代码并组织为 Wiki 形式，方便开发者结合源代码来理解整个项目。
在使用本项目的过程中遇到任何问题，欢迎提交 [issues](https://github.com/project-redbud/FunGame-Core/issues)，我们会积极解决你的问题。
## 许可证