UltimateChristmas 4.0 Wiki

UltimateChristmas / Secret Santa

Secret Santa

An anonymous gift exchange between players. Pure community glue: everyone gives, everyone receives, nobody knows from whom.

module id: secretsanta config: modules/secretsanta.yml

The flow

  1. Players join — /christmas secretsanta join (permission ultimatechristmas.secretsanta).
  2. An admin draws — /christmas secretsanta draw assigns every participant a secret recipient. A player can never draw themselves.
  3. Players deliver — hold the gift item and run /christmas secretsanta deliver. It reaches their recipient directly — and is held safely for them if they are offline, handed over on their next login.

Admin subcommands (draw, reset) need ultimatechristmas.admin.secretsanta.

Configuration

The whole file is two settings — the rest (state, pending) is the plugin's own storage for participants, pairings and held gifts; leave those sections alone:

# Naughty/nice credit for delivering your gift.
nice-points: 5

# Announce (without naming the giver) when a gift is delivered.
announce-delivery: false

Delivering a gift also feeds the gifts_given stat — the default season quest "Give 5 gifts to other players" rides on it, as does the Gifts Given leaderboard.

Running a good exchange