feat: add support for Minecraft 1.21.11 #198

mviamari · 2025-12-27T20:33:43Z

Summary

Updates BetterF3 to support Minecraft 1.21.10 and 1.21.11
Updates all platform dependencies to 1.21.11-compatible versions
Bumps mod version to 17.0.0
Fixes all breaking API changes introduced in Minecraft 1.21.11

Changes

Version Updates

Minecraft: 1.21.10 → 1.21.11 (supports both 1.21.10 and 1.21.11)
Mod version: 16.0.3 → 17.0.0
Architectury Loom: 1.11-SNAPSHOT → 1.13-SNAPSHOT (required for 1.21.11)
Fabric API: 0.136.0+1.21.10 → 0.140.2+1.21.11
Fabric Loader: 0.17.3 → 0.18.4
NeoForge: 21.10.38-beta → 21.11.13-beta
Cloth Config: 20.0.148 → 21.11.153
ModMenu: 16.0.0-rc.1 → 17.0.0-beta.1

Minecraft 1.21.11 API Changes Fixed

Straightforward API Changes:

ResourceLocation → Identifier (class renamed)
Util package relocation: net.minecraft.Util → net.minecraft.util.Util
Options.graphicsMode() → graphicsPreset() (new preset system)
ResourceKey.location() → identifier()
Access widener updated for Identifier return type

Complex API Changes:

DebugScreenEntryList method renames:
- toggleF3Visible() → toggleDebugOverlay()
- isF3Visible() → isOverlayVisible()
- setF3Visible() → setOverlayVisible()
Level.getMoonBrightness() replaced with Environment Attributes system:
- Now uses MoonPhase and DimensionType.MOON_BRIGHTNESS_PER_PHASE

Files Modified: 18 files across common, fabric, and neoforge modules

Test Plan

Notes

This update supports Minecraft 1.21.11, which is historically significant as:

The final obfuscated Minecraft version
The last version using 1.x.y version numbering before transitioning to year-based versioning (26.1)

The mod maintains backwards compatibility with 1.21.10 while adding full 1.21.11 support.

🤖 Generated with Claude Code

- Update Minecraft version to 1.21.11 in gradle.properties - Update dependencies: Fabric API 0.140.2, NeoForge 21.11.13-beta, Fabric Loader 0.18.4 - Update Architectury Loom to 1.13-SNAPSHOT (required for 1.21.11) - Bump mod version to 17.0.0 - Add changelog for 17.0.0 Minecraft 1.21.11 API changes (straightforward fixes): - Replace ResourceLocation with Identifier (class renamed in 1.21.11) - Update Util import from net.minecraft.Util to net.minecraft.util.Util - Replace Options.graphicsMode() with graphicsPreset() - Replace ResourceKey.location() with identifier() - Update access widener to use Identifier instead of ResourceLocation Remaining work: - DebugScreenEntryList API changes (toggleF3Visible, isF3Visible, setF3Visible) - Level.getMoonBrightness() replacement

Fix all remaining Minecraft 1.21.11 API changes to complete mod compatibility. DebugScreenEntryList method renames (9 files): - toggleF3Visible() → toggleDebugOverlay() - isF3Visible() → isOverlayVisible() - setF3Visible() → setOverlayVisible() Files updated: - common/ModConfigScreen.java - common/DebugMixin.java - common/KeyboardMixin.java - common/DebugOptionMixin.java - common/ScoreboardMixin.java - fabric/FabricDebugMixin.java - neoforge/NeoForgeDebugMixin.java Environment Attributes system (LocationModule.java): - Replaced Level.getMoonBrightness() with new Environment Attributes API - Added imports: EnvironmentAttributes, MoonPhase, DimensionType - Moon brightness now calculated via MoonPhase and MOON_BRIGHTNESS_PER_PHASE array Checkstyle compliance: - Fixed import ordering in DebugMixin.java, Utils.java, LocationModule.java - Made moonPhase variable final Build status: ✅ SUCCESS (all modules compile and pass checkstyle)

mviamari · 2025-12-27T20:35:53Z

I tested this on my local setup and it didn't crash. I don't use all of the features though, and didn't test it extensively.

I figured that since I got a working build, it might be helpful, even if you can't use it directly.

SwordfishBE · 2025-12-28T12:54:44Z

Compiles for me. Tested and is working.

Tatertot5s · 2026-01-02T04:15:43Z

There seems to be a bug where if you have your "Toggle Overlay" and "Debug Modifier Key" set to be the same thing (both F3, like it is by default) it holds down the debug modifier key. This makes it so if you press A it will reload chunks and not make you move to the left until you press F3 again. This should probably be fixed before it's pulled. This was tested on the fabric (Fabric 0.18.4) build on an empty instance besides Fabric API (0.140.2+1.21.11) (without it the text didn't render even though it's not listed as a dependency on modrinth. weird.)

