Neotokyo Server Guide

Guide on setting up a Neotokyo dedicated server.

On Linux

There are no Linux binaries for Neotokyo currently. You can, however, run the dedicated server with Wine. Follow this guide for Linux instead:
http://steamcommunity.com/sharedfiles/filedetails/?id=282277252

On Windows

Server downloads are managed using a tool called SteamCMD. Direct download link: https://steamcdn-a.akamaihd.net/client/installer/steamcmd.zip

Extract the file to a location where you'd like to install the server. Then, run the SteamCMD app, and allow it through firewall, if so prompted.

Type in the following commands to SteamCMD:

force_install_dir .\neotokyo\
login anonymous
app_update 313600 validate
(wait, this will take a while. eventually you should be greeted with "Success! App '313600' fully installed")
quit

This will install the Neotokyo dedicated server (Steam AppId 313600) files.

Navigate to the "neotokyo" folder. It should look something like this:



Use the srcds.exe to launch your dedicated server. Make sure to allow it past your firewall/router!
If it does nothing, see the troubleshooting section below for a batch file that should fix it.

Recommended cvar values

You can set these in your NeotokyoSource\cfg\server.cfg file.

rcon_password - If you have no need for remote controlling the server, make sure this has no value (rcon_password ""). This will disable remote access to the server altogether. If you need it, make sure to pick a strong password.
neo_score_limit 7 - How many wins required per map. 7 is the standard.
neo_round_timelimit 2.76 - 2:45 minutes + 15 seconds freezetime.
The old standard was 3:00 minutes (value 3.26), but the 15 seconds smaller 2:45 has proven itself pretty good, gameplay-wise.
neo_ff_feedback 0 - Mirrored friendly fire damage, optional. Traditionally disabled.
neo_teamkill_punish 0 - Insta-ban temporarily for FF. Stops teamkilling efficiently, however this will also ban a lot of people accidentally firing their own team. If you're going to install server plugins and have active admins, it is recommended to disable this. However, if you can't invest a lot of time in managing your server, you might want to consider enabling it.

If you enable rcon (rcon_password), a few recommended additional cvars:
sv_logbans 1 - Log server bans in the server logs.
sv_rcon_maxfailures 3 - Max number of times a user can fail rcon before being banned
sv_rcon_minfailures 3 - Number of times a user can fail rcon in minfailuretime before being banned
sv_rcon_banpenalty 1440 - Number of minutes to ban users who fail rcon authentication
sv_rcon_minfailuretime 180 - Number of seconds to track failed rcon authentications

This will IP ban anyone trying incorrect rcon password more than 3 times for 24 hours.

Essential server plugins

You should use Metamod:Source[www.sourcemm.net] and SourceMod[www.sourcemod.net] for advanced server functionality.

If you need help setting up Metamod:Source or SourceMod, see the section below this one.

Here are some essential Neotokyo SourceMod plugins:

- No Block[forums.alliedmods.net] - made by sslice (fix player "collisions" occasionally glitching)
- Spawn Protection[github.com] - Made by Soft as HELL
- Restart Fix[forums.alliedmods.net] - made by Agiel
- Teamkill Penalty Fix[forums.alliedmods.net] - made by Agiel
- Kill Assists[forums.alliedmods.net] - made by Agiel
- Votescramble / balancer[github.com] - made by gH0sTy
- NEOTOKYO° Unlimited Squads[github.com] - made by Soft as HELL
- NT° Radio[github.com] - made by Soft as HELL

If the default SourceMod mapchooser doesn't auto-start voting properly:
- Here's a version modified for NT[pastebin.com]
You might be able to also get the newer versions working by adding "NEOTOKYO Modification" marked blocks of code, if you're feeling adventurous.
This may have been fixed in current SourceMod versions, please try the original SourceMod mapchooser before using this one.

If you are running HLStatsX:
- SuperLogs: NeoTokyo[forums.alliedmods.net] - made by psychonic (headshot logging)
- NEOTOKYO° Ghost capture event[github.com] - made by Soft as HELL (ghost capture logging)

For more various Neotokyo specific plugins, have a look at:
- Glub's plugins[github.com]
- Soft as HELL's plugins[github.com]

Here is a SourceMod online compiler for your use.[www.sourcemod.net] Just paste in the source code of a plugin to compile.

If your plugin has any 3rd party includes, you can either compile locally[wiki.alliedmods.net] or try this online compiler instead: https://spider.limetech.org/

Installing Metamod:Source and SourceMod

NOTE: The default metamod.vdf may not work, use the format below if that is the case!

Get MM:S from https://www.sourcemm.net/ (dev build of MM:S is recommended for Neotokyo)

Create an "addons" folder in NeotokyoSource, and paste the "metamod" folder there. Create a new file called metamod.vdf in the addons folder. Open it in a text editor and enter:

"Plugin"
{
"file" "../NeotokyoSource/addons/metamod/bin/server"
}

Restart the server. Command "meta" in the server console should now return Metamod:Source information. If you get an unknown command error, there's something wrong with the installation.

Get SourceMod from https://www.sourcemod.net/ (stable build is recommended)

Paste the contents in addons/sourcemod and cfg/sourcemod folder paths. Restart your server. Command "sm" in the server console should now return SourceMod information. If you get an unknown command error, there's something wrong with the installation. Please note that SourceMod depends on the Metamod installation, so you'll need to have a working Metamod before SourceMod can work.

