Configuration File

Here is the default config that ships with MV-Inventories. Note the version number at the bottom. We will (try to) update this page with newer configs when they ship.

Make sure you're up to date

If you type /mv version a version string will be dumped to the console, in it you will see a line:

...
XX:XX:XX [INFO] [Multiverse-Core] [Multiverse-Inventories] Dumping Config Values: (version 2.7)
...
null

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/05/10 03:31:07