Android Tutorial for DDNet 9.3.1/zh

警告： This information is for the old old old Android Client, please refer to the future DDNet Mobile Tutorial. Check out https://ddnet.org/downloads/ for the modern android client

这是DDNet的手机版教程。请注意由于当前版本客户端非常老旧，存在许多漏洞和问题，新版本正在开发中。

在阅读此教程前，玩家需要先了解基础的按键绑定知识，并弄清楚自己需要的功能。要寻求手机版的帮助，请在wiki、b站、Discord等地方咨询ForgottenCat。因为大部分人对手机版了解不深，请勿过多叨扰。

教程中的设置仅供参考，请根据您的个人习惯适当修改。

如何下载

最新的手机版为9.3.1，仅支持安卓设备。点击此处下载。 有些设备无法正常安装，例如安卓版本不匹配。也许您可以尝试使用Android Debug Bridge来安装。

入门指南

初次启动游戏，您会看到“按下左摇杆跳跃（Tap left joystick to jump）”。此时重启游戏，将会出现一行字“更改设备配置（CHANGE DEVICE CONFIGURATION）”。请点击它来进入设置界面。

主界面

此界面的所有更改会自动保存。

按钮和重映射

手机版带有重映射这一特殊的选项。因为电脑版通常使用键盘操作，按键本身已经命名，例如ctrl、alt等，可以直接绑定不同名字按键的功能。而手机版与之不同，在绑定按键的功能之前，必须先对按钮进行命名。

以下三个选项与重映射有关：“屏幕键盘（On-screen keyboard）”、“物理按键重映射（Remap physical keys）”、“屏幕双指操作（Two-finger screen gestures）”。

屏幕键盘 On-screen keyboard

该选项用于更改屏幕上的按键设置。

屏幕按键设置界面

屏幕按键主题 On-screen keyboard theme

用于更改按钮材质。默认设置为“Sun”，这是唯一一个会显示摇杆触碰位置的材质。

屏幕键盘尺寸 On-screen keyboard size

用于更改按钮的可触碰范围。不推荐在此处更改。

按钮图案大小 Size of button images

用于更改按钮的图案大小，但是不会影响可触碰范围。

屏幕键盘透明度 On-screen keyboard transparency

用于更改按钮的透明度。调整范围在“透明（Invisible）”和“不透明（Non-transparent）”之间。

定制屏幕键盘样式 Customize on-screen keyboard layout

用于更改屏幕按键布局。非常推荐在此处编辑按钮图层，您可以直接拖动按钮摆放的位置，按下即可选中对应按钮，之后在空白处滑动调整其形状。同时会有文字显示按钮信息。

如果您的材质不是“Sun”，则会显示为“Simple Theme”。

屏幕控制重映射 Remap on-screen controls

总共有7个按钮和2个摇杆，其中“文本输入按钮（Text input button）”和摇杆不能进行重映射。建议禁用“摇杆1（Joystick 1）”，否则移动和跳跃会相互冲突。禁用方式请点进选项并参考图片。

禁用Joystick 1的勾选情况

Joystick 2是唯一可以出钩的按钮，请勿禁用。轻触ok来保存设置并进入重映射界面，如图所示。

重映射界面

被映射的按钮在表现上与键盘按键一致。例如：如果你将button 1映射为A，那么按下button 1将与连接键盘并按下A的功能完全相同。

顶部会显示当前被映射的按钮名。按钮名字。按钮通常有默认的映射。推荐将按钮映射到A、D、space、X、pagedown/PgDn，因为这些按键已经默认绑定了和电脑端一致的功能，而无须重新绑定。

注意：您必须替换并重新绑定开火键。因为开火默认操作是鼠标左键Mouse1，但是触屏手机系统的点击是手指触碰界面空白处，这会导致在按住按钮的时候无法开火。您可以尝试作如下替换：将button 6重映射为world_55，然后将world_55绑定为“+fire”，或者根据您的喜好作其他重映射。

上面提及的默认绑定功能有：A=左移动；D=右移动；Space=跳跃；X=切换分身；PgDn=切换到下一武器；Mouse1=开火。

您在任何时候退出重映射界面，已有的设置都会被保存，未改变的内容则保持不变。在重映射设置好后，调整按钮布局即可完成屏幕按钮的设置工作。

物理按键重映射 Remap physical keys

一般来说，移动设备会有音量键等实体按键，它们也能进行功能绑定，与屏幕按钮相比不容易误触却又不易触发，请根据个人习惯谨慎使用。首先，在图示界面按下要绑定的实体按钮。

在此界面按下实体按键

然后点击 Show all keycodes，注意其他选项无法使用。之后对实体按键进行重映射，每次只能更改一个按键。

您可能会尝试将某个实体键映射为 mouse1 （鼠标左键），但没有任何作用。实际上您应选择 Mouse emulation -> Left mouse click -> Physical key，然后按下要绑定的实体键。注意：要想移动光标仍需点击屏幕。

实体键有容易绑定的独特优势，在DDNet自带的设置界面中可以直接绑定实体键，与电脑端一致。在此界面所有屏幕按钮都会暂时隐藏，因此无法快速绑定。

屏幕双指操作重映射 Remap Two-finger screen gestures

一共有4种控制手势：放大、缩小、逆时针旋转、顺时针旋转。这些手势与实体键一样不容易触发，推荐绑定非频繁触发的功能。

默认灵敏度是 Medium （中），请根据个人喜好进行设置。

所有双指手势默认映射为 UNKNOWN。这不是有效键位，无法绑定任何功能。您需要先映射为有效按键。

手势的用法：您需要用两根手指在空白处长按，按住屏幕的同时张开双指为放大手势，收缩双指为缩小手势。此外，建议在使用旋转手势的时候，保持一指不动，另一根手指进行旋转。

手势也有错误判定的情况，例如进行旋转手势时有可能因为双指张开触发放大手势。请根据个人情况选用。

Remap Note

1. Please write down or memorize every button what it's mapped to. Or you will suffer while binding later.
2. To make sure the key you map to has no bindings that you don't know by chance, you can map buttons to keys like "World_X". They are not bound by default.
3. After remapping, you can renter the mapping interface to check if the buttons are mapped correctly, the mapping will be shown at the top normally.
4. If you are going to place buttons like the layout shown in the picture

the layout

, you'd better place the space button a little higher. Or bugs will cause while you are trying to kick a tee.(Tap the button A or D then Joystick 2 then Space, with a fast speed, the buttons may suddenly be useless unless you release all fingers on screen. The solution is to place space button a little higher, or you just move the finger higher while tapping space button).

1. In the Mouse emulation, you can set the Calibrate touchscreen. Touch 4 edge of the screen, then exit.
2. All mappings will be activated after you leave this interface and enter ddnet. Meaning all gestures and mappings for physical keys are inactive.

Remap Example

Button 1: A

Button 2: SPACE

Button 3: D

Button 4: X

Button 5: PAGEDOWN

Button 6: WORLD_55

Volume+: RCTRL

Volume-: LALT

Back: RETURN

Zoom in: WORLD_5

Zoom out: ESCAPE

Rotate left: K

Rotate right: F1

Explanation: You must include RETURN, this can't be changed. This is the setting of ForgottenCat.

The key CTRL and ALT don't exist, instead, we have LCTRL and RCTRL, LALT and RALT. When binding, we can't bind ctrl as well. We need to bind rctrl "...".

Settings and Binding In-Game

Basic Settings

Homepage

You can set your own name upon first entering. Then you will see this page. Clear the search box upon the Host Address, you can see servers. The DDNet and LAN option has no server in. If you want to join a LAN server, just change the Host Address.

If you refresh too fast, it may stop working, the refresh is slow on mobile ddnet. For the perfect refresh you can see x of 1000+ servers, then just wait.

Remember, all changes made after entering ddnet could only be saved by exiting using the X at the top right corner.

Controls, you can bind there

Tap the gear at the top right corner to enter the setting interface. In the option Controls you can bind your mouse1 or physical buttons conveniently.

