93 lines
3.5 KiB
C#
93 lines
3.5 KiB
C#
using System.Collections.Generic;
|
||
|
||
using ColdMint.scripts.debug;
|
||
using ColdMint.scripts.utils;
|
||
|
||
using Godot;
|
||
|
||
using YamlDotNet.Serialization;
|
||
using YamlDotNet.Serialization.NamingConventions;
|
||
|
||
namespace ColdMint.scripts.item;
|
||
|
||
/// <summary>
|
||
/// <para>Item manager</para>
|
||
/// <para>物品管理器</para>
|
||
/// </summary>
|
||
public static class ItemTypeManager
|
||
{
|
||
/// <summary>
|
||
/// <para>Register items here</para>
|
||
/// <para>在这里注册物品</para>
|
||
/// </summary>
|
||
public static void StaticRegister() { }
|
||
|
||
private static Dictionary<string, ItemType> Registry { get; } = [];
|
||
private static Texture2D DefaultTexture { get; } = new PlaceholderTexture2D();
|
||
|
||
|
||
/// <summary>
|
||
/// <para>Register an item type.</para>
|
||
/// <para>Return false if the item id already exist.</para>
|
||
/// <para>注册一个物品类型</para>
|
||
/// <para>如果项目id已经存在，则返回false。</para>
|
||
/// </summary>
|
||
/// <returns><para>Whether the registration was successful.</para>
|
||
/// <para>注册是否成功。</para>
|
||
/// </returns>
|
||
public static bool Register(ItemType itemType) => Registry.TryAdd(itemType.Id, itemType);
|
||
|
||
/// <summary>
|
||
/// <para>Creates a new instance of the item registered to the given id.</para>
|
||
/// <para>创建给定物品id的新物品实例</para>
|
||
/// </summary>
|
||
/// <returns>
|
||
/// <para>Returns null when the id is not registered.</para>
|
||
/// <para>当物品id没有注册时返回null</para>
|
||
/// </returns>
|
||
public static IItem? NewItem(string id) =>
|
||
Registry.TryGetValue(id, out var itemType) ? itemType.NewItemFunc() : null;
|
||
|
||
/// <summary>
|
||
/// <para>Get the translated default name of the item type for the given id</para>
|
||
/// <para>获取指定物品id翻译后的物品名</para>
|
||
/// </summary>
|
||
/// <returns>
|
||
/// Translated default name of the item id if it exists. Else, return the id itself
|
||
/// </returns>
|
||
public static string DefaultNameOf(string id) => TranslationServerUtils.Translate($"item_{id}") ?? id;
|
||
|
||
/// <summary>
|
||
/// <para>Get the translated default description of the item type for the given id</para>
|
||
/// <para>获取指定物品id翻译后的描述</para>
|
||
/// </summary>
|
||
/// <returns>
|
||
/// Translated default description of the item id if it exists. Else, return null
|
||
/// </returns>
|
||
public static string? DefaultDescriptionOf(string id) => TranslationServerUtils.Translate($"item_{id}_desc");
|
||
|
||
/// <summary>
|
||
/// <para>Get the default icon of the item type for the given id</para>
|
||
/// <para>获取指定物品id的默认图标</para>
|
||
/// </summary>
|
||
/// <returns>
|
||
/// <para>Default icon of the item id if it exists. Else, return a <see cref="PlaceholderTexture2D"/></para>
|
||
/// <para>当前物品id的默认图标，若无则返回一个<see cref="PlaceholderTexture2D"/></para>
|
||
/// </returns>
|
||
public static Texture2D DefaultIconOf(string id) =>
|
||
Registry.TryGetValue(id, out var itemType)
|
||
? itemType.Icon ?? DefaultTexture
|
||
: DefaultTexture;
|
||
|
||
/// <summary>
|
||
/// <para>Gets the maximum number of stacks for an item</para>
|
||
/// <para>获取某个物品的最大堆叠数量</para>
|
||
/// </summary>
|
||
/// <param name="id">
|
||
///<para>id</para>
|
||
///<para>物品ID</para>
|
||
/// </param>
|
||
/// <returns></returns>
|
||
public static int MaxStackQuantityOf(string id) =>
|
||
Registry.TryGetValue(id, out var itemType) ? itemType.MaxStackQuantity : 0;
|
||
} |