Contest Types

Location: config/reverie/contesttypes/{type_id}.conf

Contest types define the rules, scoring, phases, and behavior of a specific kind of contest. You can create unlimited custom contest types beyond the default five categories.

Managing Contest Types

/contesttype list              # List all contest types
/contesttype info <type_id>    # View detailed type info
/contesttype create            # Open creation GUI
/contesttype edit <type_id>    # Open edit GUI
/contesttype reload            # Reload from config files

Full Example

# Metadata
id = "cool"
displayName = "Cool Contest"
description = "Show off your Pokemon's coolest moves!"
color = "AQUA"
icon = "minecraft:ice"
enabled = true
priority = 1

# Category Weights
categories = [
  { category = "cool", weight = 1.0, secondaryStats = ["tough"] },
  { category = "beauty", weight = 0.3 }
]

# Scoring
scoring {
  baseAppealPoints = 30
  categoryMatchBonus = 50
  contestStatMultiplier = 0.1
  maxComboMultiplier = 3.0
  repeatPenalty = 0.5
}

# Phases
phases {
  performanceRounds = 4
  moveSelectionTime = 20000
  turnDelay = 4000
  introDuration = 10000
  presentationDuration = 15000
  judgingDuration = 20000
}

# Rules
rules {
  maxContestants = 4
  minContestants = 2
  allowMoveRepeats = true
  levelMin = 1
  levelMax = 100
  speciesClause = false
  bannedSpecies = []
  bannedMoves = []
}

# Entry Requirements
entry {
  minContestStatTotal = 0
  requiredRibbonTier = 0
  permission = ""
  entryFee = 0
}

# Excitement
excitement {
  initialLevel = 50
  highThreshold = 80
  lowThreshold = 20
}

# Rewards
rewards {
  first = [{ type = "ribbon", tier = "auto" }]
  second = [{ type = "ribbon", tier = "auto" }]
  third = [{ type = "ribbon", tier = "auto" }]
  participation = []
}

Field Reference

Metadata

Field	Type	Default	Description
`id`	String	Required	Unique identifier (used in commands)
`displayName`	String	Required	Name shown to players
`description`	String	`""`	Description in contest browser
`color`	String	`"WHITE"`	ChatFormatting color name (AQUA, RED, GOLD, etc.)
`icon`	String	`"minecraft:paper"`	Minecraft item ID for GUI icon
`enabled`	Boolean	`true`	Whether this type can be used
`priority`	Int	`0`	Sort order (higher = listed first)

Scoring

Field	Type	Default	Description
`baseAppealPoints`	Int	`30`	Base points before any bonuses
`categoryMatchBonus`	Int	`50`	Maximum bonus for move-category alignment
`contestStatMultiplier`	Double	`0.1`	Multiplier applied to Pokemon’s contest stat
`maxComboMultiplier`	Double	`3.0`	Cap on combo multiplier
`repeatPenalty`	Double	`0.5`	Score multiplier for repeated moves

Phases

Field	Type	Default	Description
`performanceRounds`	Int	`4`	Number of appeal rounds
`moveSelectionTime`	Long	`20000`	Move selection timeout (ms)
`turnDelay`	Long	`4000`	Delay between contestant turns (ms)
`introDuration`	Long	`10000`	Introduction phase duration (ms)
`presentationDuration`	Long	`15000`	Presentation phase duration (ms)
`judgingDuration`	Long	`20000`	Judging/voting phase duration (ms)

Rules

Field	Type	Default	Description
`maxContestants`	Int	`4`	Maximum players in this contest type
`minContestants`	Int	`2`	Minimum to start
`allowMoveRepeats`	Boolean	`true`	Allow same move twice
`levelMin` / `levelMax`	Int	`1` / `100`	Allowed Pokemon level range
`speciesClause`	Boolean	`false`	No duplicate species
`bannedSpecies`	List	`[]`	Banned species IDs
`bannedMoves`	List	`[]`	Banned move IDs

Entry Requirements

Field	Type	Default	Description
`minContestStatTotal`	Int	`0`	Minimum total contest stats to enter
`requiredRibbonTier`	Int	`0`	Required ribbon tier (0=none, 1-4)
`permission`	String	`""`	Permission node required (empty = none)
`entryFee`	Int	`0`	Economy cost to enter

Multi-Stage Contests

Contest types can define custom stages for more complex formats:

Stage Type	Description
`PERFORMANCE`	Traditional appeal rounds with move selection
`PRESENTATION`	Showcase phase for visual scoring
`MINIGAME`	Interactive minigame (specify `minigameId`)
`VOTING`	Audience/spectator voting round
`INTERMISSION`	Break between stages

stages = [
  {
    id = "performance_1"
    type = "PERFORMANCE"
    performanceRounds = 2
    scoreWeight = 1.0
  },
  {
    id = "minigame_1"
    type = "MINIGAME"
    minigameId = "rhythm"
    scoreWeight = 0.5
  }
]

Next Steps

Hall Configuration — Halls can override contest type settings
Scoring & Formulas — How scoring fields translate to appeal math