Configuration File

Here is the default config that ships with MV-Inventories for your reference. All the information on what each config values does is already detailed in the comments within the config file, so please read them.

Note the version number at the bottom. We will (try to) update this page with newer configs when they ship. This is the current version of your config. If it does not match the version in the example below, please grab an updated version of Multiverse-Inventories and all of the Multiverse Plugins you use .

Multiverse will always migrate your configs for you if we change the format (like when we did 2.7->2.8). With that said, it never hurts to keep backups in case of server failure or a ferret munching a few bytes off the end of a file.

Multiverse-Inventories Sample Config

#-----------------------------------------------------------------------------------------------------------------#
#                                                                                                                 #
#     __  __ _   _ _____ _    _____   _____ ___  ___ ___    ___ _  ___   _____ _  _ _____ ___  ___ ___ ___ ___    #
#    |  \/  | | | |_   _| |  |_ _\ \ / / __| _ \/ __| __|  |_ _| \| \ \ / / __| \| |_   _/ _ \| _ \_ _| __/ __|   #
#    | |\/| | |_| | | | | |__ | | \ V /| _||   /\__ \ _|    | || .` |\ V /| _|| .` | | || (_) |   /| || _|\__ \   #
#    |_|  |_|\___/  |_| |____|___| \_/ |___|_|_\|___/___|  |___|_|\_| \_/ |___|_|\_| |_| \___/|_|_\___|___|___/   #
#                                                                                                                 #
#                                                                                                                 #
#                                                                                                                 #
#                                                                                                                 #
#            WIKI:        https://github.com/Multiverse/Multiverse-Core/wiki/Basics-(Inventories)                 #
#            DISCORD:     https://discord.gg/NZtfKky                                                              #
#            BUG REPORTS: https://github.com/Multiverse/Multiverse-Inventories/issues                             #
#                                                                                                                 #
#                                                                                                                 #
#            New options are added to this file automatically. If you manually made changes                       #
#            to this file while your server is running, please run `/mvinv reload` command.                       #
#                                                                                                                 #
#-----------------------------------------------------------------------------------------------------------------#
  
  
share-handling:
  # If this is set to true, it will enable bypass permissions (Check the wiki for more info.)
  enable-bypass-permissions: false
  
  # If this is set to true, players will have different inventories/stats for each game mode.
  # Please note that old data migrated to the version that has this feature will have their data copied for both game modes.
  enable-gamemode-share-handling: false
  
  # If set to true, any world not listed in a group will automatically be assigned to the 'default' group!
  default-ungrouped-worlds: false
  
  # When set to true, optional shares WILL be utilized in cases where a group does not cover their uses for a world.
  # An example of this in action would be an ungrouped world using last_location. When this is true, players will return to their last location in that world.
  # When set to false, optional shares WILL NOT be utilized in these cases, effectively disabling it for ungrouped worlds.
  use-optionals-for-ungrouped-worlds: true
  
  # You must specify optional shares you wish to use here or they will be ignored.
  # Built-in optional shares are: "economy" and "last_location".
  active-optional-shares: []
  
  
sharables:
  # When enabled, we will use 1.21's PlayerSpawnChangeEvent to better detect bed and anchor respawn locations.
  # This options is not applicable for older minecraft server versions.
  use-improved-respawn-location-detection: true
  
  # When set to true, the last location of the player will be reset when they die.
  # This is useful if they respawn in a different world and you do not want them to return to their death location.
  reset-last-location-on-death: false
  
  # When enabled, the last location of the player will be applied for any teleportation.
  # This is useful as you want to use the last location for any teleportation, such as the warp system.
  # When disabled, you can only use `/mv tp ll:worldname` to teleport to the player's last location.
  apply-last-location-for-all-teleports: true
  
  # When enabled, we will use paper's improved byte serialization for inventory data.
  # When disabled, we will use the legacy configuration serialization method.
  # !!!!!BIG NOTE:
  #   This option is only applicable on PAPERMC.
  #   Once you enable this option, you cannot change your server software back to SPIGOT.
  # ------------
  # Byte serialization will use minecraft's NBT format. NBT is safer for data migrations as it will use the built in 
  # data converter instead of bukkits dangerous serialization system. This will fix various issues with the inventory data
  # such as Skulker Box data loss, equip-sound crash, FoodEffect error, and more.
  use-byte-serialization-for-inventory-data: false
  
  
performance:
  
  # This will only work if save-playerdata-on-quit is set to true.
  # Minecraft will already load the most up-to-date player data and this option will generally be redundant.
  # The only possible edge case uses is if you have a need to always modify the mvinv playerdata while the player is offline.
  apply-playerdata-on-join: false
  
  # By default, even when the group shares all or going to a world within the same group, the world profile will still be written to disk.
  # This will ensure that the world profile is always up-to-date, so when removing the world from the group, it will not be missing data.
  # However, if you are certain that your world will always be in a group, you can set this to false to slightly improve performance.
  always-write-world-profile: true
  
  # Pre-loads player data into caches when joining the server.
  # This will reduce the load time on first teleport to the world/group, with the cost of increased memory usage and join time.
  preload-data-on-join:
    worlds: []
    groups: []
  
  # NOTE: Cache options require a server restart to take effect.
  cache:
    player-file-cache-size: 2000
    player-file-cache-expiry: 60
    player-profile-cache-size: 6000
    player-profile-cache-expiry: 60
    global-profile-cache-size: 500
    global-profile-cache-expiry: 60
  
  
# Do not edit the following values!!!!!
first-run: true
version: 5.0
yml
Last update at: 2025/12/03 14:05:13