Configuration ‐ Overview - xBigEllx/realistic-block-physics-mirror GitHub Wiki

Summary

Realistic Block Physics offers several, highly customisable configuration files to allow you to change just about anything.

These configuration files are housed within the config/rbp directory of your Minecraft installation directory, and are not to be confused with the separate config/realisticphysics directory that belongs to the Realistic Physics dependency of this mod.

[!IMPORTANT] Mod versions that target Minecraft version 1.12.2 use the cfg file format, whereas all future versions use the toml file format.

[!WARNING] With versions of Realistic Block Physics from version 1.12.2-3.0.0-rc1 onwards, the structure/schema of the configuration files have changed. Any configurations that exist from prior versions of the mod must be deleted to prevent unwanted side effects.

The below bulleted list illustrates the default hierarchical directory structure for the configuration of Realistic Block Physics.

  • config/rbp: The root configuration directory which houses any global configuration files.
    • block_definitions: The directory which houses all block definitions.
      • overworld: Directory override for the default overworld world definition.
      • the_end: Directory override for the default the_end world definition.
      • the_nether: Directory override for the default the_nether world definition.
    • world_definitions: The directory which houses all world definitions.

Generation of Configuration Files

There are two phases at which the configuration files of Realistic Block Physics are generated:

  1. Game load: When the game first loads.
  2. World Load: When a specific world/dimension is loaded within a level.

This means that the configurations of the mod can be changed without the need to exit and reload the game. However, when changing the configuration files whilst playing in a level, any currently loaded dimensions/worlds must be reloaded in order for the changes to take effect.

[!IMPORTANT] In the event of wanting to clear the block_definitions or world_definitions directories, you should delete all their contents, rather than the folders themselves, to prevent them from regenerating.

Configuration File Types