From McJty Modding
Revision as of 09:07, 8 August 2022 by McJty (talk | contribs) (1.18 Step By Step)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


Everything you need to know about 1.18 modding with Forge.


Useful links


Various bits of information to help with porting

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

(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: [6]
  • Many other fixes (also check [7])
   * IForgeContainerType -> IForgeMenuType
   * Forge Constaints 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

Contents Video Wiki
Episode 1: Basic Project Setup, first mod, first blocks, datageneration YouTube Link Episode 1
Episode 2: Items, container, smelting, powergenerator, capabilities, gui YouTube Link Episode 2
Episode 3: Baked models, Block Entity Renderer YouTube Link Episode 3
Episode 4: Parchment, Entity YouTube Link Episode 4
Episode 5: Ore generation, Structures, AT's, Custom Dimension YouTube Link Episode 5
Episode 6: Configs YouTube Link Episode 6
Episode 7: World data, Player Capabilities, Networking, Overlay YouTube Link Episode 7
Episode 8: Porting to 1.18.2 YouTube Link

Future Subjects

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