Settings

Motion Capture provides many settings which allow to change how its features behave, disable them, or in some cases, enable features disabled by default.

Features disabled or limited by default:

• tracking all entities (by default it tracks vehicles, projectiles, and items; accessible with track_entities)
• chat recording (accessible with chat_recording)
• attacking fake players (accessible with invulnerable_playback)
• fake players attacking real players/entities (accessible with hit_range)
• starting playback with recorded player profile (accessible with assign_profile and start_as_recorded)

Motion Capture as of version 1.4 doesn't have any global (client or server) settings. It saves settings for each world (inside mocap_files directory) and always sets default values when creating new one.

Settings are divided into three categories - recording, playback, and advanced.

Managing settings

You can manage settings using /mocap settings command. There are two forms of it:

• /mocap settings [category] [setting] - retrieve setting value, default value, and description
• /mocap settings [category] [setting] [value] - change setting value

"Recording" category

• prevent_tracking_played_entities (boolean) - Prevents tracking (recording) entities that are currently played [default: true]
• entity_tracking_distance (real) - Limits the entity tracking distance [default: 128]
  • >0 - tracking radius in blocks
  • 0 - disable tracking
  • -1 - distance not limited
• on_death (enum) - Determines what will happen when recorded player dies [default: end_recording]
  • end_recording - ends recording
  • split_recording - splits recording
  • continue_synced - continues recording and records all ticks on death screen (when game is waiting for player to respawn)
  • continue_skip_ticks - continues recording but skips ticks on death screen (player is recorded as if it respawned immediately)
• on_change_dimension (enum) - Determines what will happen when recorded player changes dimension [default: end_recording]
  • nothing - ignores dimension change, not recommended in most cases as player and other recorded entities will appear somewhere in a dimension they are not supposed to be in
  • end_recording - ends recording
  • split_recording - splits recording
• start_instantly (boolean) - Makes recording start instantly instead of waiting for movement or second command [default: false]
• assign_dimension (boolean) - Assigns dimension to the recording. See dimension_source setting (in "playback" category) for more information. [default: true]
• assign_profile (enum) - Assigns recorded player profile to the recording. You also need to enable start_as_recorded for a recording playback to start as recorded player by default. [default: no]
  • no - disabled
  • only_name - assigns only player name and nothing else
  • full - assigns player name, UUID and skin
• chat_recording (boolean) - Enables player chat messages recording [default: false]

"Playback" category

• playback_speed (real) - Allows you to change speed of played recording or scene [default: 1]
• can_push_entities (boolean) - Makes fake players push other entities [default: true]
• entities_after_playback (enum) - Determines what will happen with entities after playback [default: remove]
  • remove - remove
  • kill - kill with animation
  • left_untouched - left untouched
  • release_as_normal - release it as a normal entity
• block_actions_playback (boolean) - Plays back placing, destroying, and interacting with blocks [default: true]
• block_initialization (boolean) - At the playback start sets block states to those before the start of recording [default: true]
• block_allow_scaled (boolean) - Allows playback of block actions with scene scaled by natural number. Note that it may cause major destruction of the terrain, so it's recommended to back up your world before using it. [default: false]
• drop_from_blocks (boolean) - Enables drop from destroyed blocks (recommended with item entities excluded from playback to prevent duplicates) [default: false]
• start_as_recorded (boolean) - Makes playback start as recorded player, rather than player starting playback. In case of saved recordings you need to start them with assign_player_name enabled. [default: false]
• chat_playback (boolean) - Enables player chat messages playback. Note that recording needs to be recorded with chat_recording enabled. [default: true]
• invulnerable_playback (boolean) - Makes player and other entities in the playback invulnerable to damage [default: true]
• dimension_source (enum) - Specifies in which dimension playback will start [default: assigned_or_current]
  • assigned_or_current - dimension assigned to the recording or, if it wasn't assigned, dimension of player/command block starting playback
  • assigned_or_overworld - dimension assigned to the recording or, if it wasn't assigned, overworld
  • current - ignores assigned dimension and always uses dimension of player/command block starting playback
  • overworld - ignores assigned dimension and always uses overworld
• player_name_handling (enum) - Specifies how player name should be handled - should profiles be loaded and what should be done about name letter casing. Note that it doesn't affect from_player skin modifiers. [default: ignore_casing]
  • disable_loading_profiles - profiles won't be loaded - default skin will be used unless skin modifier is specifying
  • match_exact_name - load profile from specified name, but don't apply it if its name casing isn't exactly the same as in specified player name
  • ignore_casing - load profile from specified name (ignoring letter casing) and use same casing as in specified player name
  • ignore_and_replace_casing - load profile from specified name (ignoring letter casing) and use same casing as in loaded profile
• hit_range (real) - Specifies hit range of player in playback when it swings. For 0 (or other nonpositive values) player in playback can't hit other entities. For values greater than 0 hitting is enabled, its range is multiplied by value of this setting, and hitboxes are inflated by value of this setting. Values above 4 are treated as 4. [default: 0]

"Advanced" category

• fluent_movements (real) - Sets distance to played entity for player to receive additional packets for more fluent movements [default: 32]
  • >0 - distance in blocks
  • 0 - disable fluent movements
  • -1 - no limit
• max_float_pos_value (real) - Sets distance from recording start at which recording should switch position precision from 32-bit floating point numbers (float) to 64-bit floating point numbers (double). Set this to negative value to fully switch to double precision. [default: 1024]
• allow_mineskin_requests (boolean) - Allows HTTPS requests to mineskin.org in order to load skins [default: true]
• prevent_saving_entities (boolean) - Prevents game from saving played entities in case of for example leaving game [default: true]
• use_creative_game_mode (boolean) - Sets fake players game mode to creative (monsters will ignore them) [default: false]
• allow_ghosts (boolean) - Allows usage of ghosts (invisible, server-side only players) when using player_as_entity modifier. They're created in order to perform actions that can't be done by a non-player entity. [default: true]
• experimental_release_warning (boolean) - Warns players when a server is using experimental (alpha or beta) release of Motion Capture mod [default: true]
• pretty_scene_files (boolean) - Makes scene JSON files more human-readable, at cost of slightly bigger file size (scene files are very small anyway, so it shouldn't be a problem unless you're using punch cards for storing them) [default: true]
• show_tips (boolean) - Gives tips that may help with using the mod [default: true]
• quick_discard (boolean) - Allows to quickly discard single recording by reusing "stop" command [default: true]
• required_extensions (enum) - Specifies when and if error should be thrown when extension used in recording is missing [default: let_extension_decide]
  • require_all
  • ignore_all
  • let_extension_decide
• nbt_recording_mode (enum) - Specifies what should be included in recorded NBT of non-player entity [default: filtered]
  • disabled - NBT data won't be recorded, not recommended
  • filtered - NBT data will be recorded, but known unnecessary tags will be excluded, note that it may change behavior of entity compared to original (like tracking distance) in case you want to let it be free after recording
  • full - will record all NBT tags except a few that may cause issues
• use_authlib_services (boolean) - Enables use of authlib methods to request player profiles instead of custom implementation. Useful if you defined custom mojang services URLs or proxy, or in case custom implementation will stop working. [default: false]