Configuration

 

Configuration

 


 

Besides the main configuration files, Massband also has a configuration file for each player on the server. Configuration files in Massband:

 

config.yml

The main configuration file for Massband. 

#-------------------------------------------------------------------------------
#- Massband
#- Config: config.yml
#- Format Version: 2
#-------------------------------------------------------------------------------
 
Cleanup:
    # This will remove any leftover "markers" on server start-up.
    # This will make sure there aren't any markers without an associated player.
    # Values: true | false
    Enabled: true
 
Marker:
    # The absolute maximum number of markers a single player is allowed to place.
    PlayerMaxCount: 1024
    # The space between multiple lines of a marker.
    LineOffset: 0.3
 
    OwnerTags:
        # If another player is nearby, an "owner tag" will be shown for each marker,
        # displaying the name of the player the marker belongs to.
        # Values: true | false
        Enable: true
        # The diameter in which owner tags will be shown on markers around the player.
        Diameter: 7
        # The minimum time an owner tag should be visible.
        # In Ticks. (20 Ticks => 1 sec)
        HideTicks: 60
        # The minimum delay before showing the owner tags again.
        # In Ticks. (10 Ticks => 500 ms)
        DelayTicks: 10
 
Help:
    # This defines who should be able to see the permission in the help message.
    # Values: None | Console | OP | All
    PermissionVisibility: OP
 

 

default.yml

The default configuration file. Contains the default values to be used for the player specific config files.

#-------------------------------------------------------------------------------
#- Massband
#- Config: defaults.yml
#- Format Version: 2
#-------------------------------------------------------------------------------

Default:
    # The default count of markers to be placed. (-1 for no limit.)
    MarkerCount: 1
    # The default mode to use for measurement.
    # Values: BLOCKS | VECTORS
    Mode: BLOCKS
    # The axis to be ignored by default, during measurement.
    # Values: None | X | Y | Z
    IgnoredAxis: None

Interact:
    # The material a player needs to hold, to be able to set markers.
    # Values:
    #   [...]
    Material: STICK

    # Weather the default action (e.g. "breaking a block") should be prevented,
    # when the "interact material" is been held.
    # Values: true | false
    Prevent-Action: true
    # Inverts actions of the left and right mouse buttons. Useful for left-handed.
    # Values: true | false
    Switch-Buttons: false
    # The time frame, which defines when two clicks are counted as "double click".
    # In Milliseconds.
    DoubleClick-TimeFrame: 300

 

players/<player specific id>.yml
example: 44f4d1dc-fa1a-40a7-a460-1c34834649e6.yml

Contains player specific values based on the default configuration above. For each new player on the server such a file will be created. The file name contains an unique id associated to each player and will look something like this.