Bukkit

I know lots of people have problems with the config.txt system, so I've dedicated this page to explaining how the config.txt is organized and how to use it. The config.txt is an important file used by myUltraWarps to allow admins to configure different settings for myUltraWarps.

There are two different ways that settings will be displayed in the config.txt: as a specific setting or as a question. Specific settings have a very brief description of the setting followed by a colon. You can change the text after the colon to change these settings. This setup is used for settings that cannot be described with an answer to a "yes" or "no" question like the default warp messages. The question setups are unique to this plugin and can sometimes seem confusing, but they're actually very easy to use. If you come across a question in the config.txt, all you have to do is answer the question if you want to change that setting. These questions accept a variety of answers from "Yes." to "no" to "Nah" to "hell no.". Right below any question, there will be a line that's partially indented with a statement relating to the question above it. This is the setting's current status message. It tells you how that setting the question concerns is currently configured. This may seem confusing, but it's actually simpler than it sounds. Below in the example config.txt, there are many examples of both kinds of settings. You do not need to answer every question every time you modify the config.txt! Just answer the ones you want to change.

This is what a standard config.txt might look like when you open it for the first time (with comments from me added in in italics):

Remember to use /myUltraWarps save the config before you modify this file if autosave is off and use /myUltraWarps load the config when you're done.

This sentence is a very important reminder! You must use /mUW load the config to load your configurations after you make your changes in the config.txt file or your changes will be lost!

Do you want to be able to change settings for permissions-based groups of users?
   Group settings are enabled right now.

Above is a perfect example of a question setup. If you want to turn group settings on or off, just answer the question above accordingly. Below the question is the status message, stating that "Group settings are enabled right now." If you want group settings to be enabled, you don't have to answer "yes" to this question. Just leave it blank and it will not change.
By the way, this specific setting can only be turned on if you have Vault on your server. If you try to turn it on without Vault, it will tell you so.

Do you want myUltraWarps to check for updates every time it is enabled? 
   Right now, myUltraWarps will auto-update.

The question above lets you turn the myUltraWarps updater (added in v7) on or off. I highly suggest you keep it on!!

Do you want myUltraWarps to automatically save the warps file every time a change is made? 
   Right now, autosave is off for warps.
Do you want myUltraWarps to automatically save the switches file every time a change is made? 
   Right now, autosave is off for switches.
Do you want myUltraWarps to automatically save the config file every time a change is made? 
   Right now, autosave is on for the config.

The section above is the file autosaving configuration section. You can configure whether autosaving is on or off for every standard file that myUltraWarps generates. By default, autosaving is off for switches and warps because people change these settings so often on most servers that turning it on might cause high C.P.U. and RAM usage. The config autosaving, however, is on by default because the config commands aren't used as often.

You can set the messages that appear when someone teleports to the spawn point for each world here.
     world: &aWelcome to world, [player].
     world (The Nether): &aWelcome to The Nether, [player].
     world (The End): &aWelcome to The End, [player].

Above is an example of the specific setting setup. The text after the colons on the three lines above are the default messages for the world spawn messages. You can change the spawn messages for each world by changing the text after the colons above.

Below is a bunch of sets of settings for different groups of people. The settings observed by each player are the ones that are the most specific that apply to them. For example, say the cool down time for the whole server (found under global settings) is 3 hours, the cool down time for players in the "user" group (found under group settings:) is 1 hour, and the cool down time for a player called DaPlaya (found under individual settings:) is 5 minutes. Even if DaPlaya is in the "user" group, his/her cool down time will be 5 minutes because the individual setting is the most specific setting that applies to them. DaPlaya2 could be in the "user" group, but have no specified individual settings. DaPlaya2, therefore, would have a 1 hour cool down time because the group settings are the most specific settings that apply to them.
Under global settings:, you can set a number of settings that apply by default to anyone on the server unless there are more specific group or individual settings that apply to them instead.

global settings:
     Do you want players to be able to teleport to one another without asking permission? 
        Right now, players normally have to request teleportation to the target player.
     Do you want players to be able to teleport other players places without asking permission? 
        Right now, players normally have to request that other players teleport to them.
     default warp message: &aWelcome to the [warp].
     default no warp message: &cYou're not allowed to warp to [owner]'s [warp].
     max warps: infinite
     cool down time: 0 seconds
     warp history length: 20
     death history length: 5

The group settings: section only appears if you allow group settings (see the first question in the config.txt) and you have Vault. You can set a bunch of different settings for each permissions group. myUltraWarps will automatically load all of your group names and make sections like these for them in group settings: (except for the "default" group if you have one; you can just use the global settings: section to configure that group's settings).

group settings:
     admin:
          Do you want players in this group to be able to teleport to one another without asking permission? 
             Right now, players in this group normally have to request teleportation to the target player.
          Do you want players in this group to be able to teleport other players places without asking permission? 
             Right now, players in this group normally have to request that other players teleport to them.
          default warp message: &aWelcome to the [warp].
          default no warp message: &cYou're not allowed to warp to [owner]'s [warp].
          max warps: infinite
          cool down time: 0 seconds
          warp history length: 20
          death history length: 5
     user:
          Do you want players in this group to be able to teleport to one another without asking permission? 
             Right now, players in this group normally have to request teleportation to the target player.
          Do you want players in this group to be able to teleport other players places without asking permission? 
             Right now, players in this group normally have to request that other players teleport to them.
          default warp message: &aWelcome to the [warp].
          default no warp message: &cYou're not allowed to warp to [owner]'s [warp].
          max warps: infinite
          cool down time: 0 seconds
          warp history length: 20
          death history length: 5

The individual settings: section allows you to configure settings for specific players. This section might not be used on most servers. If there are no set individual settings, myUltraWarps will generate something like the text below, using the imaginary player 1mAnExampl3 to show you an example of the layout of a set of individual settings.

individual settings:
     1mAnExampl3:
          Do you want 1mAnExampl3 to be able to teleport to others without asking permission? 
             Right now, 1mAnExampl3 normally has to request teleportation from the target player.
          Do you want 1mAnExampl3 to be able to teleport other players places without asking permission?
             Right now, 1mAnExampl3 normally has to request that other players teleport to them.
          default warp message: &aWelcome to the [warp].
          default no warp message: &cYou're not allowed to warp to [owner]'s [warp].
          max warps: infinite
          cool down time: 0 seconds
          warp history length: 20
          death history length: 5