Skip to content
EN

Configuration & Commands

Configuration & Commands · setup · Cozy Christmas

All server and gameplay options live in config/cozychristmas-common.json. Missing keys are filled with defaults on load. If the JSON fails to parse, the mod renames the broken file with a .broken suffix and writes a fresh default file.

Season section

season.source controls when seasonal features run (flying reindeer, snow presents, tree and stocking morning gifts, Santa's daily gift, Krampus visits):

  • real_date (default): active from 1 December to 7 January; Santa's sleigh delivery runs on 24 and 25 December
  • always: Christmas season stays on year-round
  • never: seasonal features stay off; crafting, structures, mobs and trading still work
  • serene_seasons: reads the Serene Seasons calendar (early and mid winter by default)

Main config sections

  • karma: daily drift (decay_per_day, default 1), nice_above (30), naughty_below (-30), penalties and rewards
  • presents: gift/coal/boom weights per karma tier, warning_radius (3 blocks), boom damage and breaks_blocks, snow spawns
  • toasty_set: keeps_warm (true) and snow_speed_bonus (0.1)
  • workshop: Santa health, anger duration, nice_discount (0.25), daily_gifts, elf stats, sleigh flight and capacity (24)
  • reindeer: flight (season, always, never), flight and climb speed, taming chance (0.33), wild herd spawn weight
  • goblins: present goblin stealing toggle, night spawns and gingerbread man soggy behavior
  • stockings and tree: season_only, coal count (1–3), min_ornaments (6), present_radius (3), max_presents (3)
  • evil_snowman and krampus: health, attack damage, fire multiplier, krampus.visits threshold (-70) and cooldown (3 game days)
  • food and citrus: chestnut drop chance (0.02), fruit ripening chance (0.15), harvest count (1–3) and wild_trees

Operator commands

  • /cozychristmas karma get <players> prints each player's numeric karma and tier
  • /cozychristmas karma set <players> <value> sets karma to a number between -100 and +100
  • /cozychristmas karma add <players> <value> shifts karma up or down
  • /cozychristmas season shows whether the Christmas season or sleigh delivery is active today and which calendar source is in use