Version: v2.3.3 Compatibility: Minecraft 1.20.1 + Forge 47.x + Embeddium 0.3.31 (optional) Target: AMD GPU (RDNA/GCN4+), but works on any card with OpenGL 4.4+ (4.6 preferred)
Amdium is a mod that replaces dozens/hundreds of chunk draw calls with a single Multi-Draw Indirect (MDI) call, plus GPU-side frustum/fog/Hi-Z occlusion culling via a compute shader. The architecture is copied from Nvidium, but adapted for AMD specifics (wavefront 64, ARB_indirect_parameters, persistent mapping).
It works in two modes:
- vanilla MDI — if Embeddium is NOT installed. Intercepts the vanilla chunk renderer.
- Embeddium interop — if Embeddium is installed. Intercepts its
multiDrawElementsBaseVertexand replaces it with MDI + per-command GPU culling.
| # | Optimization | File | Effect |
|---|---|---|---|
| A1 | Cache block atlas size (updated once per second instead of 8× per frame) | LevelRendererMixin.java |
removed 4-8 ms sync from glGetTexLevelParameteri |
| A2 | Cache uniform locations in Hi-Z copy pass + removed glClear |
HiZDepthPyramid.java |
removed 2 sync queries per frame |
| A3 | glClearNamedBufferSubData for atomic counter reset (instead of glBufferSubData) |
InteropComputeCuller.java, AmdiumComputeCuller.java |
removed 40-80 sync points per frame |
| A4 | RingStreamBuffer for per-frame SSBO uploads (instead of glBufferSubData) |
RingStreamBuffer.java (new) |
removed 80-160 sync points per frame |
| A5 | Removed glFlushMappedNamedBufferRange on coherent mapping |
PersistentStagingBuffer.java |
removed an extra driver call on every chunk upload |
| A6 | Ring of 3 output + counter buffers (instead of one) | InteropComputeCuller.java |
removed pipeline serialization between frames |
| # | Feature | File |
|---|---|---|
| B1 | F3 overlay shows Amdium status (active/inactive, mode, caps) | AmdiumDebugOverlay.java (new) |
| B2 | F3 overlay shows ring stream status (OK/fallback) + Hi-Z status | AmdiumDebugOverlay.java |
| B3 | F3 overlay shows culled/total (% + frame lag) — non-blocking readback | InteropComputeCuller.maybeCaptureDebugStats() |
| B4 | F3 overlay shows path B fallback counter (if > 0 — culling is failing) | EmbediumInterop.pathBFramesInLastSecond() |
B3 — ARCHITECTURALLY IMPORTANT: culled-stats readback is completely disabled when F3 is closed
(first line of the method is if (!renderDebug) return). When F3 is open — a
non-blocking pattern is used: glCopyNamedBufferSubData (GPU-side copy) + glFenceSync +
glClientWaitSync(timeout=0). If the fence isn't ready — the old value is shown, no waiting.
This guarantees that the zero-readback pipeline is NOT broken for the sake of a nice number in F3.
| # | Optimization | File |
|---|---|---|
| C1 | Per-slot fences instead of a shared FIFO GlFence queue |
RingStreamBuffer.java |
| C2 | GlFence.waitSingle() — public static method to wait on a specific fence |
GlFence.java |
Problem in v2.3.0: beginFrame() called fences.waitOldest() unconditionally every frame.
With RING_SIZE=3, already by frame 2 this waited on frame 1's fence before writing to slot 1,
which had never actually been used. Real CPU/GPU overlap was limited to ~1 frame
instead of the intended 3.
Fix in v2.3.1: each slot has its own fence. beginFrame() waits ONLY on
the current slot's fence, and ONLY if it's non-zero (the slot has already been used). For the first
RING_SIZE frames there's no waiting at all.
| # | Optimization | File |
|---|---|---|
| D1 | glBindBuffersBase (one GL call instead of 4× glBindBufferBase) for SSBO bindings |
InteropComputeCuller.java, AmdiumComputeCuller.java |
4 SSBO binds → 1 multi-bind call. Saves on driver overhead on every dispatch.
| # | Feature | File |
|---|---|---|
| E1 | AmdiumConfig.INTEROP_WORKGROUP_SIZE (32-256, default 64) |
AmdiumConfig.java |
| E2 | String substitution of local_size_x before glShaderSource |
InteropComputeCuller.compileAndLinkProgram() |
| E3 | refreshConfig() — recompiles the program when workgroup size changes + rollback on error |
InteropComputeCuller.refreshConfig() |
Allows A/B testing of workgroup size (32 for NVIDIA warp, 64 for AMD wavefront) without recompiling the mod. If the new value fails to compile — automatic rollback.
| # | Optimization | File |
|---|---|---|
| F1 | Compute shader builds 2 mip levels per dispatch via shared-memory reduction | hiz_build.comp.glsl |
| F2 | Dispatch loop with step 2 (10-11 dispatch+barrier pairs → 5-6) | HiZDepthPyramid.java |
| F3 | u_BuildSecondMip uniform for the edge case (last level) |
hiz_build.comp.glsl |
Why not full FidelityFX SPD? Classic SPD requires binding all mip levels
(8-13 image bindings), but GL_MAX_IMAGE_UNITS = 8 on some AMD cards. The compromise is 2 mips
per dispatch (3 image bindings), which fits within the limit. Full SPD — only after an
explicit runtime check of GL_MAX_IMAGE_UNITS (TODO for a future version).
| # | Feature | File |
|---|---|---|
| G1 | GPUCapabilityDetector.isAPU() — detects APUs (Radeon 660M/680M/780M, Vega 3-11, Intel iGPU, ARM Mali) |
GPUCapabilityDetector.java |
| G2 | getVertexPoolMBCap() — caps vertexPoolMB at 1024 MB on APUs |
GPUCapabilityDetector.java |
| G3 | Amdium.effectiveVertexPoolMB — static field, used in AmdiumVertexPool.init() |
Amdium.java, AmdiumVertexPool.java |
APUs share memory with system RAM — with vertexPoolMB=4096 (as for a discrete RD 32 card)
a Radeon 660M could crash the game with OOM. Now it's automatically capped at 1024 MB.
| # | Feature | File |
|---|---|---|
| H1 | Detailed comment for FRAMES_IN_FLIGHT (2 = min input lag, 3 = optimal, 4 = max smoothness) |
AmdiumConfig.java |
| H2 | Comment for MDI_VERTEX_POOL_MB about the APU auto-cap |
AmdiumConfig.java |
| H3 | Comment for INTEROP_WORKGROUP_SIZE about the AMD/NVIDIA difference |
AmdiumConfig.java |
┌─────────────────────────────────────────────────────────────┐
│ Minecraft 1.20.1 + Forge 47.x │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ Embedium 0.3.31 (optional) │ │
│ │ ┌──────────────────────────────────────────────────┐ │ │
│ │ │ Amdium v2.3.3 │ │ │
│ │ │ │ │ │
│ │ │ ┌──────────────────┐ ┌─────────────────────┐ │ │ │
│ │ │ │ Vanilla MDI path │ │ Embedium interop │ │ │ │
│ │ │ │ (if no Embed) │ │ (if Embed present) │ │ │ │
│ │ │ └────────┬─────────┘ └──────────┬──────────┘ │ │ │
│ │ │ │ │ │ │ │
│ │ │ ▼ ▼ │ │ │
│ │ │ ┌────────────────────────────────────────────┐ │ │ │
│ │ │ │ GPU compute culling (frustum + fog + Hi-Z) │ │ │ │
│ │ │ │ → glMultiDrawElementsIndirectCount │ │ │ │
│ │ │ │ (zero CPU readback) │ │ │ │
│ │ │ └────────────────────────────────────────────┘ │ │ │
│ │ └──────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Frame N:
1. CPU writes draw commands → inputBufferId (RingStreamBuffer, zero-sync)
2. CPU writes chunk AABBs → chunkInfoBufferId (RingStreamBuffer, zero-sync)
3. glClearNamedBufferSubData(counterBufId, 0) ← no CPU upload
4. glDispatchCompute(culler) ← GPU culls, writes compacted commands
5. glMemoryBarrier(SHADER_STORAGE | COMMAND)
6. glMultiDrawElementsIndirectCount(outBufId, counterBufId)
↑ GPU reads drawCount from counterBufId ITSELF — CPU is NOT involved!
Whole frame: 0 CPU↔GPU sync queries (except F3 debug, gated by renderDebug).
- JDK 17
- Forge 1.20.1 MDK (47.x)
- Embeddium 0.3.31 (compileOnly, optional at runtime)
# 1. Unpack amdium_fixed_v2.3.3.zip on top of the mod sources
# 2. Update gradle.properties: mod_version=2.3.3
# 3. Build
./gradlew build
# 4. The JAR will be in build/libs/amdium-2.3.3.jar
# 5. Place it in .minecraft/mods/Config file: .minecraft/config/amdium-client.toml
Discrete GPU (RTX 3060, RX 6000+):
[general.mdi]
vertexPoolMB = 1024 # 512 for RD 12, 4096 for RD 32
[general.buffers]
framesInFlight = 3 # optimal for most cases
[general.interop]
enableInteropComputeCulling = true
enableInteropFrustum = true
enableInteropFog = true
enableHiZOcclusion = true # killer feature
interopWorkgroupSize = 64 # 32 for NVIDIA, 64 for AMDAPU (Radeon 660M, Vega iGPU):
[general.mdi]
vertexPoolMB = 1024 # automatically capped at 1024 on APU
[general.buffers]
framesInFlight = 3 # APU is weaker, triple buffering helps
[general.interop]
enableHiZOcclusion = true # provides the main gain
interopWorkgroupSize = 64 # AMD wavefrontCompetitive (minimal latency):
[general.buffers]
framesInFlight = 2 # minimal input lag, but CPU may wait on GPUWhen F3 is opened, the following lines appear in the left panel:
[Amdium] active — Embeddium interop
caps: MDI=✓ Compute=✓ Persistent=✓ IndirectCount=✓
APU: yes, pool=1024 MB (capped)
ring=OK HiZ=OK wg=64 ring=3 maxCmd=4096
culled: 342/1024 (33%, lagging by 3 frame(s))
If culling occasionally fails:
⚠ path B fallback: 5 frame(s)/sec (culling is failing!)
Note: the culled stat uses non-blocking readback. When F3 is closed —
this path is completely disabled, the zero-readback pipeline is NOT broken.
| Category | Status | Version |
|---|---|---|
| A1-A6 Critical fixes | ✅ Done | v2.3.0 |
| B1-B4 F3 overlay | ✅ Done | v2.3.1 |
| C1-C2 RingStreamBuffer fix | ✅ Done | v2.3.1 |
| D1 Multi-bind | ✅ Done | v2.3.1 |
| E1-E3 Configurable workgroup | ✅ Done | v2.3.2 |
| F1-F3 Hi-Z 2 mips/dispatch | ✅ Done | v2.3.3 |
| G1-G3 APU safety | ✅ Done | v2.3.3 |
| H1-H3 UX tooltips | ✅ Done | v2.3.3 |
- Full FidelityFX SPD (after checking
GL_MAX_IMAGE_UNITS > 8at runtime) - Mesh shaders (EXT_mesh_shader on RDNA2+) — experimental, needs a separate path
- Sparse buffer (ARB_sparse_buffer) for lazy allocation of a large VBO
src/main/java/dev/amdium/gl/RingStreamBuffer.java(v2.3.0, updated v2.3.1)src/main/java/dev/amdium/debug/AmdiumDebugOverlay.java(v2.3.1)
src/main/java/dev/amdium/render/InteropComputeCuller.java(v2.3.0, 2.3.1, 2.3.2)src/main/java/dev/amdium/render/HiZDepthPyramid.java(v2.3.0, 2.3.3)src/main/java/dev/amdium/render/AmdiumComputeCuller.java(v2.3.0, 2.3.1)src/main/java/dev/amdium/render/AmdiumRenderer.java(v2.3.0)src/main/java/dev/amdium/render/EmbediumInterop.java(v2.3.0, 2.3.1)src/main/java/dev/amdium/mixin/LevelRendererMixin.java(v2.3.0)src/main/java/dev/amdium/gl/PersistentStagingBuffer.java(v2.3.0)src/main/java/dev/amdium/gl/GlFence.java(v2.3.1 — addedwaitSingle)src/main/java/dev/amdium/config/AmdiumConfig.java(v2.3.2, 2.3.3)src/main/java/dev/amdium/util/GPUCapabilityDetector.java(v2.3.3)src/main/java/dev/amdium/Amdium.java(v2.3.3)src/main/java/dev/amdium/render/AmdiumVertexPool.java(v2.3.3)src/main/resources/assets/amdium/shaders/core/hiz_build.comp.glsl(v2.3.0, 2.3.3)
src/main/java/dev/amdium/AmdiumConfigScreen.javasrc/main/java/dev/amdium/mixin/AmdiumMixinPlugin.javasrc/main/java/dev/amdium/mixin/ChunkShaderInterfaceMixin.javasrc/main/java/dev/amdium/mixin/EmbeddiumDrawCommandListMixin.javasrc/main/java/dev/amdium/mixin/MinecraftMixin.javasrc/main/java/dev/amdium/mixin/RenderChunkMixin.javasrc/main/java/dev/amdium/mixin/RenderRegionMixin.javasrc/main/java/dev/amdium/mixin/RenderSectionMixin.javasrc/main/java/dev/amdium/mixin/SectionRenderDataStorageMixin.javasrc/main/java/dev/amdium/mixin/VertexBufferMixin.javasrc/main/java/dev/amdium/render/AmdiumVertexPool.java(except v2.3.3 APU fix)src/main/java/dev/amdium/render/ChunkMetadataStore.javasrc/main/java/dev/amdium/render/MDIDrawCommandBuffer.javasrc/main/java/dev/amdium/render/PerCommandMetadata.javasrc/main/java/dev/amdium/render/SectionStorageBridge.javasrc/main/java/dev/amdium/util/IRenderChunkAccess.javasrc/main/java/dev/amdium/util/ReflectionUtil.javasrc/main/resources/assets/amdium/shaders/core/chunk_culling.comp.glslsrc/main/resources/assets/amdium/shaders/core/chunk_culling_v2.comp.glsl(used in v2.3.2 via substitution)src/main/resources/assets/amdium/shaders/core/chunk_culling_interop.comp.glslsrc/main/resources/assets/amdium/shaders/core/chunk_fragment.fshsrc/main/resources/assets/amdium/shaders/core/chunk_vertex.vshsrc/main/resources/META-INF/mods.tomlsrc/main/resources/amdium.mixins.jsonsrc/main/resources/pack.mcmetabuild.gradle,gradle.properties,settings.gradle
If something goes wrong:
- Restore the original files from the source archive
- The changes do NOT touch
mods.toml,amdium.mixins.json,build.gradle— the project structure is unchanged - All changes are backward compatible (new config options have defaults, fallback paths are preserved)
If you have problems, check the log for:
[Amdium] RingStreamBuffer (v2.3.1 per-slot fences): ... KB, 3 frames in flight— ring stream active[Amdium] InteropComputeCuller v2.3 ready. ... ringStream=enabled— interop culler with ring[Amdium] Hi-Z pyramid builder ready (v2.3.3 2-mip-per-dispatch)— Hi-Z active[Amdium] APU detected (...). vertexPoolMB capped at 1024 MB— APU cap triggered[Amdium] Fallback readback active— driver update needed (requires GL 4.6 / ARB_indirect_parameters)[Amdium] ⚠ path B fallback(in F3) — culling is failing, checkMAX_COMMANDS(4096)
Версия: v2.3.3 Совместимость: Minecraft 1.20.1 + Forge 47.x + Embeddium 0.3.31 (опционально) Цель: AMD GPU (RDNA/GCN4+), но работает на любой карте с OpenGL 4.4+ (лучше 4.6)
Amdium — это мод, который заменяет десятки/сотни draw-вызовов чанков на один Multi-Draw Indirect (MDI) вызов, плюс GPU-side frustum/fog/Hi-Z occlusion culling через compute shader. Архитектура скопирована с Nvidium, но адаптирована под специфику AMD (wavefront 64, ARB_indirect_parameters, persistent mapping).
Работает в двух режимах:
- vanilla MDI — если Embeddium НЕ установлен. Перехватывает vanilla chunk renderer.
- Embeddium interop — если Embeddium установлен. Перехватывает его
multiDrawElementsBaseVertexи заменяет на MDI + per-command GPU culling.
| # | Оптимизация | Файл | Эффект |
|---|---|---|---|
| A1 | Кэш размеров block atlas (обновление раз в секунду вместо 8× на кадр) | LevelRendererMixin.java |
убран 4-8 ms sync от glGetTexLevelParameteri |
| A2 | Кэш uniform locations в Hi-Z copy pass + убран glClear |
HiZDepthPyramid.java |
убрано 2 sync query на кадр |
| A3 | glClearNamedBufferSubData для atomic counter reset (вместо glBufferSubData) |
InteropComputeCuller.java, AmdiumComputeCuller.java |
убрано 40-80 точек синхронизации на кадр |
| A4 | RingStreamBuffer для per-frame SSBO uploads (вместо glBufferSubData) |
RingStreamBuffer.java (новый) |
убрано 80-160 точек синхронизации на кадр |
| A5 | Убран glFlushMappedNamedBufferRange на coherent mapping |
PersistentStagingBuffer.java |
убран лишний driver call на каждый chunk upload |
| A6 | Ring из 3 output + counter buffer'ов (вместо одного) | InteropComputeCuller.java |
убрана pipeline serialization между кадрами |
| # | Фича | Файл |
|---|---|---|
| B1 | F3 overlay показывает статус Amdium (active/inactive, режим, caps) | AmdiumDebugOverlay.java (новый) |
| B2 | F3 overlay показывает ring stream status (OK/fallback) + Hi-Z status | AmdiumDebugOverlay.java |
| B3 | F3 overlay показывает culled/total (% + frame lag) — non-blocking readback | InteropComputeCuller.maybeCaptureDebugStats() |
| B4 | F3 overlay показывает path B fallback counter (если > 0 — culling отваливается) | EmbediumInterop.pathBFramesInLastSecond() |
B3 — АРХИТЕКТУРНО ВАЖНО: readback culled stats полностью отключён, когда F3 закрыт
(первая строка метода — if (!renderDebug) return). Когда F3 открыт — используется
non-blocking pattern: glCopyNamedBufferSubData (GPU-side copy) + glFenceSync +
glClientWaitSync(timeout=0). Если fence не готов — показываем старое значение, НЕ ждём.
Это гарантирует, что zero-readback pipeline НЕ нарушается ради красивой циферки в F3.
| # | Оптимизация | Файл |
|---|---|---|
| C1 | Per-slot fences вместо общей FIFO-очереди GlFence |
RingStreamBuffer.java |
| C2 | GlFence.waitSingle() — публичный статический метод для ожидания конкретного fence |
GlFence.java |
Проблема v2.3.0: beginFrame() вызывал fences.waitOldest() безусловно каждый кадр.
При RING_SIZE=3 уже на 2-м кадре это ждало fence 1-го кадра перед записью в слот 1,
который вообще ни разу не был занят. Реальный overlap CPU/GPU ограничивался ~1 кадром
вместо заявленных 3.
Фикс v2.3.1: каждый слот имеет свой собственный fence. beginFrame() ждёт ТОЛЬКО
fence текущего слота и ТОЛЬКО если он ненулевой (слот уже использовался). Первые
RING_SIZE кадров ожидания нет вообще.
| # | Оптимизация | Файл |
|---|---|---|
| D1 | glBindBuffersBase (один GL call вместо 4× glBindBufferBase) для SSBO bindings |
InteropComputeCuller.java, AmdiumComputeCuller.java |
4 SSBO binds → 1 multi-bind call. Экономия на driver overhead при каждом dispatch.
| # | Фича | Файл |
|---|---|---|
| E1 | AmdiumConfig.INTEROP_WORKGROUP_SIZE (32-256, default 64) |
AmdiumConfig.java |
| E2 | Строковая подстановка local_size_x перед glShaderSource |
InteropComputeCuller.compileAndLinkProgram() |
| E3 | refreshConfig() — перекомпиляция program при смене workgroup size + rollback при ошибке |
InteropComputeCuller.refreshConfig() |
Позволяет A/B тестировать workgroup size (32 для NVIDIA warp, 64 для AMD wavefront) без перекомпиляции мода. Если новое значение не компилируется — автоматический откат.
| # | Оптимизация | Файл |
|---|---|---|
| F1 | Compute shader строит 2 mip level'а за один dispatch через shared-memory reduction | hiz_build.comp.glsl |
| F2 | Цикл dispatch с шагом 2 (10-11 dispatch+barrier пар → 5-6) | HiZDepthPyramid.java |
| F3 | u_BuildSecondMip uniform для edge case (последний level) |
hiz_build.comp.glsl |
Почему не полный FidelityFX SPD? Классический SPD требует bind'ить все mip levels
(8-13 image bindings), но GL_MAX_IMAGE_UNITS = 8 на части AMD. Компромисс — 2 mips
за dispatch (3 image bindings), укладывается в лимит. Полный SPD — только после
явной проверки GL_MAX_IMAGE_UNITS в рантайме (TODO для будущей версии).
| # | Фича | Файл |
|---|---|---|
| G1 | GPUCapabilityDetector.isAPU() — детектит APU (Radeon 660M/680M/780M, Vega 3-11, Intel iGPU, ARM Mali) |
GPUCapabilityDetector.java |
| G2 | getVertexPoolMBCap() — ограничивает vertexPoolMB до 1024 MB на APU |
GPUCapabilityDetector.java |
| G3 | Amdium.effectiveVertexPoolMB — static поле, используется в AmdiumVertexPool.init() |
Amdium.java, AmdiumVertexPool.java |
APU делят память с ОЗУ — при vertexPoolMB=4096 (как для RD 32 на дискретной карте)
Radeon 660M может уронить игру по OOM. Теперь автоматически ограничивается до 1024 MB.
| # | Фича | Файл |
|---|---|---|
| H1 | Подробный comment у FRAMES_IN_FLIGHT (2 = min input lag, 3 = оптимально, 4 = max плавность) |
AmdiumConfig.java |
| H2 | Comment у MDI_VERTEX_POOL_MB про APU-автоограничение |
AmdiumConfig.java |
| H3 | Comment у INTEROP_WORKGROUP_SIZE про AMD/NVIDIA разницу |
AmdiumConfig.java |
┌─────────────────────────────────────────────────────────────┐
│ Minecraft 1.20.1 + Forge 47.x │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ Embedium 0.3.31 (опционально) │ │
│ │ ┌──────────────────────────────────────────────────┐ │ │
│ │ │ Amdium v2.3.3 │ │ │
│ │ │ │ │ │
│ │ │ ┌──────────────────┐ ┌─────────────────────┐ │ │ │
│ │ │ │ Vanilla MDI path │ │ Embedium interop │ │ │ │
│ │ │ │ (если нет Embed) │ │ (если есть Embed) │ │ │ │
│ │ │ └────────┬─────────┘ └──────────┬──────────┘ │ │ │
│ │ │ │ │ │ │ │
│ │ │ ▼ ▼ │ │ │
│ │ │ ┌────────────────────────────────────────────┐ │ │ │
│ │ │ │ GPU compute culling (frustum + fog + Hi-Z) │ │ │ │
│ │ │ │ → glMultiDrawElementsIndirectCount │ │ │ │
│ │ │ │ (zero CPU readback) │ │ │ │
│ │ │ └────────────────────────────────────────────┘ │ │ │
│ │ └──────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
Frame N:
1. CPU writes draw commands → inputBufferId (RingStreamBuffer, zero-sync)
2. CPU writes chunk AABBs → chunkInfoBufferId (RingStreamBuffer, zero-sync)
3. glClearNamedBufferSubData(counterBufId, 0) ← без CPU upload
4. glDispatchCompute(culler) ← GPU culls, writes compacted commands
5. glMemoryBarrier(SHADER_STORAGE | COMMAND)
6. glMultiDrawElementsIndirectCount(outBufId, counterBufId)
↑ GPU САМ читает drawCount из counterBufId — CPU НЕ участвует!
Весь кадр: 0 CPU↔GPU синхронных запросов (кроме F3 debug, gated by renderDebug).
- JDK 17
- Forge 1.20.1 MDK (47.x)
- Embeddium 0.3.31 (compileOnly, опционально в рантайме)
# 1. Распаковать amdium_fixed_v2.3.3.zip поверх исходников мода
# 2. Обновить gradle.properties: mod_version=2.3.3
# 3. Собрать
./gradlew build
# 4. JAR будет в build/libs/amdium-2.3.3.jar
# 5. Положить в .minecraft/mods/Конфиг-файл: .minecraft/config/amdium-client.toml
Дискретная карта (RTX 3060, RX 6000+):
[general.mdi]
vertexPoolMB = 1024 # 512 для RD 12, 4096 для RD 32
[general.buffers]
framesInFlight = 3 # оптимально для большинства
[general.interop]
enableInteropComputeCulling = true
enableInteropFrustum = true
enableInteropFog = true
enableHiZOcclusion = true # киллер-фича
interopWorkgroupSize = 64 # 32 для NVIDIA, 64 для AMDAPU (Radeon 660M, Vega iGPU):
[general.mdi]
vertexPoolMB = 1024 # автоматически capped до 1024 на APU
[general.buffers]
framesInFlight = 3 # APU слабее, triple buffering помогает
[general.interop]
enableHiZOcclusion = true # даёт основной прирост
interopWorkgroupSize = 64 # AMD wavefrontCompetitive (минимальная задержка):
[general.buffers]
framesInFlight = 2 # минимальный input lag, но CPU может ждать GPUПри открытии F3 в левой панели появляются строки:
[Amdium] активен — Embeddium interop
caps: MDI=✓ Compute=✓ Persistent=✓ IndirectCount=✓
APU: да, pool=1024 MB (capped)
ring=OK HiZ=OK wg=64 ring=3 maxCmd=4096
culled: 342/1024 (33%, отстаёт на 3 кадр.)
Если culling периодически отваливается:
⚠ path B fallback: 5 кадр./сек (culling отваливается!)
Важно: статистика culled использует non-blocking readback. Когда F3 закрыт —
этот путь полностью отключён, zero-readback pipeline НЕ нарушается.
| Категория | Статус | Версия |
|---|---|---|
| A1-A6 Critical fixes | ✅ Сделано | v2.3.0 |
| B1-B4 F3 overlay | ✅ Сделано | v2.3.1 |
| C1-C2 RingStreamBuffer fix | ✅ Сделано | v2.3.1 |
| D1 Multi-bind | ✅ Сделано | v2.3.1 |
| E1-E3 Configurable workgroup | ✅ Сделано | v2.3.2 |
| F1-F3 Hi-Z 2 mips/dispatch | ✅ Сделано | v2.3.3 |
| G1-G3 APU safety | ✅ Сделано | v2.3.3 |
| H1-H3 UX tooltips | ✅ Сделано | v2.3.3 |
- Полный FidelityFX SPD (после проверки
GL_MAX_IMAGE_UNITS > 8в рантайме) - Mesh shaders (EXT_mesh_shader на RDNA2+) — экспериментально, нужен отдельный путь
- Sparse buffer (ARB_sparse_buffer) для lazy-аллокации большого VBO
src/main/java/dev/amdium/gl/RingStreamBuffer.java(v2.3.0, обновлён v2.3.1)src/main/java/dev/amdium/debug/AmdiumDebugOverlay.java(v2.3.1)
src/main/java/dev/amdium/render/InteropComputeCuller.java(v2.3.0, 2.3.1, 2.3.2)src/main/java/dev/amdium/render/HiZDepthPyramid.java(v2.3.0, 2.3.3)src/main/java/dev/amdium/render/AmdiumComputeCuller.java(v2.3.0, 2.3.1)src/main/java/dev/amdium/render/AmdiumRenderer.java(v2.3.0)src/main/java/dev/amdium/render/EmbediumInterop.java(v2.3.0, 2.3.1)src/main/java/dev/amdium/mixin/LevelRendererMixin.java(v2.3.0)src/main/java/dev/amdium/gl/PersistentStagingBuffer.java(v2.3.0)src/main/java/dev/amdium/gl/GlFence.java(v2.3.1 — добавленwaitSingle)src/main/java/dev/amdium/config/AmdiumConfig.java(v2.3.2, 2.3.3)src/main/java/dev/amdium/util/GPUCapabilityDetector.java(v2.3.3)src/main/java/dev/amdium/Amdium.java(v2.3.3)src/main/java/dev/amdium/render/AmdiumVertexPool.java(v2.3.3)src/main/resources/assets/amdium/shaders/core/hiz_build.comp.glsl(v2.3.0, 2.3.3)
src/main/java/dev/amdium/AmdiumConfigScreen.javasrc/main/java/dev/amdium/mixin/AmdiumMixinPlugin.javasrc/main/java/dev/amdium/mixin/ChunkShaderInterfaceMixin.javasrc/main/java/dev/amdium/mixin/EmbeddiumDrawCommandListMixin.javasrc/main/java/dev/amdium/mixin/MinecraftMixin.javasrc/main/java/dev/amdium/mixin/RenderChunkMixin.javasrc/main/java/dev/amdium/mixin/RenderRegionMixin.javasrc/main/java/dev/amdium/mixin/RenderSectionMixin.javasrc/main/java/dev/amdium/mixin/SectionRenderDataStorageMixin.javasrc/main/java/dev/amdium/mixin/VertexBufferMixin.javasrc/main/java/dev/amdium/render/AmdiumVertexPool.java(кроме v2.3.3 APU fix)src/main/java/dev/amdium/render/ChunkMetadataStore.javasrc/main/java/dev/amdium/render/MDIDrawCommandBuffer.javasrc/main/java/dev/amdium/render/PerCommandMetadata.javasrc/main/java/dev/amdium/render/SectionStorageBridge.javasrc/main/java/dev/amdium/util/IRenderChunkAccess.javasrc/main/java/dev/amdium/util/ReflectionUtil.javasrc/main/resources/assets/amdium/shaders/core/chunk_culling.comp.glslsrc/main/resources/assets/amdium/shaders/core/chunk_culling_v2.comp.glsl(используется в v2.3.2 подстановкой)src/main/resources/assets/amdium/shaders/core/chunk_culling_interop.comp.glslsrc/main/resources/assets/amdium/shaders/core/chunk_fragment.fshsrc/main/resources/assets/amdium/shaders/core/chunk_vertex.vshsrc/main/resources/META-INF/mods.tomlsrc/main/resources/amdium.mixins.jsonsrc/main/resources/pack.mcmetabuild.gradle,gradle.properties,settings.gradle
Если что-то пойдёт не так:
- Верните оригинальные файлы из исходного архива
- Изменения НЕ затрагивают
mods.toml,amdium.mixins.json,build.gradle— структура проекта не меняется - Все изменения обратно совместимы (новые config-опции имеют дефолты, fallback пути сохранены)
При проблемах проверьте лог на:
[Amdium] RingStreamBuffer (v2.3.1 per-slot fences): ... KB, 3 frames in flight— ring stream активен[Amdium] InteropComputeCuller v2.3 готов. ... ringStream=enabled— interop culler с ring'ом[Amdium] Hi-Z pyramid builder готов (v2.3.3 2-mip-per-dispatch)— Hi-Z активен[Amdium] APU обнаружен (...). vertexPoolMB ограничен 1024 MB— APU cap сработал[Amdium] Fallback readback active— нужно обновить драйвер (нужен GL 4.6 / ARB_indirect_parameters)[Amdium] ⚠ path B fallback(в F3) — culling отваливается, проверьтеMAX_COMMANDS(4096)