using System.Collections.Generic;
namespace WeaveLoader.API.Item;
///
/// Represents an item that has been registered with the game engine.
///
public class RegisteredItem
{
/// The namespaced string ID (e.g. "mymod:ruby").
public Identifier StringId { get; }
/// The numeric ID allocated by the engine.
public int NumericId { get; }
internal RegisteredItem(Identifier id, int numericId)
{
StringId = id;
NumericId = numericId;
}
}
///
/// Item registration via the WeaveLoader registry.
/// Accessed through .
///
public static class ItemRegistry
{
private static readonly object s_lock = new();
private static readonly Dictionary s_idByNumeric = new();
///
/// Register a new item with the game engine.
///
/// Namespaced identifier (e.g. "mymod:ruby").
/// Item properties built with .
/// A handle to the registered item.
public static RegisteredItem Register(Identifier id, ItemProperties properties)
{
return RegisterInternal(id, properties, null);
}
///
/// Register a managed custom item implementation.
///
/// Namespaced identifier (e.g. "mymod:ruby_pickaxe").
/// Managed item instance that can override callbacks.
/// Item properties built with .
/// A handle to the registered item.
public static RegisteredItem Register(Identifier id, Item item, ItemProperties properties)
{
return RegisterInternal(id, properties, item);
}
private static RegisteredItem RegisterInternal(Identifier id, ItemProperties properties, Item? managedItem)
{
int numericId;
if (managedItem is PickaxeItem pickaxeItem)
{
numericId = NativeInterop.native_register_pickaxe_item(
id.ToString(),
(int)pickaxeItem.Tier,
properties.MaxDamageValue,
properties.IconValue,
properties.NameValue ?? "");
}
else
{
numericId = NativeInterop.native_register_item(
id.ToString(),
properties.MaxStackSizeValue,
properties.MaxDamageValue,
properties.IconValue,
properties.NameValue ?? "");
}
if (numericId < 0)
throw new InvalidOperationException($"Failed to register item '{id}'. No free IDs or invalid parameters.");
if (properties.CreativeTabValue != CreativeTab.None)
{
NativeInterop.native_add_to_creative(numericId, 1, 0, (int)properties.CreativeTabValue);
Logger.Debug($"Item '{id}' added to creative tab {properties.CreativeTabValue}");
}
if (managedItem != null)
{
ManagedItemDispatcher.RegisterItem(id, numericId, managedItem);
Logger.Debug($"Managed item dispatcher mapped '{id}' -> numeric ID {numericId} ({managedItem.GetType().FullName})");
}
Logger.Debug($"Registered item '{id}' -> numeric ID {numericId}");
lock (s_lock)
{
s_idByNumeric[numericId] = id;
}
return new RegisteredItem(id, numericId);
}
internal static bool TryGetIdentifier(int numericId, out Identifier id)
{
lock (s_lock)
{
return s_idByNumeric.TryGetValue(numericId, out id);
}
}
}