CurseForge · Minecraft mod
Aluminium
Cuts chunk load behind you for real FPS gains. Sodium-friendly; a server-only install also benefits vanilla clients.
Quick answer
Which Aluminium release should I use?
Aluminium v0.2.0[26.1.2 Fabric]aluminum targets 26.1.2 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.
Where it goes
Is Aluminium required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does Aluminium v0.2.0[26.1.2 Fabric]aluminum need?
v0.2.0[26.1.2 Fabric]aluminum. Change the file and its required mods may change too.
Install Fabric API first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Aluminium without breaking your instance.
Built for Aluminium v0.2.0[26.1.2 Fabric]aluminum. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use v0.2.0[26.1.2 Fabric]aluminum. It targets 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside v0.2.0[26.1.2 Fabric]aluminum. It opens that exact file at the source.
About this project
What does Aluminium add?
Aluminum(Or Aluminium)
Aluminum dynamically shortens the chunk render and simulation distance directly behind you. What you face stays exactly as it is; the area behind your back keeps only a set share of the forward distance, tapered smoothly by angle so there is no visible cut edge.
Estimated ~20–28% fewer chunks loaded, at zero visual cost where you look.
For servers, please get server.md from my issue pages in Codeberg
Presets
| Preset | Behind you keeps | Est. fewer chunks |
|---|---|---|
| Auto | picked from your CPU cores / RAM | — |
| Soft | 50% | ~20% |
| Balanced | 35% | ~24% |
| Aggressive | 20% | ~28% |
| Ultra-Light | 10% | more |
| Custom | your own 0–100% (two sliders) | — |
Turning around more than 45° can unload the far chunks behind you right away ("Unload on turn", toggleable) so savings kick in faster.
Why it plays nice
- Culling happens at the server chunk-send layer, not in the renderer. Fully compatible with Sodium / Embeddium and any other client-side optimization or shader mod — there is nothing to conflict with.
- A server-only install benefits everyone: put the jar in the server's
mods/and all players gain, including unmodified vanilla clients. Players who do install Aluminum get a settings panel; those who don't just get the win.
Configuration
- With Sodium (Fabric 1.21.1): Video Settings → the Aluminum sidebar tab → Rear View Culling page (applies with Sodium's Apply button).
- Everywhere else: vanilla Video Settings → "Aluminum" entry at the bottom of the screen.
- Config file:
config/aluminum.json—enabled,mode,renderPct,simPct,rotationCull,debugHud. - F3: current preset, rear ratios and estimated savings in the right column, styled like Sodium / Iris.
Server management
config/aluminum.jsonhot-reloads within ~5s — no restart needed.- OP (level 2) commands:
/aluminum status current config & effective state
/aluminum reload reload config from disk now
/aluminum enable | disable master switch
/aluminum mode <preset> auto | ultra_light | soft | balanced | aggressive | custom
/aluminum render <0-100> rear render % (switches to Custom)
/aluminum sim <0-100> rear simulation % (switches to Custom)
Command feedback is localized for modded clients and falls back to English for vanilla clients.
Requirements
Choose one file for your setup (v0.1.1):
| Game version | Loader | Extra dependency | Java |
|---|---|---|---|
| 1.21 / 1.21.1 | Fabric | Fabric API | 21+ |
| 1.20 / 1.20.1 | Fabric | Fabric API | 17+ |
| 1.16.5 | Fabric | Fabric API | 8+ |
| 26.1.2 | Fabric | Fabric API | 25 |
| 1.21.1 | NeoForge | — | 21+ |
| 1.20.1 | Forge | — | 17+ |
Sodium is optional, never required.
Notes
- Rear simulation distance too low pauses block updates / mob spawning in the far rear — keep it ≥35% if you run farms or spawners behind you.
- In multiplayer, culling follows the server's config; the local file only applies in singleplayer / when you host a LAN world.
License & contact
All Rights Reserved · by CollinsLiu · xiaoliu666202101@163.com
中文说明
Aluminum 动态缩短玩家正身后的区块渲染与模拟距离,正前方完全不受影响, 按角度平滑收窄、没有可见切割边,预计少加载约 20%~28% 区块。 裁剪发生在服务器区块下发层,因此与 Sodium / Iris 等渲染优化完全不冲突; 服务器单独安装一份即可让所有玩家受益,包括没装模组的原版客户端。
装了 Sodium 时在视频设置侧栏的 Aluminum 栏调整;没装则在原版视频设置底部的 "Aluminum — 身后视距裁剪设置…"。直接改 config/aluminum.json 亦可,服务器 约 5 秒内自动热重载。OP 可用 /aluminum status|reload|enable|disable|mode|render|sim。
要求:按上表选一个版本——Fabric 1.21.1 / 1.20.1 / 1.16.5 / 26.1.2(均需 Fabric API), NeoForge 1.21.1 与 Forge 1.20.1 无额外前置;Sodium 可选。 协议:All Rights Reserved · 作者 CollinsLiu · 联系邮箱 xiaoliu666202101@163.com
Project description from CurseForge.
Pick your setup
Aluminium by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.1.2
1 loader build1.21.1
2 loader builds1.20.1
2 loader builds1.16.5
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Aluminium versions and loaders
v0.2.0[26.1.2 Fabric]aluminum
aluminum-26.1.2-fabric-0.2.0.jar
12 Nov 2026
v0.2.0[1.16.5 Fabric]aluminum
aluminum-1.16.5-fabric-0.2.0.jar
12 Nov 2026
v0.2.0[1.20.1 Forge]aluminum
aluminum-1.20.1-forge-0.2.0.jar
12 Nov 2026
v0.2.0[1.20.1 Fabric]aluminum
aluminum-1.20.1-fabric-0.2.0.jar
12 Nov 2026
v0.2.0[1.21.1 Fabric]aluminum
aluminum-1.21.1-fabric-0.2.0.jar
12 Nov 2026
v0.2.0[1.21.1 NeoForge]aluminum
aluminum-1.21.1-neoforge-0.2.0.jar
12 Nov 2026
v0.1.2[1.21.1 NeoForge]aluminum
aluminum-1.21.1-neoforge-0.1.2.jar
7 Nov 2026
v0.1.1[1.21.1 NeoForge]aluminum
aluminum-1.21.1-neoforge-0.1.1.jar
7 Nov 2026
v0.1.1[1.20.1 Forge]aluminum
aluminum-1.20.1-forge-0.1.1.jar
7 Nov 2026
v0.1.1[1.16.5 Fabric]aluminum
aluminum-1.16.5-fabric-0.1.1.jar
7 Nov 2026
v0.1.1[1.20.1 Fabric]aluminum
aluminum-1.20.1-fabric-0.1.1.jar
7 Nov 2026
v0.1.1[1.21.1 Fabric]aluminum
aluminum-1.21.1-fabric-0.1.1.jar
7 Nov 2026
Looking for an older file? The official CurseForge project page is in Resources.