Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Most Starbound dedicated-server failures have four practical causes: the game port is unreachable, the server and clients have different mods, incompatible patches prevent startup, or a world file is damaged. Start by checking the server console and logs, then work through ports, mod parity, startup errors and backups in that order. The default game port reported by the Starbounder wiki is 21025/TCP; your generated configuration is the authority if it uses a different value.

Start with a quick symptom check

Record the exact error text before changing anything. A message such as NetworkException points to reachability or compatibility; JsonPatchException and “Could not apply patch” point to startup-time mod conflicts; a server that runs but never appears in the browser usually has an initialization or filtering problem. Stop the server before editing files, and make a copy of the entire storage directory before changing mods, worlds or configuration.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
What you see Most likely area First action
NetworkException or players cannot connect Port forwarding, firewall, address or mod mismatch Confirm the server is fully started, then check port 21025/TCP and the shared mod set.
Server is absent from the browser Initialization did not finish or a browser filter hides it Read the console/log for startup completion and clear restrictive browser filters.
JsonPatchException during startup Conflicting or outdated object patch Use the file path in the error to identify and update or remove the responsible mod.
A single planet or world will not load Corrupted coordinate file Restore that world from backup rather than deleting the whole universe.
A mod appears installed but has no effect Incorrect file placement or a disabled/incompatible mod Put the .pak directly in the server’s mods/ directory and restart.

Fixing NetworkException and failed connections

A NetworkException means the client could not establish a usable connection. An Appuals troubleshooting guide identifies unforwarded game ports as a common cause. The same symptom can also be produced by a firewall, an incorrect address, or different mod sets, so test each layer rather than repeatedly launching the game.

Verify the server and address first

  1. Launch the dedicated server and wait until its console has completed initialization. A process that is still loading, has stopped on an error, or has closed cannot accept players.
  2. Use the address that is reachable from the players’ network. For an internet connection this is normally the host’s public address; for a local connection use the host’s LAN address. Do not give players an address that exists only inside the host’s router.
  3. Have the player try again after the server is fully running. If one player connects while another cannot, compare the failing player’s network and mod set instead of changing the server files immediately.

Forward the game port

The Starbounder wiki reports 21025/TCP as the default game port and says to allow it through both the router and the host firewall. It separately lists 21025/UDP for the Steam query system and 21026 for RCON. Those protocol and port assignments are reported by the wiki and are not verified here against the game binary; follow the keys and values in your generated configuration if they differ.

#1 Best Overall
Sale
Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear Adjustable Blower with LED Light,Dust Remover for Computer/House/Outdoor/Car
  • Powerful Turbo Fan:CAGIWIRU Electric Air Duster have reached speed up to 130000RPM,Can efficient remove dust and debris.With LED light and Three Adjustable Speed to meet with different cleaning tasks.
  • With Attached USB C Fasting Charging cable.Charing 3 hours,Enjoy up to 240 minutes of use on the lowest setting, For third speed can use for 25mins.with four charging options to meet with your needs.
  • Wide Application:Upgraded attached 5 different nozzles,making it suitable for a variety of scenes, such as car,pet, pc, keyboards, and other electronic devices. It also serves for office and home clean duster.
  • Handy Design & Portable:Cordless air duster electric nozzle is Light weight and small size, design and comfortable to hold and space saving, convenient to carry around. You can put it in your room or inside the car without taking up space.
  • Warranty & Support: Our Electric air duster comes with 5 years warranty and 24/7 customer service. During this period, if you have any questions,pls kindly feel free to contact us.
Service Reported default What to do
Game connections 21025/TCP Forward the port to the server computer and allow it in the host firewall.
Steam query 21025/UDP Allow/forward it only if your browser or management tool needs query responses; the wiki lists this assignment.
RCON 21026 Forward and secure it only when you intentionally use remote console administration.

