You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-14Lines changed: 16 additions & 14 deletions
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,14 @@
1
-
# Palworld Server Tools
2
-
PowerShell based tool for administering dedicated Palworld servers.
3
-
4
-
Readme and instructions IN PROGRESS
1
+
# Overview
2
+
PalworldServer Tools is a PowerShell script used for administering dedicated Palworld servers.
3
+
Currently this is a tool without a GUI designed to run when called by task scheduler, sensors or other scripts.
4
+
A GUI will hopefully be developed down the track, I need to learn how to create these first!.
5
5
6
6
**Note:**
7
7
This is an early version of this script and will likely have some bugs.<br>
8
-
If you notice anything funky or would like additional functionality, please raise an issue.<br>
8
+
If you notice anything funky, would like additional functionality or have any questions, please raise an [issue](https://github.com/shupershuff/PalworldServerTools/issues).<br>
9
9
Please also see the [Planned Changes](#planned-changes-features--fixes) section below.<br>
10
10
11
-
## Usage:
11
+
## Use Case:
12
12
Script is designed to be used with Task Scheduler (for updating/launching server)<br>
13
13
Can also be used with HASS.Agent (or other tools) to issue and capture the results of RCON commands.<br>
14
14
To use, call the script with launch parameters eg "& '.\PalworldServerTools.ps1' -save"<br>
@@ -39,7 +39,7 @@ Example Idea below:<br>
39
39
**Server Admin**<br>
40
40
You can check for updates (manually and at server launch), initiate updates, start and stop the server.<br>
41
41
42
-
Note: Kick and Ban not implemented yet<br>
42
+
Note: Kick and Ban not implemented yet, will be in v1.1.0<br>
43
43
Note: Auto Update feature not implemented yet but plan to have a feature to regularly check for new versions and if so force a restart and update.<br>
44
44
45
45
**Backups**<br>
@@ -92,21 +92,24 @@ You'll want to test the functions first and ensure there aren't any errors due t
92
92
3. If there are issues, you can review the log file in the folder where the script lives for further information.
93
93
94
94
**Configure Task Scheduler**<br>
95
-
1. TBC
96
-
97
-
**Launch Parameters available:**<br>
95
+
If you need help or want to see examples, see [PalworldTools Task Scheduler Documentation](docs/TASKSCHEDULER.md).
96
+
## Usage ##
97
+
**Launch Parameters available**<br>
98
98
At this stage this script is mostly a backend tool so these Parameters are the main means of performing tasks.<br>
99
99
Parameters utilizing RCON:<br>
100
100
- -Info - RCON request to return server Info.
101
101
- -Version - Used to specifically return server version text provided by -info
102
102
- -ServerName - Used to specifically return server name text provided by -info
103
-
- -ShowPlayers - Show the names of all logged in players.
103
+
- -ShowPlayers - Show the names of all logged in players. TBC FROM v1.1.0 this will instead show a comma separated response, the exact response you'd get from RCON.
104
+
- -ShowPlayerNamess - TBC FROM v1.1.0 ONWARDS Show the names of all logged in players.
104
105
- -ShowPlayerCount - Number of players online
105
106
- -Shutdown - Used to initiate a planned shutdown. Can be used in conjunction with -shutdowntimer and -shutdownmessage. The script will also initiate a broadcast message notifying of shutdown when it's imminent.
106
107
- -ShutdownTimer - Optional parameter. Used to specify how many seconds until shutdown should occur. If not specified it will use the value from the config file.
107
108
- -ShutdownMessage - To use this use -broadcast "message". Used to customise the shutdown message.
108
109
- -Broadcast - To use this use -broadcast "message". Sends a message to all players. Note that as of the time of writing, it's not possible to send messages with spaces in them (game limitation).
109
110
- -DoExit - Schedule an immediate shutdown of the server.
111
+
- -kick (or -kickplayer) - TBC FROM v1.1.0 ONWARDS Used to kick a player. Script allows you to specify either steam ID or playername to kick.
112
+
- -ban (or -banplayer) - TBC FROM v1.1.0 ONWARDS Used to ban a player. Script allows you to specify either steam ID or playername to ban. If specified player isn't online, script will warn you (in case you made a typo).
110
113
- -Save - Force server to save data.
111
114
112
115
Server Launch and misc Parameters:
@@ -127,11 +130,10 @@ Parameters you'll likely not need, but they're here if you need them:
127
130
- -RCONPass - Used to specify RCON Password. Parameter only useful if you're hosting more than one server.
128
131
129
132
**Home Assistant Nerds**<br>
130
-
TBC - explain setup<br>
131
-
1.
133
+
See [PalworldTools Home Assistant Documentation](docs/HOMEASSISTANT.md).
132
134
133
135
# FAQ #
134
-
-TBC
136
+
-Nothing Yet!
135
137
- Not seeing something here? Go to [GitHub issues](https://github.com/shupershuff/PalworldServerTools/issues) and log a request, issue or question.
0 commit comments