MC Plugin [1.13 - 1.19] CraftOfClans 0.9.0

Inspired by the famous game, CraftOfClans is growing your village, attacking others...

Trying to create the best gameplay like the real game, this plugin will manage all aspects.
The troops will not be presents but will be just the player who will have to attack others players, the player has to build his village carefully.
It's possible to withdraw the resources, simply clicking on the structure and using the GUI.
The structures can be purchased through the shop, using the gems, gold, elixir or dark elixir. The generation of the world is quite complex, every village will be large 208x208 and will possible to configure a maximum number of expansions for the village.
To give one example, the villages generation occurs as on PlotMe, but the structures are built (and claimed) when the player will create his village. Thanks to placeholder support you can integrate statistics into other plugins, for example to add scoreboard.


The plugin can be used in two ways:

1 - By creating villages in a flat world where you can't leave your village. To attack others is just random

• Full customizable (options and schematics)
• Support MySQL (raccomanded) and flat file
• Each player has own resources: gems, gold, elixir, dark elixir and the number of trophies
• Each player has own village, the allocation and generation system of the village provides for the creation of a 208x208 space where the player can build and upgrade all structures.
  Each village has a around walls that are generated during the creation step.
  Each structure can be upgrated and it's possibile set a limit based on level of the townhall, for example the gold mine can be placed only 2 times with townhall at level 1, but in townhall at level 2 it's possible placed it 3 times.
• The structures are based on schematics that are pasted to the ground through WorldEdit. It's possible to change all structures replacing them with the new schematics (max 16x16)
• Expansions 16x16, it's possible to claim by walking on chunk that you want to expand and it's possible set an increment cost for the expansion based on the number of expansions
• If you want the grass in the villages you can decide to remove it during the expansion or have it removed manually by the players by paying (option grass-removal-automatically-onexpand)
• It's possible to set a number of max expansions for each village
• Structures like gold mine and elixir collector are recharged with resources (customizable through configuration)
• Structures availables:
  
  
• 
  
