Settings UI

[jhakonen]

Features needed:

• Show mod settings
• Modify mod settings
• Save settings
• Restore default settings
• Export settings to a file
• Import settings from a file
• Show list of known TeamSpeak users (name + id?)
• Show list of known players (name + unique id?)
• Show a link between matched TeamSpeak users and players
• Show link type (automatic or manually set)
• Create manual links (manual link removes any automatic links between associated users and players)
• Remove manual links
• Any text content translatable to other languages (e.g. Finnish, Russian, etc...)

Ideas how to implement the UI:

• http server integrated into mod and then displaying html content in in-game web browser
• Flash based UI
• Settings in TeamSpeak plugin

Further ideas for Flash based UI:

• A view for settings
• A view for linking names
  • Two lists, first has player names, second has TS users
  • Each list is divided to three different sections: already linked and online; not linked and online; offline
  • Each section would be in alphapedical order
  • TS user list would show speech indicator when the user is speaking in TS
  • Player list would show speech indicator when TS user is speaking and that user is linked to player
  • Users and players would be linked somehow between lists visually
  • Linking could be done by dragging e.g. player name to TS name
  • Remove link from a button

[jhakonen]

Development branch: https://github.com/jhakonen/wot-teamspeak-mod/tree/issue_21

[jhakonen]

For master branch's building instructions see: https://github.com/jhakonen/wot-teamspeak-mod/wiki/Development-and-tests

In addition you need to install Adobe Flex 4.6 SDK. You can download it from here: https://www.adobe.com/devnet/flex/flex-sdk-download.html

When done, provide path to Flex SDK's MXMLC compiler:

make.py configure --mxmlc="E:\Programs\FlexSDK\bin\mxmlc.exe"

Adjust the path to match your environment. Building and testing happens, as always, with e.g. command:

make.py --exclude-tags=tsplugin clean install tail

[jhakonen]

You can now print debug messages from the ActionScript code to python.log using functions from DebugUtils package:

• _DebugUtils.LOGDEBUG(msg, arg1, arg2, ...)
• _DebugUtils.LOGWARNING(msg, arg1, arg2, ...)
• _DebugUtils.LOGERROR(msg, arg1, arg2, ...)

There is a few gotchas though:

• The first 'msg' variable needs to contain 'TESSUMOD' somewhere in it (case-insensitive), it is used to filter out any messages coming from other game UI components.
• If you use _LOGDEBUG, you need to also change _loglevel to 0 from _res_mods\configs\tessu_mod\tessumod.ini.

[jhakonen]

So, I've been lately learning to write ActionScript 3, reading WoT's AS code, reading forums and based on those managed to add a few elements to the settings window:

There is a text label there as well, but the text color is black so it is kinda difficult to see from the dark background.

How to add the buttons I found from ShadowHunterRUS's nice guide: http://www.koreanrandom.com/forum/topic/25477-как-создать-формуокно-в-ангаре/?p=279913

I also wrote a small test tool which allows previewing the Settings UI's SWF-file in browser:

While it doesn't look the same; no window borders, white background; it does show the same elements at same locations in same style. And it loads up much faster than the game would!

I'll add sources, binaries and instructions how to use use them later.

[jhakonen]

Would be nice to integrate the mod with this: https://bitbucket.org/P0LIR0ID/modslist/src/

I'm unsure how that is supposed to be distributed. Is it a separate mod? Or is it kind of a library that is supposed to be included in our mod?

If it is a separate mod then we would still need a fallback solution if user don't have that mod installed. That is, our own button in garage.

[jhakonen]

Well, I ended up making the preview tool better :)

Improvements I have done:

• Visible window borders (it can be even dragged around)
• Any DebugUtils calls, uncaught exceptions and preview tool's internal logging goes to Javascript's console output
• Path to the view's SWF-file can be given from the UI, it is not hard coded to "SettingsUI.swf" anymore
• verbose toggle to reduce logging spam from the tool's internal logging

The tool is integrated also to make.py. Building of the tool is done just like previously with build command:

make.py --exclude-tags=tsplugin build

In order to open the tool to web browser you need to first configure a path to some browser you wish to use, e.g.:

make.py configure --webbrowser="C:\Program Files (x86)\Mozilla Firefox\firefox.exe"

Then execute:

make.py preview_settingsui

This command will open the preview tool to your web browser with the "SWF file path" set to point to the location where the SettingsUI.swf was build to.

[jhakonen]

Got DAAPI communication to work:

That JSON data is created at Python code and then passed through to the AS3 UI.

Clicking the Ok / Cancel buttons cause click handler methods in the Python side to be called.

See the commit for details.

[jhakonen]

I have merged the issue_21 feature branch to master. Development continues there for now.