Router interfaces differ, but the required information is consistent:

  1. Give the server computer a stable LAN address, either with a DHCP reservation or a static address.
  2. Create a port-forwarding rule for the configured game port, selecting the server computer as the destination. Select TCP for the game rule; add the reported query or RCON rules only when those services are enabled.
  3. Save or apply the router rule, then create a matching inbound firewall exception for the Starbound server executable or the same port.
  4. Restart the server and test from a network outside the host’s LAN. Testing only from inside the same router can produce misleading results because some routers do not support hairpin connections.

Try UPnP, then treat workarounds as temporary

If your router supports UPnP, enabling it can let Starbound request the forwarding rule automatically. UPnP is router-dependent and may be disabled by network policy; if it does not create a rule, use manual forwarding. A VPN tunneling tool such as Hamachi has been reported as a workaround for some ISP-level IPv4 restrictions. It changes how players reach the host; it does not repair a missing forward or a blocked firewall rule, so use it only when normal IPv4 connectivity is the limiting factor.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Whitelist both Starbound and the launcher used to start it in the host firewall. Security software can permit the launcher while silently blocking the dedicated-server process, so check the executable that actually listens on the port. If your ISP uses carrier-grade NAT or otherwise does not provide an inbound IPv4 address, router forwarding may never be reachable from the public internet; a tunnel or a host with inbound connectivity is then required.

When the server does not appear in the browser

Browser visibility is not proof that the game port is open. Reports collected for Starbound indicate that a server may be omitted when initialization has not completed, or when browser filters exclude it.

Rank #2
EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled | Computer Screen Cleaner Spray and Wipe Microfiber Cloth - TV, Monitor, Laptop, iPad, Car - 6.7oz 1 Pack
  • Screen Cleaner is Your Screen’s New Bestfriend! - EVEO is proud to present a screen cleaner that’s perfectly suited for your TV. Meet your new screen cleaner, computer screen cleaner, laptop cleaner, iPad cleaner, Macbook,tv cleaner or any other electronic device. Our screen cleaner spray and wipe along with the included plush microfiber cloth, easily removes dust, fingerprints & other smudges on the screen’s surface. Clean effectively for a streak-free screen
  • Gentle on your Screens - Our screen cleaner spray and wipes is compatible to be used even for the most sensitive LCD, LED, CRT, and OLED screens in proper use. Be at ease knowing that this product is compatible with all the major brands: LG, SONY, Samsung, Sharp, iPad, iPhone, Android screens, Kindle, PC monitors - we’ve got you covered! Can be used as LCD screen cleaner, tv cleaner, smart tv screen cleaner, and more
  • Premium Super Soft Plush Microfiber Cloth - Included in this efficient screen cleaning kit. This screen cleaner spray and wipe has our signature plush microfiber cloth specially designed to comply with screens and monitors and leave them streak-free. Has been shown to effectively absorbs stubborn stains, zero streaks, and no fiber shedding. Always use this together with our screen cleaner for the best results
  • Easy-to-Use Screen Cleaner Kit + microfiber cleaning cloth - The EVEO Screen Cleaning Kit will easily be your new favorite tool when it comes to taking care of the things you love most, quick and easy solution for a streak-free screen. Simply screw on the sprayer gun on the screen cleaner bottle. Spray the cleaning liquid onto the microfiber cloth, then wipe the screen until desired cleanliness & shine is achieved.
  • Quality Screen Care Kit Worth Purchasing - Enjoy a convenient Screen Cleaner anytime, anywhere you need it. Your satisfaction is our top priority. We stand behind the quality of our products and that’s why, you shouldn’t be worrying at all. We manufacture the Best Screen Cleaner. and can be used for laptop cleaning kit, laptop screen cleaner, tv screen cleaner for smart tv. MacBook screen cleaner, monitor cleaner or screen cleaner spray for electronic devices with microfiber cleaning cloth

