├── .gitignore
├── LICENSE
├── debug.sh
├── paper.sh
├── README.md
└── .server
    └── start.sh


/.gitignore:
--------------------------------------------------------------------------------
1 | # Intellij
2 | .idea/
3 | 
4 | # Servers
5 | .paper/
6 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Copyright 2021 Monun
2 | 
3 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
4 | 
5 | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
6 | 
7 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
8 | 


--------------------------------------------------------------------------------
/debug.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | server='https://papermc.io/api/v1/paper/1.17.1/latest/download'
 4 | plugins=(
 5 |   'https://github.com/monun/auto-reloader/releases/latest/download/AutoReloader.jar'
 6 | )
 7 | 
 8 | script=$(basename "$0")
 9 | server_folder=".${script%.*}"
10 | mkdir -p "$server_folder"
11 | 
12 | start_script="start.sh"
13 | start_config="$start_script.conf"
14 | 
15 | if [ ! -f "$server_folder/$start_script" ]; then
16 |   if [ -f ".server/$start_script" ]; then
17 |     cp ".server/$start_script" "$server_folder/$start_script"
18 |   else
19 |     wget -qc -P "$server_folder" -N "https://raw.githubusercontent.com/monun/server-script/master/.server/$start_script"
20 |     wget -qc -P "$server_folder" -N "https://raw.githubusercontent.com/monun/server-script/master/.server/start.bat"
21 |   fi
22 | fi
23 | 
24 | cd "$server_folder" || exit
25 | 
26 | if [ ! -f "$start_config" ]; then
27 |   cat <<EOF >$start_config
28 | server=$server
29 | debug=true
30 | debug_port=5005
31 | backup=false
32 | force_restart=false
33 | memory=16
34 | plugins=(
35 | EOF
36 |   for plugin in "${plugins[@]}"; do
37 |     echo "  \"$plugin\"" >>$start_config
38 |   done
39 |   echo ")" >>$start_config
40 | fi
41 | 
42 | chmod +x ./$start_script
43 | ./$start_script launch
44 | 


--------------------------------------------------------------------------------
/paper.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | server='https://papermc.io/api/v1/paper/1.17.1/latest/download'
 4 | plugins=(
 5 |   'https://github.com/monun/auto-reloader/releases/latest/download/AutoReloader.jar'
 6 | )
 7 | 
 8 | script=$(basename "$0")
 9 | server_folder=".${script%.*}"
10 | mkdir -p "$server_folder"
11 | 
12 | start_script="start.sh"
13 | start_config="$start_script.conf"
14 | 
15 | if [ ! -f "$server_folder/$start_script" ]; then
16 |   if [ -f ".server/$start_script" ]; then
17 |     cp ".server/$start_script" "$server_folder/$start_script"
18 |   else
19 |     wget -qc -P "$server_folder" -N "https://raw.githubusercontent.com/monun/server-script/master/.server/$start_script"
20 |     wget -qc -P "$server_folder" -N "https://raw.githubusercontent.com/monun/server-script/master/.server/start.bat"
21 |   fi
22 | fi
23 | 
24 | cd "$server_folder" || exit
25 | 
26 | if [ ! -f "$start_config" ]; then
27 |   cat <<EOF >$start_config
28 | server=$server
29 | debug=false
30 | debug_port=5005
31 | backup=false
32 | force_restart=false
33 | memory=16
34 | plugins=(
35 | EOF
36 |   for plugin in "${plugins[@]}"; do
37 |     echo "  \"$plugin\"" >>$start_config
38 |   done
39 |   echo ")" >>$start_config
40 | fi
41 | 
42 | chmod +x ./$start_script
43 | ./$start_script launch
44 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # 마인크래프트 서버 간단하게 구축하기
 2 | 
 3 | 윈도우 유저분들은 WSL혹은 mingw64를 통해 실행하세요.
 4 | 
 5 | #### mingw64
 6 | 
 7 | * git을 설치하면 `C:\Program Files\Git\mingw64` 경로에 자동으로 설치됩니다.
 8 | * 환경변수 PATH에 `C:\Program Files\Git\mingw64\bin` 을 추가하세요.
 9 | * [wget.exe](https://eternallybored.org/misc/wget/) 파일을 다운로드하여 mingw64 폴더에 넣어주세요.
10 | 
11 | ### 환경
12 | 
13 | * JAVA
14 | * LINUX (shell)
15 | 
16 | ---
17 | 
18 | ## 사용방법 (아래 방법중 하나를 선택하세요)
19 | 
20 | ### - start.sh (기본)
21 | 
22 | 1. .server/start.sh 파일을 다운로드 `wget https://raw.githubusercontent.com/monun/server-script/master/.server/start.sh`
23 | 2. 실행권한 부여 `chmod +x ./start.sh`
24 | 3. 실행 `./start.sh` (현재 폴더에서 서버 실행됨)
25 | 4. [선택] 서버 시작시 생성된 ./start.sh.conf 파일을 필요대로 수정
26 | 
27 | ### - \<server>.sh (사전 설정 가능)
28 | 
29 | 1. 원하는 스크립트 선택 (아래 방법 중 하나를 선택)
30 |     * 예) paper 스크립트 다운로드 `wget https://raw.githubusercontent.com/monun/server-script/master/paper.sh`
31 |     * 예) 프로젝트를 복제 `git clone https://github.com/monun/server-script.git`
32 | 2. [선택] 스크립트를 수정 (플러그인, 백업, 재시작 등)
33 | 3. 실행권한 부여 `chmod +x ./<script>.sh`
34 | 4. 실행 `./<script>.sh` (.\<script> 폴더에서 server.sh 스크립트를 이용한 서버가 실행됨)
35 | 5. [선택] 사전설정된 스크립트를 배포
36 | 
37 | ## start.sh.conf의 server 설정 (서버로 사용할 jar파일)
38 | 
39 | 1. URL (웹에서 파일을 다운로드하여 `~/.minecraft/server/` 폴더에 저장 후 서버 시작)
40 |     * `server=https://papermc.io/api/v1/paper/1.17/latest/download`
41 | 2. 로컬 경로
42 |     * `server=/user/monun/my.jar`
43 |     * `server=$HOME/.jar`
44 |     * `server=C:\\Users\monun\my.jar`
45 | 4. 현재 디렉토리에서 자동으로 찾기
46 |     * `server=.`
47 | 
48 | ## 문제해결
49 | 
50 | * 다운로드한 server jar이 인식이 안돼요
51 |     * grep 에서 pearl 정규식을 사용 할 수 있어야 합니다. grep을 업데이트 해보세요(기준: grep 3.6)
52 |    
53 | ## 기타
54 | 
55 | * 11월 이후 paper의 api v1이 서비스 종료됩니다. (paper 브랜치를 참조하세요)
56 | 
57 | ## 다른 구현체들
58 | 
59 | Go언어로 제작된 서버 실행기: [aroxu](https://github.com/aroxu/server-script)
60 | 
61 | Paper 전용 서버 실행기: [monun](https://github.com/monun/server-script/tree/paper)
62 | 


--------------------------------------------------------------------------------
/.server/start.sh:
--------------------------------------------------------------------------------
  1 | #!/bin/bash
  2 | 
  3 | download() {
  4 |   wget -c --content-disposition -P "$2" -N "$1" 2>&1 | grep -Po '([A-Z]:)?[\/\.\-\w]+\.jar' | tail -1
  5 | }
  6 | 
  7 | if [[ $1 != launch ]]; then
  8 |   touch start
  9 |   exit
 10 | fi
 11 | 
 12 | # check java (https://stackoverflow.com/questions/7334754/correct-way-to-check-java-version-from-bash-script)
 13 | if type -p java; then
 14 |   echo "Found java executable in PATH"
 15 |   _java=java
 16 | elif [[ -n "$JAVA_HOME" ]] && [[ -x "$JAVA_HOME/bin/java" ]]; then
 17 |   echo "Found java executable in JAVA_HOME"
 18 |   _java="$JAVA_HOME/bin/java"
 19 | else
 20 |   echo "Not found java"
 21 |   exit
 22 | fi
 23 | 
 24 | while :; do
 25 |   rm -f start
 26 | 
 27 |   script=$(basename "$0")
 28 |   script_config="./$script.conf"
 29 | 
 30 |   if [ ! -f "$script_config" ]; then
 31 |     cat <<EOT >"$script_config"
 32 | server=https://papermc.io/api/v1/paper/1.17.1/latest/download
 33 | debug=false
 34 | debug_port=5005
 35 | backup=false
 36 | force_restart=false
 37 | memory=16
 38 | plugins=()
 39 | EOT
 40 |   fi
 41 | 
 42 |   source "$script_config"
 43 | 
 44 |   # Print configurations
 45 |   echo "server = $server"
 46 |   echo "debug = $debug"
 47 |   echo "backup = $backup"
 48 |   echo "force_restart = $force_restart"
 49 |   echo "memory = ${memory}G"
 50 | 
 51 |   if [ "$server" = "." ]; then
 52 |     jar=$(ls -dt ./*.jar | head -1)
 53 |   elif [ -f "$server" ]; then
 54 |     jar=$server
 55 |   else
 56 |     url_regex='(https?)://[-A-Za-z0-9\+&@#/%?=~_|!:,.;]*[-A-Za-z0-9\+&@#/%=~_|]'
 57 |     if [[ $server =~ $url_regex ]]; then
 58 |       jar_folder="$HOME/.minecraft/server/"
 59 |       mkdir -p "$jar_folder"
 60 |       jar=$(download "$server" "$jar_folder")
 61 |     else
 62 |       echo "Not found server jar"
 63 |       exit
 64 |     fi
 65 |   fi
 66 | 
 67 |   echo "jar = $jar"
 68 | 
 69 |   mkdir -p "./plugins"
 70 | 
 71 |   # Download plugins
 72 |   for i in "${plugins[@]}"; do
 73 |     download_result=$(download "$i" "./plugins")
 74 |     echo "$download_result <- $i"
 75 |   done
 76 | 
 77 |   jvm_arguments=(
 78 |     "-Xmx${memory}G"
 79 |     "-Xms${memory}G"
 80 |     "-XX:+ParallelRefProcEnabled"
 81 |     "-XX:MaxGCPauseMillis=200"
 82 |     "-XX:+UnlockExperimentalVMOptions"
 83 |     "-XX:+DisableExplicitGC"
 84 |     "-XX:+AlwaysPreTouch"
 85 |     "-XX:G1HeapWastePercent=5"
 86 |     "-XX:G1MixedGCCountTarget=4"
 87 |     "-XX:G1MixedGCLiveThresholdPercent=90"
 88 |     "-XX:G1RSetUpdatingPauseTimePercent=5"
 89 |     "-XX:SurvivorRatio=32"
 90 |     "-XX:+PerfDisableSharedMem"
 91 |     "-XX:MaxTenuringThreshold=1"
 92 |     "-Dusing.aikars.flags=https://mcflags.emc.gs"
 93 |     "-Daikars.new.flags=true"
 94 |     "-Dcom.mojang.eula.agree=true"
 95 |   )
 96 | 
 97 |   if [[ $memory -lt 12 ]]; then
 98 |     echo "Use Aikar's standard memory options"
 99 |     jvm_arguments+=(
100 |       "-XX:G1NewSizePercent=30"
101 |       "-XX:G1MaxNewSizePercent=40"
102 |       "-XX:G1HeapRegionSize=8M"
103 |       "-XX:G1ReservePercent=20"
104 |       "-XX:InitiatingHeapOccupancyPercent=15"
105 |     )
106 |   else
107 |     echo "Use Aikar's Advanced memory options"
108 |     jvm_arguments+=(
109 |       "-XX:G1NewSizePercent=40"
110 |       "-XX:G1MaxNewSizePercent=50"
111 |       "-XX:G1HeapRegionSize=16M"
112 |       "-XX:G1ReservePercent=15"
113 |       "-XX:InitiatingHeapOccupancyPercent=20"
114 |     )
115 |   fi
116 | 
117 |   if [[ $debug == true ]]; then
118 |     port_arguments="$debug_port"
119 | 
120 |     java_version=$("$_java" -version 2>&1 | awk -F '"' '/version/ {print $2}')
121 |     java_version_9="9"
122 | 
123 |     if [ "$(printf '%s\n' "$java_version" "$java_version_9" | sort -V | head -n1)" = "$java_version_9" ]; then
124 |       echo "DEBUG MODE: JDK9+"
125 |       port_arguments="*:$port_arguments"
126 |     else
127 |       echo "DEBUG MODE: JDK8"
128 |     fi
129 | 
130 |     jvm_arguments+=("-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=$port_arguments")
131 |   fi
132 | 
133 |   jvm_arguments+=(
134 |     "-jar"
135 |     "$jar"
136 |     "nogui"
137 |   )
138 | 
139 |   "$_java" "${jvm_arguments[@]}"
140 | 
141 |   if [[ $backup = true ]]; then
142 |     read -r -t 5 -p "Press Enter to start the backup immediately or Ctrl+C to cancel `echo $'\n> '`"
143 |     echo 'Start the backup.'
144 |     backup_file_name=$(date +"%y%m%d-%H%M%S")
145 |     mkdir -p '.backup'
146 |     tar --exclude='./.backup' --exclude='*.gz' --exclude='./cache' -zcf ".backup/$backup_file_name.tar.gz" .
147 |     echo 'The backup is complete.'
148 |   fi
149 | 
150 |   if [[ -f start ]]; then
151 |     continue
152 |   elif [[ $force_restart = true ]]; then
153 |     read -r -t 3 -p "The server restarts. Press Enter to start immediately or Ctrl+C to cancel `echo $'\n> '`"
154 |     continue
155 |   else
156 |     break
157 |   fi
158 | done
159 | 


--------------------------------------------------------------------------------