绑定

在《DDNet》里你能通过F1控制台将设置与指令绑定到您的键盘和鼠标上。

语法

单指令绑定

bind [按键] [设置／指令] [参数]

此为绑定的基本语法。

• [按键]：键盘和鼠标上您所选的任意按键。
• [设置／指令]：您可以在官方网站（客户端设置／客户端指令）或站内页面（客户端设置／客户端指令）查找相关设置和指令。
• [参数]：您想要调整的设置或指令的变量或参数。（仅有某些设置需要使用参数，指令和某些设置无需参数）

倘若您不知道某个按键的名称，可以在这个页面中查找，亦或者在游戏设置 > 控制中随意找一格按下你想要的按键，即会显示按键名称。您也可以与修饰键ctrl、⇧ Shift、alt和GUI键（即Windows的⊞ Win、Mac的⌘ Command、Linux的Super）一起使用，如下：

bind ctrl+[按键] [设置／指令] [参数]

多指令绑定

您可以使用分号将多条设置与指令绑定到单一按键上：

bind [按键] "[设置／指令] [参数];[设置／指令] [参数]"

当您按下此按键后，所有绑定到这个按键的设置与指令会在同一时间被激活，换言之，这些设置与指令不会按照您所写的顺序依次激活。如果您想它们依次激活，您可以将它们分别绑定到不同的按键上，依次按下以激活，或者使用配置文件让您多次按下同一按键时激活不同的设置与指令。

嵌套绑定

您可以使用反斜杠将一条绑定嵌套在另一绑定中：

bind [按键] "bind [按键] \"[设置／指令] [参数]; bind [按键] \\\"[设置／指令] [参数] \\\"\""

客户端的字符长度限制为255，而每一层嵌套的反斜杠数量为上一层的反斜杠数量乘二加一。倘若您使用六层嵌套，反斜杠数量将会是240个（1*2 + 3*2 + 7*2 + 15*2 + 31*2 + 63*2），这样您只剩15个字符可键入，因此只能接受最多五层嵌套。每一层的反斜杠数量如下：

1 = 1   \
2 = 3   \\\
3 = 7   \\\\\\\
4 = 15  \\\\\\\\\\\\\\\
5 = 31  \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\

如果您仍感到疑惑，可看下方的拆解：

bind [按键] 
 "bind [按键] 
  \"[设置／指令] [参数]; bind [按键] 
   \\\"[设置／指令] [参数]; bind [按键] 
    \\\\\\\"[设置／指令] [参数]
    \\\\\\\"
   \\\"
  \"
 "

实用设置与指令

切换

切换（英语：Toggles）指令可以让您在单个按键切换设置的两个参数。客户端中有两种切换方式。

• toggle：令您每按一次按键时切换为另一个参数。
• +toggle：令您在按下按键时使用第一个参数，松开按键时则使用第二个参数。

bind [按键] "toggle [设置] [参数1] [参数2]"

bind [按键] "+toggle [设置] [参数1] [参数2]"

说话

说话（英语：Say）指令可以帮您在聊天框里快速输入文本。

bind [按键] say /[聊天框指令]

bind [按键] say [聊天信息]

颜色

某些客户端指令可以让您设置颜色。

• player_color_body
• player_color_feet
• cl_message_client_color

以上为部分例子。

想知道您所要的颜色参数，您可先在设定内调好，再在F1控制台内查询。例如在 设置 > Tee 里将本体身体颜色调成绿色后，可以在控制台内使用与其所对应的客户端指令player_color_body ，所返回在Value:后的一串数字则是您所调的绿色的参数。

然后您可使用以下绑定快速设置颜色：
bind [按键] player_color_body 5635840

或者使用十六进制代码：

bind [按键] player_color_body $00FF00

客户端也支持直接使用某些颜色名：red，yellow，green，cyan，blue，magenta，white，gray， black。

Emotes

The emote command can be used to display emotes without using the emote wheel. Each emote is represented by a different number.

emote 0	oop
emote 1	exclamation
emote 2	hearts
emote 3	drop
emote 4	dotdot
emote 5	music
emote 6	sorry
emote 7	ghost
emote 8	sushi
emote 9	splattee
emote 10	deviltee
emote 11	zomg
emote 12	zzz
emote 13	wtf
emote 14	eyes
emote 15	question

For example:

bind h emote 14

Other

binds [key] You can use this command to print what's bound to a single key. Use it without a key at the end to get a full list of all your current binds.

unbind [key]

Will unbind whatever key you specify.

Using Config Files

Syntax

For more complicated binds, you can make text files containing settings/commands that get executed via a key press.

settings.cfg

[command/setting] [value]
[command/setting] [value]
[command/setting] [value]; [command/setting] [value]
[command/setting] [value]; [command/setting] [value]

bind [key] [command/setting] [value]
bind [key] exec [file.cfg]

Settings/commands can be chained together via a semicolon or by just using a new line. You can put as many commands/settings/binds as you want in these files.

Note: You don't need to use .cfg as the extension. You can actually use any file extension you want. .cfg just seems to be the standard.

Path/Exec

In order to execute these files, you need to put them in correct directory and execute them with the exec command. The correct path depends on your operating system.

Windows

%APPDATA%\DDNet An easier way to find this folder is to press win+r to open the Run dialog, and paste the path above.

MacOS

~/Library/Application\ Support/DDNet The library folder might be hidden by default. In Finder, click the Go menu in the menu bar. If you hold the alt key, the Library folder will appear. You can also press cmd + shift + g to open the "Go to folder" menu, and paste the path above.

Linux

~/.DDNet Note: as of DDNet version 16.1, the new config directory is called DDNet. In previous versions it was called Teeworlds. The old Teeworlds directories still work as a fallback. For example, the old config directory for windows was:

%APPDATA%\Teeworlds

Once the files are in the correct path, you can execute them in the game console with the exec command.

exec [file.cfg]

or

bind [key] exec [file.cfg]

You can use sub-directories within the 'Teeworlds' directory to organize files. Just include the path when you execute the file.

bind [key] exec [path/to/file.cfg]

Improved toggle with config files

The most common reason to use config files is to create a single-key toggle to alternate between two files.

file1.cfg

[command/setting] [value]
[command/setting] [value]
[command/setting] [value]

bind [key] exec file2.cfg

file2.cfg

[command/setting] [value]
[command/setting] [value]
[command/setting] [value]

bind [key] exec file1.cfg

In this case, [key] would be the same key in both files. This way each time you press the key, it will switch to the other file. Once you have both of these files in the correct path, you can exec either one just once and they will be bound forever until you unbind them.

bind [key] exec file1.cfg

You can use this method to cycle between any amount of files.

Customization

Echo

As a more clear way to show which file you're activating when you press a bind, you can use the echo command to display which one is active.

[command/setting] [value]
[command/setting] [value]

echo setting ON

bind [key] exec file1.cfg

To take this a step further, there is a command to change the color of the echo messages.

[command/setting] [value]
[command/setting] [value]

cl_message_client_color red
echo setting OFF

bind [key] exec file1.cfg

Having different colors for "on" and "off" binds makes it a bit easier to notice which setting you've activated. If you want to get more creative with colors, see colors.

Comments

You can put comments in your bind files too.

# These lines change some settings

[command/setting] [value]
[command/setting] [value]

# This next line rebinds the key
bind [key] exec file1.cfg

Examples

Hook line always on

The command cl_show_hook_coll_own, sets whether you will see your own hook collision line or not when you hold your +showhookcoll bind (defaulted to S). When set to 2, your hook collision line will always show only to you. Others players won't see it.

hook_line_on.cfg

cl_show_hook_coll_own 2

cl_message_client_color green
echo Hook Line ON

bind x exec hook_line_off.cfg

hook_line_off.cfg

cl_show_hook_coll_own 1

cl_message_client_color red
echo Hook Line OFF

bind x exec hook_line_on.cfg

Put both of these in the correct path, and in console:

bind x exec hook_line_on.cfg

Everyone's hooklines

The command cl_show_hook_coll_other allows you to see other tee's hooklines, which can be useful when they are out of your view. You can add this to the basic hookline bind to "upgrade" it:

cl_show_hook_coll_other

bind x "+showhookcoll; +toggle cl_show_hook_coll_other 2 1"

Deep Fly

The deep fly bind is a way to make your dummy hammer/fire toward you whenever you fire with your main tee. If your dummy is deep frozen, they can hammer back at you when you hammer them with this bind on. You can use this to fly with your dummy, but it takes practice. If your dummy is not deep frozen, you can just use this as a alternative version of the regular Dummy Hammerfly bind included in the games settings, where you can fire your pistol each time you want to be hammered. It offers better control since you can control the timing of your dummy's hammers.

The command cl_dummy_hammer 1 is what is used for the regular Dummy Hammerfly bind in the games control options. By using a toggle, you can make your dummy hammer you only when you fire, and can make an on/off switch with config files.

Using 2 Config Files

deepfly_on.cfg

bind mouse1 "+fire; +toggle cl_dummy_hammer 1 0"

cl_message_client_color green
echo Deep Fly ON

bind x exec deepfly_off.cfg

deepfly_off.cfg

bind mouse1 +fire
cl_dummy_hammer 0

cl_message_client_color red
echo Deep Fly OFF

bind x exec deepfly_on.cfg

Put both of these in the correct path, and in console:

bind x exec deepfly_on.cfg

Using 1 Config File

You can accomplish the same thing as above using only 1 config file.

bind x "bind mouse1 \"+fire; +toggle cl_dummy_hammer 1 0\";cl_message_client_color green; echo Deep Fly ON; bind x \"bind mouse1 +fire; cl_dummy_hammer 0; cl_message_client_color red; echo Deep Fly OFF; exec deepfly.cfg\"" Put this file in the correct path, and in console:

bind x exec deepfly.cfg

Note 1: This assumes mouse1 is your +fire bind.

Note 2: If you turn deep fly off while you're holding your +fire bind, your dummy will get stuck in a hammering rhythm since cl_dummy_hammer is set to 1 still. The cl_dummy_hammer 0 line in deepfly_off.cfg fixes this.

Weapon Swapping

If your dummy isn't holding hammer when you turn the bind on, they will switch back and forth between pistol and hammer. If you want to fix this:

cl_dummy_restore_weapon 0

Now if they're holding pistol when you start using the bind, they will switch to hammer and stay there after 1 pistol shot. There are however some benefits of having this setting set to 1.

cl_dummy_restore_weapon 1

This will allow you to laser yourself with your dummy with perfect aim. It can also be useful with shotgun.

To manage dealing with both of these settings, you can either create a toggle, use config files, or have this setting attached to your weapon binds.

bind [key] "+weapon1; cl_dummy_restore_weapon 0"

bind [key] "+weapon5; cl_dummy_restore_weapon 1" This of course only works if you have dedicated weapon binds as opposed to +nextweapon and +prevweapon which is by default bound to mousewheelup and mousewheeldown.

45° Aiming

This bind allows you to only aim in 45° angles when holding down the key. This is useful for shooting rockets straight up for double rockets and a few other scenarios.

bind x "+toggle cl_mouse_max_distance 2 400; +toggle inp_mousesens 1 200; +showhookcoll"

Keep in mind that if you have changed cl_mouse_max_distance or inp_mousesens from the default, using the example above will reset those settings to default. Before you just enter the binds, check your settings for both first by typing cl_mouse_max_distance and inp_mousesens into the console.

bind x "+toggle cl_mouse_max_distance 2 [Your Value]; +toggle inp_mousesens 1 [Your Value]; +showhookcoll"

Note: the +showhookcoll line is optional, it's just helpful to see which way you're aiming since your tee's eyes don't follow the 45° constraints.

Rainbow Tee

You will sometimes see players rapidly changing color as they play. To do this you just have to bind a player_color_body change to each of your regular movement inputs.

bind a "+left; player_color_body red"

You can do this for several common inputs and get a variety of to cycle through.

rainbow_tee.cfg

bind a "+left; player_color_body red"
bind d "+right; player_color_body yellow"
bind space "+jump; player_color_body green"
bind mouse1 "+fire; player_color_body blue"
bind mouse2 "+hook; player_color_body cyan"

Here's an example of what a rainbow tee file looks like. You could save that in the correct path and execute it once.

exec rainbow_tee.cfg

Or if you want a key to toggle it on and off:

rainbow_tee_on.cfg

bind a "+left; player_color_body red"
bind d "+right; player_color_body yellow"
bind space "+jump; player_color_body green"
bind mouse1 "+fire; player_color_body blue"
bind mouse2 "+hook; player_color_body cyan"

bind x exec rainbow_tee_off.cfg

rainbow_tee_off.cfg

bind a +left
bind d +right
bind space +jump
bind mouse1 +fire
bind mouse2 +hook

bind x exec rainbow_tee_on.cfg

Put both of these in the correct path, and in console:

bind x exec rainbow_tee_on.cfg

You can of course get more creative with colors and use player_color_feet too. To learn more about how colors work, see colors

Note: This assumes you have default binds for left, right, jump, fire, and hook.

See also

• Just bind it - Useful binds available for copying
• Take Binding to the next level, with Scripting! - Another forum post about more advanced binds
• Teeworlds New Binding Tutorial by Klex - A video tutorial about binds by KlexMikrowelle