If you need further help with Metamod:Source or SourceMod, see the AlliedModders Wiki[wiki.alliedmods.net].

Troubleshooting

I need help with port forwarding (Windows)!
Open up a command prompt (Windows key + R --> cmd). Type in "ipconfig" to the command prompt. Look for the "IPv4 address" entry. It usually starts 192... if you are behind a router. This is your internal network IP. You'll need to forward the game server's port (usually UDP 27015) to this internal IP. This way, incoming connections from the internet will get routed to your PC instead of stopping at your router. If you need to, look up a manual for your specific router brand on how port forwarding is done.

srcds.exe doesn't run!
Try creating a launcher.bat file in your srcds.exe folder. Open it in a text editor, and paste in the following:

srcds.exe -autoupdate -game NeotokyoSource -maxplayers 24 +sv_lan 0 +map nt_dawn_ctg

Launch from the launcher.bat. You can edit maxplayers (32 players max) and startup map to your liking.

"Your version does not match the servers..."
Check the NT Hub Announcements for any recent patch releases. You might have to update your server and/or game client, depending on the update. Server updating happens with SteamCMD.

login anonymous
force_install_dir .\neotokyo\
app_update 313600 validate
quit

The "force_install_dir" path should be the same you used while installing the server.

My server isn't in the serverlist!
Check the NT Hub Announcements for any recent patch releases. You might have to update your server and/or game client, depending on the update. Server updating happens with SteamCMD.

login anonymous
force_install_dir .\neotokyo\
app_update 313600 validate
quit

The "force_install_dir" path should be the same you used while installing the server.

Otherwise, make sure your cfg/server.cfg contains the following commands:

sv_master_legacy_mode 0
sv_lan 0
heartbeat

If that doesn't help either, and your network connection is behind a router, check the "I need help with port forwarding" section above.

Otherwise, confirm that your firewall accepts incoming connections to the game server's port (usually UDP 27015). For more info, see relevant sections in the "Required Ports for Steam" Steam support article.

Metamod:Source doesn't launch!
The default metamod.vdf may not work. Use the format described in the installation section above if this is the case.

The SourceMod map vote plugin doesn't work!
First, make sure your SourceMod, and its included "mapchooser" plugin are up to date. If that doesn't help, see the alternative mapchooser in "Essential Plugins" section above.

How do I auto-restart the server on crash (Windows)?
Create a new autorestart.bat file with the following code: https://pastebin.com/uiXybQvs
Launch from the autorestart.bat file.

I need feature X for my server!
Install Metamod:Source and SourceMod (section above), and you'll be able to expand your server's functionality a lot. You can find many server plugins here[www.sourcemod.net]. Always test to make sure the plugin works and supports NT!

I want SourceMod command X to be public / admin only!
This can be achieved with overrides[wiki.alliedmods.net].

Something else!
Ask below!

[cheezopath]

i discovered that the MM:S issue goes away if you use the launcher.bat approach

[niar]

Also, if someone's experiencing the MM:S issues discussed earlier, it's worth trying the latest branch (currently 1.11), which saw some ep1 engine api changes.

[niar]

Not sure on hardware side, but any somewhat modern CPU with decent single core performance should do. Bandwidth should be able to handle (sv_maxrate bytes/s * maxplayers) with some overhead, so probably a minimum of around 10 MB/s download/upload speed for "sv_maxrate 300000" and 32 maxplayers, or half of that for 16 maxplayers, would be my guess.

[Dennogin]

What are the minimum/recommended specs for a server?

[niar]

No clue then, sorry. You'll probably be fine without the plugins anyways for a private server.

[Sleesh]

welp i went ahead and tried that and about 10 other dev and stable builds that were available for windows, all getting the same result of crashing as soon as i hit start. i looked at several log files to see if that would give me anything but i think it crashes so fast after i hit start. its really almost immediate. the only logs that show up are when i took out the vdf files and just ran the server normally.

[niar]

Alright, np. If you wanna debug further down the rabbit hole:

From the way it's crashing, I'd guess the version of Metamod isn't supported. Iirc you have to use the dev branch instead of the stable one for some compatibility reasons I'm forgetting: http://www.sourcemm.net/downloads.php?branch=dev (Currently build 1116 in the list is the latest with a compiled Windows build, click the green Windows flag or use this direct link: https://mms.alliedmods.net/mmsdrop/1.11/mmsource-1.11.0-git1116-windows.zip ).

[Sleesh]

I've made sure all that other stuff isn't whats causing it. as far as the extensions and folder placement and such. so with the default vdf text line, the command prompt responds with an unknown command when i type "meta"

when i switch to the recommended vdf text that you pasted to copy into the vdf file. the server crashes on startup, so i cant exactly check the server console haha.

anyway its not a huge deal. i probably dont need plugins anyway since this is mostly for friends, and it works fine without them.

[niar]

The metamod.vdf should exist in NeotokyoSource/addons. Make sure it's not in NeotokyoSource/addons/metamod, or some other folder.

[niar]

What does the srcds.exe command line return when you send a "meta version" command?
Unknown command "meta"? Something else?

What is the path where your metamod.vdf file is? Also make sure it isn't called metamod.vdf.txt or anything like that, if you have file extensions hidden in Windows.

You could also post your metamod.vdf contents as a https://pastebin.com/ link for me to look at, if those didn't fix it