Skip to content

Database, Placeholder and API

casqidev edited this page Jun 7, 2026 · 3 revisions

Database

Storage is selected from config.yml.

Available types:

  • YAML
  • SQLite
  • MySQL
  • MariaDB

SQLite is default and recommended for small/medium servers. MySQL or MariaDB is recommended for networks and larger servers.

PlaceholderAPI

Internal placeholders currently include:

  • %koth%
  • %kothname%
  • %mode%
  • %location%
  • %capturer%
  • %time%
  • %time_left%
  • %player%
  • %previous%
  • %capturer1%
  • %capturer2%
  • %capturer3%
  • %top1_points%
  • %top2_points%
  • %top3_points%
  • %my_points%

Developer API

MimiKoth provides a public API designed for developers who want to integrate their plugins with MimiKoth. The API allows access to KOTH data, player statistics, active events, and event listeners without interacting with MimiKoth's internal implementation.

Getting Started

Access the API through:

MimiKothAPI api = MimiKothAPI.get();

Methods

MimiKothAPI.get().getKoth("spawn");
MimiKothAPI.get().getAllKoths();
MimiKothAPI.get().getActiveKoths();
MimiKothAPI.get().startKoth("spawn");
MimiKothAPI.get().stopKoth("spawn");
MimiKothAPI.get().getPlayerPoints(player);

Events

  • KothStartEvent
  • KothEndEvent
  • KothCancelEvent
  • KothCaptureStartEvent
  • KothCaptureStopEvent
  • KothCaptureCompleteEvent
  • KothKingChangeEvent
  • KothPointsGainEvent
  • KothRewardGiveEvent

Example Listener

@EventHandler
public void onKothStart(KothStartEvent event) {

    String kothName = event.getKoth().getName();

    Bukkit.broadcastMessage(
        "KOTH Started: " + kothName
    );
}

Clone this wiki locally