Skip to content
SimonSays Docs

SimonSays Documentation

A premium "Simon Says" arena minigame for Minecraft. Fast rounds, trap and combo challenges, persistent stats, cosmetics and a clean developer API.
Get Started Developer API GitHub

What you’ll find here

Installation

Drop the jar in, set the optional dependencies, build your first arena and go live. See Installation.

Commands

Every player and admin command, plus the full arena setup flow. See Commands.

Permissions

The two permission nodes and what they unlock. See Permissions.

Placeholders

PlaceholderAPI placeholders for stats, live arena state and leaderboards. See Placeholders.

Developer API

Hook into game events and register your own tasks from another plugin. See API Overview.

Custom Tasks

Build round challenges with the fluent TaskBuilder. See Custom Tasks.

In-game Simon Says title with a cyan-to-green gradient
Round titles with full MiniMessage gradient + hex support.
A round in progress with boss bar, action bar and scoreboard
A live round: boss-bar timer, action bar instruction and scoreboard.
Waiting lobby with scoreboard and countdown
Waiting lobby with a live scoreboard and start countdown.
The cosmetics shop GUI
Cosmetics shop — spend coins on particles, glow and sounds.
A packet-based join NPC labelled Click to join
Packet-based join NPC — no real entity, right-click to join.
A leaderboard hologram showing top games
Leaderboard holograms (DecentHolograms) for any stat.
A join sign showing live arena state
Join signs reflect arena state live, with a coloured backing block.
Creating a join sign with [ss] and an arena id
Create a join sign: [ss] on line one, the arena id on line two.

Features

  • Unlimited arenas.
  • Lobby, game spawn, spectator spawn, center, radius and color floor per arena.
  • Normal rounds, trap rounds and combo rounds.
  • Movement, interaction, chat, direction, block, item, NPC, animal and color tasks.
  • Inventory, experience, food and game mode save/restore.
  • Persistent statistics with SQLite or MySQL.
  • Rewards for wins, participation and survived rounds.
  • Cosmetics shop with coins, particles, glow and sounds.
  • Scoreboard, bossbar, actionbar, titles, sounds and configurable effects.
  • Join signs, NPCs and GUI arena selector.
  • Leaderboard holograms with DecentHolograms.
  • PlaceholderAPI support for stats, arenas and leaderboards.
  • Velocity support for lobby routing and shared MySQL data.
  • Public API for custom tasks from other plugins.

Requirements

  • Spigot / Paper / Purpur / fork server.
  • Java 25 or newer.

Dependencies:

  • PacketEvents — advanced NPC support.
  • DecentHolograms — leaderboard holograms.
  • MySQL — stats storage (multi-server / Velocity networks).

Optional:

  • PlaceholderAPI — external placeholders.