…tectury/1.21.11 # Conflicts: # common/src/main/java/me/cominixo/betterf3/mixin/KeyboardMixin.java # common/src/main/java/me/cominixo/betterf3/modules/LocationModule.java # docs/changelogs/17.0.0.md # gradle.properties

Copilot

Pull request overview

This PR updates BetterF3 to support Minecraft version 1.21.11, adapting to significant API changes introduced in that version. The update includes dependency version bumps and fixes for breaking API changes, particularly around resource identifiers, utility class relocations, and a new Environment Attributes system that replaced the old moon brightness API.

Key changes:

Migrated from deprecated getMoonBrightness() to the new EnvironmentAttributes.MOON_PHASE system
Updated moon brightness calculation to use DimensionType.MOON_BRIGHTNESS_PER_PHASE
Refactored local difficulty calculation logic to work outside the ServerLevel-specific context
Bumped mod version from 16.0.3 to 17.0.0

Reviewed changes

Copilot reviewed 1 out of 2 changed files in this pull request and generated 2 comments.

File	Description
docs/changelogs/17.0.0.md	Changelog entry documenting 1.21.11 support
common/src/main/java/me/cominixo/betterf3/modules/LocationModule.java	Updated to use new Minecraft 1.21.11 APIs for moon phase and environment attributes; refactored local difficulty calculation

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

common/src/main/java/me/cominixo/betterf3/modules/LocationModule.java

TreyRuffy · 2026-01-06T05:09:29Z

There seems to be a bug where if you have your "Toggle Overlay" and "Debug Modifier Key" set to be the same thing (both F3, like it is by default) it holds down the debug modifier key. This makes it so if you press A it will reload chunks and not make you move to the left until you press F3 again. This should probably be fixed before it's pulled. This was tested on the fabric (Fabric 0.18.4) build on an empty instance besides Fabric API (0.140.2+1.21.11) (without it the text didn't render even though it's not listed as a dependency on modrinth. weird.)

I'm seeing this issue too. I'll need to look into it more before merging this PR. I also should have updated the Fabric API dependency since the 1.21.11 change.

Copilot

Pull request overview

Copilot reviewed 11 out of 12 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

common/src/main/java/me/cominixo/betterf3/mixin/DebugScreenEntryListMixin.java

neoforge/src/main/resources/META-INF/neoforge.mods.toml

forge/src/main/resources/META-INF/mods.toml

fabric/src/main/resources/fabric.mod.json

mviamari added 2 commits December 26, 2025 18:01

TreyRuffy changed the base branch from architectury/1.21.10 to architectury/1.21.11 January 6, 2026 04:42

TreyRuffy requested a review from Copilot January 6, 2026 04:49

TreyRuffy assigned TreyRuffy and mviamari Jan 6, 2026

Copilot started reviewing on behalf of TreyRuffy January 6, 2026 04:50 View session

Copilot AI reviewed Jan 6, 2026

View reviewed changes

common/src/main/java/me/cominixo/betterf3/modules/LocationModule.java Outdated Show resolved Hide resolved

common/src/main/java/me/cominixo/betterf3/modules/LocationModule.java Outdated Show resolved Hide resolved

feat: Add additional fixes for 1.21.11

073d20d

fix: Update 1.21.11 debug modifier logic

841cec2

TreyRuffy requested a review from Copilot January 9, 2026 06:13

Copilot started reviewing on behalf of TreyRuffy January 9, 2026 06:13 View session

Copilot AI reviewed Jan 9, 2026

View reviewed changes

TreyRuffy changed the title ~~feat: add support for Minecraft 1.21.10/1.21.11~~ feat: add support for Minecraft 1.21.11 Jan 9, 2026

TreyRuffy merged commit 3e43c36 into TreyRuffy:architectury/1.21.11 Jan 9, 2026
7 checks passed

TreyRuffy mentioned this pull request Jan 9, 2026

1.21.11 Update #197

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

feat: add support for Minecraft 1.21.11 #198

feat: add support for Minecraft 1.21.11 #198

Uh oh!

mviamari commented Dec 27, 2025

Uh oh!

mviamari commented Dec 27, 2025 •

edited

Loading

Uh oh!

SwordfishBE commented Dec 28, 2025

Uh oh!

Tatertot5s commented Jan 2, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

TreyRuffy commented Jan 6, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

feat: add support for Minecraft 1.21.11 #198

feat: add support for Minecraft 1.21.11 #198

Uh oh!

Conversation

mviamari commented Dec 27, 2025

Summary

Changes

Version Updates

Minecraft 1.21.11 API Changes Fixed

Test Plan

Notes

Uh oh!

mviamari commented Dec 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

SwordfishBE commented Dec 28, 2025

Uh oh!

Tatertot5s commented Jan 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

TreyRuffy commented Jan 6, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

mviamari commented Dec 27, 2025 •

edited

Loading

Tatertot5s commented Jan 2, 2026 •

edited

Loading