Skip to content

Commit 6048e62

Browse files
authored
📝 Included functionality
Included current and planned functionality. Added release badge. Improved formatting to improve structure and readability.
1 parent 53259b6 commit 6048e62

File tree

1 file changed

+38
-3
lines changed

1 file changed

+38
-3
lines changed

README.md

Lines changed: 38 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
1-
# Minecraft Startup Script
1+
<div align="center">
22

3-
A fully-customisable, modular .bat startup script for Minecraft servers, where all variables can be modified on the fly and applied upon server restart.
3+
# `Minecraft Startup Script`
4+
![GitHub Release](https://img.shields.io/github/v/release/GarnServo/mc-startup-script?style=for-the-badge&logo=github&labelColor=1a1a1a&color=EB5B27)
5+
6+
### A fully-customisable, modular .bat startup script for Minecraft servers, where all variables can be modified on the fly and applied upon server restart.
7+
8+
</div>
49

510
## Features
611
1️⃣ Toggleable auto-restart
@@ -15,7 +20,7 @@ A fully-customisable, modular .bat startup script for Minecraft servers, where a
1520
- Java 17
1621

1722
## How to Use
18-
1. Download the script's latest release (ensure it is saved as a '.bat').
23+
1. Download the script's [latest release](https://github.com/GarnServo/mc-startup-script/releases/latest) (ensure it is saved as a '.bat').
1924
2. Place it in your Minecraft server's root directory.
2025
3. Run the script by either double clicking the file, or executing via CMD.
2126
4. Upon first use, the script will run you through the configuration prompts.
@@ -33,6 +38,36 @@ No need to restart the script.
3338

3439
![Console Screenshot](https://raw.githubusercontent.com/GarnServo/mc-startup-script/main/imgs/Console_launch.png)
3540

41+
## Functionality
42+
### First Launch/Initial Setup
43+
- [X] Prompts user for server .jar filename. Checks if the file exists.
44+
- [X] Prompts user to allocate initial and maximum RAM for the server. Checks if entry is a valid value.
45+
- [X] Queries user whether the server should auto-restart or not.
46+
- [X] Queries user whether server should use pre-configured JVM arguments. Regardless of result, will generate file for flag storage.
47+
- [X] Queries user whether to launch with GUI.
48+
- [X] Lets user confirm choices. If confirmed, continue to normal startup. If rejected, will restart initial configuration.
49+
- [X] Stores configuration in /config/StartupScript.conf, and JVM args in /config/jvm_args.txt.
50+
- [X] Generates auto-accepted EULA.
51+
### Normal Startup
52+
- [X] Checks for config folder, config file, and sets restart counter. If config is missing, reverts back to initial setup.
53+
- [X] Checks for EULA, if non-existent, creates accepted eula.txt.
54+
- [X] Reads script config file and stores contents as environment variables.
55+
- [X] Displays configuration to user and initialises the server.
56+
- [X] Checks for JVM arguments file, if non-existent, will create one with optimised flags. If it exists, loads the args into an environment variable.
57+
- [X] Checks auto-restart config to decide launch path.
58+
#### Auto-Restart Enabled
59+
- [X] Launches server and changes console title to the configurable title + restart count.
60+
- [X] Upon crash or restart, increments the restart counter and reloads configuration + JVM flags.
61+
#### Auto-Restart Disabled
62+
- [X] Launches server and changes console title to the configurable title.
63+
- [X] Upon crash or restart, prompts user whether to restart or exit.
64+
65+
### Planned
66+
- [ ] Include version checking for this script
67+
- [ ] Auto-update this script
68+
- [ ] Improved text formatting
69+
- [ ]
70+
3671
## Disclaimer
3772
By using this script, you are indicating your agreement to the [Minecraft EULA](https://aka.ms/MinecraftEULA).
3873

0 commit comments

Comments
 (0)