Post by Vivian on Jun 13, 2021 16:37:41 GMT -5
How to Install New Frontier Craft on a Server
If you run into any issues, are stuck, or have any questions, contact us on our Discord server!
discord.gg/HvGx8vE
Download CraftBukkit
No matter what you do, you'll need a Vanilla CraftBukkit 1060 jar. Due to legal issues we cannot provide a direct download to this, however in the future the installation script will compile this on-the-fly. But for now you still need to provide your own copy. You should be able to find the file if you Google something along the lines of "Minecraft CraftBukkit 1.7.3 1060"
Anything other than unmodified CraftBukkit 1060 WILL NOT WORK! Do not attempt to use clients like Canyon
The jar should have a SHA-256 hash of aa7e750cea03b1fd9e0feb3c2214a7f5d18fee5677fd39ec7784f3a9f820eb28 & an MD5 hash of 3a7c88414eb684d5a582b6c53ce23296.
These hashes are just identifiers that let you know you have the right file, as only the correct file will have these hashes. You don't need to check this.
No matter what you do, you'll need a Vanilla CraftBukkit 1060 jar. Due to legal issues we cannot provide a direct download to this, however in the future the installation script will compile this on-the-fly. But for now you still need to provide your own copy. You should be able to find the file if you Google something along the lines of "Minecraft CraftBukkit 1.7.3 1060"
Anything other than unmodified CraftBukkit 1060 WILL NOT WORK! Do not attempt to use clients like Canyon
The jar should have a SHA-256 hash of aa7e750cea03b1fd9e0feb3c2214a7f5d18fee5677fd39ec7784f3a9f820eb28 & an MD5 hash of 3a7c88414eb684d5a582b6c53ce23296.
These hashes are just identifiers that let you know you have the right file, as only the correct file will have these hashes. You don't need to check this.
Automated Installation
Setup Utility Download (v3.5.1 S2): github.com/New-Frontier-Craft/NFC-Server-Setup-Utility/archive/refs/heads/main.zip
This is Windows/Wine only at the moment. macOS and Linux shell scripts will come at some point in the future.
Extract the zip, place the CraftBukkit jar in the folder, and run the setup_nfc script for your OS. Once it's complete, run the start_server script and you should have an NFC server up and running
If you'd like to poke around at the GitHub the setup utility is hosted on, check it out here
Manual Installation
Downloading the Files
Step 1: Download the Patch
Then, you'll want to download this file: github.com/New-Frontier-Craft/New-Frontier-Craft/releases/download/v3.5.1/NFC_Patch_v3.5.1_S2.xdelta
If this opens a page full of confusing text, right click it and save it as a .xdelta file.
Step 2: Download the Patching Software
Follow the instructions below for your current operating system...
Windows:
NOTE: 7-Zip (Recommended) or WinRAR may be required to extract the files from the .rar below!
Download and extract the xDelta GUI here from the .zip to a folder: github.com/marco-calautti/DeltaPatcher/releases
If you want to use the command line instead, grab this .exe instead: github.com/New-Frontier-Craft/New-Frontier-Craft/blob/master/runtime/bin/xdelta3.exe
Linux:
Simply run the following commands:
| sudo apt update |
| sudo apt install xdelta3 |
macOS:
Install Homebrew to get the 'brew' command needed for the next step: brew.sh/
Now run this command:
| brew install xdelta |
Building the Jar
Now, for the best part. Let's make this boring old vanilla Bukkit 1.7.3 jar into an NFC jar!
Windows XDeltaUI:
Windows XDeltaUI:
If you chose to use the GUI on Windows, open the xdeltaUI.exe file.
Make sure you're in the 'Apply Patch' tab.
For 'original file', select the vanilla Bukkit jar, for 'patch file', select the .xdelta file you downloaded in the last step of part 2.
For the output, it can be named anything you want, but you must add the .jar file extension manually, it will not be added for you. So your file should be named something like "server.jar"
Terminal on Windows, Linux, and macOS:
If you're not using XDeltaUI, open a terminal and use 'cd' to navigate to the folder your files are in.
Run the command below, where 'bukkit' is for whatever your bukkit jar is named, 'nfcpatch' for whatever the .xdelta patch is named, and 'jarname' for what you want your server jar to be named. File paths work too.
Do not erase the quotation marks, this ensures the command runs with no errors regardless of the file name or path.
| Windows | xdelta3.exe -d -s "bukkit.jar" "nfcpatch.xdelta" "jarname.jar" |
| Linux | xdelta3 -d -s "bukkit.jar" "nfcpatch.xdelta" "jarname.jar" |
| macOS | xdelta3 -d -s "bukkit.jar" "nfcpatch.xdelta" "jarname.jar" |
If your terminal doesn't recognize the command, precede the command with the characters "./"
Running the Jar
Is NFC your first server jar and you have no idea how to run this thing? Don't worry, we got you!
NOTE: If you already know how to run a server jar, skip parts 1 and 3, but DO NOT skip part 2! It's important to NFC!
With part 2, check it every time you make a new server jar, just in case we've updated the dependencies.
Step 1: Downloading Java
If you already have Java installed, you can skip this step.
Go to this website: adoptium.net/temurin/releases/?version=8
Download the one for your operating system
If you've got a 64-bit system, it's highly recommended you get the 64-bit version to be able to allocate more RAM to Minecraft if needed.
Step 2: Setting Up Dependencies
Create a folder named 'lib' in the folder you want your server jar to run in, if it is not already there.
Step 2: Setting Up Dependencies
Create a folder named 'lib' in the folder you want your server jar to run in, if it is not already there.
Download this: github.com/New-Frontier-Craft/New-Frontier-Craft/releases/download/v3.4.2/lib.zip, and then extract the contents of it to the 'lib' folder you created.
(Note, if you're updating this server from an earlier version, this step can be skipped if you're server is for NFC v3.4.2 S2 or newer.)
Step 3: Creating the Script
Now, we'll need to create a script to run our server.
First of all, if you're running on Windows, it's recommended you go to your file explorer, view, and then untick the option to hide file extensions.
If you messed up the earlier step of adding the .jar to the name of the server file, you can fix that now.
Next, for Windows, create a ".bat" file with any name.
For Linux, create a ".sh" file with any name.
For macOS, create a ".command" file with any name.
Make sure you create it in the same folder that your jar is in.
Copy the following arguments into it, where "jarname" is replaced with what you named the server jar.
| Windows | java -jar -Xmx4G -Xms4G -Duser.language=en "jarname.jar" |
| Linux | java -Xmx4G -Xms4G -Dfile.encoding=UTF8 -jar -Duser.language=en "jarname.jar" |
| macOS | exec java -Xmx4G -Xms4G -Dfile.encoding=UTF8 -jar -Duser.language=en "jarname.jar" |
The numbers before the "G"s are the amount of gigabytes of RAM used. We've used 4 gigabytes in this example. You can change this to any number you want, or you can change the "G" to an "M" for megabytes instead (the minimum recommended is 512 megabytes).
Step 4: Running the Script
Now, run it, and there you go! If everything worked out the server should be up and running, and /version should mention it's a custom NFC build of Bukkit.
If you're on Linux, and you're running the .sh with a GUI instead of the terminal, edit the file's properties, tick 'Allow executing files as program' and then when running it, click 'run in terminal'.
If you get some sort of error after launching, something about file utils, be sure the 'lib' folder is in the same folder as your jar and has all the libraries in it.
If you're on Linux, and you're running the .sh with a GUI instead of the terminal, edit the file's properties, tick 'Allow executing files as program' and then when running it, click 'run in terminal'.
If you get some sort of error after launching, something about file utils, be sure the 'lib' folder is in the same folder as your jar and has all the libraries in it.
