Голографические метки (MC 26.1.2)

Этот документ описывает систему парящих индикаторов количества и нативный рендеринг меток на клиентах без модов в Minecraft 26.1.2.

---

📊 Информационный блок функции

Свойство	Спецификация
Имя системы	Серверный провайдер голографических бирок
Стратегия рендеринга	Стандартные бирки имен ванильных сущностей (setCustomName / setCustomNameVisible)
Нужен клиентский мод?	Нет (на 100% рендерится ванильным клиентом)
Формат метки	<название_предмета> x<число> (напр. Алмаз x128, Дубовое бревно x500)
Правило порога	Отображается при $\text{count} > \text{maxStackSize}$ (напр. $> 64$ для булыжника)
Переключатель отображения	item_clumps:render_labels (по умолч.: true)

---

🏷️ Как парящие метки отображаются на ванильных клиентах

Item Clumps использует встроенный механизм отображения именных бирок сущностей:

                      ┌───────────────────────────────┐
                      │ Ground Item Stack Size Changes│
                      └───────────────┬───────────────┘
                                      │
                                      ▼
                      ┌───────────────────────────────┐
                      │  Is render_labels Enabled?    │
                      │  Does count > maxStackSize?   │
                      └───────────────┬───────────────┘
                                      │
                     ┌────────────────┴────────────────┐
                     │ (Yes)                           │ (No)
                     ▼                                 ▼
       ┌───────────────────────────┐     ┌───────────────────────────┐
       │ Set Entity Custom Name    │     │ Clear Entity Custom Name  │
       │ setCustomName(name xCount)│     │ setCustomName(null)       │
       │ setCustomNameVisible(true)│     │ setCustomNameVisible(false│
       └─────────────┬─────────────┘     └───────────────────────────┘
                     │
                     ▼
       ┌───────────────────────────┐
       │ SyncedEntityData Packet   │
       │ Sent to all nearby clients│
       └─────────────┬─────────────┘
                     │
                     ▼
       ┌───────────────────────────┐
       │ Vanilla Client Renders    │
       │ Clean Floating Name Tag!  │
       └───────────────────────────┘

---

💻 Исходный код реализации на Java

Из ItemEntityMixin.java в Minecraft 26.1.2:

private void item_clumps$updateVanillaNameTag() {
    if (this.level() == null || this.level().isClientSide()) return;
    ItemStack stack = this.getItem();
    if (stack.isEmpty()) {
        this.setCustomName(null);
        this.setCustomNameVisible(false);
        return;
    }

    int count = stack.getCount();
    int maxStack = stack.getMaxStackSize();
    if (DynamicGameRuleManager.getBoolean(this.level(), ItemClumpsFabric.RENDER_LABELS) && count > maxStack) {
        Component name = stack.getItemName().copy().append(" x" + count);
        if (!this.hasCustomName() || !this.getCustomName().getString().equals(name.getString())) {
            this.setCustomName(name);
            this.setCustomNameVisible(true);
        }
    } else {
        if (this.hasCustomName()) {
            this.setCustomName(null);
            this.setCustomNameVisible(false);
        }
    }
}

@Inject(method = "tick", at = @At("HEAD"))
private void item_clumps$onTick(CallbackInfo ci) {
    if (!this.level().isClientSide()) {
        this.item_clumps$updateVanillaNameTag();
    }
}

@Inject(method = "setItem", at = @At("TAIL"))
private void item_clumps$onSetItem(ItemStack itemStack, CallbackInfo ci) {
    if (!this.level().isClientSide()) {
        this.item_clumps$updateVanillaNameTag();
    }
}

---

🔗 Связанная документация (MC 26.1.2)

• 26.1.2 Механика мега-стаков
• 26.1.2 Справочник GameRules
• 26.1.2 Архитектура и Mixin