There is a special option in HUD: Show Chat. If you turn it off, the text input button will act weirdly. Normally when using the button, you will open chat automatically, then you can input messages. But turning Show chat off will prevent the chat from entering. For example, you input "/lock", you will kill, because the last word of /lock is K, and k is bound to kill. So if you input "yyyyyyk", you will also kill.

Now, get into a random DDNet server, and start binding.

Basic Bindings

Press the button that is mapped to F1, then you can use the Text input button to input commands.

If you decided to use an on-screen button to fire, it's recommended to bind mouse1 to spectate. Because while spectating, you have to hold the screen to choose which who you want to spec. If you bind another button to spectate, you need to hold that button and the screen at the same time.

After all these settings, your mobile ddnet is now playable! You can now beat most easy maps, but if you are going to higher difficulties, you will find serious problems. You can choose whether to skip mode switch key, but I recommend you not to read them if you are not very familiar with DDNet, or you aren't planning to be a pro in mobile ddnet.

Mode Switch Key

There are too many bindings, but we don't have that many buttons to use. Also, commands like "bind ctrl+a" is not usable in mobile ddnet. So mode switch key is the best solution.

Firstly, you need to know Config Files, and you need to know basic commands. You must place your config files in /storage/emulated/0/Android/data/tw.ddnet/files/data/. Take care that there is a folder named "data", and it has the same content as the current folder. Placing files in there will do nothing.

The Mode switch key is used for bind lots of buttons to another usage. For example, create a config file called "on.cfg". The following commands are what's inside.

• bind a "zoom+"
• bind d "zoom-"
• bind rctrl "exec off.cfg"

Then, create another config file called "off.cfg". The following commands are what's inside.

• bind a "+left"
• bind d "+right"
• bind rctrl "exec on.cfg"

Then, go into game, tap f1, input "exec off.cfg", the key is now usable. Let's see what the key can do.

Firstly, you use the key, the key a and d can now zoom, and the mode switch key can now execute the "off.cfg". When you finish zooming, use the rctrl again, the key a and d can now make you move, and the key rctrl can now execute on.cfg. As you see, rctrl is considered as a mode switch key there, it can temporarily change the binding of other buttons and have the ability to reset them after using. This is similar to "bind rctrl+a", but mobile ddnet does not support this, so we have to make a small change.

Sounds easy right? But there are more you need to care about while creating your own mode switch key. Firstly, the key that will be changed shouldn't be changed by mode switch key. For example, deep fly will change the binding of fire button. After changing, you need to use the mode switch key to reset bindings. But if it will reset the binding of fire button, the deep fly bind just disappear.

Another issue is, you can't let the key can be triggered by accident. Triggering mode switch key by accident is usually fatal, it may deprive you of your ability to move, if your mode switch key has something to do with move buttons. Take physical keys such as volume keys as mode switch keys is a good option, they can't be triggered easily.

To know which mode you are currently at, using emote is a good choice. Upon entering setting mode, show an afk emote, and upon resetting, show a happy emote. This can prevent you from misunderstanding.

You shouldn't to relate screen gestures to mode change keys. They can't be triggered if you can't release hook for a period of time, and they are easily triggered by accident.

Two mode switch key is enough for now, just two volume keys. Too many mode switch keys will make you confused.

Bugs and Solutions

On-Screen buttons released itself or cant be released.

Your hook usually breaks itself, especially in hf parts, endless, and dummy drags. Avoid situations that you must hold hook for a long time or you will die. If it's not avoidable, release all your buttons before starting to hook, then touch hook joystick only. After this you can start moving, and try not to release your finger which is on the moving buttons. This is a useful way to prevent this bug from occuring.

In some hookthrough part or rehook part, you will find your hook won't release even though you release your finger. The only way to deal with this problem is to tap your joystick for another time. Of course this is not useful most of the time. A map named Polarity is a good example, this map is way harder for mobile players because of this bug.

A more common issue is you can't release on-screen buttons, it usually occurs when you are holding your hook joystick, you just can't release your move buttons. The solution is to touch move buttons before jumping. Jump, then move while holding hook at a fast speed will 100% cause this bug.

