Running servers

Performance

Each server’s Performance panel shows CPU, memory, tick health (TPS and milliseconds per tick), players, disk activity and storage.

• 1 hour is live: one sample a second while the server runs. Players cover the last hour; the other graphs show the last 5 minutes.
• 24 hours, 7 days and 30 days show history. The panel keeps a summary of every minute for three days and of every hour for about a month, for servers on every machine. Gaps are when the server wasn’t running. The minute in progress shows up once it ends.

History lives in the panel’s database, so it survives restarts and updates of both the panel and the servers.

Paused servers

Minecraft 1.21.2 and later pause the world when nobody has been online for a while (pause-when-empty-seconds, Pause when empty in the game settings; 60 seconds by default). The server keeps running but stops ticking, and NetherNode shows it as Paused rather than Running. It resumes as soon as someone joins.

This is separate from NetherNode’s own Sleep when empty, which stops the server entirely and wakes it when a player connects.

Console

• Search (or Ctrl/⌘ F) finds text in the console’s output. Older logs searches the logs Minecraft saved from this and earlier runs (logs/latest.log and the dated .log.gz files), newest first. With an empty search, or Chat only ticked, it lists chat.
• Completion: as you type a command, suggestions appear for command names, players (online ones first, then everyone seen on the server, and @a/@p-style selectors once you type @), and fixed words such as game modes. Use ↑ ↓ to choose, Tab to complete, Esc to hide them. Without suggestions, ↑ ↓ go through the commands you sent before.

Players

A server’s Players tab lists everyone who has joined it through NetherNode or is on one of its lists. Search by name or UUID, and filter to Online, Operators, Allowlisted or Banned. Everyone can see the list; moderators and up can change things, and only administrators and owners see players’ full IP addresses.

• Select players to kick, allowlist or ban several at once.
• Ban has a reason (shown to the player), a length (permanent, an hour up to 30 days, or your own; NetherNode lifts it when it ends), Also block their IP address, and, for administrators, Ban on every server. IP bans are enforced by the proxy, since servers behind it only see the proxy’s address.
• Allowlist turns Only allow listed players on or off, and adds, imports (up to 500 names) or exports the list. Turning it on doesn’t kick players already online unless Enforce allowlist is on in the game settings.
• To ban or allowlist someone who has never joined, type their exact name. NetherNode looks it up with Mojang (or, on an offline-mode server, works out the offline UUID).

Click a player to open their card: kick, ban, allowlist, make them an operator (level 1–4), and, while they’re online, set their game mode, teleport them, or give them items. Its tabs:

• Overview: first and last seen, time played, last IP address, and any ban.
• Inventory: see Player inventories below.
• Stats: the game’s own statistics, such as deaths, mobs killed and distance walked.
• Sessions: their last 50 visits, with times and addresses.
• Notes: notes for panel users only, shared across all servers.

Bans, operators and the allowlist can be changed while the server is stopped; they apply when it starts. Kicking, game modes, teleporting and giving need it running. On Minecraft 1.21.9 and later NetherNode uses the game’s management protocol for these, and RCON on older or modded servers.

The Players page in the sidebar lists everyone across all your servers. Administrators can ban (or unban) players everywhere from there; everything else is done from a server’s own Players tab.

Player inventories

A player’s Inventory tab shows their health, food, level, position, armor, inventory and ender chest. For a player who is online, it’s read from the running server every couple of seconds over RCON; otherwise it’s the server’s last save (when they left, or the last autosave).

Paper prints only the first few parts of a long value in command output, so on Paper servers NetherNode reads a player’s data piece by piece instead: each stat, then each stack, then the details of enchanted or renamed items. This takes up to 160 short commands per refresh, each well under a millisecond on the server. If something can’t be read in full (an item with more enchantments or other details than Paper will print at once, or more than 160 commands’ worth), the tab says the live view is incomplete and some items or enchantments may be missing; the player’s saved file always has them all. Vanilla, Fabric and Forge servers are read with a single command.

Mods

Fabric, Quilt, Forge, NeoForge and modpack servers have a Mods tab (administrators and owners). It lists the .jar files in the server’s mods folder with their names and versions. Paper and Purpur servers run plugins instead: put them in the plugins folder from the Files tab.

