What is it?

Castle Defence for SimpleClans is an attack and defence mini-game for protected clan areas. Defenders must protect their core block from attackers. If attackers break the core, the attacking clan wins and takes control of that area until the next event.

Everything is based on SimpleClans.

The plugin is focused on castle defence, but it can also be used for any defence mini-game system or simply as a protection system integrated with SimpleClans.

Very easy to set up and very easy to use.

Features

Castle defence mini-game
Protect areas for SimpleClans clans
MySQL and SQLite support
Auto-event support
Translation support for main gameplay messages
Optional full mini-game system with classes and clan/team spawns

Permissions

cdsc.admin (All permissions)
- cdsc.define (Define area)
- cdsc.delete (Delete area)
- cdsc.reload (Reload plugin)
- cdsc.wand (Get wand)
- cdsc.start (Start event)
- cdsc.end (End event)
- cdsc.sc (Set core)
- cdsc.tp (Teleport to area)
- cdsc.info (Area info)
- cdsc.list (List areas)
- cdsc.setexit (Set exit point)
- cdsc.bypass (Bypass area protection)
- cdsc.setspawn (Set area spawn)
- cdsc.setflag (Set area flag)
- cdsc.delflag (Delete area flag)
- cdsc.setautoevent (Configure auto-event)
- cdsc.setgamespawn (Configure mini-game spawns)

Commands

/cd <w or wand> - Give you the wand to set an area, similar to WorldGuard
/cd <d or define> <areaName> <clanTag> - Save the selected area
/cd <i or info> - Show information about the area you are in
/cd <l or list> - List all areas
/cd <dl or delete> <areaName> - Delete an existing area
/cd <tp or teleport> <areaName> - Teleport to an existing area
/cd <sc or setcore> - Set the core of the current area to the targeted block
/cd <se or setexit> <areaName> - Set the exit point for players who are not allowed inside
/cd spawn <areaName> - Set the default area spawn
/cd <s or start> [areaName] - Start the event
/cd <e or end> [areaName] - End the event
/cd <sf or setflag> <flag> <areaName> - Set an area flag
/cd <df or delflag> <flag> <areaName> - Delete an area flag
/cd reload - Reload the plugin
/cd <help | ? | nothing> - Show command help

/cd <setautoevent or autoevent or sae> on <intervalMinutes> <durationMinutes> - Enable auto-event
/cd <setautoevent or autoevent or sae> off - Disable auto-event
/cd <setautoevent or autoevent or sae> status - Show auto-event status

Mini-game System

The mini-game system is optional and disabled by default to preserve compatibility with existing servers.

Default configuration:

MiniGame:
  Enabled: false

When disabled, the classic CDSC behavior remains unchanged. Existing areas, spawns, events, core damage, and ownership transfer continue working as before.

How the Mini-game Works

When enabled, the mini-game runs on top of the current event system.

An admin starts an event with /cd start <area>
The player selects a class
The player joins the mini-game
The plugin saves the player's inventory, armor, location, and active effects
The player receives the selected class kit
The player is teleported to the correct spawn
When the player dies, they respawn at their team or clan spawn
When the player leaves, the event ends, or the core breaks, everything is restored

Mini-game Classes

Classes are configurable in config.yml.

Default examples:

Warrior
Archer
Tank

Commands:

/cd classes
/cd class <className>

Mini-game Spawns

The mini-game uses safe fallback logic for spawns.

Spawn priority order:

Clan-specific spawn
Role spawn: defender or attacker
Existing area spawn
Existing area exit
Area first point

This means that if you do not configure the new mini-game spawns, the plugin automatically falls back to the existing area setup.

Commands:

/cd setgamespawn defender <areaName>
/cd setgamespawn attacker <areaName>
/cd setclanspawn <areaName> <clanTag>
/cd setclanspawn <areaName> <clanTag> defender
/cd setclanspawn <areaName> <clanTag> attacker

Defender and Attacker Detection

The plugin automatically detects the player's role:

If the player's clan owns the area, they join as a defender
If the player belongs to another clan, they join as an attacker

Safe Inventory Handling

When joining the mini-game:

Current inventory is saved
Current armor is saved
Active potion effects are saved
Previous location is saved
The selected class kit is applied

When leaving, when the event ends, or when the core breaks:

Original inventory is restored
Original armor is restored
Original effects are restored
The player returns to the location they were at before joining

Mini-game Commands

/cd join <areaName>
/cd leave
/cd class <className>
/cd classes
/cd setgamespawn <defender|attacker> <areaName>
/cd setclanspawn <areaName> <clanTag> [defender|attacker]

Mini-game commands are shown in /cd help only when MiniGame is enabled.

Setup Area for the Event

Get the wand: /cd wand
Set first and second spot
Use /cd define <areaName> <clanTagOwner>
Target the block that will be the core and use /cd setcore
Stand where the exit point should be and use /cd setexit <areaName>
Stand where the default spawn should be and use /cd spawn <areaName>
Optional: configure mini-game defender, attacker, or clan-specific spawns
Hint: <clanTagOwner> can be "staff" if no clan owns the area yet
Hint: set core works by location. If you replace the block after setting it, the new block at that location becomes the core.

Start / End Event

Every time an event starts, core life is reset.

Start the event with /cd start or /cd start <areaName>. During the event, clans can enter protected areas and try to hit the core. If the core reaches 0, the attacking clan wins the area and the event ends for that area.

You can end events manually with /cd end or use the auto-event system.

Flag System

You can include flags on your areas:

Flag: blockplaceduringevent

During the event, all players will be able to place blocks in that area.

Flag: blockbreakduringevent

During the event, all players will be able to break blocks in that area.

Flag: rebuildafterend

At the end of the event, blocks destroyed or placed during the event will be rebuilt.

Flag: denyclanbreak

Deny clan members from breaking blocks inside that area.

Flag: denyclanplace

Deny clan members from placing blocks inside that area.

Requirement

Vault
SimpleClans

Setup

This plugin is installed like any other Bukkit/Spigot plugin. Put the jar file in your /plugins/ folder and restart the server. The config files will automatically appear in the /plugins/CDSC/ folder.