5 easy steps to generate your first report
- Go raiding, type command /combatlog in the chat window, play and win
- Click here to launch the WWS client
- Go to the Logs & Report tab, add log <your wow install dirrectory>/logs/WoWCombatLog.txt
- If it is the first time you use WWS, go to the Actors tab, click Auto-update
- Go back to the Logs & Report tab, click Generate report, and here is your report !
Now for those who like reading more...
Installation guide
On 80% of PCs, Macs and Linux computers, just click here to install, update and run WWS.
If it doesn't work, you must install the Java software before.
If you want to relaunch WWS without going back to the web site, you can either bookmark the link above, or copy the link
to your forum or any convenient place. However, never do a local copy of the JNLP file, because it could prevent you to
launch future versions of WWS.
Note : On the first launch of WWS, you will be asked to trust the software. This is necessary so WWS can write its
results on your HDD.
More information about the security warning
WWS is written in Java and distributed through Java Webstart. Webstart is a great tool : it allows to run the software with one single click on PC, Mac and Linux, and it updates it automatically. As a "drawback" however, Webstart is really nervous about the distributed software (WWS) modifying the client (your) machine. Obviously, WWS needs to write the final reports on your hard drive, so Webstart issues a security warning to warn you about this.
Why isn't the certificate trusted ? Because getting a certificate to be trusted requires wasting vast amounts of undeserved money to a third-party company (Verisign, Thawtee...). Moreover, a trusted certificate would mean that the third-party company knows me, nothing more. The software could very well be harmfull anyway.
Do you know that every single application you install on your PC (including some .EXE distributed inside addons) can freely write on
your hard disk without you being warned about it ? WWS does nothing more, and it asks politely for permission before.
User guide
- The Logs & Report tab is where you specify which log files to use. You can use many log files from different
persons of your raid and they will be merged, which is the equivalent of SW Stats synchronization.
- Add Log : adds a log file to the list of logs, you will need to enter the name of the player who generated this log file
- Remove Log : remove a log file from the list
- Output directory : the directory where reports will be generated. Subdirectories will be created in the form /wws-mmdd-hhmm. If a report already exists in the output directory for the same day and time, it will be overwritten.
- Raid comment : might help you to sort out your reports
- Updates history : if this case is checked, WWS will create and update an history page, located at /wws-history
- Use whole log : use the whole log data
- or Trim logs : crudely trims the log data, by choosing to start and end the report when a given mob is first-seen or last-seen
- Generate report : generate the final report on your hard disk
- Host report : hosts your report on the WWS server
- The Actors tab is where you configure all players in your raid. The table can be sorted by clicking on columns.
When an actor appears in yellow, it means that this is a new entry that you should double-check. Of course, the list is saved when
you exit WWS so you don't have to enter it every time.
- Auto-update : scans the first log file, extract all actors from it, and guess their class. All entries added are tagged in yellow
- Remove mobs : remove all mobs
- Remove selected : remove selected actors (multi-selection is supported)
- Remove all : clear the list
- Add Actor : adds a single actor to the list
- Export list & Import List : in case you would like to move your actors list around
- The Configuration tab is quite scary, but you don't have to fill in all these fields :)
- Guild Name : your guild name, appears on reports
- Realm : enter your WoW realm if you want to get the armory links on the player pages
- Language : language WWS will use to parse log files and generate reports
- Encoding : use iso-8859-1 only if your web hosting provider has problems with page encoding and produces weird characters
WWS Server : create an account on the WWS server and enter the login information here if you want to host your reports online
- User Name : user name
- Password : password
All the rest is for the Log Roller, you can generate reports without it
- Player Name : The name of your avatar in game
- Wow log directory : The directory of WoW log files. Usually c:\program files\world of warcraft\logs
- Mail server configuration : Classic SMTP configuration. You can probably copy this information from your Outlook, or Thunderbird configuration. Some webmails, like GMail, provide an SMTP server. Some others do not. You absolutely need an SMTP server in order to send mails. Send to address is the mail address of the guild officer who will gather logs and generate final report
- FTP server configuration : Classic FTP configuration
- The Log Roller lets you send your log files around with a simple click. If your guildmates don't send you their log files,
make them use the Log Roller ! Each time you roll a log file,
- it is compressed as a ZIP file in WoW log directory with name WWSLR-mmdd-hhmm-playername.zip
- the file is sent by mail or FTP, or both, according to your configuration
- the original log file is deleted
After you have entered the configuration of either FTP or mail, it is strongly advised to Test your configuration. The Test
button will send a dummy log file using your settings so you can verify everything is OK.
Once everything is OK, you can
- Roll now : will roll your current log file, if any
- Auto-roll on startup: when this option is checked, your current log file will be rolled everytime you start WWS
- Not on client reports customization : you can customize client reports by creating any of the files custom.css,
custom-top.css, custom-bottom.css at the root of the output directory. These files will be copied to every report
that is generated by the WWS client. Play with them to see what they do !
|