FALLENKINGDOMS MINIGAMES

68747470733a2f2f692e696d6775722e636f6d2f55744e544a526c2e706e67.png

FallenKingdoms is a complete kingdom warfare minigame built for server owners who want something fresh, polished and easy to configure.
Each team starts with its own base and magical heart. Players prepare, choose kits, protect their territory, then enter the assault phase where enemy bases become the main target. Break the enemy heart, eliminate the remaining players and crown the last kingdom standing.

The plugin is designed as a full minigame suite, not just a single arena script. It includes a guided arena setup, multi-arena support, lobby NPCs, holograms, player profiles, leaderboards, kit upgrades, XP levels, achievements, cosmetics, map snapshots, arena duplication and optional economy integration through Vault.

Everything is English by default and configurable: messages, menus, scoreboards, teams, colors, kits, rewards, cosmetics, sounds, lobby items and game settings.

SETUP MAPS :

Multi-arena system with optional BungeeCord mode.
2 to 8 configurable teams.
Custom team names, colors and max players per team.
Guided setup wizard for spawns, hearts and base cuboids.
Heart objective with configurable health, damage, particles and sounds.
Kit selection and kit upgrade system.
XP, levels and scoreboard progress bar.
80 configurable achievements with rewards.
Internal economy by default, Vault optional.
Lobby NPCs for game modes and player profiles.
Holograms for stats, leaderboards and arena information.
Leaderboard settings menu with time range and display options.
Cosmetic system with heart skins, auras, kill effects, trails and fireworks.
Spectator tools and clean respawn flow.
Map snapshots, reset tools and arena duplication.
Arena analytics for match duration, winrates and kit usage.
Fully configurable messages, menus, scoreboards and sounds.

LeaderBoard - Lobby :

NPC Join - Lobby :

NPC Profile - Lobby :

Base - InGame :

Map style - InGame :

Create an arena with /fk create <id> <name>, select the teams you want, choose max players per team, then use the guided items to set each team spawn, heart and base cuboid. When the setup is complete, the plugin opens a recap menu and creates a map snapshot so the arena can be restored after games.

FallenKingdoms gives your server a team minigame with a clear objective, strong progression and a clean lobby experience. It is not a BedWars clone, not a BattlePass system and not a quest plugin. It is a standalone kingdom warfare game mode built to feel premium from the first join.

Requirements

Latest Spigot/Paper version supported by the plugin build.
Java 21 recommended.
Vault is optional.
PartyAndFriends is optional.

FallenKingdoms exposes a Bukkit service API through com.fallenkingdoms.api.FallenKingdomsApi.

Code:

FallenKingdomsApi api = Bukkit.getServicesManager().load(FallenKingdomsApi.class);

or:

Code:

FallenKingdomsApi api = FallenKingdomsProvider.require();

Use softdepend: [FallenKingdoms] in your plugin.

Control Methods

Code:

boolean joinArena(Player player, String arenaId);
boolean joinBestArena(Player player, int teamCount);
boolean leaveArena(Player player);
boolean selectTeam(Player player, String teamKey);
boolean startArena(String arenaId, boolean force);
boolean stopArena(String arenaId);
boolean resetArena(String arenaId);

Query Methods

Code:

String version();

List<ArenaSnapshot> arenas();
Optional<ArenaSnapshot> arena(String arenaId);
Optional<ArenaSnapshot> arena(Player player);
Optional<String> arenaId(Player player);
Optional<TeamSnapshot> team(Player player);
Optional<PlayerStatsSnapshot> stats(UUID playerId);

Events
Listen normally with Bukkit's EventHandler.

Code:

@EventHandler
public void onGameEnd(FallenKingdomsGameEndEvent event) {
    String arena = event.arenaId();
    String winner = event.winnerTeamName();
}

Events:

- FallenKingdomsArenaJoinEvent
- FallenKingdomsArenaLeaveEvent
- FallenKingdomsTeamJoinEvent
- FallenKingdomsGameStartEvent
- FallenKingdomsGameEndEvent
- FallenKingdomsHeartDamageEvent
- FallenKingdomsHeartDestroyEvent
- FallenKingdomsProfileUpdateEvent

Notes

Snapshots are immutable.

API methods should be called on the main server thread unless your addon only reads already-copied snapshots.

Team keys are lowercase: blue, red, green, yellow, purple, orange, cyan, pink.

fk.play:
description: Allows players to join and play FallenKingdoms.
default: true
fk.admin:
description: Allows staff to configure and control FallenKingdoms.
default: op

fallenkingdoms.kit.miner
fallenkingdoms.kit.better-bow
fallenkingdoms.kit.better-sword
fallenkingdoms.kit.better-armor
fallenkingdoms.kit.enchanter

fk.cosmetic.nexus-skin.default
fk.cosmetic.nexus-skin.end-crystal-safe
fk.cosmetic.nexus-skin.red-heart
fk.cosmetic.nexus-skin.runic-crystal
fk.cosmetic.nexus-skin.mini-obelisk
fk.cosmetic.nexus-skin.light-cage
fk.cosmetic.kill-effect.lightning
fk.cosmetic.kill-effect.smoke
fk.cosmetic.kill-effect.ring
fk.cosmetic.kill-effect.souls
fk.cosmetic.victory-firework.burst
fk.cosmetic.victory-firework.mega

/fk join
/fk leave
/fk lobby
/fk stats
/fk cosmetics
/fk cosmeticshop
/fk arenas
/fk status

FALLENKINGDOMS MINIGAMES v1.0.3

Overview Updates (3) History