mmb.engine.item.Items Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of multimachinebuilder Show documentation
Dependency for the MultiMachineBuilder, a voxel game about building an industrial empire in a finite world. THIS RELEASE IS NOT PLAYABLE. To play the game, donwload from >ITCH.IO LINK HERE< or >GH releases link here<
The newest version!
/**
 * 
 */
package mmb.engine.item;

import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.Objects;

import com.google.common.collect.HashMultimap;
import com.google.common.collect.Multimaps;
import com.google.common.collect.SetMultimap;

import mmb.GameLoader;
import mmb.NN;
import mmb.Nil;
import mmb.engine.debug.Debugger;
import monniasza.collects.Collects;
import monniasza.collects.selfset.HashSelfSet;
import monniasza.collects.selfset.SelfSet;

/**
 * A set of item utilities
 * @author oskar
 */
public class Items {
	private Items() {}
	private static Debugger debug = new Debugger("ITEMS");
	
	//Registration
	@NN private static final SelfSet     _items =      HashSelfSet.createNonnull(ItemType.class);
	/**
	 * String to item lookup.
	 * Deprecation is not supported.
	 * To find deprecated items, use {@link #get(String)}
	 */
	@NN public  static final SelfSet      items =      Collects.unmodifiableSelfSet(_items);	
	/**
	 * Registers a new item type
	 * @param type item type to register
	 * @throws NullPointerException when the item or it's ID is null
	 */
	public static void register(ItemType type) {
		Objects.requireNonNull(type, "The item must not be null");
		Objects.requireNonNull(type.id(), "The item's ID must not be null");
		debug.printl("Adding "+type.id()+" with title "+type.title()+" and description:\n "+type.description());
		_items.add(type);
		if(type instanceof ItemEntityType) 
			GameLoader.onIntegRun(() -> ItemRaw.make((ItemEntityType) type)); //ignore the result, all the magic is in the ItemRaw
		type.onregister();
	}
	
	//Deprecation
	@NN private static final Map    _deprecator = new HashMap<>();
	/** A map from deprecated IDs to items. Used to keep compatibility with older versions after renaming */
	@NN public  static final Map     deprecator = Collections.unmodifiableMap(_deprecator);
	/**
	 * @param deprecated the deprecated ID of an item
	 * @param type item type to be deprecated
	 * @throws IllegalStateException if item is not already registered before deprecation
	 */
	public static void deprecate(String deprecated, ItemType type) {
		if(!items.contains(type)) throw new IllegalStateException("Item type "+type+" is not registered before deprecation");
		debug.printl("Deprecating "+type.id()+" as "+deprecated);
		_deprecator.put(deprecated, type);
	}
	
	//Retrieval
	/**
	 * Get an item with following ID, or null if block with given ID is not found
	 * @param name item ID
	 * @return an item with given name, or null if not found
	 */
	@Nil public static ItemType get(@Nil String name) {
		if(name == null) return null;		
		ItemType get = items.get(name);
		if(get == null) get = deprecator.get(name);
		return get;
	}
	/**
	 * Get an item with following ID with type restrictions, or null if block with given ID is not found
	 * @param  generic restriction type
	 * @param name item ID
	 * @param cls item type restriction
	 * @return an item with given name, or null if not found
	 */
	@Nil public static  T getExpectType(@Nil String name, Class cls) {
		ItemType item = get(name);
		if(cls.isInstance(item)) return cls.cast(item);
		return null;
	}

	//Tags
	@NN private static final HashMultimap _tags = HashMultimap.create();
	/** Tag to items lookup */
	@NN public  static final SetMultimap  tags = Multimaps.unmodifiableSetMultimap(_tags);
	@NN private static final HashMultimap _btags = HashMultimap.create();
	/** Item to tags lookup */
	@NN public  static final SetMultimap  btags = Multimaps.unmodifiableSetMultimap(_btags);
	/**
	 * Tags a single item
	 * @param tag item tag
	 * @param item item to be tagged
	 */
	public static void tagItem(String tag, ItemType item) {
		debug.printl("Tagging "+item+" with "+tag);
		_tags.put(tag, item);
		_btags.put(item, tag);
	}
	/**
	 * Tags a single ite with mutiple tags
	 * @param item item to be tagged
	 * @param tags1 item tags
	 */
	public static void tagsItem(ItemType item, String... tags1) {
		tagsItem(item, Arrays.asList(tags1));
	}
	/**
	 * Tags a single ite with mutiple tags
	 * @param item item to be tagged
	 * @param tags1 item tags
	 */
	public static void tagsItem(ItemType item, Iterable<@NN String> tags1) {
		for(String tag: tags1) {
			tagItem(tag, item);
		}
	}
	/**
	 * Tags mutiple items with one tag
	 * @param tag item tags
	 * @param items1 items to be tagged
	 */
	public static void tagItems(String tag, ItemType... items1) {
		tagItems(tag, Arrays.asList(items1));
	}
	/**
	 * Tags each item with all given tags
	 * @param tag item tags
	 * @param items1 items to be tagged
	 */
	public static void tagsItems(String[] tag, ItemType... items1) {
		tagsItems(tag, Arrays.asList(items1));
	}
	/**
	 * Tags mutiple items with one tag
	 * @param tag item tags
	 * @param items1 items to be tagged
	 */
	public static void tagItems(String tag, Iterable<@NN ? extends ItemType> items1) {
		for(ItemType item: items1) {
			tagItem(tag, item);
		}
	}
	/**
	 * Tags each item with all given tags
	 * @param tag item tags
	 * @param items1 items to be tagged
	 */
	public static void tagsItems(String[] tag, Iterable<@NN ? extends ItemType> items1) {
		for(ItemType item: items1) {
			tagsItem(item, tag);
		}
	}

}