Santa Says Documentation

Santa Says 🎅

Santa Says is a fast-paced Minecraft minigame built around quick challenges, competitive scoring, and round-based gameplay. Players must complete a series of short tasks under time pressure, earning points through participation and top placements. After 15 intense rounds, the player with the highest score wins the game.

Designed for fast matches, high replayability, and competitive servers, Santa Says is easy to learn but hard to master.

Get Started

Getting Started Install Santa Says and get your server ready for gameplay in minutes.

Arena Setup Create and configure arenas to host Santa Says matches.

Gameplay Overview Learn how matches work, how points are earned, and how winners are decided.

Tasks System

Santa Says features a large pool of unique tasks that are randomly selected during each game. Each match consists of 15 tasks, mixing different task types to keep gameplay unpredictable and exciting.

Participation Tasks All players who successfully complete the task earn 1 point.

Placement Tasks Only the fastest or top-performing players earn points based on placement.

Commands

All Santa Says commands are grouped by purpose to keep server management clean and intuitive.

Player Commands Commands that can be used by players to join or leave games and view player statistics.

Arena Commands Commands used to create, edit, and manage arenas.

Admin Commands Administrative commands for managing games and settings.

Debug Commands Advanced commands for testing and troubleshooting.

Configuration Files

Santa Says offers extensive configuration through multiple files, allowing full control over visuals, messages, and gameplay behavior.

config.yml Main configuration file controlling core gameplay behavior and plugin settings.

messages.yml Customize all in-game messages, titles, subtitles, and text outputs used by Santa Says.

signs.yml Customize arena join signs, state labels, placeholders, and sign setup messages.

scoreboard.yml Configure the in-game scoreboard layout, lines, and displayed values.

bossbar.yml Customize boss bars used during gameplay, including colors, styles, and messages.

items.yml Configure lobby items such as the leave item, including their name, material, slot, and lore.

stats-menu.yml Modify the layout and appearance of the player statistics and ranking interface.

setup-menu.yml Customize the interactive GUI menu used for arena creation and configuration.

mysql.yml Configure external database connections to synchronize player statistics across your network.

Other Files Automatically managed internal files used by the Santa Says plugin.

Placeholders

Santa Says provides built-in placeholders and full PlaceholderAPI support, allowing you to display game, arena, and player data across your server.

General Placeholders Placeholders for game state, arena information, and player-related data.

Leaderboard Placeholders Placeholders specifically designed to display leaderboard rankings and statistics.

Features

Discover the powerful systems that make Santa Says robust and customizable.

Sprites & Icons Learn how to use custom images in chat, scoreboards, and titles to create a premium experience.

Smart Recovery Understand how the plugin automatically restores the arena state after a server crash.

Music Support

Santa Says supports in-game music playback through NoteBlockAPI, allowing custom songs to be played during gameplay.

NoteBlockAPI Integration Learn how to enable and configure music playback using NoteBlockAPI.

Developer API

Explore the various events and integration points to extend Santa Says functionality.

Player Events Documentation for events related to player actions and statistics.

Game Events Events triggered by game state changes, starts, and endings.

Round Events Detailed events for round transitions and internal round logic.

Task Events Events for managing and tracking specific mini-game tasks.

---

Miscellaneous

FAQ Common questions, known issues, and troubleshooting information.

Source Code Purchase access to the source code for private modifications and development.