Welcome to the BukkitWiki!

This Wiki is home to Bukkit's documentation and regulations surrounding the Bukkit Project and it's services. Want to help out? We would love to have you! Signup to get started!


Thuejk (talk | contribs)
Line 197: Line 197:
For the Linux servers section, how about mentioning my [https://github.com/Thue/rfwadmin rfwadmin] startup script and web interface? [[User:Thuejk|Thuejk]] 14:08, 22 December 2012 (EST)
For the Linux servers section, how about mentioning my [https://github.com/Thue/rfwadmin rfwadmin] startup script and web interface? [[User:Thuejk|Thuejk]] 14:08, 22 December 2012 (EST)
:BukkitWiki is not a place for advertisment. -- [[User:Chrisward|Chris Ward]] - <small>Wiki Admin ([[Special:EmailUser/Chrisward|Report Spam/Contact]])</small> 02:12, 23 December 2012 (EST)

Revision as of 07:12, 23 December 2012

Inclusion into Docs Nomination (06/05/2012)

Please Discuss the Docs Nomination here. I'm alright with including it as long as we split the pages into Windows, Linux, and Mac Install Instructions. resba - BukkitWiki Admin 18:20, 5 June 2012 (EST)

Page Protection Notice (Updated 06/05/2012, Removed 06/05/2012)

The page associated with this talk page has been locked due to counter-productive editing. In addition: Community tutorials should not be considered the Universally Reccomended method because it nullifies the use of this page. If you don't agree with the edits of a user, inquire on their talk page the reasoning behind it OR start a conversation on that page's talk page. This page's protection will expire in one week of this posting. If this continues I will lock it permanently and additions to the tutorial will have to be requested on the talk page. resba - BukkitWiki Admin 12:58, 31 January 2012 (EST)

The page associated with this talk page has been locked indefinably due to being a high-traffic page. Edits can be discussed on this page and added by an administrator. resba - BukkitWiki Admin 07:34, 2 February 2012 (EST)
Locking this page isn't useful. The documentation with respect to Linux is embarrassing at best. If you can't handle dealing with vandalism, just delete the thing or at least give pointers to some forum threads. -- Dagmar d'Surreal 13:18, 25 February 2012 (EST)
Page has been unlocked due to demand and nomination for inclusion into docs. resba - BukkitWiki Admin 18:19, 5 June 2012 (EST)

Two Major Problems with the Mac Instructions

First of all, on mac step 3.2, before saving the file, the user must go to Format > Make Plain Text in order fo the command to work.

Also, in the Mac Alternate Method is not up to date, on the line: mv craftbukkit-1.1-R3.jar CraftBukkit.jar The line says 1.1-R3, while the current version is 1.2.5.

Try to fix the problems ASAP, because both of the Mac methods fail to work due to the problems.

--Assisstion 05:14, 22 April 2012 (EST)

Minor Problem in Mac Instructions

This isn't a huge fix. In the Mac OSX instructions under the section that says "ALTERNATE METHOD" there is a line that reads as follows:

Textedit should open a document called "LaunchServer.command".

when the line should read as:

Textedit should open a document called "start.command".


The main download link goes direct to a 404-not-found page.

The second download link (under linux) goes to some lamearse graphic telling everyone that "read permission" is not granted, or some other similar bogus message (yes - I clicked "Allow"...)

Further cleanup and streamline. Slaps to those using bash for portable scripts. --AnrDaemon 22:24, 27 March 2011 (EST)
Dude, no "reasonable" Linux distribution out there doesn't have bash in it. Heck, you can generally expect even Solaris machines to have bash now. -- Dagmar d'Surreal 13:24, 25 February 2012 (EST)
Cleaned up the Windows startup script. %ProgramFiles% has the same end result for both x86 and x86-64 systems, unless, as note on page specified, you are running a 32-bit Java machine on x86-64. Also separated base path extraction from server startup. While it does not affect example directly, it opens a way to improve script in some interesting ways... --AnrDaemon 20:55, 13 March 2011 (EST)
Reworded note about jar file name matching downloaded name. The existing text was incorrect and confusing users. Unfortunately, now it doesn't fit in the code window. Also: can anyone confirm that on a 64 bit machine java is actually installed in the program files(x86) folder, as listed here? This seems unlikely. I will double check tomorrow and update if necessary. I also reformatted this page a bit.--Mughi 19:14, 20 February 2011 (EST)

Someone forgot to put in steps for giving a PATH variable in Windows. A .bat file with only those commands in it won't work unless you have a path for java set up in your system variables, or unless it's declared in the . bat script. --unknown user

The page says to download craftbukkit... It might be useful to have a link pointing to the latest stable version??? --Mr FJ 09:51, 18 January 2011 (MST)

Someone left </source> at the end of the linux shell script. This resulted in:
./run.sh: line 2: syntax error near unexpected token `newline'
./run.sh: line 2: `cd "${0%/*}"; java -Xms512M -Xmx1024M -jar craftbukkit-0.0.1-                                                  SNAPSHOT.jar</source>'

I corrected the error. --unknown user

Need Mac instructions

Can someone with a Mac please confirm that the instructions for Linux also work on Macs.

It doesnt work. Please rewrite.--SmiVan 18:43, 04 March 2011
I made one for this thread: http://forums.bukkit.org/threads/how-to-install-bukkit-newb-friendly.245/ And adapted it for here :)-PierreLouis 11:47, 06 March 2011
Please be sure to sign your name properly by using the signature button in the toolbar. 4am 12:42, 3 September 2011 (EST)
I just added a new mac instruction --Sagacious Zed 13:04, 1 December 2011 (EST)
Under the section 3. Obtaining startup script it needs to be noted that when pasting the startup script into TextEdit users should convert the file to plain text before saving by selecting the menu option Format>Make Plain Text. By default, TextEdit creates a rich text document that will not work properly as a unix script without converting to plain text. --MrMalm 23:24, 1 March 2012 (EST)
Noted --Sagacious Zed 21:26, 5 June 2012 (EST)
The mac download instruction doesn't work. curl -O http://cbukk.it/craftbukkit.jar does not fetch any data, even though the direct URL from a browser seems to work. The command-line command that works, and the one that is used by the main page is the following: curl -LO http://dl.bukkit.org/latest-rb/craftbukkit.jar I made this change, but it was reverted for some reason by Mbaxter to the non-working version. Jellyvista 23:12, 22 September 2012 (EST)
Without documentation you edited the URL to a different one. I'm updating the command to curl -LO, as that works fine with the existing URL. Sorry for the confusion. - mbaxter 02:09, 23 September 2012 (EST)

Please don't spam

I removed a link to MCMSC.com, The BukkitWiki is not your personal ad space. I am going to move to have the user who posted this link banned if it happens again. Consider yourself warned. 4am 12:40, 3 September 2011 (EST)

In regards to > sign

In the bash scripts, the terminal relys on > If someone were to copy what is rendered however is &GT; which breaks the script. --Sagacious Zed 13:02, 1 December 2011 (EST)

Adf.ly Links Not Permitted

There is no reason they should not be permitted. In this scenario, the setup they link to is invaluable in helping people setup a Minecraft server with ease. The five seconds you wait for (which supports the creator) is nothing compared to the relatively vast amount of work you must do as an alternative, which is neither helpful to those new to setting up servers or those who have setup servers before. In addition, the installer is universal and can be used on any operating system.

Perhaps the moderators should realize there is no reason to over-complicate things.

Bukkit's policy is to disallow ad.fly links, not BukkitWiki's. This is final, don't do it again. resba - BukkitWiki Admin 12:00, 13 January 2012 (EST)
You are welcome to post non-adfly or other money-link services links to these auto-installers. But if you have an issue with the policy itself feel free to discuss this policy with administration --NuclearW 17:13, 13 January 2012 (EST)

Problem in Linux section

Problem with step 5

You don't want to copy/paste the code in #5 into a document called craftbukkit.sh. The code in question will actually create a file called craftbukkit.sh and make it executable, so sticking it into a file called craftbukkit.sh seems pointless/wrong. Let's go into the code in detail:

cat > craftbukkit.sh << EOF

redirect STDIN to the truncated file craftbukkit.sh until STDIN contains EOF on its own line. Everything entered after this line (and until EOF) is part of STDIN, and will be put into craftbukkit.sh.

BINDIR=$(dirname "$(readlink -fn "$0")")
cd "$BINDIR"
java -Xmx1024M -Xms1024M -jar craftbukkit.jar

This is all STDIN, and will be placed in the file above.


This is the token the shell is waiting for to know to stop listening for text on STDIN. It is essentially replaced with an actual EOF (end of file) character.

chmod +x craftbukkit.sh

This makes the craftbukkit.sh file executable (what step 6 says to do).

I wholly concur. It's more than a little senseless to have someone create a script, just to run it so that it creates another script. -- Dagmar d'Surreal 13:26, 25 February 2012 (EST)


I would recommend replacing steps 4-6 (the first 6, not the second) with a recommendation that the user runs the code from step 5. Additionally, the styles of the wiki should be adjusted so extra space characters are not inserted at the beginning of each line for text inside "pre" tags. The spaces prevent the terminal from seeing the EOF, and will break the #!/bin/sh line at the beginning of the file.

Recommended Build Number

This page hasn't been updated to say what the latest craftbukkit version is. It says 1.1-R4, but the link for download goes to 1.1-R6.

More java details.

Just noticed it locked, but maybe some information could be added about java?

For example a link to the java site, and a 'comparison' of java versions. 64 bit is better as 32 (if your system supports it) and supports more RAM. JRE7 is better at performance, improved generally compared to JRE6. Also 32bit is restricted to 1GB RAM, that isn't mentioned.

I think these could be usefull.

Bertware 13:21, 23 March 2012 (EST)

Edit in Windows

The third text box should say

CD /D "%~dp0"
java -Xmx1024M -Xms1024M -jar craftbukkit.jar

This makes it easier... sort of

Windows trouble

When I run RUN.bat it says: "unable to access jar file" Please help

I also get this error! I seem to be unable to find a sollution Dx.



I am having the same problem as the person above me.

When I run the RUN.bat file, it comes up with 'Error: Unable to access jarfile craftbukkit.jar'

I used the Java-7 code for the file:

"%ProgramFiles%\Java\jre7\bin\java.exe" -Xmx1024M -Xms1024M -jar craftbukkit.jar
This page is not for Bukkit Support. Please ask your questions either on IRC or on the bukkit forums. Thank you - Chris Ward - Wiki Admin (Report Spam/Contact) 03:20, 2 August 2012 (EST)

Remove Auto-Installer

The topic for the auto-installer has had its links removed for "Making money off of an open-source project without validation of integrity." Since no one but mods / admins can edit this article, I will be leaving this note here. Iyeru 20:04, 9 April 2012 (EST)

"Advanced" tutorials and scripts

I added an improved Windows .bat and marked it as such. The edit was reverted given the reason "this is a basic tutorial not a madhouse". While I'm fine with it being a basic tutorial, I feel that the principle should either exist globally or not at all. The Mac heading has an Advanced section in much the same vein as my contribution (to improve ease of use), and I think that if that is permitted then mine should also... or neither should. Perhaps advanced tips should have their own page, if they don't belong here? --Joequincy 22:54, 14 October 2012 (EST)

The advanced section of the Mac OS X instructions is not a start up script. It is merely the way to perform all the action in the basic setup through the terminal. --Sagacious Zed 20:08, 15 October 2012 (EST)

Obtaining Startup Script Mac Problem

When you copy and paste the text for the start_server.command file it doesn't work. You have to delete the line breaks and manually enter them yourself in text edit, otherwise it results in:

... -bash: /Users/.../start_server.command: /bin/bash^M: bad interpreter: No such file or directory logout

[Process completed]

This was not easy for a beginner to figure out. --Clockbound 10:57, 5 November 2012 (EST)

I have corrected the problem with the following User:Sagacious Zed/MacOSX startup script, awaiting for an administrator to either copy the source or move it out of my user page and include it into the page. --Sagacious Zed 13:46, 5 November 2012 (EST)
Mbaxter has updated the script on the page, it should have fixed the problem (invisible characters) --Sagacious Zed 16:00, 6 November 2012 (EST)

rfwadmin Linux server admin

For the Linux servers section, how about mentioning my rfwadmin startup script and web interface? Thuejk 14:08, 22 December 2012 (EST)

BukkitWiki is not a place for advertisment. -- Chris Ward - Wiki Admin (Report Spam/Contact) 02:12, 23 December 2012 (EST)