Skip to main content
Version: 0.0.55

VotingPresetPlugin

note

Forced minimum CSP version of 0.2.0 (2651) and EnableClientMessages: true in extra_cfg.yml required for this plugin!

Configuration​

Enable the plugin in extra_cfg.yml

extra_cfg.yml
EnablePlugins:
- VotingPresetPlugin

Example configuration

plugin_voting_preset_cfg.yml
# Reconnect clients instead of kicking when restart is initiated. 
# Please disable reconnect with varying entry lists in the presets
ReconnectEnabled: true
# Enable Voting
VoteEnabled: true
# Number of choices players can choose from at each voting interval
VoteChoices: 3
# Will preset/track change randomly with equal odds if no vote has been counted
ChangePresetWithoutVotes: false
# Whether the current preset/track should be part of the next vote.
IncludeStayOnTrackVote: true
# Whether to skip the comparison of the starting entry list to the presets entry lists.
SkipEntryListCheck: false
# How often a cycle/vote takes place. Minimum 5, Default 90
VotingIntervalMinutes: 90
# How long the vote stays open. Minimum 10, Default 300
VotingDurationSeconds: 300
# How long it takes before notifying. Minimum 0, Default 10
DelayTransitionDurationSeconds: 0
# How long it takes to change the preset/track after notifying. Minimum 2, Default 5
TransitionDurationSeconds: 5
# Preset specific settings 
# The cfg/ directory is always ignored for the presets pool.
Meta:
  # The name that is displayed when a vote is going on or the preset is changing
  Name: <Please change me>
  # Is this preset part of the voting, Admins can still change to this track.
  VotingEnabled: true

Place your presets in the presets folder, they need to include all files that would normally be inside your cfg folder.
Example folder structure:

📁presets
├── 📁preset_name_1
│   ├── 📁cm_content
│   ├── 📁reference
│   ├── 📁schemas
│   ├── 📄csp_extra_options.ini
│   ├── 📄data_track_params.ini
│   ├── 📄entry_list.ini
│   ├── 📄extra_cfg.yml
│   ├── 📄plugin_example_name_cfg.yml
│   └── 📄server_cfg.ini
└── 📁preset_name_2
    ├── 📁cm_content
    ├── 📁reference
    ├── 📁schemas
    ├── 📄csp_extra_options.ini
    ├── 📄data_track_params.ini
    ├── 📄entry_list.ini
    ├── 📄extra_cfg.yml
    ├── 📄plugin_example_name_cfg.yml
    └── 📄server_cfg.ini

Commands​

Most commands have multiple alias

Show current track / preset​

  • /currenttrack
  • /presetshow
  • /currentpreset

Vote for the next track / preset​

Server will ask users to vote for new map as per configured timeframe.

  • /votetrack <number>
  • /vt <number>
  • /votepreset <number>
  • /vp <number>
  • /presetvote <number>
  • /pv <number>

Admin commands​

List available tracks / presets​

  • /presetlist
  • /presetget
  • /presets

Change track / preset​

Exact usage is shown by track list

  • /presetset
  • /presetchange
  • /presetuse
  • /presetupdate

Initiate track / preset vote​

  • /presetstartvote
  • /presetvotestart

Finish track / preset vote​

  • /presetfinishvote
  • /presetvotefinish

Cancel track / preset vote​

  • /presetcancelvote
  • /presetvotecancel

Change to random track / preset with equal odds​

  • /presetrandom