# Wars Lands features a war system which allows other lands to fight against each other. This page only explains the basic options you should start with configuring. There are even more options in the `wars.yml` file. They're all self explanatory (with comments) in the `wars.yml` file located in the `plugins/Lands` folder. The full file can be viewed here: ## Before the War To declare war against a land or nation execute `/wars declare `. Then the defender receives a war declaration with more information, like when the war time starts and the tribute which the attacker set. The tribute is payed by the defender to the attacker, in case the defender surrenders. War declarations can be disabled by setting the preparation time to 0 below. ### Minimum amount of Players Set the minimum amount of trusted players a land needs to have to be allowed to engaged in a war. ```yaml min-players: # Set minimum amount of trusted players for the declaring attacker. attacker: 0 # Set minimum amount of trusted players for the defender to receive a war declaration. defender: 0 ``` ### War Preparation Time How much time do you want to give the defender lands for war preparation, before it will start? ```yaml # Default is one day preparation-time: 1d ``` ### Mutual War Declarations Should war declarations need a mutual acceptation? If enabled, the defender land needs to confirm the declaration before the war can start. They need to do this by executing `/wars declare `. They can deny a war declaration by executing `/wars deny`. ```yaml mutual: enabled_2: false # Should the declaration be deleted if the enemy did not accept it during the configured period? # You can disable this by setting the value to 0. # timeout: 5d ``` ## During War ### Max War Time Set the max time a war can hold on. When this time is over the team with the most kills will win. If both teams have the same amount of kills, it will end in a draw and no team will be rewarded. ```yaml duration: 36h ``` ### Flags during War ```yaml # Limit what invading enemies are able to do. flags: # Allow players doing the following things in the enemy land (only during war). # Available actions: https://wiki.incredibleplugins.com/lands/configuration/roles-and-their-flags#action-flags # NOTE: Adding BLOCK_PLACE or BLOCK_BREAK to this list will allow invaders to break, place ALL blocks. If you want to specify blocks, please use the lists below. # NOTE: In war the attackers and defenders also have the flags of the untrusted role of the area they're invading. # NOTE: If you want to allow players to ignite and explode tnt blocks you need to add BLOCK_IGNITE to this list and TNT_GRIEFING to land-flags_list above. role-flags_list: - ITEM_PICKUP - ATTACK_PLAYER - LAND_ENTER # Allow the placement of specific blocks if the land part of a war. # NOTE: This is only needed if BLOCK_PLACE is NOT in the role-settings_list above. # Values: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html block-place_list: - LADDER - VINE - SCAFFOLDING # Allow breaking of specific blocks if the land part of a war. # NOTE: This is only needed if BLOCK_BREAK is NOT in the role-settings_list above. # Values: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html block-break_list: - LADDER - VINE - SCAFFOLDING ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.incredibleplugins.com/lands/configuration/wars.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.