Skip to main content



Everything you need to know about 1.18 modding with Forge.



Various bits of information to help with porting

  • Making a custom rendertype with custom shader: here
  • How to add entity renderers and layer renderers: here
  • Updating a mod from 1.16.5 to 1.17 (start with this): here
  • A migration tool for IntelliJ to move from 1.17 to 1.18: here
  • List of renames and refactors in 1.18 forge: here

(most of these are from gigaherz)

Some notes about BlockEntity saving:

"1.18 doesn't really use save() in the same way older versions used to. If you continue overriding save, it will not work. Instead, you should override saveAdditional. If you are storing BlockEntities somewhere, don't call save. Call saveWithFullMetadata(), saveWithId() or saveWithoutMetadata(), depending on your needs."

Porting step summary

Porting steps (from 1.17):

  • Clone 1.17 version of your project (or copy it using file system)
  • Change Project JDK to Java 17
  • build.gradle: Change mappings to either parchment or official
  • build.gradle: Change forge dependency to latest version
  • build.gradle: change java target to 17
  • build.gradle and set JEI and TOP dependencies
  • Update to latest gradle wrapper from MDK
  • Refresh gradle
  • genIntellijRuns
  • Switch to gradle settings: IntelliJ
  • Do the FML Legacy migration: here
  • Many other fixes (also check here)
    • IForgeContainerType -> IForgeMenuType
    • Forge Constraints class -> Block
    • ClientboundBlockEntityDataPacket constructor private: use create
    • RenderWorldLastEvent -> RenderLevelLastEvent
    • Capabilities have changed: The @CapabilityInject annotation is gone. Use CapabilityManager.get(...) and the RegisterCapabilitiesEvent to register it
    • getMatrixStack() -> getPoseStack()
    • ChunkGenerator/BiomeSource changes
    • Override BlockEntity.saveAdditional() instead of save()!
    • Use RenderTooltipEvent.GatherComponents instead of RenderTooltipEvent.Pre
    • Don't override! Instead override saveAdditional()

The Porting Tutorial

Check the two part 1.16 to 1.17 porting tutorial first:

This video follows the steps described above: Porting from 1.17 to 1.18

1.18 Step By Step

These videos will now have a table of contents for easier navigation. Note that whenever possible some remarks have been added for 1.19.2 versions of the code. The GitHub for the source code from this tutorial can be found here: TutorialV3 GitHub

Episode 1: Basic Project Setup, first mod, first blocks, datagenerationYouTube LinkEpisode 1
Episode 2: Items, container, smelting, powergenerator, capabilities, guiYouTube LinkEpisode 2
Episode 3: Baked models, Block Entity RendererYouTube LinkEpisode 3
Episode 4: Parchment, EntityYouTube LinkEpisode 4
Episode 5: Ore generation, Structures, AT's, Custom DimensionYouTube LinkEpisode 5
Episode 6: ConfigsYouTube LinkEpisode 6
Episode 7: World data, Player Capabilities, Networking, OverlayYouTube LinkEpisode 7
Episode 8: Porting to 1.18.2YouTube Link

Future Subjects

  • Commands
  • Multiblocks
  • Interfacing with other mods: JEI, TOP, Curios, ...
  • Advanced Rendering
  • Overlay Rendering
  • Sounds
  • Particle Systems