Add and Configure Your Server

Go to Dashboard > Add Server while logged in. The wizard walks through server basics, connection setup, community details, and review.

• Non-admin users can list up to 4 servers per account.
• Game selection controls whether the connection step asks for address/port or a direct URL.
• For queryable games, a recent successful connection test may be required before a new listing can be submitted.
• Current valid submissions are saved as public, active listings. Admin moderation tools exist separately, but the add-server flow is not presented as a pending approval queue.
• Server names create public URLs and are locked after creation in the edit form.

These limits come from the current add-server form and submission validation.

Field	Current rule
Server community name	Required, at most 150 characters. It must generate a valid URL slug and cannot use reserved URLs.
Game	Required. The selected game must be active in ServerTilt.
Versions	Select at least 1 and at most 5 valid versions for the selected game.
Server types	Select at least 1 and at most 5 valid server types for the selected game.
Queryable connection	Hostname/address is required, at most 255 characters, lowercase letters/numbers/dots/hyphens only. Port must be 1-65535.
Direct URL connection	Server / Community Link is required for direct URL games, must be http or https, and must match game-specific rules where configured.
Community description	Required, 150-1500 characters.
Full description	Optional, at most 5000 characters.
Country	Required, stored as a valid two-letter country code.
Vote reward mode	Required selection from the currently supported reward mode list.

Queryable servers

Queryable games use an address/IP and port. ServerTilt attempts to query the server, and live status, player counts, uptime, and charts depend on the server responding to external query requests.

A recent successful connection test may be required before a new queryable listing can be submitted. Duplicate hostname and port combinations are blocked for queryable games.

Direct URL games

Direct URL games are used when ServerTilt should link to a public game or community URL instead of querying a server address and port.

• Discord: Accepted URLs: discord.gg, discord.com and subdomains.
• Runescape: Any public http or https URL is accepted for this direct URL game.
• Roblox: Accepted URLs: roblox.com and subdomains; paths starting with /games/.

Direct URL listings may not show live ServerTilt player counts.

For queryable games, use the wizard's Test Server Connection button before submitting. A failed test usually means ServerTilt cannot reach or query the server from outside your network.

• Confirm the address and port are correct. Some games use a separate query port.
• Make sure the server is online and visible publicly.
• Enable the game's query/status feature if your server software requires it.
• Check firewalls, host panels, DDoS protection, and NAT rules that may block external checks.
• Do not use private or local-only hosts such as internal LAN addresses.
• If the wizard asks for a direct URL, do not try to force IP/port setup for that game.

Each public server page has a vote page where players can support the server. Current voting checks use a daily vote window per server, with cooldown checks for signed-in users, browser fingerprint, and IP address.

Vote history and reward delivery depend on the server's selected reward mode. ServerTilt can record votes even when a server has no external reward integration.

Manual reward identity values, such as player usernames or custom reward keys, are limited to 25 characters on the vote page.

The add-server form currently exposes these reward modes:

• none: None (disabled)
• votifier_username: Minecraft / Username (Votifier)
• steam_identity: Steam (linked identity)
• discord_identity: Discord (linked identity)
• postback: Postback / Custom callback

No reward integration

Votes are still recorded on ServerTilt, but no Votifier or postback delivery is configured.

Votifier username

Players enter an in-game username or reward key on the vote page. This mode requires Votifier host, port, and public key details in the server form.

Postback

Players enter a username or reward key, and ServerTilt can call your configured callback URL after a vote. Your system is responsible for validating the callback and granting any external reward.

Steam and Discord identity

Steam and Discord identity modes are present in the current form and vote page flow. Treat them as linked-identity vote modes, not as generic plugin claim modes. The public vote check/claim API currently returns recent votes only for manual identity modes such as Votifier username and postback.

Votifier is for Minecraft-style vote rewards where supported. If you choose Minecraft / Username (Votifier), the server form requires:

• Votifier host, at most 255 characters.
• Votifier port, 1-65535.
• Votifier public key, at most 4096 characters.
• An optional postback URL if you also use a callback.

Use the Votifier test in the dashboard before relying on live vote delivery. The focused setup guide is at /help/votifier.

Postback mode requires a public http or https callback URL. ServerTilt validates the target and sends the submitted reward identity to your callback when delivery is attempted.

GET https://yourdomain.example/callback?username=PlayerOne&userip=203.0.113.10

Your system should validate the request, record the vote, and decide whether to grant an external reward. Advanced reward integrations may require a server vote API key. If you do not see this option in your dashboard, use Votifier or contact ServerTilt support.

The wizard accepts optional banner and icon uploads. Current media rules are:

Media	Formats	Size and dimensions
Banner	JPG, JPEG, PNG, GIF, WEBP, MP4, WEBM	Max 12 MB. Required dimensions 468x60. Animated banners are limited to 25 seconds and 30 FPS.
Icon	JPG, JPEG, PNG, GIF, WEBP	Max 2 MB. Input image can be up to 4096x4096 and is output at 256x256.

Live player counts and online status depend on the selected game's query support and whether your server responds to external checks. If the query fails, status and player-count displays can be missing or stale.

Direct URL listings may not show live ServerTilt player counts because they do not provide a query address and port.

Charts and stats need time and successful query data before they look complete. New listings may start with limited history.

My server connection test failed

Check the host, port, query setting, firewall, and whether the server is publicly reachable. Use the query port when your game separates game traffic from query traffic.

My server is a direct URL game

Use the Server / Community Link field. Do not enter a private invite or an internal URL. Discord and Roblox links must match their configured domain/path rules.

My banner will not upload

Use one of the allowed formats, stay under 12 MB, and make the banner exactly 468x60.

My player count is missing

Player counts require successful query support. Direct URL games and servers blocking external query checks may not show live counts.

My vote rewards are not working

Confirm the reward mode, Votifier or postback settings, and any required username/reward key entry on the vote page. Use the dashboard tests where available.

I cannot add more servers

Non-admin accounts are limited to 4 listed servers.

I cannot find my old server page

Check your dashboard for the current listing. Removed or archived servers may not be available as public vote pages.

/api/v1 exists for advanced integrations. In the current API surface, vote check and claim endpoints may be used by supported manual reward flows.

GET /api/v1/votes/check?key=SERVER_API_KEY&username=PlayerOne
GET /api/v1/votes/claim?key=SERVER_API_KEY&username=PlayerOne

Some endpoints under /api/v1 are internal or provider-facing, including billing and mail webhooks. The /api/v1/servers endpoints currently return unavailable responses rather than a public server directory API.

A fuller endpoint reference should be maintained separately from this setup guide.

Do I need an account to add a server?

Yes. You need a free account to add and manage server listings.

Why is my player count not showing?

Live player counts require a successful server query. Direct URL games and blocked query ports may not show live counts.

Why does my game use a URL instead of IP/port?

Some platforms are configured as direct URL games because ServerTilt links to the public game or community page instead of querying a traditional server address.

How do I update my banner?

Edit the server from your dashboard and upload a new banner that matches the media rules above.

Where do I set up Votifier?

Choose the Minecraft / Username (Votifier) reward mode in the server form, enter your Votifier details, and use the guide at /help/votifier.

What happened to old ServerTilt links?

Server URLs are based on listing data and redirects may exist for some legacy paths. If a page is gone, check whether the server was removed, archived, renamed, or recreated.