Skip to content

Commit 296f21d

Browse files
authored
Update README.md
1 parent e805f5c commit 296f21d

File tree

1 file changed

+16
-14
lines changed

1 file changed

+16
-14
lines changed

README.md

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff 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!.
55

66
**Note:**
77
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>
99
Please also see the [Planned Changes](#planned-changes-features--fixes) section below.<br>
1010

11-
## Usage:
11+
## Use Case:
1212
Script is designed to be used with Task Scheduler (for updating/launching server)<br>
1313
Can also be used with HASS.Agent (or other tools) to issue and capture the results of RCON commands.<br>
1414
To use, call the script with launch parameters eg "& '.\PalworldServerTools.ps1' -save"<br>
@@ -39,7 +39,7 @@ Example Idea below:<br>
3939
**Server Admin**<br>
4040
You can check for updates (manually and at server launch), initiate updates, start and stop the server.<br>
4141

42-
Note: Kick and Ban not implemented yet<br>
42+
Note: Kick and Ban not implemented yet, will be in v1.1.0<br>
4343
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>
4444

4545
**Backups**<br>
@@ -92,21 +92,24 @@ You'll want to test the functions first and ensure there aren't any errors due t
9292
3. If there are issues, you can review the log file in the folder where the script lives for further information.
9393

9494
**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>
9898
At this stage this script is mostly a backend tool so these Parameters are the main means of performing tasks.<br>
9999
Parameters utilizing RCON:<br>
100100
- -Info - RCON request to return server Info.
101101
- -Version - Used to specifically return server version text provided by -info
102102
- -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.
104105
- -ShowPlayerCount - Number of players online
105106
- -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.
106107
- -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.
107108
- -ShutdownMessage - To use this use -broadcast "message". Used to customise the shutdown message.
108109
- -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).
109110
- -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).
110113
- -Save - Force server to save data.
111114

112115
Server Launch and misc Parameters:
@@ -127,11 +130,10 @@ Parameters you'll likely not need, but they're here if you need them:
127130
- -RCONPass - Used to specify RCON Password. Parameter only useful if you're hosting more than one server.
128131

129132
**Home Assistant Nerds**<br>
130-
TBC - explain setup<br>
131-
1.
133+
See [PalworldTools Home Assistant Documentation](docs/HOMEASSISTANT.md).
132134

133135
# FAQ #
134-
- TBC
136+
- Nothing Yet!
135137
- Not seeing something here? Go to [GitHub issues](https://github.com/shupershuff/PalworldServerTools/issues) and log a request, issue or question.
136138

137139
# Planned Changes, Features & Fixes #

0 commit comments

Comments
 (0)