Of course, sometimes your move button will release itself. Probably because you are releasing hook joystick. Lots of hook part requires you to drag dummy, go back, then go forward and get a faster speed to pass through some freeze zone, which means you probably need to release hook. The solution is, when you release your hook, just quickly tap the hook joystick again, then your move button will recover.

White hell

If you placing ddnet client in the background, or something like this, when you come back, your entity will be completely white or something you can't understand most of the time. And if you repeat the action, everything will just collapse. Just reopen the game can fix this problem.

/load problem

Sometimes after using /load, the collision between two tees will act very weird, seems very laggy. The solution is, just don't enter solo mode before /load. If you can't, use /timeout or entering a solo tile after /load.

Full-width breakdown

The text input button can't input full-width characters such as Chinese characters. If you do that, the game will crash normally. But maybe, this bug only occurs on certain devices. However, if you open the input interface without using text input button, the game won't crash if you input full-width characters. For example, change your name in the setting input box. And, for some reason, if you get into a server, don't connect your dummy, and write some Chinese characters in the input box without using that button, then you may temporarily get the ability to send full-width characters without crashing the game.

Normally, the solution is to create some config files. Placing commands like player_name or say. Then while playing you can f1 and execute those files to help you swaping, changing name, or sending messages.

Textures

/storage/emulated/0/Android/data/tw.ddnet/files/data/, there you can find every texture. Just replace the original texture without changing the file name. The entity texture is in the editor folder, its name is entities_clear.png. If you want to add skins, put files in the skins folder. x_ninja.png is the default skin when tee is in freeze. Replace it without changing the file name can change the in-freeze skin.

Example

This is the current setting of ForgottenCat, hope this will help you!

Remap Part

The on-screen button layout

• Volume+:RCTRL
• Volume-:LALT
• Back:RETURN

• Button 1:A
• Button 2:SPACE
• Button 3:D
• Button 4:X
• Button 5:PAGEDOWN
• Button 6:WORLD_55

• Zoom in:WORLD_5
• Zoom out:ESCAPE
• Rotate left:K
• Rotate right:F1

Binding Part

ctrlon.cfg

emote 12
bind a "zoom+"
bind d "zoom-"
bind space "say /team 1;toggle cl_dummy 0 1;say /team 1"
bind pagedown "toggle cl_dummy_copy_moves 0 1"
bind x "exec deepfly.cfg"
bind rctrl "exec ctrloff.cfg"
bind world_5 "toggle cl_mouse_max_distance 400 2;toggle inp_mousesens 200 1"
bind return "say /spec"

ctrloff.cfg

emote 2
bind a "+left"
bind d "+right"
bind x "toggle cl_dummy 0 1"
bind pagedown "+nextweapon"
bind space "+jump"
bind rctrl "exec ctrlon.cfg"
bind lalt "exec alton.cfg"
bind return "toggle cl_overlay_entities 100 0"

deepfly.cfg

bind world_55 "+fire;+toggle cl_dummy_hammer 1 0"
bind x "exec deepflyoff.cfg"
emote 1

deepflyoff.cfg

bind world_55 "+fire"
bind x "exec deepfly.cfg"
emote 12

alton.cfg

emote 12
bind d "player_name DDNET;dummy_name DDRACE"
bind x "toggle cl_dummy_resetonswitch 0 1"
bind space "say /dnd;toggle cl_dummy 0 1;say /dnd"
bind lalt "exec ctrloff.cfg"
bind rctrl "+showhookcoll"
bind return "Help yourself this is empty"
bind a "exec fastron.cfg"
bind pagedown "Help yourself this is empty"

fastron.cfg

exec ctrloff.cfg
emote 5
bind return "say /r"

Ending

That's all, very thanks for reading! Playing ddnet on phones and pads is very convenient for us, and can provide us a new experience. However, we don't want you to play this just because you want to show yourself. Of course, the mobile version is hard to play, hard to set well, but this is not the excuse to ask others to help you more than normal. We mobile players are not the disabled, with enough practice even the insane maps are not our limitation. Good luck and have fun!