Skip to content

Built-in festival ​

Built-in festival ​

You can use these built-in festivals directly in the check-in configuration to set corresponding rewards without additional consideration for date configuration.

The Chinese name in the brackets is the exact festival key used by the plugin, e.g. in the disabledFestival list — keep it unchanged when writing your configuration.


  1. Spring Festival (春节)
  2. Day of the Dog (犬日)
  3. Day of the Pig (猪日)
  4. Day of the Sheep (羊日)
  5. Day of the Ox · Breaking of the Fifth (牛日 破五日)
  6. Day of the Horse · Sending Away Poverty (马日 送穷日)
  7. Day of Humanity · Renri Festival (人日 人胜节)
  8. Grain Day · Eight Immortals Day (谷日 八仙日)
  9. Heaven Day · Nine Emperors Assembly (天日 九皇会)
  10. Earth Day · Stone's Birthday (地日 石头生日)
  11. Fire Day · Mouse Wedding Day (火日 老鼠娶媳妇日)
  12. Lantern Testing Day · Guan Gong's Ascension (上(试)灯日 关公升天日)
  13. Lantern Festival · Shangyuan Festival (元宵节 上元节)
  14. Lowering the Lanterns Day (落灯日)
  15. Zhonghe Festival · Sun's Birthday (中和节 太阳生日)
  16. Dragon Head Raising Day (龙抬头)
  17. Flower Festival (花朝节)
  18. Guanyin's Birthday (观世音圣诞)
  19. Shangsi Festival (上巳节)
  20. Hail God Worship Day (祭雹神)
  21. Manjushri's Birthday (文殊菩萨诞辰)
  22. Buddha's Birthday (佛诞节)
  23. Dragon Boat Festival · Duanyang Festival (端午节 端阳节)
  24. Tiankuang Festival (天贶节)
  25. Yi Torch Festival (彝族火把节)
  26. Qixi Festival · Chinese Valentine's Day (七夕)
  27. Ghost Festival · Southern China (鬼节(南方))
  28. Ullambana Festival · Zhongyuan Festival (盂兰盆节 中元节)
  29. Ksitigarbha Festival (地藏节)
  30. Mid-Autumn Festival (中秋节)
  31. Double Ninth Festival (重阳节)
  32. Ancestor Worship Day (祭祖节)
  33. Xiayuan Festival (下元节)
  34. Amitabha's Birthday (阿弥陀佛圣诞)
  35. Laba Festival (腊八节)
  36. Weiya · Year-end Banquet (尾牙)
  37. Little New Year (小年)
  38. Chinese New Year's Eve (除夕)
  39. New Year's Day (元旦)
  40. Qingming Festival (清明节)
  41. Labor Day (劳动节)
  42. National Day (国庆节)

Special Notice ​

The following holidays are national statutory holidays and are considered as special festival days in the plugin during their official periods:

  • New Year's Day (元旦)
  • Spring Festival (春节)
  • Qingming Festival (清明节)
  • Labor Day (劳动节)
  • Dragon Boat Festival (端午节)
  • National Day (国庆节)
  • Mid-Autumn Festival (中秋节)

Example: The 2025 National Day holiday period is from October 1st to October 8th, all days during this period are considered National Day holidays; specifically, October 6th is also designated as Mid-Autumn Festival.