Class wide ladders

Each of the projects (except project this project) will have two class-wide sets of agents running against or with each other. These will generally start within a few days after the project is handed out. These will be explained in Project 1 but the idea is that one set of agents will be choosing the peaceful approach and one set the more war-like approach. For this project, the only goal is to ensure that you turned in an agent successfully and that it runs without crashing. Random is FINE. There will be NO extra credit for the ladder so performance does not matter so long as your agent does not crash.  There will be only one ladder running for this project so that you can ensure your agent ran properly but you do not need to choose competitive versus cooperative.

part 2: Due 11:59pm Wednesday Sep 1, 2021

Part 2 focuses on getting spacesettlers up and running on your machine and ensuring you can turn in code on the AWS machine.

1. Download and install an Integrated Development Environment (IDE).
   • You MUST use an IDE for these projects! You can pick your favorite IDE but the instructions below are for eclipse, which is a very good IDE available for free for any platform.
2. Download and install the Space Settlers code.
   • The code is stored in a github repository. It is good for your future jobs to know how to use existing code bases and how to work with a repository. Your next step is to download the latest code from the github repository (URL below). The advantage of the online repository is that you will have access to bug fixes. For all projects, both finding and fixing bugs will get you extra credit. You can submit your bug reports using github but you can also submit them via email (more on that in future projects).
   • If you have never used git before, please look up tutorials online. git support is incorporated into eclipse so you should be able to clone the repository directly from eclipse. The main commands you will need to know are: clone and pull. You will NOT be checking any changes directly into the code base this semester so you do not need to worry about push or commit.
   • Note: if you fork the repository into your own GitHub account, ensure the fork is private. You can make private repositories with an academic email account for free with GitHub.  If you make a public fork, anyone else in class can see your code. This can be used for academic misconduct and thus we will give you a zero for any non-private forks we can see (see rubric below)
3. You can test your download of the code in either of two ways.
   1. You can go to the directory where you downloaded the code and type:
      • ant spacesettlers-human
      • Note that this method of compilation requires the “ant” program, which can be obtained at:
   2. You can also run it from eclipse by right clicking on the build.xml file in eclipse and choosing the second ‘run as ant build’ option. Then choose ‘spacesettlers-human‘.
      • Note: if neither method works, you have either not properly downloaded the code or you need ant or java installed properly.
4. Create a controllable agent (e.g. something that controls an agent) that makes legal moves. For this project, it is perfectly acceptable to reuse the sample random agent. The point of this project is to ensure you can get the mechanics of your player working, not that you have made the world’s smartest player. Note that although the ladder will run once for this project, it will NOT count for extra credit. You can find the sample random agent at:
   • spacesettlers.clients.RandomTeamClient
     • Your agent needs to run in its own package. This package MUST be your 4×4. If you copy the random agent, be sure to change the package header to be:
     • package your4x4;
   • All of your code must run in a single package based on your OU 4×4 id. To compile and run your code with the spacesettlers code create a directory under spacesettlers/src with your 4×4 such as spacesettlers/src/your4x4. Place your java source files in this directory.
5. To make the simulation know about your new agent, you also need an initialization and configuration file. There is a sample init file in the config/human subdirectory. You should copy random-clientinit.xml and point it to your own agent. Name the file spacesettlersinit.xml. Then you need to change SpaceSettlersConfig.xml to point to your new agent and config file. Make sure you change the ladderName setting to something with your name in it so that I can give you full credit. The ladder name can be funny but it must follow two rules:
   • It must be G-rated and contain nothing offensive or derogatory
   • It must contain your name somehow so that we can properly give you a grade (e.g. Team Winner doesn’t tell me who you are unless your name happens to be Winner!)
6. Submit your project on the AWS server using the submit script as described below. Note this server is NOT a webserver. You must login as described below.
   1. ssh into spacesettlers.cs.ou.edu using the account that was created for you for this class. Your username is your 4×4. This should be a passwordless login because it relies on your ssh keys. If you did not create your account in part 0, contact Matt immediately. He cannot create accounts at the last minute and you will not get credit for the assignment if you do not check this ASAP.
      • To login to the server, either use ssh at a terminal window (mac or linux) or use an ssh client such as putty (windows)
      • The address is spacesettlers.cs.ou.edu. Your username is your 4×4.
   2. Make sure your working directory contains all the files you want to turn in. For example, my directory contained the following files:
      • AmysRandomAgent.java spacesettlersinit.xml
   3. You must copy the files from your laptop or desktop to the spacewar machine. To do this, you can use the scp command (mac, linux) or the pscp or winscp program (windows). Make sure you copy the files to a directory that does not allow everyone else to read your files!
   4. Submit your file using the following command (be sure your java files come last):

      • /home/spacewar/bin/submit --config_file spacesettlersinit.xml --project project0 --java_files YourJavaFiles.java

   5. After the project deadline, the above command will not accept submissions. If you want to turn in your project late, use:

      /home/spacewar/bin/submit --config_file spacesettlersinit.xml --project project0_late --java_files YourJavaFiles.java

We will run a sample ladder after 12:01AM on Sep 6. This ladder will not count for extra-credit points as the focus of this part of the assignment is to make sure that your accounts are setup correctly and that the ladder is able to run each of your players. If you do not see your agent in the final ladder that we post on #annoucements, you will want to fix it before Project 1!

Note, your grade for this part of the project will show up on canvas in Project 0: Part 2 but you will NOT turn your files in there.  You must turn them in as described above!