XP Orbs Added to ItemESP and ItemHandler

Author: cev-api

README.md

@@ -297,6 +297,7 @@ Because so many of these mods are entirely original, I plan to release some of t
 - Adjustable font scale setting (scales text and popup icon size).
 - Adjustable Popup HUD display offset X/Y
 - Respects ItemESP ignored list (optional) and provides link to edit the list.
+- Detects XP Orbs and shows the exact XP each orb will give
 
 ![Popup](https://i.imgur.com/W97borj.png)
 ![GUI](https://i.imgur.com/eunLgVr.png)
@@ -318,6 +319,7 @@ Highlights dropped, equipped, and framed items with powerful filters and customi
 - Robust parsing: lists accept unknown entries as keywords (safe parsing via `Identifier.tryParse`).  
 - Ignore list: using keywords or specific item names you can exclude items from being highlighted entirely.
 - Entity ignore: Can ignore other players, armor stands etc
+- Detects XP Orbs and allows for different coloring or disabling entirely.
 
 Examples:  
 - Highlight skulls → Item ID: `minecraft:player_head`, special color: magenta, outline-only ON.  

src/main/java/net/wurstclient/hacks/ItemEspHack.java

@@ -22,6 +22,7 @@
 import net.minecraft.world.entity.decoration.ArmorStand;
 import net.minecraft.world.entity.decoration.ItemFrame;
 import net.minecraft.world.entity.item.ItemEntity;
+import net.minecraft.world.entity.ExperienceOrb;
 import net.minecraft.world.entity.npc.Villager;
 import net.minecraft.world.entity.player.Player;
 import net.minecraft.world.item.Item;
@@ -55,6 +56,14 @@ private enum SpecialMode
 		QUERY
 	}
 
+	private enum XpMode
+	{
+		OFF,
+		NORMAL,
+		SPECIAL,
+		RAINBOW
+	}
+	
 	private static final int MAX_SPECIAL_TEXT_LENGTH = 256;
 	private final EspStyleSetting style = new EspStyleSetting();
 
@@ -122,6 +131,11 @@ private enum SpecialMode
 		new CheckboxSetting("Ignore villagers",
 			"Won't highlight equipped special items on villagers.", false);
 
+	// XP orb handling mode
+	private final net.wurstclient.settings.EnumSetting<XpMode> xpMode =
+		new net.wurstclient.settings.EnumSetting<>("XP orb mode",
+			XpMode.values(), XpMode.NORMAL);
+	
 	// New: include item frames holding special items
 	private final CheckboxSetting includeItemFrames =
 		new CheckboxSetting("Highlight frames with special",
@@ -134,6 +148,7 @@ private enum SpecialMode
 		false);
 
 	private final ArrayList<ItemEntity> items = new ArrayList<>();
+	private final ArrayList<ExperienceOrb> xpOrbs = new ArrayList<>();
 	// Above-ground filter
 	private final CheckboxSetting onlyAboveGround =
 		new CheckboxSetting("Above ground only",
@@ -164,6 +179,7 @@ public ItemEspHack()
 		addSetting(specialRainbow);
 		addSetting(specialColor);
 		addSetting(outlineOnly);
+		addSetting(xpMode);
 		// ignored items
 		addSetting(useIgnoredItems);
 		addSetting(ignoredList);
@@ -223,11 +239,16 @@ public boolean isIgnoredId(String id)
 	public void onUpdate()
 	{
 		items.clear();
+		xpOrbs.clear();
 		for(Entity entity : MC.level.entitiesForRendering())
-			if(entity instanceof ItemEntity)
-				items.add((ItemEntity)entity);
+		{
+			if(entity instanceof ItemEntity ie)
+				items.add(ie);
+			else if(entity instanceof ExperienceOrb xo)
+				xpOrbs.add(xo);
+		}
 		// update count for HUD (clamped to 999)
-		foundCount = Math.min(items.size(), 999);
+		foundCount = Math.min(items.size() + xpOrbs.size(), 999);
 	}
 
 	@Override
@@ -324,12 +345,22 @@ public void onRender(PoseStack matrixStack, float partialTicks)
 			AABB box = EntityUtils.getLerpedBox(e, partialTicks)
 				.move(0, extraSize, 0).inflate(extraSize);
 			boolean isSpecial = isSpecial(stack);
-			// check traced override from ItemHandlerHack
-			String id =
-				BuiltInRegistries.ITEM.getKey(stack.getItem()).toString();
+			// check traced override from ItemHandlerHack (use synthetic id if
+			// present)
+			String id = net.wurstclient.util.ItemUtils.getStackId(stack);
 			net.wurstclient.hacks.itemhandler.ItemHandlerHack ih =
 				net.wurstclient.WurstClient.INSTANCE.getHax().itemHandlerHack;
-			boolean isTraced = ih != null && ih.isTraced(id);
+			boolean isTraced = false;
+			if(ih != null && id != null)
+			{
+				isTraced = ih.isTraced(id);
+				if(!isTraced
+					&& net.wurstclient.util.ItemUtils.isSyntheticXp(stack))
+				{
+					int xp = net.wurstclient.util.ItemUtils.getXpAmount(stack);
+					isTraced = ih.isTraced(id + ":xp:" + xp);
+				}
+			}
 			visibleDrops++;
 			if(isTraced)
 			{
@@ -350,6 +381,63 @@ public void onRender(PoseStack matrixStack, float partialTicks)
 		}
 		foundCount = Math.min(visibleDrops, 999);
 
+		// Integrate XP orbs into boxes/ends as synthetic items
+		for(ExperienceOrb orb : xpOrbs)
+		{
+			if(onlyAboveGround.isChecked()
+				&& orb.getY() < aboveGroundY.getValue())
+				continue;
+			// synthetic proxy stack for rendering and UI
+			net.minecraft.world.item.ItemStack stack =
+				net.wurstclient.util.ItemUtils.createSyntheticXpStack(orb);
+			if(isIgnored(stack))
+				continue;
+			Vec3 center =
+				EntityUtils.getLerpedBox(orb, partialTicks).getCenter();
+			AABB box = smallBoxAt(center);
+			// decide how to render XP orbs based on user setting and trace
+			XpMode mode = xpMode.getSelected();
+			if(mode == XpMode.OFF)
+				continue;
+			String id = "minecraft:experience_orb";
+			net.wurstclient.hacks.itemhandler.ItemHandlerHack ih =
+				net.wurstclient.WurstClient.INSTANCE.getHax().itemHandlerHack;
+			boolean isTraced = false;
+			if(ih != null)
+			{
+				isTraced = ih.isTraced(id);
+				int xp = net.wurstclient.util.ItemUtils.getXpAmount(stack);
+				if(!isTraced)
+					isTraced = ih.isTraced(id + ":xp:" + xp);
+			}
+			visibleDrops++;
+			if(isTraced)
+			{
+				tracedBoxes.add(box);
+				tracedEnds.add(center);
+			}else
+			{
+				switch(mode)
+				{
+					case RAINBOW ->
+					{
+						tracedBoxes.add(box);
+						tracedEnds.add(center);
+					}
+					case SPECIAL ->
+					{
+						specialBoxes.add(box);
+						specialEnds.add(center);
+					}
+					default ->
+					{
+						normalBoxes.add(box);
+						normalEnds.add(center);
+					}
+				}
+			}
+		}
+		
 		// Item frames holding special items
 		if(includeItemFrames.isChecked())
 		{
@@ -520,20 +608,28 @@ private boolean isIgnored(ItemStack stack)
 			return false;
 		if(ignoredExactIds == null || ignoredExactIds.isEmpty())
 			return false;
-		ResourceLocation id = BuiltInRegistries.ITEM.getKey(stack.getItem());
+		String id = net.wurstclient.util.ItemUtils.getStackId(stack);
 		if(id == null)
 			return false;
-		return ignoredExactIds.contains(id.toString());
+		if(ignoredExactIds != null && ignoredExactIds.contains(id))
+			return true;
+		// fallback: allow raw ignored list entries (useful for synthetic ids)
+		for(String s : ignoredList.getItemNames())
+			if(id.equalsIgnoreCase(s.trim()))
+				return true;
+		return false;
 	}
 
 	private boolean isSpecial(ItemStack stack)
 	{
 		Item item = stack.getItem();
+		String stackId = net.wurstclient.util.ItemUtils.getStackId(stack);
 		switch(specialMode.getSelected())
 		{
 			case LIST:
 			{
-				String id = BuiltInRegistries.ITEM.getKey(item).toString();
+				String id = stackId != null ? stackId
+					: BuiltInRegistries.ITEM.getKey(item).toString();
 				if(specialExactIds != null && specialExactIds.contains(id))
 					return true;
 				String localId =
@@ -554,7 +650,13 @@ private boolean isSpecial(ItemStack stack)
 				return false;
 			}
 			case ITEM_ID:
-			return itemMatchesId(item, specialItemId.getValue());
+			{
+				if(stackId != null && specialItemId.getValue() != null
+					&& stackId
+						.equalsIgnoreCase(specialItemId.getValue().trim()))
+					return true;
+				return itemMatchesId(item, specialItemId.getValue());
+			}
 			case QUERY:
 			return itemOrStackMatchesQuery(item, stack,
 				normalizeQuery(specialQuery.getValue()));
@@ -590,7 +692,9 @@ private boolean itemOrStackMatchesQuery(Item item, ItemStack stack,
 	{
 		if(normalizedQuery.isEmpty())
 			return false;
-		String fullId = BuiltInRegistries.ITEM.getKey(item).toString();
+		String stackId = net.wurstclient.util.ItemUtils.getStackId(stack);
+		String fullId = stackId != null ? stackId
+			: BuiltInRegistries.ITEM.getKey(item).toString();
 		String localId = fullId.contains(":")
 			? fullId.substring(fullId.indexOf(":") + 1) : fullId;
 		String localSpaced = localId.replace('_', ' ');