Headless Server Software/Commands: Difference between revisions

From Resonite Wiki
Added doctor container access info
add debugWorldState command
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<!--T:1-->
<!--T:1-->
The following commands are available on the [[Headless Client|headless client]] interface:
The following commands are available on the [[Headless Server Software|headless server]] interface:


<!--T:2-->
<!--T:2-->
If you need to include spaces (e.g. for a username), wrap the argument in quotes. Example: ''acceptFriendRequest "Bob Jones"''
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
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.


<!--T:3-->
<!--T:3-->
Line 198: Line 198:
|-
|-
| shutdown
| shutdown
| Shuts the headless client down (without saving world state)
| Shuts the headless down (without saving world state)
| shutdown
| shutdown
|-
|-
Line 208: Line 208:
| Switches the interactive shell to logging output. Press Enter again to restore interactive console.
| Switches the interactive shell to logging output. Press Enter again to restore interactive console.
| log
| log
|-
| debugWorldState
| Prints out debugging information about the state of the worlds to help diagnose issues.
| debugWorldState
|}
|}

Latest revision as of 08:48, 25 June 2024

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
debugWorldState Prints out debugging information about the state of the worlds to help diagnose issues. debugWorldState