Skip to content

Conversation

@kevinthegreat1
Copy link
Contributor

This guide covers some world rendering concepts and changes in new versions, which have become very confusing for modders. The idea is that this guide covers both concepts (the "extraction" and "drawing" split) and gives a concrete example of how to render in the world using a custom render pipeline.

While I understand this API may change in the future, there is currently no good guide on how to render in the world in versions 1.21.6-1.21.8. This guide covers these versions, and currently works in the 1.21.9 snapshots as well.

I am aware that WorldRenderEvents is being replaced to better serve usages like this, and I will update this using the new API when it becomes available for 1.21.9 and above. But as of now, I think it will be beneficial to have a guide covering versions 1.21.6-1.21.8.

This is a bit technical and confusing for me. If there are better ways of doing what I'm doing, please let me know, because this is what I'm doing in my mods, and I would definitely appreciate a simpler way.

@kevinthegreat1 kevinthegreat1 requested a review from a team as a code owner September 23, 2025 21:06
@netlify
Copy link

netlify bot commented Sep 23, 2025

Deploy Preview for nimble-elf-d9d491 ready!

Name Link
🔨 Latest commit c5ed622
🔍 Latest deploy log https://app.netlify.com/projects/nimble-elf-d9d491/deploys/68d851a8290cd70008f50926
😎 Deploy Preview https://deploy-preview-365--nimble-elf-d9d491.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@kevinthegreat1 kevinthegreat1 requested a review from a team as a code owner September 23, 2025 21:26
@its-miroma its-miroma added new-content A new page or set of pages todo:verify This needs to be reviewed priority:medium This should be addressed relatively quickly labels Sep 23, 2025
@dicedpixels
Copy link
Contributor

LGTM!

cassiancc
cassiancc previously approved these changes Sep 26, 2025
Copy link
Member

@its-miroma its-miroma left a comment

Choose a reason for hiding this comment

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

Thank you! Minor changes then LGTM!


If "drawing" is considered a synonym for the "rendering" (second) phase, it would be clearer if we used it everywhere. Also, I've seen "preparation" referring to extraction, maybe we should take a look at that also. Maybe something like:

  • Rendering is composed of two phases: extraction, which prepares the render state, and drawing.

Co-authored-by: Miroma <136986257+its-miroma@users.noreply.github.com>
its-miroma
its-miroma previously approved these changes Sep 27, 2025
Copy link
Member

@its-miroma its-miroma left a comment

Choose a reason for hiding this comment

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

LGTM!

@its-miroma its-miroma added stage:ready and removed todo:verify This needs to be reviewed labels Sep 27, 2025
@its-miroma
Copy link
Member

@modmuss50 we need your approval because of a change to checkstyle config

@modmuss50 modmuss50 merged commit 5cf3406 into FabricMC:main Sep 27, 2025
8 checks passed
@kevinthegreat1 kevinthegreat1 deleted the world branch September 28, 2025 01:31
its-miroma added a commit to dicedpixels/fabric-docs that referenced this pull request Oct 5, 2025
* upstream/main:
  Notes on Creating a Project (FabricMC#367)
  Rendering in the world and custom render pipelines (FabricMC#365)
its-miroma added a commit to dicedpixels/fabric-docs that referenced this pull request Oct 5, 2025
* upstream/main:
  Notes on Creating a Project (FabricMC#367)
  Rendering in the world and custom render pipelines (FabricMC#365)
its-miroma added a commit to dicedpixels/fabric-docs that referenced this pull request Oct 12, 2025
* upstream/main:
  Update Docs to 1.21.10 (FabricMC#369)
  uniform sidebar translations keys (FabricMC#370)
  fix image z-index (FabricMC#368)
  Blocks: Block Models (FabricMC#364)
  Split IDE-Specific Pages (FabricMC#366)
  Notes on Creating a Project (FabricMC#367)
  Rendering in the world and custom render pipelines (FabricMC#365)
kevinthegreat1 added a commit to kevinthegreat1/fabric-docs that referenced this pull request Oct 14, 2025
* Rendering in the world

* Lint

* Allow comments after block

* Apply suggestions from code review

Co-authored-by: Miroma <136986257+its-miroma@users.noreply.github.com>

* Clean up phases

* Update phases explanation

---------

Co-authored-by: Miroma <136986257+its-miroma@users.noreply.github.com>
(cherry picked from commit 5cf3406)
kevinthegreat1 added a commit to kevinthegreat1/fabric-docs that referenced this pull request Oct 14, 2025
* Rendering in the world

* Lint

* Allow comments after block

* Apply suggestions from code review

Co-authored-by: Miroma <136986257+its-miroma@users.noreply.github.com>

* Clean up phases

* Update phases explanation

---------

Co-authored-by: Miroma <136986257+its-miroma@users.noreply.github.com>
(cherry picked from commit 5cf3406)
kevinthegreat1 added a commit to kevinthegreat1/fabric-docs that referenced this pull request Oct 15, 2025
* Rendering in the world

* Lint

* Allow comments after block

* Apply suggestions from code review

Co-authored-by: Miroma <136986257+its-miroma@users.noreply.github.com>

* Clean up phases

* Update phases explanation

---------

Co-authored-by: Miroma <136986257+its-miroma@users.noreply.github.com>
(cherry picked from commit 5cf3406)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new-content A new page or set of pages priority:medium This should be addressed relatively quickly

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants