Store Page
Teeworlds
All Discussions Screenshots Artwork Broadcasts Videos News Guides Reviews

Teeworlds

Store Page
Teeworlds > Guides > mkjol's Guides
Not enough ratings
Setting Up Teeworlds Server
By mkjol
Hello, this is a guide about creating a Teeworlds Server!
If you like it, please leave a thumbs up and share it to help more newbies!
   
Award
Favorite
Favorited
Unfavorite
Created by
mkjol
In-Game
Teeworlds
Category: Game Modes, Gameplay Basics, Multiplayer, Secrets, Walkthroughs
Languages: English
Posted
Updated
15 Sep, 2016 @ 1:00pm
26 Feb, 2017 @ 8:05am
1,152 Unique Visitors
21 Current Favorites
Guide Index
Overview
Basics 
Server Setup 
Server Settings 
Game Settings 
Tuning reference 
Server Commands 
Server Autoexec Examples 
FAQ/Source 
Ending 
Comments
Basics
To create a teeworlds vanilla server you need:
  • Download the basic teeworlds files. To do it, download tw from steam or from official website[downloads.teeworlds.com]

  • Then unpack the downloaded file and create new text file in that folder.

  • Name it exactly "autoexec"

  • Then open it and click "File" > "Save as..." and replace from "autoexec" ".txt" into ".cfg".
    It should look like that
  • Now you can delete autoexec.txt
    autoexec.cfg will be our server settings file.
Server Setup
Port forwarding
  • First to launch server at your pc you have to forward a port to the server. portforward[portforward.com] has a lot information on how to do this.
Remote Console
  • To be able to execute server commands while playing, there is a remote console. To open it, press F2 (or the key you have chosen). You will now be asked to enter a password. If the console says that there are no password, you have to set the "sv_rcon_password" variable to enable that.

Server Settings
  • There are lots of server settings to change all from the score limit, to the speed of the shotgun.

Engine settings

Settings
Description
Default
sv_name
Name of the server
unnamed
bindaddr *
Address to bind]
sv_port *
Port the server will listen on
8303
sv_external_port *
Port to report to the master servers (e.g. in case of a firewall rename)
0
sv_max_clients *
Number of clients that can be connected to the server at the same time
12
sv_max_clients_per_ip
Number of clients with the same ip that can be connected to the server at the same time
12
sv_high_bandwidth *
Use high bandwidth mode, for LAN servers only
0
sv_register
Register on the master servers
1
sv_map
Map to use
dm1
sv_rcon_password
Password to access the remote console (if not set, rcon is disabled)
password
Password to connect to the server
logfile
Path to a logfile
console_output_level
Adjust the amount of messages in the console
0
sv_rcon_max_tries
Maximum number of tries for remote console authetication
3
sv_rcon_bantime
Time (in minutes) a client gets banned if remote console authentication fails (0 makes it just use kick)
5
sv_auto_demo_record
Automatically record demos
0
sv_auto_demo_max
Maximum number of automatically recorded demos (0 = no limit)
10
ec_bindaddr
Address to bind the external console to. Anything but 'localhost' is dangerous"
localhost
ec_port
Port to use for the external console
ec_password
External console password
ec_bantime
The time a client gets banned if econ authentication fails. 0 just closes the connection
0
ec_auth_timeout
Time in seconds before the the econ authentication times out
30
ec_output_level
Adjusts the amount of information in the external console
1

  • * means it can't be changed while running the server.
