Skip to main content

FAQ - Frequently Asked Questions

Unable to connect to the server​

See the following troubleshooting guide.

Error occurred during initialization of VM : Could not reserve enough space​

You are likely using the 32bit version of Java. You need the 64bit version. It's either not installed or needs reinstalling.

To check which version you are currently using, open a command prompt and type java -version
If you see 32-bit or an error, you need a new version of Java.

Choosing a Java Version

Depending on what server type / version you need a specific java version. Refer to our Java Guide to see which version you need. Download links are also listed.

Failed To Bind to Port​

A process on your computer is already using the port your server is trying to use.

Start by ensuring you do not already have a server running on this port. If that's the case

Try killing all java processes (refer to regain-control) and start your server again.

If you added an IP to the 'server-ip' field in the server.properties file make sure to remove it. If you're running multiple servers make sure they're not using the same port. If you're still getting this error restarting your computer will usually resolve it.

The process cannot access the file because another process has locked a portion of the file​

This error happens when the server is already started in the background, but not visible in mcss. You have to stop the server, then start it again in mcss. To do that, follow these steps, then start the server again in mcss.

Trouble starting a server​

The console remains empty and the server does nothing​

You either don't have Java installed or MCSS doesn't know where it is.

Make sure you have installed the correct version by following this guide.

If you know you have the correct version already installed, follow this guide to tell MCSS where to look for it.

The console does something, but the server fails to start​

Read the error. More often than not, Minecraft throws easy to read errors that tell you exactly what went wrong. The answer to your issue could be even be in this FAQ !

The server works but when sending commands to the console nothing happens/The dashboard buttons don't work​

Open your server's settings (cogwheel icon on the dashboard) and open the advanced tab. Depending on your server type, append the following paramater to the end of the Java Startup Line :

  • For a bukkit-based server (Bukkit/Spigot/Paper on any other fork) use --nojline.
  • For Bungeecord and its forks (Waterfall) use -Djline.terminal=jline.UnsupportedTerminal instead.

Make sure to have a space between the end of the line and the argument.

Error: unable to access jarfile​

If this issue happens on a newly created server, it usually means the name of your server's JAR doesn't match with that in the startup flags.

Try to re-create the server. If the issue persists, join our discord server and we'll guide you through the steps to solve your issue. Alternatively if you know what you're doing you can edit the startup flags and the JAR's name to make them match

If this issue occurs on an existing, working server, it means the JAR is being used somewhere else. The first fix would be to kill all java processes (through MCSS or task manager). If that doesn't work, restart your computer.

Can I create a Neoforge/Quilt/any other "unsupported" server ?​

Yes, in fact MCSS can run almost any server type, the differences between server types in the app are mostly visual.
As long as your server is a jar, you should be able to run it with MCSS, just select the "closest" server type (Use Forge for Neoforge for example).

How do I regain control of my server if MCSS crashes?​

To regain control of your servers you need to stop the servers. The easiest and safest way to do this is to join each server as an operator and type /stop, then restart them using MCSS.
If you can't, you have to kill all Java processes, to do this you go to "Quick Options" > "Kill all Java processes" in the app.

Screenshot of the Kill all java processes option

danger

This will kill ALL Java processes, not only MCSS hosted Minecraft servers.
This includes:

  • The game itself
  • Any other program running Java or relying on Java to function

Also, you might experience loss of recent activity if the map wasn't saved recently.
Always prefer a proper stop to killing the server when possible!

Is there a Mac or Linux version?​

MCSS is currently only available on Windows.

Is this 24/7?​

MCSS runs on your computer. As long as it is online, the server is. So yes, if your computer in ON 24/7, the server can be too

Is there a way to remote control MCSS ?​

MCSS comes with a web panel to manage your servers remotely. You can find more info about it here. Please note that the panel is still under development so not all features from the app are included. There is also a REST API available for developers, you can learn more about it here.

Dashboard graphs are stuck to 0% CPU and 1MB of RAM​

On a server using a java startup line​

This issue happens with the latest versions of Java. It can easily be fixed by defining the path to your version of java.

To fix it, you have to specify the direct path to your java binaries in MCSS.

  1. open the file > options menu
  2. in the Global Java path override line, add the path to your java.exe (most often in C:\Program Files\Java\jdk-<version>\bin\java.exe), or use the Path Picker
  3. restart MCSS and try to start a server again, the graphs should display the correct information.

