Pages

Configuration

Drugs Config

In the config there are 3 sections:
  • Options
  • Drugs
  • Message

Section: Options

The following is the default configuration for the options:

Options:
    Prefix: "&0(&aDrugs&0)&f"
    Check_For_Updates: true
    Use_Custom_Perms: false
Option
Description
Prefix This is the prefix that appears before ALL messages
Check_For_Updates This enables update checking when you join the server
Use_Custom_Perms Toggles the ability to use custom perms for each drug

Section: Drugs

The following shows you how to customize, add or edit drugs and their properties
On the first line we put: Drugs: On the next line we put the id of the drug (item id), for example we have used sugar in the following (id: 353) Drugs:
    353: On the next line you can either put Effects, Random_Effects, Commands or Options
In this example we are going to do effects: Drugs:
    353:
        Effects: On the next line you specify the name of an effect from this list
In this example we are going to do speed: Drugs:
    353:
        Effects:
            Speed: On the next lines we specify the effect's duration (in seconds) and strength (0 for normal)
In this example we are going to have a duration of 20 seconds and a strength of 2
You can add as many Effects as you like Drugs:
    353:
        Effects:
            Speed:
                Duration: 20
                Strength: 2 Now (inline with Effects) we are going to add Random_Effects (this is optional) Drugs:
    353:
        Effects:
            Speed:
                Duration: 20
                Strength: 2
        Random_Effects: On the next line you specify the name of an effect using the same list as earlier
In this example we are going to do blindness: Drugs:
    353:
        Effects:
            Speed:
                Duration: 20
                Strength: 2
        Random_Effects:
            Blindness: On the next lines we specify the effect's duration (in seconds), strength (0 for normal) and, because it's Random_Effects, the % chance (without the % sign)
In this example we are going to have a duration of 20 seconds, a strength of 2 and a % chance of 40
You can add as many Random Effects as you like Drugs:
    353:
        Effects:
            Speed:
                Duration: 20
                Strength: 2
        Random_Effects:
            Blindness:
                Duration: 20
                Strength: 2
                Chance: 40 Now (inline with Random_Effects) we are going to add Commands (this is optional) Drugs:
    353:
        Effects:
            Speed:
                Duration: 20
                Strength: 2
        Random_Effects:
            Blindness:
                Duration: 20
                Strength: 2
                Chance: 40
        Commands: Commands are simple to add, you just do it like you would on the console (without the /) and replace the player's name with {player}
In this example we are going to make it burn the player (Essentials). You can add as many Commands as you want Drugs:
    353:
        Effects:
            Speed:
                Duration: 20
                Strength: 2
        Random_Effects:
            Blindness:
                Duration: 20
                Strength: 2
                Chance: 40
        Commands:
        - burn {player} 10 Now (inline with Commands) we are going to add Options (this is also optional funny enough) Drugs:
    353:
        Effects:
            Speed:
                Duration: 20
                Strength: 2
        Random_Effects:
            Blindness:
                Duration: 20
                Strength: 2
                Chance: 40
        Commands:
        - burn {player} 10
        Options: In the options you can specify a Name, Usage_Message and Permission (if Use_Custom_Perms: is set to true)
We are going to set the nickname as Cocaine (optional)
A usage message, it will replace {drug} with the drug's nickname or the id of the drug if the nickname is not set, we are going to set it as "You have just snorted some {drug}" (optional)
And a permission, this is described on this page, we are going to leave it blank Drugs:
    353:
        Effects:
            Speed:
                Duration: 20
                Strength: 2
        Random_Effects:
            Blindness:
                Duration: 20
                Strength: 2
                Chance: 40
        Commands:
        - burn {player} 10
        Options:
            Nickame: "Cocaine"
            Usage_Message: "You have just snorted some {drug}" You can add as many of these drugs as you want, if you want to use an id with a damage value then simply write it as you would do the normal drug id, but surround the id with quote marks eg: '17:1':
This is the end of this section!

Section: Message

The following is the default configuration for the messages: Message:
    Reload: "Config Reloaded!"
    No_Perm: "&4You Don't Have Permission!"
    Drug_Use: "You Have Just Used {drug}"
Message
Description
Reload This is the message that shows when you reload the config /drugs reload
No_Perm This is the message that shows when you don't have permission to do something
Drug_Use This is the message that shows when you use a drug (if the drug doesn't have a Usage_Message set), {drug} will be replaced with the nickname of the drug, or the id of the drug if it is not set

Final Config

For the final config you just add ALL of the sections above together
Options:
    Prefix: "&0(&aDrugs&0)&f"
    Check_For_Updates: true
    Use_Custom_Perms: false Drugs:
    353:
        Effects:
            Speed:
                Duration: 20
                Strength: 2
        Random_Effects:
            Blindness:
                Duration: 20
                Strength: 2
                Chance: 40
        Commands:
        - burn {player} 10
        Options:
            Nickame: "Cocaine"
            Usage_Message: "You have just snorted some {drug}" Message:
    Reload: "Config Reloaded!"
    No_Perm: "&4You Don't Have Permission!"
    Drug_Use: "You Have Just Used {drug}"