• Add mods searches Modrinth or CurseForge for mods that suit the server’s Minecraft version and loader, and installs the newest release. From Modrinth, the mods it requires come along. Some CurseForge authors don’t allow other apps to download their mods; download those yourself and upload them.
• Upload adds .jar files, or drop them on the tab. A file with the same name is replaced.
• The switch on each mod turns it off or on (it renames the file to .jar.disabled and back). The bin moves it to the trash.
• Check for updates asks Modrinth about every mod it knows (stable mods are only offered stable versions); Update swaps in the new file and moves the old one to the trash.
• A Client only badge marks a mod meant for players’ games, not servers. It’s only a warning; turn the mod off if the server won’t start.

Changes take effect the next time the server starts.

CurseForge needs an API key: get a free one at console.curseforge.com and add it in Settings › Mods and modpacks. It’s stored encrypted.

Modpack updates

A server installed from a Modrinth or CurseForge modpack shows its pack at the top of the Mods tab (admins), with any newer versions of the pack and a link to each one’s changelog. Check for updates looks again. The bell also says when there’s a newer version (see Notifications).

Update to a version:

1. stops the server if it’s running (players are disconnected);
2. makes a backup labelled with both versions;
3. pins the new version, along with its Minecraft version;
4. starts the server again if it was running. The pack installs as the server starts: its mods and files are replaced, and files the old version installed but the new one doesn’t are removed. Mods you added yourself stay.

If the server can’t be stopped, or the backup or the version change fails, nothing is changed and the server is started again (if it was running) on the version it had. A failed update shows under the bell for a day, and in Discord if you’ve turned on modpack updates there.

The pack’s own config files are written over with the new version’s, so changes you made to those are undone; the backup has them.

Only newer versions can be installed, and not ones for an older Minecraft version, since worlds can’t go back. To go back to the old version, restore the backup from before the update: every backup of a modpack server remembers its pack version, and restoring it puts that version back.

CurseForge packs need the CurseForge API key (Settings) to look up versions.

Files

The Files tab (administrators and owners) shows the server’s folder. New makes a folder or text file, Upload (or dropping files on the tab) adds files to the folder you’re in, and each item’s menu (or a right-click) has Open, Download, Rename…, Copy to…, Move to…, Compress…, Extract… and Delete. Select several to compress, move or delete them together.

• Editor: text files up to 5 MB open in an editor with highlighting for JSON, YAML, TOML and .properties. Ctrl/⌘ S saves. If the file changed on disk since you opened it, you choose whether to reload or overwrite. Files the server keeps in memory (ops.json, whitelist.json, the ban lists) show a warning while it runs: use the Players tab, or stop the server first.
• Uploads of any size (up to 50 GB per file by default) are sent in pieces and resume if the connection drops; choose the same file again to continue. If a name is taken you can replace it, keep both, or skip it, and a .zip can be extracted once it’s up. Folders can’t be dropped; upload them as a .zip.
• Extract opens .zip files, into a folder you choose. It refuses archives that try to write outside the server’s folder and stops ones that unpack to more than 32 GB. Unless you tick Replace files that already exist, nothing is extracted if any file is already there.
• Compress makes a .zip. Download works for single files; to download a folder, compress it first. Downloads resume if interrupted.
• Delete moves things to the Trash (the bin button in the toolbar), where they can be restored for 30 days. Files replaced by an upload don’t go to the trash. Backups leave the trash out.

Copying, moving and extracting never overwrite files unless you ask, and nothing can reach outside the server’s folder, including through links.

Copies and templates

On a server’s Configuration tab (admins):

• Make a copy creates a separate server from this one, on any machine, with its own name and ports. Its files, mods and settings are copied, and its world too unless you untick Copy the world too. The copy starts out stopped and without an address: give it one on Proxy & routes (a *.example.com route that picks the server by subdomain covers it already). Schedules, routes, backups and modules stay with the original. A running server can be copied; its world is saved first and players stay connected.
• Save as template keeps the server’s software, mods, plugins, configuration and settings, without the world. Templates appear under Create server; pick one, name the new server and choose its machine. Like a copy, it starts without an address. Templates are stored next to the panel’s backups (<data>/backups/template-*.tar.zst).

Downloaded files

Settings › Storage shows what the panel keeps of its downloads: Minecraft game files and copies of mod files (for item pictures in inventories), mod and modpack icons, and player faces. Game files and mod copies unused for two weeks are removed automatically (game files stay while a server runs that Minecraft version), and icons and faces after a month. Clear now removes it all; it’s downloaded again when needed.