You can also add a different Java path for some server if only one requires Java 11 or higher. To do this, stop the server, go to the servers tab and click view settings on the three dots. There, you will be able to set a local Java path, under the Advanced tab.

On a server using a .bat file​

Open the server's settings, and click on the advanced tab, then click the pencil icon next to the bat file selector :

Edit bat

In you bat file, replace java by your full path to java.exe, in quotes (you can use the path picker to find it).

MCSS crashes when opening console or player manager (v13 and above).​

You get this error when opening the console, player manager or other text editor:

Exception Message: Could not load the Scintilla module at the path 'C:\Users\Desktop\AppData\Local\Temp\Scintilla.NET\5.1.5\x86\Scintilla.dll'.
Exception TargetSite: System.Windows.Forms.CreateParams get_CreateParams()
Exception StackTrace: 
   at ScintillaNET.Scintilla.get_CreateParams()
   at System.Windows.Forms.Control..ctor(Boolean autoInstallSyncContext)
   at System.Windows.Forms.Control..ctor()
   at ScintillaNET.Scintilla..ctor()
   at McssMain.Controls.ScintillaEditor.ScintillaControl..ctor()
   at McssMain.Controls.ScintillaEditor.BasicTextEditor..ctor()

This is because you are missing 2 dependencies.

  • Microsoft Visual C++ 2015-2019 Redistributable (x64)
  • Microsoft Visual C++ 2015-2019 Redistributable (x86)
ArchitectureLinkNotes
X86https://aka.ms/vs/17/release/vc_redist.x86.exePermalink for latest supported x86 version
X64https://aka.ms/vs/17/release/vc_redist.x64.exePermalink for latest supported x64 & ARM64 version

Or if you rather download it from the Microsoft website: https://docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist

While mcss is currently built against x86 it might change in the future. So it's recommended to install both. A lot of applications require this, at some point your computer will have this installed anyway.

Since v11.5.0 the process name requires a different format.​

Screenshot of the process name requires different format dialog

This change is required, click 'Yes' to apply the change.

Failed to set performance counters.​

Screenshot of failed to set performance counters dialog

Your performance counters are corrupt. MCSS can automatically do this for you. Click "Yes" to fix it.

In case you want to do this manually:

Open a command prompt with administrator rights and execute the following commands:

cd c:\windows\system32`
lodctr /R`
(if the lodctr command fails, simply run it again)

More info: Microsoft Support | How to manually rebuild Performance Counter Library values

I have this weird long IP address, is this normal?​

Yes that is completely normal, that is called an IPv6 address. Most people don't have access to IPv6 yet so it's smart to share your IPv4 address instead.

There are 2 versions of the IP protocol.

  • IPv4: 192.x.x.x
  • IPv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

More info about IPv6

IPv6 doesn't need port forwarding

IPv6 doesn't require port forwarding. With IPv4 you have a private and public IP. This is not the case with IPv6, because there are plenty of addresses to hand out. So each computer gets its own public address.

MCSS has crashed and I want to help fix it.​

To help fix it, you can upload your Windows event logs and MCSS logs. (please zip all the files and send them to me by email, SpigotMC or Discord)

To get the MCSS logs:

  • MCSS logs can be found in the MCSS folder under /logs

To get the Windows event logs:

  • Go to start and type eventvwr

You can follow the other steps on screenshot below.

Screenshot of the event viewer

The UTF-8 encoding doesn't work, I really really need it to work.​

The sad reality is that UTF-8 is a second-class citizen in Windows.

As of Windows 10 version 1903, you have the option to set the system locale (language for non-Unicode programs) to UTF-8, but the feature is in beta.

To activate it:

  • Run intl.cpl (which opens the regional settings in Control Panel)
  • Follow the instructions in the screen shot below.

Screenshot of the region settings window as part of the control panel

In some cases, the server needs to be started with additional parameters. E.g -Dfile.encoding=UTF-8, this varies from the server type used. More research is required on your end.

After setting this all up, this still doesn't guarantee that it will work. This just shows how bad the UTF-8 console support in Windows really is.

(sources)