• The structures can be purchased using a GUI
• The structures can be moved using a GUI (http://image.prntscr.com/image/d88db4ae31fd4bb4b3d09dffb341b219.png)
• It's possible to click right on all the structures to display information and withdraw resources
• Through a GUI, users can sell their materials (/coc sell)
• Attacks against other villages: the match will take into account the level of the town hall
• For disabling the structures during the attacks, simply break 3 times 4 blocks created next to each structure
• System of calculation for the structures destroyed at the end of attack, so as to assign the number of trophies
• During the attacks, the resources stolen from the opponent are updated in real time
• Tier system, users can unlock tier paying
• Support external plugins (check Required plugins, Featherboard, AnimatedNames, ActionBar and others..)
• Players can create clan, join and leave, show details using the command /clan show <clan name>
• Option player-can-build allows player to free construction in villages.
  
  
  
  
  
• Death chest after player death in attack (required Holographic Displays)
  
  

  
• Shield system for the attack
• Vault support: use the CoC economy as default for your server
• Freedom to add decorative structures
• Admins can destroy villages (using /coc destroy <player name>)
• Auto-destruction of villages if the player is inactive for 30 days (configurable)
• NPCs have a customizable skin
• Player tag system with different notification sound if players are in the same clan

Tiers are mines that users can unlock.
You can set a necessary step as requirements (es. tier 1, tier 2, tier 3) to buy all tiers.
You can create tiers, set the cost and set spawn point.
How to - create a new tier:

1. Select the area using WorldEdit
2. Use the command /tier create <name of new tier>
3. Remeber to set the cost of the new tier using /tier <cost_gems | cost_elixir | cost_gold | cost_dark_elixir > <name> <value>
4. The players can use the command /tier to open a GUI with all tier and can teleport after buying.
5. See the Command section for more info

Using the value tier-afterbuy-run-command in the config you can set a command that will be excuted after a player buy a new tier. Example: luckperms user {username} permission set coc.tier_{name}


Create a clan and fight against others
Users can create a new clan using a command /clan create
The wizard allows creating your own village in seconds. the owner may invite other members. The other players can see the clan statistics

• The owner of the clan can use /clan invite <player name> and the player must use /coc join <name clan> to join
• The owner can use /coc kick <player name>
• All members can use /coc leave to quit

Players can see the clan statistics using /clan show <clan name>

If you use essentials chat, you can use the prefix [coc_nameclan]

Player show info: /coc show <player name>

A player can attack another player simply using the command /coc attack
It's not possible attack a player that is in the same clan or if is online.
During the attack, the owner of village cannot enter in the server. (like the real game).
A shield will be created if the attack reaches a certain percentage. There are avaliable two options in the config: shield-duration-if-attack-50 and shield-duration-if-attack-85.
At the end of the attack will be given trophies (based on algorithm) to the player, and removed to the target player.

When an attack ends, the number of resources earned is indicated in chat.

Step to disabled a structure:


Troops

Operation is simple:
through the laboratory you can buy and upgrade troops and through the barracks you can train paying through elixir or gold.

For each attack, the player must re-train the troops and at the end he must take the item to be used during the attack.

Spawning troops at the moment will only attack the other enemy defenses (guardians and skeleton trap)




You can add an unlimited number of troops.The default troops for now are:

• Archer
• Barbarian
• Wizard

To work properly, I decided to use for CraftOfClans the following plugins as needed dependencies:

• Multiverse-Core
• WorldEdit (If you use 1.13 install WorldEdit 7.1.0, otherwise the latest version)
• WorldGuard
• Citizens (required last version)
• Sentinel(required last version)
• ProtocolLib (for entity management, in attack mode)
• EffectLib(for attacks)

For additional help you can also use (highly recommended)!

• Holographic Displays (highly recommended)
• Vault (uses the CoC economy as default on the server): Download here: https://github.com/itpao25/CraftOfClans-Vault/releases
• TitleManager
• AsyncWorldEdit
• MVdWPlaceholderAPI
  • {coc_player_gems}
  • {coc_player_gold}
  • {coc_player_elixir}
  • {coc_player_dark_elixir}
  • {coc_max_player_gold}
  • {coc_max_player_elixir}
  • {coc_max_player_dark_elixir}
  • {coc_player_trophies}
  • {coc_player_clan}
  • {coc_player_tier_last} (last tier bought by user)
  • {coc_player_tier_next} (next tier to buy for user)
• Placeholder API
  • %coc_player_gems%
  • %coc_player_gold%
  • %coc_player_elixir%
  • %coc_player_dark_elixir%
  • %coc_max_player_gold%
  • %coc_max_player_elixir%
  • %coc_max_player_dark_elixir%
  • %coc_player_trophies%
  • %coc_player_clan%
  • %coc_player_tier_last% (last tier bought by user)
  • %coc_player_tier_next% (next tier to buy for user)

CraftOfClans support the plugin Holographic Displays (by filoghost).
Beside the structures that provide resources (gold mines and elixir collector) it will present a hologram containing the basic information.

For the first installation, you must follow this step by step guide. If you have any problem in the installation you can contact me

Custom installation:

• You can set these generator options:
  • surface
    This is the last 20 blocks before the ground (es. WATER or COBBLESTONE)
  • surface-block-pattern
    This is the last block before the ground. If true, a pattern (listed in surface-block-list) will be used to create the ground. If you want a water you must set it to false
  • surface-grass.
    This is a block above the floor, that if true, a pattern (listed in surface-grass-list) will be used to create the ground. If you want a water you must set it to false
• Wall generator:
  The names of the schematics for the walls are
  - Wall.schematic: the walls that do not make an angle
  - WALL_CORNER.schematic: the walls that make an angle
  
  If you want change the default schematics (WALL, WALL_CORNER):
  1. Build a new structure in a separate world, that must be max 16x16.
  2. Select all block on chunk (at least in x,z), the height is't important, so select also the AIR
  3. Use worldedit to copy and save as schematics the structure (using //schem save WALL and WALL_CORNER)

How to change NPC skins

1. Check the Wiki page

/coc start | Start the creation of new village. Max one for player
Perms: coc.create

/coc shop | Buy structures for the villages
/coc shop buy <name in config.yml> | Buy structures for your village like a using the GUI (es. <name>: GOLD_MINE)
Perms: coc.shop

/coc expand | Create an expansion for your personal village
Perms: coc.expand

/coc sell | Sell items for a gems
Perms: coc.sell

/coc give <player> < gems | gold | elixir | dark_elixir > <amount> | Give resources to a player
Perms: coc.give.*
coc.give.gems
coc.give.gold
coc.give.elixir
coc.give.dark_elixir

/coc set-resources <player> < gems | gold | elixir | dark_elixir > <amount> | Set resources to a player
Perms: coc.set-resource.*
coc.set-resource.gems
coc.set-resource.gold
coc.set-resource.elixir
coc.set-resource.dark_elixir

/coc remove-resources <player> < gems | gold | elixir | dark_elixir > <amount> | Remove resources to a player
Perms: coc.remove.*
coc.remove.gems
coc.remove.gold
coc.remove.elixir
coc.remove.dark_elixir

/coc pay <player> < gems | gold | elixir | dark_elixir > <amount> | Allow trade between players
Perms: coc.pay.*
coc.pay.gems
coc.pay.gold
coc.pay.elixir
coc.pay.dark_elixir

/coc info | View your stats
Perms: coc.info

/coc show <player name> | View a player info

/coc tp [player name] | Tp on your village
Perms: coc.tp
coc.tp.other

/coc attack | Start an attack
Perms: coc.attack
Perms: coc.attack.passcmd - Bypass block command in attack mode

/coc destroy <player name> | Destroy a village
Perms: coc.destroy

TIERS:
/tier | View list of tiers available
/tier buy <name> | Buy tier (like using the GUI)
/tier tp <name> | Teleport to tier (like using the GUI)
Perms: coc.tier.gui

Admin:

/tier create <name> | Create a new tier, select firts area using WorldEdit
/tier spawnpoint <name> | Set the spawnpoint for tier
/tier add-player <tier name> <player name> | Add tier to a player
/tier remove-player <tier name> <player name> | Remove tier from player
/tier <cost_gems | cost_elixir | cost_gold> <name> <value> | Set cost for the tier
/tier add-requirement <tier name base> <tier name 2> | Set an obligatory purchase route, force the player to buy one tier of the other first
/tier remove-requirement <tier name base> <tier name 2> | Undo an obligatory purchase route
Perms: coc.tier.admin

CLANS:
/clan create | Create a new clan
/can invite <player name> | Invite user to a clan
/clan join <clan name> | Join in the clan
/clan kick <player name> | Kick player from your clan
/clan leave | Get out from your clan
/coc disband | Disband the clan
/clan list [page], /clan stats [page] | List of all clans

- The clan owner can:
/clan name <new name>
/clan desc <new desc>
/clan min-trophies <new minium trophies to join>