Game Settings
Settings
Description
Default
sv_warmup
Warmup time between rounds
0
sv_scorelimit
Score limit of the game (0 disables it)
20
sv_timelimit
Time limit of the game (in case of equal points there will be sudden death)
0
sv_gametype
Gametype (dm/ctf/tdm) (This setting needs the map to be reloaded in order to take effect)
dm
sv_maprotation
The maps to be rotated
sv_rounds_per_map
Number of rounds before changing to next map in rotation
1
sv_motd
Message of the day, shown in server info and when joining a server
sv_spectator_slots
Number of clients that can only be spectators
0
sv_teambalance_time
Time in minutes after the teams are uneven, to auto balance
1
sv_spamprotection
Enable spam filter
1
sv_tournament_mode
Players will automatically join as spectator
0
sv_respawn_delay_tdm
Time in seconds needed to respawn in the tdm gametype
3
sv_teamdamage
Enable friendly fire
0
sv_powerups
Enable powerups (katana
1
sv_vote_kick
Enable kick voting
1
sv_vote_kick_bantime
Time in minutes to ban a player if kicked by voting (0 equals only kick)
5
sv_vote_kick_min
Minimum number of players required to start a kick vote
0
sv_inactivekick_time
Time in minutes after an inactive player will be taken care of
3
sv_inactivekick
How to deal with inactive players (0 = move to spectator, 1 = move to free spectator slot/kick, 2 = kick)
1
Tuning reference
Physics tuning



  • Tuning is a way to edit physics and weapon settings so that the server is more customizable.
  • Tuning can only be used on non-pure gametypes. Set the gametype to mod using sv_gametype mod and execute the following in rcon or config to tune a variable:
    tune gravity 1.0 where you replace gravity 1.0 with the variable and value you want.


Tuning
Description
Default Unit
ground_control_speed
Max speed the tee can get on ground
10.0
ground_control_accel
Acceleration speed on the ground
2.0
ground_friction
Friction on the ground
0.5
ground_jump_impulse
Impulse when jumping on ground
13.2
air_jump_impulse
Impulse when jumping in air
12.0
air_control_speed
Max speed the tee can get in the air
5.0
air_control_accel
Acceleration speed in air
1.5
air_friction
Friction in the air
0.95
hook_length
Length of the hook
380.0 (pixels)
hook_fire_speed
How fast the hook is fired
80.0
hook_drag_accel
Acceleration when hook is stuck
3.0
hook_drag_speed
Drag speed of the hook
15.0
gravity
Gravity of the teeworld
0.5
velramp_start
Velocity ramp start
550.0
velramp_range
Velocity ramp range
2000.0
velramp_curvature
Velocity ramp curvature
1.4
player_collision
Enable player collisions
1
player_hooking
Enable player vs player hooking
1


Weapon tuning


Tuning
Description
Default
Unit
gun_curvature
Gun curvature
1.25
gun_speed
Gun speed
2200.0
pixels / sec
gun_lifetime
Gun lifetime
2.0
sec
shotgun_curvature
Shotgun curvature
1.25
shotgun_speed
Shotgun speed
2750.0
pixels / sec
shotgun_speeddiff
(UNUSED) Speed difference between shotgun bullets
0.8
shotgun_lifetime
Shotgun lifetime
0.20
sec
grenade_curvature
Grenade curvature
7.0
grenade_speed
Grenade speed
1000.0
pixels / sec
grenade_lifetime
Grenade lifetime
2.0
sec
laser_reach
How long the laser can reach
800.0
pixels
laser_bounce_delay
When bouncing, stop the laser this long
150.0
ms
laser_bounce_num
How many times the laser can bounce
1.0
laser_bounce_cost
Remove this much from reach when laser is bouncing
0.0
pixels
laser_damage
Laser damage
5.0
damage
Server Commands
  • To kick players from the server and to do other similar things, you have to use the server commands.

Commands:

Command
Syntax
Description
echo
echo [text]
Print a text in console
exec
exec [file]
Execute the commands in the file
kick
kick [id]
Kick the user with the specified id directly
ban
ban [ip/id] [minutes]
Ban the ip from the server for the given time
unban
unban [ip]
Unban the ip
bans
bans
Show a list of bans
status
status
List the player's id, ip, name and score
shutdown
shutdown
Shut the server down
reload
reload
Reload the map
record
record filename
Start recording
stoprecord
stoprecord
Stop recording
tune
tune variable value
Tune the variable.
tune_reset
tune_reset
Reset the tuning to default
tune_dump
tune_dump
Make a dump that shows what tuning is used
change_map
change_map [mapname]
Change to the specified map
restart
restart [time]
Restart the round (time is optional)
broadcast
broadcast [text]
Broadcast the text
say
say [test]
Send a chat message
set_team
setteam [clientid] [team_id]
Move a player to a specific team (0 = red, 1 = blue, -1 = spectators)
set_team_all
setteamall [team_id]
Move all players to a specific team
add_vote
add_vote [description] [command]
Add a vote option for the provided command with the provided description ( description is optional)
remove_vote
remove_vote [command]
remove a vote option
force_vote
forcevote type option/playerid reason
Force a certain vote to be executed immediately (type can be "option", "kick" or "spectate")
clear_votes
clear votes
remove all vote options
vote
vote [yes/no]
Force the end result of the vote to yes/no
Server Autoexec Examples
Example configurations

  • Sample DM config

    sv_name Teeworlds sample dm sv_map dm1 sv_scorelimit 20 sv_timelimit 10 sv_gametype dm sv_rcon_password sample_pass sv_motd Teeworlds sample dm configuration sv_max_clients 12 sv_spectator_slots 10

    • Sample TDM config

      sv_name Teeworlds sample tdm sv_map dm6 sv_scorelimit 50 sv_gametype tdm sv_rcon_password remember sv_motd Teeworlds sample tdm configuration

      • Sample CTF config

        sv_name Teeworlds sample ctf sv_map ctf2 sv_scorelimit 400 sv_gametype ctf sv_rcon_password remember sv_motd Teeworlds sample ctf configuration
FAQ/Source
More info about server commands, server settings and little FAQ are in these links:

1. Server commands[www.teeworlds.com]
2. Server settings[www.teeworlds.com]
3. More info about creating a server[www.teeworlds.com]
4. Little FAQ[www.teeworlds.com]
5. A bit expanded FAQ[www.teeworlds.com]
Ending
After doing everything correct you can launch your server by double clicking teeworlds_srv

  • If you want to create votes in your autoexec here's how:

    add_vote "<description>" "<command to execute>"

  • For example it could look like this:

    add_vote "map: ctf5" sv_map "ctf5"

  • In game it looks like that:



iF this little guide helped you, please consider sharing or rating it :)
11 Comments
< >
KEEB 29 May, 2023 @ 6:27am 
server list*
KEEB 29 May, 2023 @ 6:26am 
Thanks for helping with the configs! I am struggling to get my server to pop up on the server links, If you still wanna update this I would appreciate some help. I have already done a port forward

