Skip to content

Clarify source build docs for qt6 branch and cmake compat#124

Open
trasnake87 wants to merge 2 commits intominecraft-linux:mainfrom
trasnake87:fix/source-build-branch-instructions
Open

Clarify source build docs for qt6 branch and cmake compat#124
trasnake87 wants to merge 2 commits intominecraft-linux:mainfrom
trasnake87:fix/source-build-branch-instructions

Conversation

@trasnake87
Copy link
Contributor

@trasnake87 trasnake87 commented Feb 6, 2026

Summary

  • Adds explicit build instructions for the recommended qt6 branch, including the correct git clone -b qt6 command
  • Documents the -DCMAKE_POLICY_VERSION_MINIMUM=3.5 workaround for cmake 4.0+ users encountering policy errors from older submodules (e.g. eglut)
  • Clearly separates deprecated main branch (Qt5) instructions from the recommended qt6 path with appropriate warnings and cross-references

Addresses #120

Context

As reported in #120, the source build guide previously only showed how to clone the default (main/Qt5) branch, which is deprecated. The warning box mentioned the qt6 branch but didn't explain how to actually use it. Users building from source with cmake 4.0+ would also encounter cmake policy version conflicts from submodules like eglut that specify cmake 3.5, with no guidance on how to resolve them.

Test plan

  • Verify the internal anchor link (#building-the-qt6-branch-recommended) resolves correctly in the rendered mdbook output
  • Confirm the blockquote notes and warnings render properly in mdbook
  • Verify git clone --recursive -b qt6 correctly pulls the qt6 branch with submodules

Add explicit build instructions for the recommended qt6 branch with
the correct git clone command (-b qt6), document the
CMAKE_POLICY_VERSION_MINIMUM workaround for cmake 4.0+ compatibility
with older submodules like eglut, and clearly separate the deprecated
main branch instructions from the recommended qt6 path.

Addresses minecraft-linux#120

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
<div class="warning">

The qt5 version is deprecated and only supported on distributions with protobuf that not depends on abseil and uses cmake 3.x.
The default (main) branch uses Qt5 and is deprecated. It is only supported on distributions with protobuf that does not depend on abseil and that use cmake 3.x.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

our default branch is called ng

- Default branch of mcpelauncher-manifest is 'ng', not 'main'
- Remove cmake 4.0 support claims from qt6 branch (never completed)
- Remove cmake policy workaround note (not applicable)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants