2CHEVSKII
Adds 'capture the flag' type events to your server

Supported Games
GameServerKingsGameServerKings

Features

Plugin allows to create server events which goal is to capture the area of the flag. Flags are based on floating items, to capture an area player needs to enter it and stay in for configurable amount of time while keeping other players away from it.

  • Map markers
  • Chat notifications
  • Contested areas
  • Team capture
  • Automatic timed event creation

Permissions

ctfevents.manage - allows to create and destroy events

Commands

  • ctf help - shows information about command usage
  • ctf info - shows information about events (all, or specific, if supplied with event id or grid cell name)
  • ctf start - starts new event (at random point, or at player's view if supplied with here argument)
  • ctf end - stops event (specified by event id / grid cell or all events if supplied with all argument)

Configuration


{
  "Capture item shortname": "rifle.ak",
  "Capture item skin ID": 1167207039,
  "Total event time": 300.0,
  "Time needed to capture": 60.0,
  "Capture radius": 30.0,
  "Allow capturing with teammates": false,
  "Capture speed increase per teammate": 0.5,
  "Enable map markers": true,
  "Event status update notifications frequency": 15.0,
  "Event autospawn frequency": 900.0,
  "Allow autospawn if another event is present": false,
  "Event count limit": -1
}

Localization


{
  "Chat prefix": "[CTF] ",
  "No permission": "<color=#ff5526>You have no access to this command</color>",
  "Wrong usage": "<color=#f5cd2c>Syntax error. Use <color=#309bd9>/ctf help</color> to get help</color>",
  "Help": "Usage: <color=#309bd9>/ctf</color> [<color=#72c93c>command</color>] <<color=#a2ad9c>arguments</color>>\nCommands:\nno command | <color=#72c93c>info</color> - Shows info about all current events. Can be provided with an id or grid cell name to get info about specific event\n<color=#72c93c>start</color> - Starts event at random position. Additional argument - <color=#a2ad9c>here</color> might be specified to create event on the point you are currently looking at\n<color=#72c93c>end</color> - Stops an event, needs to be provided with either id or grid cell as an argument",
  "Event info": "#<color=#309bd9>{0}</color>: [ <color=#f5cd2c>{1}</color> ], Time left: <color=#a2ad9c>{2}</color>",
  "Event not found": "<color=#ff5526>Event not found</color>",
  "No events running": "<color=#f5cd2c>No events currently in process</color>",
  "Event started": "Capture the flag event started at [ <color=#f5cd2c>{0}</color> ], check your map!",
  "Event started by player/plugin": "Capture the flag event started by <color=#309bd9>{1}</color> at [ <color=#f5cd2c>{0}</color> ], check your map!",
  "Event time expired": "<color=#a2ad9c>Capture the flag event at [ <color=#f5cd2c>{0}</color> ] has ran out of time, no winner chosen</color>",
  "Event finished forcefully": "Capture the flag event at [ <color=#a2ad9c>{0}</color> ] was stopped by <color=#f5cd2c>{1}</color>",
  "Event finished by capturing flag": "Capture the flag event at [ <color=#72c93c>{0}</color> ] was won by {1}",
  "Invalid position for event": "<color=#ff5526>Event cannot be spawned here</color>",
  "Event already exists": "<color=#f5cd2c>Event already exists near that position, try choosing another place</color>",
  "Event limit reached": "<color=#ff5526>Event limit reached, wait for other event to end, or stop it manually</color>",
  "Event tick capture": "You are capturing flag at [ <color=#72c93c>{0}</color> ], stay in the zone for <color=#309bd9>{1}</color> more seconds",
  "Event tick contested": "The objective at [ <color=#f5cd2c>{0}</color> ] is being contested, make other <color=#ff5526>{1}</color> players leave the zone or put a bullet in their heads!",
  "Player entered capture zone": "You've entered event zone [ <color=#72c93c>{0}</color> ]",
  "Player left capture zone": "You've left event zone [ <color=#ff5526>{0}</color> ]"
}

Additional notes

For server owners

UI, rewards, and other plugin integrations are currently WIP, feel free to leave a suggestion in the support section.

For developers

Plugin API is unstable and subject to change, hence undocumented. Don't rely on available methods right now.

Credits

Lamego - author of the predecessor plugin

The MIT License (MIT)


Copyright (c) 2021 2CHEVSKII


Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:


The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.


THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.