The RUST Xmas command and variables
The RUST Xmas Command and variables allow server admins to enable or disable the RUST Xmas Event. The RUST Xmas command and variables were originally introduced in December of 2015. Recently the event was updated with Devblog 190, in December 2017.
When the RUST Xmas event is enabled, on each new day (in-game), the server event triggers a short audio clip of bells jingling. All players actively logged in will then, with default configurations, have 2 presents spawn within 50 meters of their location.
Spawned presents will have a spotlight glowing on them, with snowflakes continually falling in the area. The presents are white boxes, with red ribbons wrapped around them and a bow tied on the top. The present boxes can be opened by players and additional “presents” will be found inside, with three varying sizes (large, medium and small).
Inside of each of these presents, players can find an assortment of items. They can also save the medium or small presents and later combine them to create a present the next size up. The larger the present, the higher the quality of the reward when unwrapped.
In addition, stockings can be obtained from each present. There are two different types, a super stocking, and a normal stocking. The super stocking has the chance of better loot appearing, while the normal stocking will be standard loot. Each time the RUST Xmas event triggers, stockings will be filled up and a golden glow and sparkle will appear to be coming out of the tops.
There is one available console command that can be run for the RUST Xmas event:
- The RUST Xmas event itself can be triggered at will by admins and moderators by running the Xmas command.
There are three variables that can be set for the RUST Xmas event:
- The distance of presents spawning can be configured through the Xmas variable.
- The number of presents spawning per player can be configured through the Xmas variable.
- The amount of times presents attempt to spawn around a player can be configured through the Xmas variable. There are a limited number of spawn locations around a player, so if a player is standing AFK and the event is triggered multiple times, the player may not see the appropriate amount of presents when they return. Also, if this variable is set to 0, no presents will spawn, but the stockings will continue to refill and the jingle bell audio clip will play.
A few practical reasons for using the RUST Xmas command:
- The RUST Xmas command adds seasonal holiday spirit to the game server.
- Allows players to receive ornamentation to decorate the in-game Christmas trees.
- Run the RUST Xmas event to refill players’ stockings and spread cheer.
- Great way to get players outside of their bases with the chance of reward.
- Adds new goal for raiders to seek out presents locked away in other bases.
- Admins can advertise a unique aspect of their RUST server and control the events.
Who can enter the RUST Xmas command
The RUST Xmas command and variables can be issued and configured on vanilla RUST servers by RUST admins and moderators only. Players on vanilla RUST servers cannot use the RUST Xmas command and variables. Regular players will need to be on a server that has the event enabled to partake in the Xmas presents, stockings, and ornamentation.
How to use the RUST Xmas command and variables
Before initiating the RUST Xmas command, ensure the following:
- Make sure the Xmas event variables are configured properly, check the following to ensure it’s configured:
- The presents spawn range
- The presents spawn amount per-player
- The presents maximum re-spawn attempts
- The RUST Xmas command will trigger a jingle bell audio clip that can become annoying if constantly repeated and can interfere with players’ gameplay, streams, communications, etc.
- Once this setting is enabled, all players on the server will experience the event and they cannot opt-out.
- This event can impact the server’s overall performance if any of the settings are wildly configured. Keep sane defaults.
The RUST Xmas command and variables can be issued and set from RCON platforms, the in-game console, or changed in the server’s configuration files. Press the F1 key to open the in-game console and type in the specific Xmas command or variable syntax listed below, then press enter.
RUST xmas.refill command (1 of 1)
This command is used to manually trigger the RUST Xmas event across the game server if the RUST Xmas event is enabled. When the event has been configured to be enabled, it will automatically trigger at the start of each new day in-game.
Note that this RUST admin command does work from RCON platforms and doesn’t require being logged into the game server.
Use the command below to run the event:
xmas.refill
On the success of this command being entered, the console will display:
N/A
On success the server chat will display:
N/A
RUST xmas.enabled variable (1 of 4)
- This variable is used to enable and disable the RUST Xmas event on a game server.
- This setting is defaulted to true.
- Note that this command does work from RCON platforms and doesn’t require being logged into the game server.
Get the server’s current configuration value
Use the command below to report the current configuration:
xmas.enabled
On the success of this command being entered, the console will display:
xmas.enabled "true" or "false"
Enable the RUST Xmas event
Use the command below to enable the event:
xmas.enabled true
On the success of this variable being entered, the console will display:
xmas.enabled "true"
Disable the RUST Xmas event
Use the command below to disable the event:
xmas.enabled false
On the success of this variable being entered, the console will display:
xmas.enabled "false"
RUST xmas.giftsperplayer variable (2 of 4)
- This variable is used to set the number of gifts that will attempt to spawn for each player when the RUST Xmas event is triggered.
- This setting is defaulted to 2 presents and can be configured to any number, but beware, this can cause severe server performance issues.
- Note that this command does work from RCON platforms and doesn’t require being logged into the game server.
Get the server’s current configuration value
Use the command below to report the current configuration:
xmas.giftsperplayer
On the success of this command being entered, the console will display:
xmas.giftsperplayer "current_number"
Change the current configuration value
Use the command below to change the current configuration:
xmas.giftsperplayer “2”
On the success of this command being entered, the console will display:
xmas.giftsperplayer "2"
RUST xmas.spawnattempts variable (3 of 4)
- This variable is used to set the number of times gifts will attempt to spawn around players.
- This setting is defaulted to 5 attempts and can be configured to any number, but beware, this can cause severe server performance issues as it will continue to loop through each attempt.
- Note that this command does work from RCON platforms and doesn’t require being logged into the game server.
Get the server’s current configuration value
Use the command below to report the current configuration:
xmas.spawnattempts
On the success of this command being entered, the console will display:
xmas.giftsperplayer "current_number"
Change the current configuration value
Use the command below to change the current configuration:
xmas.spawnattempts “5”
On the success of this command being entered, the console will display:
xmas.spawnattempts "5"
RUST xmas.spawnrange variable (4 of 4)
- This variable is used to set the range in which the RUST Xmas event presents will spawn from each actively logged in player.
- This setting is defaulted to 50 meters and can be configured to any number, but beware:
- If the distance is set to far, players will not be able to locate the gifts.
- If the distance is set to short, and the number of presents is larger than available spawn points, players will not receive all of the intended gifts.
Note that this command does work from RCON platforms and doesn’t require being logged into the game server.
Get the server’s current configuration value
Use the command below to report the current configuration:
xmas.spawnrange
On the success of this command being entered, the console will display:
xmas.spawnrange "current_number"
Change the current configuration value
Use the command below to change the current configuration:
xmas.spawnrange “50”
On the success of this command being entered, the console will display:
xmas.spawnrange "50"