Check initialization and logs

  1. Start the server without launching clients and watch the console until it reaches its normal ready state. A patch error, missing asset or crash must be fixed before discovery can work.
  2. Read the server log around the time it should register. Look for bind failures, configuration parse errors and mod-loading errors rather than only the final “not visible” symptom.
  3. In the client browser, clear filters for version, password, region, player count and favorites. Filters vary by client build, and a valid server can be hidden by a stale filter.
  4. Use a direct connection as a diagnostic if you know the reachable address and port. If direct connection also fails, return to forwarding, firewall and mod checks; if it works, the remaining problem is discovery or query configuration.

The query-port details published for Starbound are inconsistent across hosting guides. Do not add arbitrary query settings merely because a guide uses a different name; first confirm which key your generated configuration accepts.

Resolve mod and version mismatches

A server can start normally yet reject a player when the two sides do not have the same content. Community reports describe a mod present on one side but not the other as one of the most common connection causes. Game updates, framework changes and third-party server tools can also leave an older server incompatible with current clients; a Game Server Kings maintenance guide was reported updated July 31, 2026.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Build one authoritative mod set

  1. Create one shared Steam Workshop collection containing every mod intended for the server.
  2. Have the server administrator and every player subscribe to that same collection. Remove obsolete duplicates and make sure each side is running the same mod version.
  3. Compare the enabled lists, not just the download lists. A subscribed mod that is disabled, loaded twice, or installed only on the client still produces a mismatch.
  4. Restart the dedicated server after changing the set, then restart clients before testing again. Cached assets can make a correct change appear ineffective until both processes reload.
  5. Keep the game, server files and framework dependencies updated together. If an update introduces a failure, record the previous versions and restore the last known-compatible set rather than mixing old and new components.

Some guides suggest setting checkAssetsDigest=false. That suppresses the asset-digest check and can hide the immediate mismatch message, but it does not make different content safe. Treat it as a diagnostic or emergency compatibility measure; matching the mod set is the durable fix.

Fix JsonPatchException and startup crashes

A dedicated server can fail with JsonPatchException even when single-player appears to work, particularly with a large mod list. The specific path in the error is more useful than the exception name. For example, “Could not apply patch from file /objects/outpost/shipyardwelding/shipyardwelding.object.patch in source” indicates that a mod patch targeting that object conflicts with the current asset or with another patch.

Rank #3
BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black
  • 【Large size】:Measuring 800 x 300 mm/ 31. 5×12 inches, which is wider and taller than others. Large mouse pad can perfectly fit your keyboard and mouse of any size, and there is also ample space for peripherals such as phones, tablets, etc.
  • 【LED backlight mouse pad】:Blade Hawks RGB mouse pad provides 7 static modes and 7 dynamic modes will give you the options you are looking for. Power-off memory function remembers the last lighting mode you selected. The super glow fiber Chroma will give you a colorful gaming setup that you want.
  • 【Anti-slip rubber base】:Made from Natural rubber, this gaming mousepad will firmly grip your desktop, allowing you to enjoy the ultimate precision in the games you are most passionate about. It also comes with a texture that enhances this ability even further.
  • 【Smooth and waterproof surface】: Micro-textured cloth surface, for extremely precise mouse control and a smooth movement. When liquid splashes on the gaming mouse pad, it forms water droplets and slides down. Will not delay your work or gameplay.
  • 【Plug and play】: This mouse and keyboard pad is powered by USB, plug and play, no driver required. One button control light modes. Press one time to change the lighting mode, press twice to change the brightness, press and hold about 3 seconds turn ON/OFF.

Use the path to isolate the conflict

  1. Stop the server and copy storage and the active mods directory to a backup location.
  2. Write down the complete patch path and the mod that supplies it. If the path does not identify a mod directly, inspect each mod package’s contents rather than deleting random files.
  3. Update the named mod and any dependency it requires. If no compatible update exists, remove that mod temporarily and start the server.
  4. If the server starts after removal, add other mods back in controlled groups, restarting between groups. This identifies a second patch that collides with the first without risking the live universe.
  5. Once the conflicting combination is known, keep only a compatible version set or replace the feature. Do not leave a failing patch enabled and attempt to repair the world files; the server must start cleanly before world recovery is meaningful.

