1
0
mirror of https://github.com/ppy/osu.git synced 2024-12-16 21:02:55 +08:00
osu-lazer/osu.Game/Rulesets/Mods/Mod.cs

83 lines
2.4 KiB
C#
Raw Normal View History

// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
// See the LICENCE file in the repository root for full licence text.
2018-04-13 17:19:50 +08:00
using System;
2018-11-28 12:12:29 +08:00
using Newtonsoft.Json;
using osu.Framework.Graphics.Sprites;
2018-11-28 12:12:29 +08:00
using osu.Game.IO.Serialization;
2018-04-13 17:19:50 +08:00
namespace osu.Game.Rulesets.Mods
{
/// <summary>
/// The base class for gameplay modifiers.
/// </summary>
public abstract class Mod : IMod, IJsonSerializable
2018-04-13 17:19:50 +08:00
{
/// <summary>
/// The name of this mod.
/// </summary>
2018-11-28 12:12:29 +08:00
[JsonIgnore]
2018-04-13 17:19:50 +08:00
public abstract string Name { get; }
/// <summary>
/// The shortened name of this mod.
/// </summary>
public abstract string Acronym { get; }
2018-04-13 17:19:50 +08:00
/// <summary>
/// The icon of this mod.
/// </summary>
2018-11-28 12:12:29 +08:00
[JsonIgnore]
2020-01-14 21:22:00 +08:00
public virtual IconUsage? Icon => null;
2018-04-13 17:19:50 +08:00
/// <summary>
/// The type of this mod.
/// </summary>
2018-11-28 12:12:29 +08:00
[JsonIgnore]
public virtual ModType Type => ModType.Fun;
2018-04-13 17:19:50 +08:00
/// <summary>
/// The user readable description of this mod.
/// </summary>
2018-11-28 12:12:29 +08:00
[JsonIgnore]
2018-04-13 17:19:50 +08:00
public virtual string Description => string.Empty;
/// <summary>
/// The score multiplier of this mod.
/// </summary>
2018-11-28 12:12:29 +08:00
[JsonIgnore]
2018-04-13 17:19:50 +08:00
public abstract double ScoreMultiplier { get; }
/// <summary>
/// Returns true if this mod is implemented (and playable).
/// </summary>
2018-11-28 12:12:29 +08:00
[JsonIgnore]
2018-04-13 17:19:50 +08:00
public virtual bool HasImplementation => this is IApplicableMod;
/// <summary>
/// Returns if this mod is ranked.
/// </summary>
2018-11-28 12:12:29 +08:00
[JsonIgnore]
2018-04-13 17:19:50 +08:00
public virtual bool Ranked => false;
/// <summary>
/// Whether this mod requires configuration to apply changes to the game.
/// </summary>
[JsonIgnore]
public virtual bool RequiresConfiguration => false;
2018-04-13 17:19:50 +08:00
/// <summary>
/// The mods this mod cannot be enabled with.
/// </summary>
2018-11-28 12:12:29 +08:00
[JsonIgnore]
2019-11-28 21:41:29 +08:00
public virtual Type[] IncompatibleMods => Array.Empty<Type>();
/// <summary>
/// Creates a copy of this <see cref="Mod"/> initialised to a default state.
/// </summary>
public virtual Mod CreateCopy() => (Mod)MemberwiseClone();
public bool Equals(IMod other) => GetType() == other?.GetType();
2018-04-13 17:19:50 +08:00
}
}