ru_ru Architecture and Mixins

Архитектура пакетов и миксины

В этом техническом справочнике подробно описана иерархия пакетов, структура исходного кода и точки внедрения миксинов.

---

📊 Package Architecture Diagram

net.vanillaoutsider.speedometer
├── SpeedometerMod.java               <-- Constants & Identifier definitions
├── client
│   ├── SpeedometerClient.java        <-- ClientModInitializer entrypoint
│   ├── DebugEntrySpeedometer.java     <-- Custom DebugScreenEntry implementation
│   └── DebugEntryPlayerSpeedWrapper.java <-- Interceptor spy-wrapper for player_speed
└── mixin
    ├── DebugScreenEntriesMixin.java   <-- Hooks into DebugScreenEntries static init
    └── DebugScreenEntryListMixin.java <-- Enforces default IN_OVERLAY status

---

🧩 Mixin Target Breakdown Table

Mixin Class	Target Minecraft Class	Target Method / Point	Injection Type	Purpose
DebugScreenEntriesMixin	net.minecraft.client.gui.components.debug.DebugScreenEntries	<clinit> @At("TAIL")	@Inject	Registers speedometer entry ID and wraps native player_speed entry if present.
DebugScreenEntriesMixin	net.minecraft.client.gui.components.debug.DebugScreenEntries	register	@Invoker	Invokes private vanilla register(Identifier, DebugScreenEntry) method.
DebugScreenEntryListMixin	net.minecraft.client.gui.components.debug.DebugScreenEntryList	rebuildCurrentList @At("HEAD")	@Inject	Ensures speedometer status defaults to DebugScreenEntryStatus.IN_OVERLAY.

---

🔒 Thread Safety & Non-Blocking Guarantee

• All Mixin injections execute exclusively on Minecraft's Client Render Thread.
• Non-blocking implementation with zero locks guarantees zero frame drops ($<0.001\text{ ms}$).

---

🔗 Связанные страницы

• Настройка окружения и сборка
• API и интеграция аддонов
• Архитектура с нулевыми зависимостями