Christmas Gifts v2.9.7

$20.00

A Nativity scene of stone statues where Santa flies in with daily Christmas gifts: song, fireworks, confetti, Mr. Hankey dancing and presents only you can open. Automatic placement at Bandit Camp or the Outpost, 14 languages and an in-game admin menu. One file, no dependencies.

About Christmas Gifts

A Nativity scene of stone statues on a rock base, with Christmas trees, candy canes, wreaths and columns wrapped in lights. Press the button and the show begins: a song, fireworks, confetti and coloured spheres, Mr. Hankey comes out to dance, and Santa flies over the scene in his sleigh dropping Christmas presents for you.

CHRISTMAS GIFTS is a daily Christmas gift event for Rust that runs entirely on its own. Install one file and the scene places itself at Bandit Camp or the Outpost on any map. Every player gets one show and one set of presents per day, and every setting can be changed from a full-screen menu inside the game.

WHAT IS IN THE BOX

  • A Nativity scene of stone statues: Joseph, Mary, the Baby Jesus in the manger, the ox and the donkey, on a rock base.
  • Christmas decoration: Christmas trees, candy canes, wreaths, four columns with Christmas lights and floodlights at night.
  • Daily gifts: one show per player per day, with presents that only that player can open.
  • A Christmas show: song, fireworks, confetti, coloured spheres and floating text.
  • Mr. Hankey dancing on the base, jumping from side to side.
  • Santa's sleigh flying in circles over the scene and dropping the presents.
  • A private turn: while a player receives their gifts, the scene is closed to everybody else.
  • Automatic placement at Bandit Camp (default) or the Outpost, on any map.
  • Custom loot for the presents, or the game's own present loot.
  • An admin menu (/gift) with 8 pages, and 14 languages.
  • One single file. It creates its own configuration and data. No dependencies.

THE SCENE

The statues are real stone sculptures of the game, standing on a rock base that follows the slope of the ground. Behind them stand the Christmas trees and the candy canes; around them, four columns wrapped in Christmas lights, with wreaths on the front ones and floodlights that switch on at night.

A fixed sphere surrounds the scene: inside it there is a safe zone, comfort and no building. Nobody can stay asleep or disconnected inside it: they are moved just outside.

HOW IT WORKS FOR THE PLAYERS

  • PRESS THE BUTTON. It is on the front right column of the scene.
  • THE SHOW STARTS. The song plays once, with fireworks from every column, confetti, coloured spheres and the floating text. The lights of the front columns change their animation to the music.
  • MR. HANKEY DANCES. He comes out, jumps from side to side across the base, spins, swings his arms and leaves before the end.
  • SANTA ARRIVES. His sleigh flies in circles over the scene and drops 8 presents (configurable) on the ground inside the sphere.
  • OPEN YOUR PRESENTS. Only the player who pressed the button can open them. When Mr. Hankey leaves, a countdown starts: 5 minutes to open them (configurable). Presents left at the end disappear.
  • YOUR OWN TURN. While it is your turn nobody else can press the button, other players are moved outside the sphere, and the edge of the sphere turns red.
  • DON'T WANDER OFF. If you leave the sphere, disconnect or die, your presents disappear after 1 minute unless you come back.
  • ONE GIFT A DAY. Each player can start one show per day. Pressing the button again shows a red warning with the time left. Level 2 admins can skip the limit (option).

A panel at the top right of the screen tells the player whose turn it is, how many presents are waiting and how long is left.

THE PRESENTS

  • Two kinds of the game's own boxes, picked at random: the big present drop and the Christmas loot box. Both can be switched on or off.
  • They fall softly to the ground and can be opened the moment they land.
  • They fall on open ground, never on roofs or high places, and never behind the scene.
  • Presents cannot be damaged, and nobody but their owner can open them.
  • Loot: the game's present loot by default, or your own list with item icons, amounts, chances and skins.

AUTOMATIC PLACEMENT

The scene places itself at Bandit Camp (default) or at the Outpost, on a spot chosen by hand at each monument. The spot is stored relative to the monument, so it works on every map. If a map does not have that monument, the scene stays where it is. You can also place it yourself anywhere with /nat, and save your own spot for each monument from the menu.

ADMIN MENU: /gift

A full-screen menu where every change is saved at once.

  • GENERAL - shows per day, the hour the day starts, admins without limit, warning time.
  • SANTA & PRESENTS - sleigh height (one per place), flight radius, lap time, number and kinds of presents, time to open them.
  • LOOT - your own loot for the presents, with item icons and an item picker.
  • EFFECTS - song, fireworks, confetti, Mr. Hankey, portals, sleigh, spheres, floating text, column lights and floodlights, each on or off.
  • TEXTS - the floating text, its colours and sizes.
  • MESSAGES - every message the players see, on screen and in the chat.
  • PLACEMENT - automatic placement at the Outpost or Bandit Camp, and where the presents fall at each place.
  • LANGUAGE - the flag button at the top: each admin and player picks their language.
  • ACTIONS - test show, stop the show, clear today's gifts.

14 LANGUAGES

Every text of the menu, the warnings on screen, the chat messages and the floating text is in 14 languages: English, Spanish, Portuguese (Brazil), French, German, Italian, Polish, Russian, Ukrainian, Turkish, Dutch, Chinese, Japanese and Korean. Everything is in English until a player picks another language with the flag button, and the choice is shared by every BADGYVER.COM plugin on the server.

Write your own text in any language in the menu and press Enter: the plugin translates it once with a free online translator and saves it in Oxide's language files, so every player reads it in their own language. The menu looks the same at any screen resolution and any UI scale.

WHAT IT NEVER DOES

  • It never leaves anything behind: when the scene is removed or the plugin is unloaded, every piece goes, and after a restart the scene is rebuilt in the same spot.
  • The statues and the decoration cannot be damaged or picked up.
  • Nobody can build inside the sphere.

PERFORMANCE

Nothing checks areas all the time: the sphere tells the plugin when a player comes in or goes out. The show and its effects only exist while it plays, and the pieces of the scene are never written to your server save. Checked with the Carbon profiler.

COMMANDS AND PERMISSION

  • /nat - places the scene in front of you (level 2 admins). It turns the automatic placement off.
  • /nat remove - removes the scene (level 2 admins).
  • /gift - opens the admin menu. The command name can be changed.

Permission christmasgifts.admin lets a player open /gift. Level 2 admins can always open it.

INSTALLATION

  1. Copy ChristmasGifts.cs into oxide/plugins/.
  2. The plugin creates all its files by itself.
  3. The scene appears on its own at Bandit Camp. To put it somewhere else, stand there and type /nat.

Written for Oxide (uMod). No other plugin is needed. The full guide, section by section, is in readme.txt inside the download.

Guides

How to run, set up and play the servers this is made for.

View all