Bukkit

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.

 

v 1.0.0

• Update to BK 1.16
• Remove Combat-Tag support
• Update to SimpleClans 2.15.2 (not legacy)
• Change config from ID core block to string material name
• Release as version 1.0

---

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

Planned

• Set auto-event
• Add Translate support
• Add Full Mini-game system
  • Add Classes
  • Add Spawn for different clans

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.

1. An admin starts an event with /cd start <area>
2. The player selects a class
3. The player joins the mini-game
4. The plugin saves the player's inventory, armor, location, and active effects
5. The player receives the selected class kit
6. The player is teleported to the correct spawn
7. When the player dies, they respawn at their team or clan spawn
8. 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:

1. Clan-specific spawn
2. Role spawn: defender or attacker
3. Existing area spawn
4. Existing area exit
5. 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

1. Get the wand: /cd wand
2. Set first and second spot
3. Use /cd define <areaName> <clanTagOwner>
4. Target the block that will be the core and use /cd setcore
5. Stand where the exit point should be and use /cd setexit <areaName>
6. Stand where the default spawn should be and use /cd spawn <areaName>
7. Optional: configure mini-game defender, attacker, or clan-specific spawns
8. Hint: <clanTagOwner> can be "staff" if no clan owns the area yet
9. 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.