Zero to racing in 60 seconds
Once you have the Code Rally game installed it is really easy to start racing. The first thing you need to do is to start the Code Rally client. Once started you should see the below screen.
Close the welcome screen by clicking the "x" on the welcome tab. You should now see the below screen.
From this view you need to click on window>open perspective>other and choose the "code rally" option at the top of the list. This will open the Code Rally perspective shown below.
This is the basic Code Rally view - the large, empty area is where you will write your code. The section at the bottom ("my races") will show you all of the races you have run in the game. The upper left hand side will show a list of cars you have created and the lower left corner will show you any local or cloud servers you have created to run your agent AIs on (for more info on agent AIs read creating an AI. Before you can race you need to connect to a server - the easiest way to do this is to connect to the IBM Cloud Server. The IBM Cloud Server is a free to use global server where anyone can race where you will race people from around the world!
Connecting to the IBM Cloud Server
To connect to the cloud server click on the "Manage Server" button above the vehicles section on the left hand side:
This will open the manage servers window - this is where you can add and remove servers to race on, as well as login and logout of each of the servers. The color of the icon for a server reflects its status - red means that you are not able to communicate with the server correctly and green indicates that the server is online.
To add a new server you can click on "Add new" at the bottom of the list of servers. You can then fill in the information for the server in the right hand side and click "save" to create a new server entry. When you click on a server in the list you can delete that server entry (using the "delete" button in the bottom left), edit the server settings on the right hand side and login/logout from that server using the login/logout button. For connecting to the cloud server click on the "IBM Cloud" - the icon should be green to indicate that you can connect to the server. Once you have done that click on "login" and provide a username for yourself (no spaces).
If the username is valid you will then be asked to login using OAuth - you can login to Twitter, Facebook or Google - once you have logged into one of the OAuth providers your account will then be locked to that account so you will only be able to login to that username with the same social media account. If you are not allowed to login it with this ID it could be that someone else has associated the username with their own social media account so try with a different username.
You should be provided with server information for the Worldwide cloud server as well as our regional contest servers. In case you delete the information for one of these servers by accent the connection information is:
IBM Worldwide Cloud information
North America contest server:
Europe contest server:
Brazil contest server:
India contest server:
China contest server:
Once you have logged into a server to race then you're ready to create your first AI and get racing!
Creating a basic car
If you want to know more details around creating a car and coding your first AI we have a blog post to walk you through it. To enter a race quickly however you can follow these basic instructions.
Click the green "+" button above the vehicles list on the left side of Eclipse:
This will open the create new AI window:
You will need to give your car a name - don't start the name with a number and only use letters, numbers, underscores (_) and dashes (-). Below is the attributes setting section with 4 different boxes by default these boxes will have 1 in each of Acceleration, Weight, Traction and Turning which is enough to get started for more information on what these boxes mean you can read creating your AI.
Below the attributes are two radio buttons - Intermediate and Agent. Leave the radio button on Intermediate and below you will see 5 new drop-down menus - the first should be the name of the server you are connected to and can be left alone. The next 4 options will select how your car behaves in different scenarios - choose an option for each of the 4 boxes and click "Submit".
Your vehicle will now appear on the left hand side - right-click on the name and go enter race on...> your server name.
You will now be asked to choose a track to race on - choose any track as well as the "vehicle type" - this is just what your vehicle looks like in the race. When you have chosen a track and vehicle type click on enter race.
Watching a replay of your race
In the bottom part of the UI you should now see an entry for the race you just entered:
If you create a new race it will wait upto 30 seconds to see if anyone else wants to race against you. Your race will then start and will take approximately 10-30 seconds to complete. You cannot watch the race as it runs with an Intermediate AI (agent races can be watched live) but as soon as the status for your race changes to "finished" you can double-left-click on the race in the table and a race replay window will open that should look similar to the screenshot below. (tip: if your race takes longer than 1 minute to change to "finished" click the sync button above the list - the sync button is the two yellow lines pointing in opposite directions).
From here you can click the blue play button at the bottom of the screen and the race will run - cars with names next to them are other players - if a car does not have a name next to it then it is a bot generated by the game for this race. Each race is 3 laps and has a maximum time of 5 minutes 30 seconds (if you have not finished by then you will be marked as "did not finish").
See where you stand
If you want to see how you are doing compared to other racers you can view the IBM Cloud Leaderboard - you can change the settings to view ranking by average place or fastest time, as well as fastest time by track.
Now you have gone through the basics of connecting to the IBM Cloud Server and running a race you can go and create a more advanced AI or learn how to tweak the intermediate difficulty AIs - go read about how to create better vehicle AIs.
Having problems? Need help?