TM-FORUM

Onyx with its NyxServer is a plugin container written in java. Nyx plugins are simple javascript text files and can be added and removed on the fly. Some plugins: TMX, Dedimania, NextMapInfo, CopperDonation and many more.

After a long period of developement, Onyx V2 is ready and is released today.
No license or key needed with this new version, unlimited download.

What is Onyx V2 ?

Onyx is an internet application written in Java. It consists of an update engine as well as a plugin engine.
The onyx distribution for Trackmania manages a nadeo dedicated server and the scriptnyx language.

The dedicated server is the latest one and you will be always up to date thanks to the automatic update.
The scriptnyx language reached the version 2 too. With this, you will be able to write scripts easily to customize your server as you wish.
There are already lots of available scripts.

Who is Onyx V2 for ?

- For basic users who need to run a quick dedicated server time to time without annoying configuration.
The Desktop Edition is made for you, provided with an user interface.

- For administrators who need to install a nadeo server on their linux/windows servers.
The Server Edition is made for you. You will be able to start it with ssh.

- For developpers who like to add features to the nadeo server or add a full plugin to Onyx.If you are interested in creating some scripts to add features to the nadeo server:
The language Scriptnyx has been developed only for that.
Here are links to website related to ScriptNyx:Home PageLatest SciptNyxLanguage SpecificationScriptNyx APIShare Your ScriptNyxIf you want to develop a java application and to add it to Onyx v2 as a plugin
The Onyx SDK will help you to do that, Onyx SDK
and use the contact details so that we can add your plugin to all Onyx V2 clients.

What are the Onyx V2 features ?

* Onyx V2 has all the classic features which are included in any controllers (Next, Start, Restart, Add Challenges, Set games Infos, Set Server Options, ...). Onyx V2 is compatible with all the controllers.

* As well, Onyx V2 can get the features of the scriptnyx created by the community.
But here are some of the possible features:- Random Mode (randommode.nyx):
This script will change the mode of the server randomly (TA, Round Team) at the end of each challenge.- GuessNumber (guessnumber.nyx):
The rule is simple. Guess a number between 1 and 1000. The script will tell you if it s more or less. - SortPlaylist (sortplaylist.nyx):
This script will sort your playlist in order to alternate the environnements on your server.- badwords (badwords.nyx):
Fed up of rude words on your server, use this script, people will get kick as soon as a bad word is detected. - LimitAdaptator (limitadaptator.nyx):
This script recalculate the time limit in time attack mode or point limit in rounds mode for each map. - LoadLastConfig (loadlastconfig.nyx):
The purpose of this script is to load the last configuration of your server and to start it exactly at the same map it was stopped.- MapInfo (mapinfo.nyx):
This script returns a lot of info of the current challenge and the five next challenges. - Control (control.nyx):
This script will enable you to control your server from the in-game chat. (Restart, Next, SetGameMode, Kick ...)- Jukebox (jukebox.cyx):
This script will transform your server in a Track Jukebox (Tracks coming from Trackmania Exchange). - Dedimania (dedimania.cyx):
This script will manage records and will be linked to the Dedimania database record server. http://dedimania.com- RSS (rss.nyx):
This script will enable to display RSS feed on the in-game chat every n minutes.- Word Hider (wordhider.nyx):
This script take a random word from an English dictionary on the internet, hides characters and makes them appear one by one every 30 sec until somebody finds it. - Word Mixer (wordmixer.nyx):
This script take a random word from an English dictionary on the internet, mix characters and it s up to players to guess it by putting characters in the right order.- Dictionary (dictionary.nyx):
This script will display the definition of a word. Type '/dict word'many more on scriptnyx.dndnetworks.com...You can also have some script generated online You will need a server nadeo login to access them at http://scriptnyx.dndnetworks.com- Theme (theme.nyx.php):
Customize your server with your own messages (when a player enters, leaves, finishes the map, ...)- Bind (bind.nyx.php):
Binding is a process by which you attach a text to a key shortcut. Example: Typing /gg into the in-game chat displays Good Game.
You will be able to create your binds, to share them with the community, to choose some amongst the ones created by others, to preview them ...