Here is my config:

sv_name "[my server name]"
sv_register 1
sv_map dm1
sv_scorelimit 20
sv_timelimit 10
sv_gametype dm
sv_motd "hai :)"
sv_max_clients 12
sv_spectator_slots 10
Man_in_blacK 6 May, 2019 @ 2:01pm 
It's really usefull!
I wanna ask about creating and running other modes, especially ddrace server. I tried to find any config exaples but I couldn't :steamsad:
I will be really happy, if you write about it!
Thank you!
SILLY!!! 28 Dec, 2018 @ 2:42pm 
thx
mkjol  [author] 28 Dec, 2018 @ 2:23pm 
If you can't make it, im too lazy to explain you, just download the one I made for u :P
Its empty, .cfg file: https://cdn.discordapp.com/attachments/287697613149437952/528335905698873374/autoexec.cfg
SILLY!!! 28 Dec, 2018 @ 9:40am 
its not working for me it wont let me make it a cfg plz help :steamsad:
mkjol  [author] 17 Sep, 2017 @ 6:28am 
I hope you will like it ^^
Toude 17 Sep, 2017 @ 5:43am 
Cool I'll try it.
mkjol  [author] 26 Feb, 2017 @ 8:04am 
Oh, thanks
NerfBoy291 26 Feb, 2017 @ 7:55am 
Btw in ur second bullet u put "exacly" instead of exactly