Do not assume that a successful single-player launch validates a dedicated-server mod list. The dedicated server loads its own assets and patch order, so both environments must be tested with the same versions.

Repair mods that are not loading

A reported installation rule is that .pak files must be placed directly inside the server’s mods/ directory, not inside another folder. This location claim comes from secondary search material and should be checked against your installation, but it is a low-cost first test.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Stop the server.
  2. Open the server’s actual mods/ directory, not a client-only mods folder.
  3. Move each intended package so the .pak file is directly in that directory. Remove accidental nested folders and duplicate copies.
  4. Confirm the file extension has not been changed by an archive utility, then start the server and inspect the console for load errors.
  5. Verify a client has the same package and version before attempting to connect.

If the package loads but causes a patch exception, return to the conflict procedure above; placement and compatibility are separate problems.

Recover a corrupted universe, world or player

A crash while the game is writing can damage one world without destroying every save. Deleting the entire universe is therefore an unnecessarily destructive first response.

Rank #4
Sale
Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam Arm Cushion for Desk, Palm Hand Office Laptop Typing
  • 【Softer and More Comfortable】Vaydeer wrist rest has unique diamond pattern, which is the combination of softness and aesthetics. The materials of wrist rest are improved into higher quality memory foam and covered with silky smooth lycra. The computer wrist rest makes you as comfortable and cushiony as like rest your wrists on clouds.
  • 【Ergonomic Wrist Saver】The wrist rests for keyboard and mouse comes with a 17.32×3.15×0.83 inch keyboard wrist pad and a 5.94×3.15×0.83 inch mouse wrist support. Based on ergonomic design, the unique concave shape is the perfect fit for your wrist joints. The wrist rest pad fits most computer keyboards and laptops, improve hand and wrist posture, release your wrist and arm stress.
  • 【Non-Slip Rubber Bottom】Featuring an anti-skid silicone base on the bottom, this wrist keyboard support stays firmly in place on your desk, preventing the padding from sliding around, ensuring stable and consistent wrist support during extended computer sessions.
  • 【Better Experience & Pain Relief】Our keyboard arm rest is beneficial to alleviate the soreness caused by direct contact and friction between your arm and a hard desk surface, reducing the risk of wrist fatigue or carpal tunnel. The soft texture of memory foam can evenly distribute the pressure around your wrists and provide good support with just enough give.
  • 【Helpful in Multiple Scenarios】Whether you're working, studying, writing, typing, gaming, this keyboard and mouse rest combo is an essential accessory to add comfort and support to your hands and wrists. It’s also a great gift for men, women, family, friend, coworker, gamer, teacher, etc.

Back up before touching save files

Stop the server, copy the complete storage/ directory, and label the copy with the date and the mod set. A backup made after the corruption is detected may already contain the damaged file, so routine snapshots are more useful than a one-time copy. A Game Server Kings guide recommends daily snapshots through a Backups tab, but that hosting-specific procedure is not independently verified; use whatever scheduled or manual method your host supports.

Understand the reported paths

Secondary search summaries report that saves are under storage/, worlds under storage/universe/ with coordinate-based filenames, and player characters under storage/player/<PlayerName>.player. These paths are not confirmed against every installation, so locate the generated directories on your server before deleting anything.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Reset one world, not the universe

  1. Identify the coordinate file corresponding to the planet or world that fails while other worlds remain accessible.
  2. Move that single coordinate file into a dated quarantine folder rather than permanently deleting it.
  3. Start the server and test the affected coordinate. The game can regenerate the world, but its previous construction will be gone unless you restore the original file.
  4. If regeneration does not help, stop the server and restore the quarantined file or a known-good backup, then investigate mods and recent crashes.

