Jetrix TetriNET Server

File Release Notes and Changelog

Release Name: 0.2.3

Notes:
Jetrix TetriNET Server                   http://jetrix.sourceforge.net
----------------------------------------------------------------------

What is Jetrix ?

  Jetrix is a new generation TetriNET server written in Java and 
  designed for maximum scalability, extensibility and ease of use. 
  It features a web based administration console and a simple API
  to let developpers add custom commands or change the channels'
  behavior with little knowledge of the server's inner functioning. 
  The ambitious goal of this project is to create the ideal plateform 
  for server side TetriNET programmers. Jetrix is open source and 
  developped under the GNU General Public License.

Installing & Running Jetrix

  You need a JRE 1.5 or higher installed on your server to run Jetrix.
  You can download it here : http://java.sun.com/j2se/1.5.0/download.jsp

  Unix

  Once the Java Runtime Environnement is installed, you'll need a 
  JAVA_HOME environnement variable pointing to your Java directory. 
  For example on Linux you can add this line to your /etc/profile file:

    export JAVA_HOME=/usr/java/j2sdk_1.5.0

  Then decompress the Jetrix archive to the installation directory:

    tar -jxvf jetrix-x.y.z.tar.bz2

  To start the server, type the following commands in the jetrix directory:

    ./jetrix

  To start the server as a background process, type:

    nohup ./jetrix &

  Or even better if the screen tool is available on your system, type:

    screen ./jetrix
    
  And then detach from the process with CTRL+A CTRL+D

  To download the latest release and upgrade your version (experimental), 
  type:

    ./update


  Windows

  Install the Java Runtime Environnement and then run the Jetrix installer 
  (jetrix-x.y.z-installer.exe). This will create a "Jetrix TetriNET Server" 
  group in your Start menu, just click on "Jetrix TetriNET Server" to
  start Jetrix, an icon will appear in the system tray. You can click on 
  this icon to open a menu and stop the server or open the administration 
  console.


Latest Documentation:

   http://jetrix.sourceforge.net

Bug Reports

   smanux@lfjr.net

Technical Support

   http://sourceforge.net/forum/forum.php?forum_id=172941


Changes:
Changes in version 0.2.3 (2008-08-23)
-------------------------------------

- Fixed a bug in the mode 4 (25% pure) of the #custom channel that was causing a crash the classic tnet 1.13 client
- The address of the server is now published to http://servers.tetrinet.fr instead of tsrv.com, tetrinet.org and tfast.org


Changes in version 0.2.2 (2005-04-07)
-------------------------------------

- Fixed a bug preventing clients from connecting on a server with a default encoding different from ISO-8859-1
- The configuration is no longer broken by a "&" char in the description of a channel


Changes in version 0.2.1 (2005-02-18)
-------------------------------------

- Fixed the Shutdown button on the server administration page
- Fixed a bug preventing the configuration files from being saved if the server was installed in a path containing a space character
- Running Jetrix with jetrix.exe no longer saturate the CPU
- Fixed a bug preventing the execution of several query commands with the same connection


Changes in version 0.2 (2005-02-23)
-----------------------------------

Player visible changes
- new commands: /afk (away from keyboard), /ignore (ignore list), /mode (pre configured settings, thanks to Gamereplay)
- Added the sudden death mode
- portuguese translation contributed by Vítor Melo
- operators can now create new channels dynamically with the /join command
- The name of the player starting or stopping the game is now displayed on the party line
- the StartFilter can now trigger a countdown before starting the game by specifying a number of seconds in the filter's "countdown" parameter
- partial support of IRC clients on the the port 31456 (disabled by default)
- on connecting, the player now joins automatically the first accessible channel with other players
- Added a flow control to prevent players using the windows client from being disconnected when they are flooded
- The server now responds "PONG" when a player send just "t" in an ingame message.
- It's now possible to remain idle forever on the #admins channel
- the dutch translation is once again up to date, thanks to "Sobi" from the tetridome forum
- improved the accuracy of the game stats (bpm)

Admin visible changes
- Jetrix now requires the JRE 1.5 to run
- the configuration file config.xml has been split in two files : server.xml and channels.xml
- a listener can now be disabled at startup by setting the auto-start attribute to false
- the address of the server is now automatically published on tetrinet.org, tfast.org & tsrv.com server lists
- the server can be locked from the admin console, once locked new connections will be rejected
- commands can be hidden from the /help list by specifying a "hidden" atribute on the <command> element
- the access level of a command can be overridden by adding an "access-level" attribute on the <command> attribute
- web admin: there is now a specific administrator password to log on the admin console (admin/adminpass by default instead of operator/jetrixpass)
- web admin: changes made to the configuration are now automatically saved to the disk !
- web admin: the name of the server can now be configured
- web admin: the idle time is now displayed on the user page
- web admin: listeners and services can be started/stopped
- web admin: implemented the "Shutdown" button on the "Server" page
- web admin: default values on the settings screen are now displayed in gray
- web admin: erasing a value on the settings screen will now reset it to the default value
- web admin: added basic server statistics (uptime, game count and connection count)
- web admin: commands can be removed
- web admin: the ip bound to the server can be changed on the 'General' tab, the ip available are automatically detected and listed
- web admin: added an "Idle allowed" parameter on the channel page, it maps to the <idle> element in the channels.xml file
- web admin: added a drop down list to select the winlist on the channel page
- web admin: added the 'Description' field on the channel page
- the server now checks the availability of a new release and display a message on startup and in the server administration page
- a system tray icon is displayed on windows platforms
- a native executable is provided on windows to run the server without the DOS console
- a windows installer is available
- reduced the size of the binary distribution by 35%

Developper visible changes
- code ported to Java 5.0 !
- added the services interface (net.jetrix.Service)
- renamed the Destination.sendMessage() method to send()
- Commands requiring a minimum number of parameters can now implement the ParameterCommand interface, the server will validate automatically the number of input parameters.
- added a clear() and a size() method to the Winlist interface
- added an AbstractCommand class to reduce the code needed to implement a new Command
- Localized messages can now have localized parameters by prefixing the parameter with "key:" : Language.getText("key", "key:paramKey");