No edit summary |
|||
(26 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ |
+ | {{Docs}} |
== Preliminary notes == |
== Preliminary notes == |
||
+ | {{note|In this guide we refer to the server file as '''craftbukkit.jar''' but the file you download may be named differently. The file name used in your start script '''must''' match the name of the file you download. }} {{note|Unless you have a multi-homed machine and know what this means/requires, '''server-ip<nowiki>=</nowiki>''' in server.properties MUST remain unchanged from default and be blank.}} {{note|When running a server for the first time, errors will show up. Do not worry as this is normal; the server is generating files and folders needed to run as they do not exist yet.}} |
||
− | |||
− | + | {{note|The Bukkit server is intended as a ''complete replacement'' for the official Minecraft Server downloaded from Minecraft.net and is not normally ran at the same time on a single computer. It is possible however, to copy your 'World' data files previously created within a Minecraft Server into your Bukkit folders to continue use of your previous game. As always, backup your data and configuration prior to migrating to Bukkit.}} |
|
== Windows == |
== Windows == |
||
− | :1. |
+ | :1. Get CraftBukkit's latest recommended build: {{CBDownloadRB}} |
:2. Put the .jar file in the directory you'd like the server to run from |
:2. Put the .jar file in the directory you'd like the server to run from |
||
:3. Open a text editor such as Notepad and type: |
:3. Open a text editor such as Notepad and type: |
||
− | java |
+ | java -jar craftbukkit.jar |
PAUSE |
PAUSE |
||
:4. Save the document as run.bat (not as a .txt) in the same directory as craftbukkit.jar. |
:4. Save the document as run.bat (not as a .txt) in the same directory as craftbukkit.jar. |
||
⚫ | |||
− | |||
⚫ | |||
− | |||
:5. Double click run.bat and you're away! |
:5. Double click run.bat and you're away! |
||
:6. To shut down, issue the "stop" command in console. |
:6. To shut down, issue the "stop" command in console. |
||
− | :If you see "'Java' is not recognized as an internal or external command, operable program or batch file." then you need to reinstall Java. Still get this error? Follow this [http://www.java.com/en/download/help/path.xml guide] to adding Java to your system path. |
+ | : If you see "'Java' is not recognized as an internal or external command, operable program or batch file." then you need to reinstall Java. Still get this error? Follow this [http://www.java.com/en/download/help/path.xml guide] to adding Java to your system path. |
− | |||
− | {{note|Below is a slightly improved variant of the batch file above, which looks for the newest version of Craftbukkit and launches that. This makes it so that you don't have to remove the version info from the Craftbukkit .jar, which could be useful for painlessly falling back to an older version if you need to wait for a plugin to update.}} |
||
− | |||
− | @Echo Off |
||
− | Dir /B>Dir.temp |
||
− | FindStr /R "craftbukkit-[0-9]\.[0-9]\.[0-9].*\.jar" "Dir.temp">FindStr.temp |
||
− | Del Dir.temp |
||
− | For /F "tokens=*" %%a In ('sort /r FindStr.temp') Do Call :WorkIt "%%a" |
||
− | |||
− | :WorkIt |
||
− | java -Xmx1024M -Xms1024M -jar %1 -o true |
||
− | Del FindStr.temp |
||
− | PAUSE |
||
− | EXIT |
||
− | |||
== Linux == |
== Linux == |
||
− | :1. |
+ | :1. Get CraftBukkit's latest build: {{CBDownloadRB}} |
:2. Put the .jar in a folder, for this example we'll use a generic one: ~/craftbukkit |
:2. Put the .jar in a folder, for this example we'll use a generic one: ~/craftbukkit |
||
:3. Move to the above directory in terminal with 'cd ~/craftbukkit' |
:3. Move to the above directory in terminal with 'cd ~/craftbukkit' |
||
Line 48: | Line 31: | ||
BINDIR=$(dirname "$(readlink -fn "$0")") |
BINDIR=$(dirname "$(readlink -fn "$0")") |
||
cd "$BINDIR" |
cd "$BINDIR" |
||
− | java |
+ | java -jar craftbukkit.jar |
</pre></div></div> |
</pre></div></div> |
||
:6. Make the file executable, either by running "chmod +x ~/craftbukkit/craftbukkit.sh" in a terminal, or by changing the permissions in the file's properties. |
:6. Make the file executable, either by running "chmod +x ~/craftbukkit/craftbukkit.sh" in a terminal, or by changing the permissions in the file's properties. |
||
Line 58: | Line 41: | ||
If you plan to run the server more permanently an init script like this one (recommended) [https://github.com/Ahtenus/minecraft-init] |
If you plan to run the server more permanently an init script like this one (recommended) [https://github.com/Ahtenus/minecraft-init] |
||
− | If you want to run your server with screen, you can use a script like this one (recommended) [http://dev.bukkit.org/server-mods/ascii-bukkit-menu/ ABM] |
+ | If you want to run your server with screen, you can use a script like this one (recommended) [http://dev.bukkit.org/server-mods/ascii-bukkit-menu/ ABM] |
== Mac OS X == |
== Mac OS X == |
||
− | #Install Java |
+ | # Install Java |
− | #:Since OS X 10.7 Java does not come packaged with OS X. You will need to install java from the Apple's website http://support.apple.com/kb/DL1421 |
+ | #: Since OS X 10.7 Java does not come packaged with OS X. You will need to install java from the Apple's website http://support.apple.com/kb/DL1421 |
− | #Obtaining the Server Files |
+ | # Obtaining the Server Files |
− | #:To run a server you will need the server jars, i.e. the server files. We will need a place to put the files. |
+ | #: To run a server you will need the server jars, i.e. the server files. We will need a place to put the files. |
− | ##Create a New Folder |
+ | ## Create a New Folder |
− | ##:Open up finder, and create a new folder in your Home folder named ''CraftBukkit'' |
+ | ##: Open up finder, and create a new folder in your Home folder named ''CraftBukkit'' |
− | ##Download the File |
+ | ## Download the File |
− | ##:Download the server files. You can download the latest builds from the front page of the wiki. |
+ | ##: Download the server files. You can download the latest builds from the front page of the wiki. |
− | ##:'''''Note:''''' Download the stable build if you are not chasing the cutting edge in the development build |
+ | ##: '''''Note:''''' Download the stable build if you are not chasing the cutting edge in the development build |
− | ##Move the File |
+ | ## Move the File |
− | ##:Move the file from the Downloads folder to the CraftBukkit folder you created. |
+ | ##: Move the file from the Downloads folder to the CraftBukkit folder you created. |
− | #Obtaining startup script |
+ | # Obtaining startup script |
− | #:To easily start the server you will need a startup script. The following is a basic server script to start your server. |
+ | #: To easily start the server you will need a startup script. The following is a basic server script to start your server. |
− | ##Open up TextEdit set it to |
+ | ## Open up TextEdit set it to plain text mode under format and paste the following in <pre><nowiki>#!/bin/bash cd "$( dirname "$0" )" java -Xmx1024M -jar craftbukkit.jar -o true</nowiki></pre> |
+ | ## Save the file |
||
− | |||
⚫ | |||
− | cd "$( dirname "$0" )" |
||
⚫ | |||
− | |||
⚫ | |||
− | java -Xmx1024M -Xms1024M -jar craftbukkit.jar -o true </pre> |
||
⚫ | |||
− | |||
− | ## |
+ | ###: chmod a+x |
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
− | ###:chmod a+x |
||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
⚫ | |||
<br> '''ALTERNATE METHOD''' [Only for Advanced Users]: |
<br> '''ALTERNATE METHOD''' [Only for Advanced Users]: |
||
Line 103: | Line 81: | ||
curl -LO http://cbukk.it/craftbukkit.jar |
curl -LO http://cbukk.it/craftbukkit.jar |
||
echo "cd ~/Desktop/BukkitServer/" >> start.command |
echo "cd ~/Desktop/BukkitServer/" >> start.command |
||
− | echo "java - |
+ | echo " java -Xmx1024M -jar craftbukkit.jar -o true" >> start.command |
chmod +x start.command |
chmod +x start.command |
||
− | open -a TextEdit start.command |
||
</pre></div></div> |
</pre></div></div> |
||
− | Textedit should open a document called "LaunchServer.command". Find [RAM] and replace it with:<br>512 or 1024 or 1536 or 2560 or 3072 or 5120 |
||
− | |||
− | <br>That is the ram amount the server will have.<br>512=512MB; 1024=1GB; 1536=1.5GB; 2560=2.5GB; 3072=3GB; 5120=5GB<br><br> |
||
The server is installed on your Desktop, in "Bukkit Server". To start it double click "LaunchServer.command". <br> |
The server is installed on your Desktop, in "Bukkit Server". To start it double click "LaunchServer.command". <br> |
||
− | == |
+ | == Troubleshooting == |
+ | |||
+ | [[Troubleshooting Common Problems]] |
||
+ | == Community Guides == |
||
− | [http://forums.bukkit.org/threads/how-to-setup-a-ubuntu-craftbukkit-server-x64-running-java-x64.598/ Ubuntu Server x64 Setup.] |
||
− | [http://forums.bukkit.org/threads/ |
+ | [http://forums.bukkit.org/threads/how-to-setup-a-ubuntu-craftbukkit-server-x64-running-java-x64.598/ Ubuntu Server x64 Setup.] |
− | <br> |
||
{{Languages|Setting up a server}} |
{{Languages|Setting up a server}} |
Latest revision as of 21:10, 22 August 2017
This page is part of the official Bukkit Documentation
|
Preliminary notes
- Note: In this guide we refer to the server file as craftbukkit.jar but the file you download may be named differently. The file name used in your start script must match the name of the file you download.
- Note: Unless you have a multi-homed machine and know what this means/requires, server-ip= in server.properties MUST remain unchanged from default and be blank.
- Note: When running a server for the first time, errors will show up. Do not worry as this is normal; the server is generating files and folders needed to run as they do not exist yet.
- Note: The Bukkit server is intended as a complete replacement for the official Minecraft Server downloaded from Minecraft.net and is not normally ran at the same time on a single computer. It is possible however, to copy your 'World' data files previously created within a Minecraft Server into your Bukkit folders to continue use of your previous game. As always, backup your data and configuration prior to migrating to Bukkit.
Windows
- 1. Get CraftBukkit's latest recommended build: CraftBukkit - Where can I get it?
- 2. Put the .jar file in the directory you'd like the server to run from
- 3. Open a text editor such as Notepad and type:
java -jar craftbukkit.jar PAUSE
- 4. Save the document as run.bat (not as a .txt) in the same directory as craftbukkit.jar.
- Note: With some programs such as Notepad, it may try saving as run.bat.txt. When saving to a file name, put the name in quotes: "run.bat"
- 5. Double click run.bat and you're away!
- 6. To shut down, issue the "stop" command in console.
- If you see "'Java' is not recognized as an internal or external command, operable program or batch file." then you need to reinstall Java. Still get this error? Follow this guide to adding Java to your system path.
Linux
- 1. Get CraftBukkit's latest build: CraftBukkit - Where can I get it?
- 2. Put the .jar in a folder, for this example we'll use a generic one: ~/craftbukkit
- 3. Move to the above directory in terminal with 'cd ~/craftbukkit'
- 4. Create a new file in the minecraft folder and name it craftbukkit.sh
- 5. Edit the file and paste this into it:
#!/bin/sh BINDIR=$(dirname "$(readlink -fn "$0")") cd "$BINDIR" java -jar craftbukkit.jar
- 6. Make the file executable, either by running "chmod +x ~/craftbukkit/craftbukkit.sh" in a terminal, or by changing the permissions in the file's properties.
- 7. Then, in terminal, type '~/craftbukkit/craftbukkit.sh' to run to start the server.
- 8. When you're done playing around, issue the "stop" command in console.
If you plan to run the server more permanently an init script like this one (recommended) [1]
If you want to run your server with screen, you can use a script like this one (recommended) ABM
Mac OS X
- Install Java
- Since OS X 10.7 Java does not come packaged with OS X. You will need to install java from the Apple's website http://support.apple.com/kb/DL1421
- Obtaining the Server Files
- To run a server you will need the server jars, i.e. the server files. We will need a place to put the files.
- Create a New Folder
- Open up finder, and create a new folder in your Home folder named CraftBukkit
- Download the File
- Download the server files. You can download the latest builds from the front page of the wiki.
- Note: Download the stable build if you are not chasing the cutting edge in the development build
- Move the File
- Move the file from the Downloads folder to the CraftBukkit folder you created.
- Obtaining startup script
- To easily start the server you will need a startup script. The following is a basic server script to start your server.
- Open up TextEdit set it to plain text mode under format and paste the following in
#!/bin/bash cd "$( dirname "$0" )" java -Xmx1024M -jar craftbukkit.jar -o true
- Save the file
- Save it in your CraftBukkit folder as start_server.command
- Allow the script to run
- Open up Terminal.app
- Type into Terminal.app
- chmod a+x
Warning: Do not hit return
- drag the start_server.command into Terminal.app
- hit return
- Starting the server
- From this point on you can start the server by double-clicking start_server.command.
- You will need to run the server once for it to generate some configuration files.
Warning: To stop the server, do not close the terminal/command prompt window. Instead, type 'stop' into the console. Closing the terminal window without stopping the server could lead to corruption of the save files.
ALTERNATE METHOD [Only for Advanced Users]:
Open Terminal (Found in Application/Utilities) and paste:
cd ~/Desktop/ mkdir BukkitServer cd BukkitServer/ curl -LO http://cbukk.it/craftbukkit.jar echo "cd ~/Desktop/BukkitServer/" >> start.command echo " java -Xmx1024M -jar craftbukkit.jar -o true" >> start.command chmod +x start.command
The server is installed on your Desktop, in "Bukkit Server". To start it double click "LaunchServer.command".
Troubleshooting
Troubleshooting Common Problems
Community Guides
Language | English • беларуская • Deutsch • español • suomi • français • italiano • 한국어 • Nederlands • norsk • polski • português • русский • lietuvių • čeština |
---|