Introduction to settings
As you can probably guess from the fact that an entire help document exists for settings, these little guys are pretty important to us. We first recognized the need for settings years ago on February 7, 2015, with the release of The Toggle Update. Back then, settings could only have an "enabled" or "disabled" value, and the interface and implementation was clunky. However, it addressed the reality that players want to be able to control their experience on a server. When we redid all of SynergySuite and released Synergy 2.0 on August 3, 2016, we completely overhauled the setting system, doubled the number of settings offered, and added the now-extremely-popular GUI interface. This document provides a thorough tutorial about settings, in addition to listing every single setting currently offered.
Your setting preferences are localized to each world group. This means that you could possibly have chat fully enabled in Plots while having only messages that mention your name be visible for a more peaceful playing experience in Survival. All of this is handled by the server autmoatically, so you don't need to manually change these values yourself.
Settings can be managed by two ways: commands and the GUI.
Managing your settings with commands
/settings list- Lists all settings you have access in the format
setting identifier: current valueand grouped by category.
/settings info <setting> [value]- Provides additional info about the given setting, including a description about it and its valid values. If a value is provided for
[value]then additional information about that value is given instead. Providing info about values is primarily intended for mutli-option settings, as each value functions differently instead of being a simple "on/off" for a behavior.
/settings set <setting> <value>- Changes the value of a setting.
<setting>refers to the setting's identifier, while
<value>is the value that you wish to set that setting to. Two-value settings, AKA toggle settings, accept
falseas valid values, where
trueenables the behavior of the setting and
falsedisables the behavior. For multi-option settings you should refer to their own valid values by running the info command on them.
Managing your settings with the GUI
- Open the GUI by doing
/settingstemporarily works as shortcut but we may remove this in the future.
- In the top row are your setting presets. More on what those are in a little bit.
- In the middle rows are the settings.
- In the bottom row is the navigation to switch the view between the different setting categories.
- To see more information about something (such as its name or description), hover over it. To load/change/open it, simply click on the item.
- For toggle settings, clicking on the item toggles the value of the setting. For multi-option settings, clicking on the item cycles through its values.
Settings that help out with the mundane things in redstoning and building.
drops- Allows item drops to be created when pressing the item drop key or breaking inventory holders.
night_vision- Gives an unlimited night vision potion effect with no particles,
flip_slabs- Automatically makes slabs flip to the top half of the block when placed.
fill_cauldrons- Automatically fills cauldrons to the brim when placed.
remove_torches_on_redstone_blocks- Automatically removes redstone torches after they're placed on redstone blocks.
noclip- Switches your gamemode to spectator whenever you get near a block.
Settings that alter the behavior of teleportation.
full_teleportation- If switching worlds, teleports you to the intended destination instead of to your last location in the targeted world.
teleports- Allows players to teleport to you.
notify_tp_target- Notifies your target when using /tp that you've teleported to them.
Settings that alter the look or behavior of your personal chat.
receive_afk_notifications- Notifies you whenever a player's status changes.
emit_afk_notifications- Notifies other players whenever your AFK status changes.
name_highlighting- Highlights your name when it's mentioned in chat messages.
colored_chat- Displays chat messages in their fully formatted and colored glory.
remove_excessive_caps- Forces messages sent to you to lowercases if they contain a large percentage of capitalized letters.
hide_spam- Prevents recently duplicated messages by the sender from being sent to you.
connection_messages- Shows join and leave messages for players.
minimal_chat- Hides all messages that don't target or mention you.
minechat_join_message- If set to false, then this plugin will try to prevent MineChat's automatic join message from being sent by you.
Settings that only special people can access, such as staff and Distinguisheds.
join_unvanished- Automatically unvanishes you when logging on the server.
announce_quit- Announces that you've left the server if you leave while unvanished.
chat_while_vanished- Allows chatting while vanished. Try not to blow your cover!
staff_chat- Directs all of your chat messages to StaffChat.
Settings that don't quite fit into the other categories.
alert_sounds- Plays a sound whenever someone tries to get your attention (e.g. Teleport requests, mentioned in chat, etc)
afk_target_notification- Notifies you whenever the person you try to interact with is AFK.
allow_spectators- Allows other players to spectate you.
Introduction to setting presets
Setting presets are a saved collection of values for settings that you can load at a later time. These are particularly useful for people who like to have multiple playing environments, like those who record videos on the server or those that switch between building and redstoning.
Presets can currently only be managed through commands, but you can load previously-created presets through the settings GUI.
/settings preset create <name>- Creates a preset from your current settings with the given name.
/settings preset delete <name>- Deletes the preset with the given name.
/settings preset load <name>- Loads the the given preset into your current settings.
/settings preset list- Lists all of your presets.