Never remove the entire universe folder to solve a single-world failure. If only one character fails to load, treat the corresponding player file as the affected scope and restore that file from backup instead of altering every world.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Find and edit starbound_server.config safely

A Steam Game Server Manager guide reports that starbound_server.config is in the server’s storage subfolder and is generated after the dedicated server has been run at least once. If you cannot find it, launch the server once, let it create its files, stop it cleanly, and search the resulting storage directory.

Best Value
Sale
Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount, 2 Hole Cable Tray with Wire Management and Cord Organizer for Home Office Standing Desk
  • 【No Drill Mounted】Cable management tray can be assembled in as little as 3 minutes or less-simply. Side clips easily clampe the edge of desk, pass through the holes on the sides, and secure excess cables with baskets. Desk cable management supports inward or outward installation to meet your needs in different scenarios, and provides you with great convenience when collecting and organizing wires.
  • 【Rubber Pad Protects Desk】Wire organizer under desk built-in soft rubber pads on the clamp protect your desk from scratches, so you will not damage your furniture or office.
  • 【Sturdy and Beautiful】Cord management under desk is made of high-quality carbon steel and holds about 15 lbs. The wire basket has 2 holes on each side of the tray to enable your cables to pass freely. Cable baskets are suitable for desk thickness use from 0.4" to 2.4".
  • 【Space Saving & Keep Organized】Desk cable management tray holds all your power cords, outlet strips, USB hubs and computer transformers hidden from your feet, and the data cables will not enter the vacuum cleaner to keep your desk clean and tidy. Desk wire organizer is also suitable for use in the kitchen and outdoors.
  • 【Reduce Safety Risks】Cable tray under desk keeps all plugs away from your kids, no more worry about tripping. Using 2 holes wire tray saves extra space, helps you easily cabling and wire protection. The mesh design is not easy to accumulate dust, but avoids safety accidents caused by messy wires.

Configuration keys vary across guides, and no official key reference was identified. Use the file generated by your own server version as the baseline: preserve its spelling, capitalization and JSON structure, and restart the server after every change.

Setting Evidence about the value Safe handling
maxPlayers The Starbounder wiki reports a default of 8 simultaneous sessions. Change it only after considering available RAM and testing under load; the claim that there is no hard upper limit comes from an unverified hosting guide.
serverName A search summary reports the default as “A Starbound Server.”; attribution is unconfirmed. Use the key already present in your generated file and choose a name that helps players identify the server.
Query enable flag One guide uses runQueryServer; another uses queryServerEnabled. The names conflict. Check which key your server version reads instead of copying both; enable the query service only when needed.
upnpPortForwarding A 2016-era forum workaround says to set it to false for an old error. Treat this as an old, unverified workaround. Do not change it unless the generated file contains the key and current testing shows UPnP is causing the failure.

Keep JSON syntax valid: quote string values, retain commas between properties, and avoid comments inside the file. Make one change at a time so a new parse error can be attributed to the last edit. If the server stops reading the file, restore the backup and regenerate a clean copy rather than guessing key names from a different guide.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A maintenance routine that prevents repeat failures

  • Keep a dated backup of storage/ before major mod changes, game updates and configuration edits.
  • Maintain one shared Workshop collection and record the collection’s mod versions for every player.
  • Document the configured game, query and RCON ports, the server’s LAN address and the firewall rules that match them.
  • After an update, start the server alone and read the full console before allowing players to join.
  • When a failure appears, preserve the log and exact error path. A patch filename or coordinate is often the shortest route to the correct fix.
  • Restore the smallest affected scope: one mod for a patch conflict, one world file for world corruption, or one player file for a character problem.

This approach separates network reachability, content compatibility, startup patching and save recovery. Changing all four at once destroys the evidence needed to identify the cause and increases the chance of losing a working world.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.