DeluxeCombat Wiki - Historical

Applied By timderspieler: Aug 26, 2019 at 10:20 AM

DeluxeCombat Wiki
[​IMG]

This is the official wiki page of DeluxeCombat.

If you have interest in the plugin you can purchase it here:
https://www.spigotmc.org/resources/63970/
[​IMG]

Permissions:
  • deluxecombat.bypasscommand ( Use blocked cmds in combat )
  • deluxecombat.bypassquit ( Combatlog without punishment )
  • deluxecombat.bypasshitdelay ( Hit without delay )
  • deluxecombat.admin ( Needed for /dc reload / clearcorpses / clearnpcs / createHologram / createSign / clearHolograms / menu / setValue )
  • deluxecombat.status.check ( Needed for /dc status )
  • deluxecombat.status.check.other ( Needed for /dc status (Player) )
  • deluxecombat.stats.check ( Needed for /dc stats )
  • deluxecombat.stats.check.other ( Needed for /dc stats (Player)
  • deluxecombat.stats.reset ( Needed for /dc resetstats )
  • deluxecombat.stats.reset.other ( Needed for /dc resetstats (Player)
  • deluxecombat.bypass.enderpearl ( Bypass enderpearl restrictions )
  • deluxecombat.bypass.chorusfruit ( Bypass chorus fruit restrictions )
  • deluxecombat.view.kill-recaps ( View kill recaps )
  • deluxecombat.view.leaderboards ( View leaderboards )
Commands:
  • /dc help ( Shows help message )
  • /dc status ( Shows your combat status )
  • /dc status (Player) ( Shows the combat status of a player )
  • /dc clearcorpses ( Removes all spawned corpses )
  • /dc clearnpcs ( Removes all spawned npcs )
  • /dc killrecaps ( View all recent kill recaps ordered by date )
  • /dc viewrecap (ID) ( View a certain kill recap )
  • /dc menu ( Open Admin panel )
  • /dc setValue (Value) ( Set value on configuration request )
  • /dc stats ( Shows your stats )
  • /dc stats (Player) ( Shows the stats of a player )
  • /dc leaderboard/lb (Stats) ( Shows a leaderboard )
  • /dc createHologram (Stats) (Amount) ( Creates a leaderboard hologram )
  • /dc createSign ( Gives information on how to create a leaderboard sign )
  • /dc clearHolograms ( Removes all placed holograms )
  • /dc reload ( Reloads all config values )
[​IMG]
  1. Download the newest version of DeluxeCombat.
  2. Drop the DeluxeCombat v.X.X.X.jar into your spigot plugins folder
  3. Start the server.
  4. Apply the deluxecombat.admin permission to your account and all other wanted permissions to your players permission group.
  5. Configure the plugin ingame with /dc menu ( if you enable support for certain plugins, you need to restart the server afterwards because deluxecombat only hooks into plugins on the server start )
  6. Add / Remove disabled worlds and configure the sql settings in the config.yml
  7. Reload the plugin with /dc reload ( SQL Settings are applied after server restart )
  8. DONE!
[​IMG]
You can use papi placeholders in nearly all messages of deluxecombat. Simply add them into the lang.yml in your disired message. Furthermore you can use deluxecombat placeholders in other plugins ( Such as Tablist / Scoreboard plugins etc. ) if you have PlaceholderAPI installed.

All current PAPI Placeholders of deluxecombat can be found HERE
[​IMG]
Create a combat-region-border
Region borders only appear once you are in combat. These borders are invisible but they will push you back when you have reached them. This border is the outline of every worldguard region with a pvp deny flag. So the border prevents players from entering non pvp regions while they are in combat. You dont need to setup anything for this. Only activate worldguard support and enable the combat region borders. ( You need the worldguard addon for this! )

Create a leaderboard

Needs the ranking system to be enabled!

If you want to create a leaderboard you need to decide if you want to have a leaderboard created with signs or a leaderboards created with holograms ( If you choose the second option you need to install HolographicDisplays on your server )

Create a leaderboard with signs

  1. Place a sign at the wanted location
  2. Line 1: [DC]
  3. Line 2: {STATS}
  4. Line 3: {RANK} ( The rank you want to get displayed )
  5. Line 4: EMPTY
  6. Press ESC. DONE!
Create a leaderboard with holograms
  1. Stand on the wanted block
  2. Type in /dc createHologram {STATS} {AMOUNT}
  3. Done!

{STATS}: Available stats: KILLS, DEATHS, POINTS, COMBATLOGS
{AMOUNT}: The amount of displayed stats

IMPORTANT: The leaderboard wont get updated directly unless you wait for the update interval you have set in the config.yml or have typed in /dc reload!


[​IMG]
Both of the files config.yml and lang.yml are up-to-date and have their own purpose, one to configure options and the other one to configure messages and formats. If you need help with those files, do not hesitate to contact us as soon as possible. Last update: 25.08.19
Code (YAML):
[/FONT]
##############################################################################################################
#                                                                                                            #
# ______     _                _____                 _           _                                            #
# |  _  \   | |              /  __ \               | |         | |                                           #
# | | | |___| |_   ___  _____| /  \/ ___  _ __ ___ | |__   __ _| |_                                          #
# | | | / _ \ | | | \ \/ / _ \ |    / _ \| '_ ` _ \| '_ \ / _` | __|                                         #
# | |/ /  __/ | |_| |>  <  __/ \__/\ (_) | | | | | | |_) | (_| | |_                                          #
# |___/ \___|_|\__,_/_/\_\___|\____/\___/|_| |_| |_|_.__/ \__,_|\__|                                         #
#------------------------------------------------------------------------------------------------------------#
#                                                                                                            #
# Thank you for purchasing DeluxeCombat - An ultimate powerful combat resource for every server              #
#                                                                                                            #            
# This is one of the configuration files of the DeluxeCombat plugin.                                         #
# Here, you can configure the basic plugin. If you want to change all messages, switch to the lang.yml       #
#                                                                                                            #
# The plugin supports following server versions: 1.8.x, 1.9.x, 1.10.x, 1.11.x, 1.12.x, 1.13.x, 1.14.x        #
#                                                                                                            #
# Any problems? Write me a private message on spigot! Spigot: www.spigotmc.org/members/199727/               #
#                                                                                                            #
# ~ Marido, timderspieler                                                                                    #
#                                                                                                            #
# Useful: You can use colorcodes '&' in nearly all string configurations                                     #
#                                                                                                            #
##############################################################################################################

#
# !IMPORTANT!: Most of the config values have been moved to the ingame settings editor! Use /dc menu for that!
#

Storage
:

  # Following types are available: MYSQL, SQLITE
  # 'MYSQL' stores the data in a Database on your MySQL Server ( Better, for multiservers )
  # 'SQLITE' stores the data in a flatfile database in the plugin folder ( CAN BE SLOW! )
 
  type
: "SQLITE"
 
  MySQL
:

    # You need to set following things up when you selected 'MYSQL' above
   
    # !WARNING! If you did something wrong here (Wrong password, username etc.)
    # the plugin disables itself!
   
    username
: "DeluxeCombat"
    password
: "1234"
    database
: "DeluxeCombat"
    host
: "localhost"
   
    # If you didnt change the port of the mysql server, dont touch this!
    port
: "3306"

Point-Ranking-System
:

  # Here you set different displaynames for your
  # players on each rank. You can add more
  # displaynames with <RANK>:<DISPLAYNAME>
  # The rank "0" sets a displayname for all
  # players who are not in the e.g top 3.
  displayname
:
 - "1:&a&l#1 &r&f%player%"
  - "2:&e&l#2 &r&f%player%"
  - "3:&c&l#3 &r&f%player%"
  - "0:&7&l#>3 &r&f%player%"

Custom_Items
:

  # Custom items, or better said: Custom tools are
  # normal items/tools with cool effects bind to them.
  # You can e.g add WOOD_SWORD to this list and every
  # wooden sword on the server has from now on these
  # special effects. You need a configured permission
  # to see these effects.
 
  # Simply add any material you want into this section
  STICK
:

    # Set a permission you need to have to see the
    # effects / particles / sounds
    permission
: "customtool.stick"
   
    # Following modes are available:
    # 'PLAYER': Fired when you hit a player
    # 'ANIMAL': Fired when you hit an animal
    # 'BOTH': Fired when you hit a player / an animal
    enemy_mode
: "BOTH"
   
    # Following target modes are available:
    # 'ENEMY': Effects / Sounds / Potioneffects will be applied to the enemy
    # 'PLAYER': Effects / Sound / Potioneffects will be applied to you the player
    target
: "ENEMY"
   
    # Particles will appear at the target you have hit
    # with you custom tool
    particle
:
 
      # Particle name
      name
: "HEART"
     
      # Select an amount of particles that
      # will appear on your choosen target
      amount
: 10
     
    # A potioneffect will be applied to your choosen target
    effect
:
 
      # Potioneffect name
      name
: "NIGHT_VISION"
     
      # Select an amplifier for the potioneffect
      amplifier
: 1
     
      # Select a duration of the effect in seconds
      duration
: 5
     
    # Select a sound that will be played when you hit your target
    sound
:
 
      # Sound name
      name
: "ENTITY_PIG_HURT"
     
      # Select a volume and pitch ( Integer only )
      volume
: 1
      pitch
: 1

Rewards
:

  # Enable or disable rewards
  enable
: true
 
  # Give players rewards for killing animals or players
 
  # If you have e.g 'permission-one' you will get a diamond
  # If you have e.g 'permission-two' you will get 100 money
  # You can add as many permissions / commands as you want
  # Dont use dots. '-' will be replaced with a dot
  # So 'permission-one' is actually 'permission.one'
  permissions
:

    permission-one
:
 
      # Decide when this reward will be triggered
      # Kill modes:
      # 'PLAYER': Rewards for killing a player (Playerholder: %victim%)
      # 'ANIMAL': Rewards for killing an animal (Placeholder: %animal%)
      # 'MONSTER': Rewards for killing a monster (Placeholder: %monster%)
      # 'BOTH': Rewards for killing players / animals (Placeholder: %entity%)
      kill_mode
: "PLAYER"
     
      # Commands executes on when killing a 'kill_mode'
      # Placeholders:
      # %victim% Name of the killed player (Only in kill_mode player)
      # %player% Name of the player
      # %animal% Name/Type of the killed animal (Only in kill_mode animal)
      # %entity% Name of the killed enemy (Only in kill_mode both)
     
      # Available cmds:
      # [CMD] <arguments> : Runs command from console
      # [MSG] <message> : Sends message to the player
      # [TITLE] <message> : Sends title to the player
      # [SUBTITLE] <message> : Sends subtitle to the player
      cmds
:
     - "[TITLE] &a&l+1 Kill"
      - "[SUBTITLE] &cYou killed %victim%"
      - "[CMD] give %player% diamond 1"
     
    permission-two
:
 
      # Decide when this reward will be triggered
      # Kill modes:
      # 'PLAYER': Rewards for killing a player (Playerholder: %victim%)
      # 'ANIMAL': Rewards for killing an animal (Placeholder: %animal%)
      # 'MONSTER': Rewards for killing a monster (Placeholder: %monster%)
      # 'BOTH': Rewards for killing players / animals (Placeholder: %entity%)
      kill_mode
: "ANIMAL"
     
      # Commands executes on when killing a 'kill_mode'
      # Placeholders:
      # %victim% Name of the killed player (Only in kill_mode player)
      # %player% Name of the player
      # %animal% Name/Type of the killed animal (Only in kill_mode animal)
      # %entity% Name of the killed enemy (Only in kill_mode both)
     
      # Available cmds:
      # [CMD] <arguments> : Runs command from console
      # [MSG] <message> : Sends message to the player
      # [TITLE] <message> : Sends title to the player
      # [SUBTITLE] <message> : Sends subtitle to the player
      cmds
:
     - "[SUBTITLE] &c&lWhy did you kill &4&l%animal%"
      - "[MSG] &eDont do that again %player%!"
      - "[CMD] give %player% barrier 1"

[FONT=Arial]
Code (Text):

##############################################################################################################
#                                                                                                            #
# ______     _                _____                 _           _                                            #
# |  _  \   | |              /  __ \               | |         | |                                           #
# | | | |___| |_   ___  _____| /  \/ ___  _ __ ___ | |__   __ _| |_                                          #
# | | | / _ \ | | | \ \/ / _ \ |    / _ \| '_ ` _ \| '_ \ / _` | __|                                         #
# | |/ /  __/ | |_| |>  <  __/ \__/\ (_) | | | | | | |_) | (_| | |_                                          #
# |___/ \___|_|\__,_/_/\_\___|\____/\___/|_| |_| |_|_.__/ \__,_|\__|                                         #
#------------------------------------------------------------------------------------------------------------#
#                                                                                                            #
# Thank you for purchasing DeluxeCombat - An ultimate powerful combat resource for every server              #
#                                                                                                            #            
# This is one of the configuration files of the DeluxeCombat plugin.                                         #
# Here, you can configure the messages. If you want to change all settings, switch to the config.yml         #
#                                                                                                            #
# The plugin supports following server versions: 1.8.x, 1.9.x, 1.10.x, 1.11.x, 1.12.x, 1.13.x, 1.14.x        #
#                                                                                                            #
# Any problems? Write me a private message on spigot! Spigot: www.spigotmc.org/members/199727/               #
#                                                                                                            #
# ~ timderspieler                                                                                            #
#                                                                                                            #
##############################################################################################################
# COMBAT-LOGGER
combat-logger:
 damage-to-enemy: '&eYou are now in &ccombat &ewith &6%victim% &eso do not quit.'
 damage-from-enemy: '&6%damager% &eis now in &ccombat &ewith you so do not quit.'
 disabled-command: '&eYou can not use the command &c%command% &ewhile in combat.'
 leave-broadcast: '&c%player% left while in combat with %damager% and has played himself.'
 items-broadcast: "&4%player%'s &citems are at: &4%world%&c, &4%x%, %y%, %z%"
 combat-expired: '&eYou are &anot &ein combat anymore and allowed to quit.'
 enderpearl-disabled-during-combat: "&cYou cant use enderpearls during combat!"
 chorusfruit-disabled-during-combat: "&cYou cant use chorus fruits during combat!"
 deny-pvp-deny-enter: "&cYou cant enter this region during a fight!"
 display-time-bossbar: "&e&o%time%s &r&c&lCombat Mode &r&e&o%time%s"
 display-time-actionbar: "%progressbar% &r&e- &c%time%s"

death-causes:
  void: "&c%player% &efelt into the void"
  void_player: "&c%player% &ewas thrown into the void by &c%killer%"
  shoot: "&c%player% &ehas been shot by &c%killer%"
  drown: "&c%player% &edrowned"
  lava: "&c%player% &etook a bath in lava"
  fall: "&c%player% &edidnt knew that this hill was too high"
  magic: "&c%player% &edidnt knew that this trink was poisened"
  magic_player: "&c%killer% &egave &c%player% &etoo much of the good shit"
  fire: "&c%player% &eplayed with fire"
  none: "&c%player% &edied"
  sword_kill: "&c%player% &egot stapped by &c%killer%"

# Corpses
corpses-messages:
- "&c&o%player% &e&otook the L"
- "&c&lR.I.P %player%"
- "&eG3t R3kt &c%player%&e!"
- "%player% is buried here!"
- "&c%player% &edidnt saw this one coming!"

# DEATH-SIGN
death-sign:
  line1: "R.I.P"
  line2: "%player%"
  line3: "Died for"
  line4: "combatlogging"

# Points-Ranking-System
Points-Ranking-System:
  unknown-input-stats: "&cUnknown input: Please choose one of these stats: KILLS, DEATHS, POINTS, COMBATLOGS"
  not-loaded-atm: "&cThese stats are not loaded at the moment! Try again later!"
  disabled: "&cThe ranking system is disabled at the moment!"
  reset: "&cYour stats have been cleared!"
  reset-other: "&cThe stats of &4%player% &chave been cleared!"
  add-kill: "&a&l+1 &r&7Kill"
  add-death: "&c&l+1 &r&7Death"
  add-points: "&a&l+%points% &r&7Points"
  remove-points: "&c&l-%points% &r&7Points"
  your-rank: "&7Your rank is: &a#%rank%&r&7. Rank calculated by %value%"
  players-rank: "&7The rank of %player% is: &e#%rank%&r&7. Rank calculated by %value%"
  hd-line-header: "&c* &fTop %amount% PvP Players (&7Ordered by: &a%value%&7) &c*"
  hd-line-footer: "&c&oEnd of the list"
  hd-line-value: "&e%rank%. &b%player% &7- &e%amount%"
  sign-layout:
  - "#%rank%"
  - " "
  - "&o%player%"
  - "%amount% %value%"
  pvp-stats:
  - "&4&m#&c&m---------------------------------&4&m#"
  - "                  &cPvP Stats                  "
  - "                  &e%player%                   "
  - " "
  - "&8- &cKills: &e%kills%"
  - "&8- &cDeaths: &e%deaths%"
  - "&8- &cK/D: &e%kd%"
  - "&8- &cCombatlogs: &e%combatlogs%"
  - "&8- &cPoints: &e%points%"
  - "&8- &cRank: &e#%rank% &7(%sort%)"
  - "&4&m#&c&m---------------------------------&4&m#"
  loading-data: "&7&oLoading data..."

# GENERAL
general:
  headshot-actionbar: "&a&oHeadshot for %player%!"
  # Use '=' to seperate lore lines
  kill-recap:
    click-to-view-recap: "&7Click to view the &e&lRECAP &r&7of this fight!"
    close: "&c&lClose"
    close-lore: "&7Click to close"
    list-recap: "&6%killer% &b&lvs. &r&c%victim%"
    list-recap-lore: "&7See informations about this fight=&7Date: %date%"
    inv-name: "&4Kill Recap"
    victim: "&cVictim: &4%victim%"
    victim-lore: "&7This play got killed by &6%killer%"
    killer-weapon: "&c&lWeapon: &r%item_name%"
    killer-weapon-lore: "&7The killer used this weapon"
    damage-dealt: "&cDamage dealt"
    damage-dealt-lore: "&7The damage the victim=&7has dealt during fight= =&eDamage dealt: &c%damage_dealt%"
    damage-taken: "&eDamage taken"
    damage-taken-lore: "&7The damage the victim=&7has taken during fight= =&eDamage taken: &c%damage_taken%"
    killer: "&eKiller: &6%killer%"
    killer-lore: "&7This player killed &c%victim%= =&eDamage taken: &c%damage_taken%=&dHearts left: %hearts_left%=&eDamage dealt: &c%damage_dealt%"
    assistants: "&bAssistants"
    assistants-lore: "&7These players have assisted=&7the killer: %assistants%"
    assistant-lore: "&e- &b%assistant_name%&e, &a↑ %damage_dealt%&e, &c↓ %damage_taken%"
  flying-not-allowed-during-combat: "&cFlying is not allowed during combat!"
  please-wait-enderpearl: "&cPlease wait &4%time% &cmore seconds until you can use a endepearl again"
  please-wait-chorusfruit: "&cPlease wait &4%time% &cmore seconds until you can use a chorus fruit again"
  enderpearls-disabled: "&cEnderpearls are disabled on this server"
  chorusfruits-disabled: "&cChorusfruits are disabled on this server"
  player-not-online: "&cThis player is not online!"
  player-not-in-combat: "&a%player% &7is not in combat mode!"
  player-in-combat: "&c%player% &7is in combat mode!"
  still-in-combat: "&cYou are still in combat! Dont leave the server!"
  not-in-combat: "&aYou are not in combat! You can leave the server!"
  deny-gamemode: "&cYou cant hit other players while you are in creative gamemode!"
  no-permission: "&cYou dont have Permission!"
  help-message: "&7Type in &c/dc help &7for help!"
  help-list:
  - "&4&m#&c&m---------------------------------&4&m#"
  - "                  &cDeluxeCombat               "
  - " "
  - "&8- &c/%cmd% help &8> &7Shows this message"
  - "&8- &c/%cmd% status [Player] &8> &7Shows your combat status"
  - "&8- &c/%cmd% stats [Player] &8> &7Shows your pvp stats"
  - "&8- &c/%cmd% resetstats &8> &7Reset your stats"
  - "&8- &c/%cmd% lb (Stats) &8> &7Shows stats leaderboard"
  - " "
  - "&8(): &cRequired&7, []: &cOptional"
  - "&4&m#&c&m---------------------------------&4&m#"
# Have fun with DeluxeCombat on your server, you reached the end.
# Love the resource? Consider to review it on the resource thread.

 

[​IMG]
Check if the plugin is enabled:

Code (Java):
    public void yourMethod() {
 
        if (Bukkit.getPluginManager().getPlugin("DeluxeCombat") != null) {
     
            // YOUR CODE HERE
     
        }
 
    }
Initialize the API:

Code (Java):
    public void yourMethod() {
 
        if (Bukkit.getPluginManager().getPlugin("DeluxeCombat") != null) {
     
            DeluxeCombatAPI dc_api = DeluxeCombat.getAPI();
     
            // . . . .
     
        }
 
    }
Methods:

Code (YAML):
(int) getPoints(Player), getKills(Player), getDeaths(Player), getCombatlogs(Player), getRemainingCombatTime(Player)
(void) addPoints(Player, Integer), removePoints(Player, Integer)
(boolean) isInCombat(Player)

All icons are from www.flaticon.com
[​IMG]