How do i control my Onyx V2 ?

Onyx V2 is fully compatible with all controllers (OnyxController, TMWeb, RemoteCP, ServerMania ...)
Use one of them in order to set the server options (name, comment, max player...), game info (mode, Pt limit, chat time, ...), and to add challenges.
If you need to manage scriptnyx remotely (add/remove), OnyxController can do it.
With the dedimania script installed and activated on your Onyx, you will be able to see it on Dedimania site.

Where do i get Onyx V2 ?

You can go to the official website: http://www.onyx-software.com
and go to the section Download.
2 Onyx Distributions:
- a Desktop Edition (provided with a scriptnyx engine and an user interface)
- a Server Edition (provided with a scriptnyx engine but no user interface)
Choose the one which fits to your needs.

A menu has been integrated on Onyx servers.
This menu has for purpose to remove chat command and to replace it by a click
The menu will appear like this:
You click on it and the menu will open:

The content of the menu depends on the scripts you have activated on your onyx.
So far, the following scripts are adding buttons to the menu: Control V2.cyx, TMX.cyx, Dedimania.cyx, SetNextMap.nyx, DediVote.cyx, StuntRec.cyx, and the online generated scriptnyx bind.nyx.php.
Soon, others are coming or will be upgraded...

Some screenshots of new scriptnyx:TMX Search on TMX and add it as next on the playlistBind keyboard shortcutControl next, restart, change game mode ...Dedivote vote for the map, and look at vote resultsDedimania record manager

Here is the set of functions you need to know:dnd.addHelpContent will add a category on the help manialink page for your script
- title: title of the category
- content: explanationdnd.addManialinkPage will add a manialink page on the screen
- id: string to identify your manianlink
- xml: your xml manialink
- login: login player where to send the manialink (if login="", it will be sent to all players)dnd.closeManialinkPage
- id: string to identify your manianlink
- login: login player (if login="", it will be closed on all players screen)dnd.addUIServerCommand
- label: the label of the button
- login: login player (if "", all players)

To handle the answer of the menu, implement the onServerCommand callback Method.
List of the callbacks at the 1st page of the doc

Damn, it's been a long time since I worked with Java. Thank God. What I meant, however, was could you please compile the app instead of chaining java from a batch file so that it runs as a proper Windows app.

If u choose the windows desktop edition of Onyx, u ll get a msi file (microsoft installation file) which will install Onyx on the directory of your choice and will set up everything for you (Start Menu and icon on the desktop).
If u take a look in the directory where Onyx is installed, u ll see that the main executable is not a batch file but a proper windows executable file

If I was using the desktop edition then I imagine that I would have known that. Notice that I am interested in the server edition, though. In my earlier post I mistyped "server edition" as "server editing" for some reason.

Update [23/01/2007]:Scriptnyx changes:
- the dnd.getChallengeAt(0) in scriptnyx has been fixed
- the dnd.getLength() in scriptnyx return the right value in TMO/S/N with server even with more than 150 maps.

NEW Scriptnyx added:
- StuntRec (by koko): will manage your stunt record
- DediChat (by Vegeta): will link your server chat to a common chat with other servers.
- OnyxServerNetwork API (by Vegeta): API in order to create a network of server (control the network, get infomation on each server of the network)
- Onyx Infos Reporter (by Vegeta): use this package to display information of your server on your own website.
- String API (by PaGaisu): API to manipulate string (replace and basename functions)
- Train&Fight (by koko): first Time Attack mode to train, then the server restarts on Round mode for the match.

To update your onyx, you need to reboot your onyx.
At the start-up, the onyx update engine will download the latest libraries and plug ins.

Slig, i was talking about the script dedimania.
I know the record server can handle records made in team mode. Anyway, I just chose not to report them in team mode in order to let ppl focus on their match