Headless Server Software/Commands

From Resonite Wiki

The following commands are available on the headless server interface:

If you need to include spaces (e.g. for a username), wrap the argument in quotes. Example: acceptFriendRequest "Bob Jones"

If using the shadowpanther Docker container, use the command ‘’docker container attach <docker container id>’’ to be able to use these commands. Use "docker ps" to get a list of docker containers with their container IDs.

Command Description Usage
saveConfig Saves the current settings into the original config file saveconfig <filename> (optional, will save in place without)
login Log into a Resonite account login <username/email> <password>
logout Log out from the current Resonite account logout
message Message user in friends list message <friend name> <message>
invite Invite a friend to the currently focused world invite <friend name>
friendRequests Lists all incoming friend requests friendRequests
acceptFriendRequest Accepts a friend request acceptfriendrequest <friend name>
worlds Lists all active worlds worlds
focus Focuses a specific world focus <world id>
startWorldURL Start a new world from Resonite URL. This world URL is acquired through the session tab and clicking the Copy World URL button in game. startworldurl <record URL>
startWorldTemplate Start a new world from template startworldtemplate <template name>
status Shows the status of the current world status
sessionURL Prints the Resonite Url of the current session to the console sessionurl
sessionID Prints the ID of the current session to the console (Also can be acquired in the current session in world via the Session ID Flux Node) sessionid
copySessionURL Copies the Resonite URL of the current session to the clipboard copysessionurl
copySessionID Copies the ID of the current session to the clipboard copysessionid
users Lists all the users in the currently focused world users
close Closes the currently focused world close
save Saves the currently focused world save
restart Restarts the currently focused world restart
kick Kicks a given user from the session kick <username>
silence Silences given user in the session silence <username>
unsilence Removes silence from given user in the session unsilence <username>
ban Bans a given user from all sessions hosted by this server ban <username>
unban Removes a ban for a specified user unban <username>
listbans Lists all active bans listbans
banByName Bans user with given Resonite username from all sessions hosted by this server banbyname <Resonite username>
unbanByName Unbans user with given Resonite username from all sessions hosted by this server unbanbyname <Resonite username>
banByID Bans user with given Resonite User ID from all sessions hosted by this server banbyid <user ID>
unbanByID Unbans user with given Resonite User ID from all sessions hosted by this server unbanbyid <user ID>
respawn Respawns a specified user respawn <username>
role Assigns a role to a specified user. Possible values: Admin, Builder, Moderator, Guest, Spectator role <username> <role>
name Sets a new world name for the currently focused world name <new name>
accessLevel Sets a new world access level for the currently focused world. Possible values: Private, LAN, Friends, FriendsOfFriends, RegisteredUsers, Anyone accesslevel <access level name>
hideFromListing Sets whether the session should be hidden from listing or not hidefromlisting <true/false>
description Sets a new world description for the currently focused world description <new description>
maxUsers Sets a user limit for the currently focused world maxusers <number of users>
awayKickInterval Sets the away kick interval for the currently focused world awaykickinterval <interval in minutes>
import Import an asset into the currently focused world import <file path or Resonite URL>
importMinecraft Import a Minecraft world. Requires Mineways to be installed. importminecraft <folder containing Minecraft world with the level.dat file>
dynamicImpulse Sends a dynamic impulse with a given tag to the scene root dynamicimpulse <tag>
dynamicImpulseString Sends a dynamic impulse with given tag and string value to the scene root dynamicimpulsesstring <tag> <value>
dynamicImpulseInt Sends a dynamic impulse with given tag and integer value to the scene root dynamicimpulsesint <tag> <value>
dynamicImpulseFloat Sends a dynamic impulse with given tag and float value to the scene root dynamicimpulsefloat <tag> <value>
spawn Spawns a saved item from the inventory into the root spawn <Resonite url> <active state>
gc Forces full garbage collection gc
shutdown Shuts the headless down (without saving world state) shutdown
tickRate Sets the maximum simulation rate for the server tickrate <ticks per second>
log Switches the interactive shell to logging output. Press Enter again to restore interactive console. log