Add command to get reliquary with specific props (#300)

src/main/java/emu/grasscutter/command/commands/GiveArtifactCommand.java

@@ -0,0 +1,88 @@
+package emu.grasscutter.command.commands;
+
+import emu.grasscutter.Grasscutter;
+import emu.grasscutter.command.Command;
+import emu.grasscutter.command.CommandHandler;
+import emu.grasscutter.data.GameData;
+import emu.grasscutter.data.def.ItemData;
+import emu.grasscutter.game.inventory.GameItem;
+import emu.grasscutter.game.inventory.ItemType;
+import emu.grasscutter.game.player.Player;
+import emu.grasscutter.game.props.ActionReason;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+@Command(label = "giveart", usage = "giveart [player] <artifactId> <mainPropId> [<appendPropId>[,<times>]]... [level]", description = "Gives the player a specified reliquary", aliases = {"givea"}, permission = "player.giveart")
+public final class GiveArtifactCommand implements CommandHandler {
+	@Override
+	public void execute(Player sender, List<String> args) {
+		int size = args.size(), target, itemId, mainPropId, level;
+		ArrayList<Integer> appendPropIdList = new ArrayList<>();
+		String msg = "Usage: giveart|givea [player] <artifactId> <mainPropId> [<appendPropId>[,<times>]]... [level]";
+
+		if (sender == null && size < 2) {
+			CommandHandler.sendMessage(null, msg);
+			return;
+		}
+
+		if (size >= 2) {
+			try {
+				level = Integer.parseInt(args.get(size - 1));
+				if (level <= 21) size--;
+				else level = 1;
+				target = Integer.parseInt(args.get(0));
+				int fromIdx;
+				if (Grasscutter.getGameServer().getPlayerByUid(target) == null && sender != null) {
+					target = sender.getUid();
+					itemId = Integer.parseInt(args.get(0));
+					mainPropId = Integer.parseInt(args.get(1));
+					fromIdx = 2;
+				} else {
+					target = Integer.parseInt(args.get(0));
+					itemId = Integer.parseInt(args.get(1));
+					mainPropId = Integer.parseInt(args.get(2));
+					fromIdx = 3;
+				}
+				args.subList(fromIdx, size).forEach(it -> {
+					String[] arr;
+					int n = 1;
+					if ((arr = it.split(",")).length == 2) {
+						it = arr[0];
+						n = Integer.parseInt(arr[1]);
+					}
+					appendPropIdList.addAll(Collections.nCopies(n, Integer.parseInt(it)));
+				});
+			} catch (Exception ignored) {
+				CommandHandler.sendMessage(sender, msg);
+				return;
+			}
+		} else {
+			CommandHandler.sendMessage(sender, msg);
+			return;
+		}
+
+		Player targetPlayer = Grasscutter.getGameServer().getPlayerByUid(target);
+		if (targetPlayer == null) {
+			CommandHandler.sendMessage(sender, "Player not found.");
+			return;
+		}
+
+		ItemData itemData = GameData.getItemDataMap().get(itemId);
+
+		if (itemData.getItemType() != ItemType.ITEM_RELIQUARY) {
+			CommandHandler.sendMessage(sender, "Invalid artifact ID.");
+			return;
+		}
+
+		GameItem item = new GameItem(itemData);
+		item.setLevel(level);
+		item.setMainPropId(mainPropId);
+		item.getAppendPropIdList().addAll(appendPropIdList);
+		targetPlayer.getInventory().addItem(item, ActionReason.SubfieldDrop);
+
+		CommandHandler.sendMessage(sender, String.format("Given %s to %s.", itemId, target));
+	}
+}
+

src/main/java/emu/grasscutter/game/inventory/GameItem.java

@@ -244,6 +244,10 @@ public class GameItem {
 		return mainPropId;
 	}
 
+	public void setMainPropId(int mainPropId) {
+		this.mainPropId = mainPropId;
+	}
+
 	public List<Integer> getAppendPropIdList() {
 		return appendPropIdList;
 	}