Help

Report a bug

Record one task’s next run into a file you can send to Evonex support.

What it does

Records the next run of one task into a single file for Evonex support: pictures of the game, every step, every tap and every log line.

Where

Instances ▸ open an instance ▸ Duties ▸ the bug button at the right end of the row of jump keys, beside Filter by name

You need

An instance with the task you want recorded. Sending from the app needs a connection to Evonex.

It costs

Nothing in the game. A minute of recording takes about 2.5 MB of disk space.

When a task does something wrong, a short recording tells support far more than a description can. Click the bug button, choose the task, click Start, and let the task run. Evonex records 60 seconds by default and saves the file. The task keeps running afterwards.

121212

1. 1Filter by name Narrows the page to the duties and tasks whose name holds the words you type.
2. 2Bug report Opens the recorder. It draws its own state, so you can read it at a glance.

Record a report

1. Open Duties for the instance where the problem happens.
2. Click the bug button. The Record a bug report window opens.
3. Check Task. It starts on the task that holds the screen at the moment, usually the one with the problem. Pick another if you need to.
4. Leave Record for at 60 seconds, or choose another length.
5. Write a line or two under What went wrong?. It is optional, but it helps support a lot.
6. Tick Send it to Evonex support when it’s done only if you want the file sent by itself. It starts unticked.
7. Click Start. The button turns green: the report is armed. If the task has the screen at that moment, recording starts at once. If not, it starts the next time that task runs, even after you restart Evonex.
8. Wait. The button shows the seconds left. When they are up, Evonex saves the file.
9. When the report is saved, click the button again. Press Send to support, or send the file yourself from its folder.

123456712345671234567

1. 1Task Chooses the task to record.
2. 2Record for Sets how many seconds to record.
3. 3What went wrong? Takes your notes for support. This box is optional.
4. 4Send it to Evonex support when it’s done Sends the file by itself when it is saved. It starts unticked.
5. 5Save to Names the folder that keeps the file.
6. 6… Opens a folder chooser.
7. 7Start Arms the recording.

The window

What the bug button shows

The button shows its state by shape as well as colour. Click it in any state except Off to see the report’s card with the buttons that fit.

How a recording ends

• Your seconds run out. Evonex saves the file, and the task goes on.
• The task’s run ends. The card then tells you whether the run went well, failed or was stopped.
• You click Stop and save.
• The instance stops, or Evonex closes. If Evonex ends without closing the recording, it delivers the file the next time it starts, and sends it if you ticked Send.
• A very long recording reaches a size limit and stops.

What a report holds

• Pictures of the game as Evonex saw it. It keeps a picture only when something happens on it (a step starts, a tap, a log line), and stores identical pictures once.
• Every step the task ran and what it found, every tap, and every log and Activity line, in order.
• Your notes from What went wrong? and any moment you marked.
• Who sent it and from which PC: your e-mail address and the PC’s name, so support can answer you.
• What it ran on: the emulator and its player, the screen size and renderer, and your PC’s graphics adapters, Windows build, processors and memory.

Where the file goes

Into the folder under Save to. Files stay there until you delete them. To open the folder, use Show in folder on the report’s card. If Evonex can’t write there, the button shows Couldn’t save and offers Choose a folder….

Send it to Evonex support

Tick Send it to Evonex support when it’s done before you start, or press Send to support on the saved report’s card. Sending needs a connection to Evonex. Evonex sends the file in parts and keeps the speed gentle, so your game connections are not hurt. If the connection drops or you close Evonex, it carries on from the next part.

If it can’t send, it waits and tries again by itself: after 30 seconds, 2 minutes, 10 minutes, 30 minutes, then every hour. The file stays in its folder meanwhile, so you can also send it yourself.

Problems?