Merge branch 'master' into 'config-checker'

# Conflicts:
#   playground/misc/misc-3-release-notes.md

Author: Julien Poulton

engine/core/src/main/java/com/codingame/gameengine/core/GameManager.java

@@ -371,9 +371,13 @@ public final void putMetadata(String key, String value) {
      * 
      * @param frameDuration
      *            The frame duration in milliseconds.
+     * @throws IllegalArgumentException
+     *             if frameDuration <= 0
      */
     public void setFrameDuration(int frameDuration) {
-        if (this.frameDuration != frameDuration) {
+        if (frameDuration <= 0) {
+            throw new IllegalArgumentException("Invalid frame duration: only positive frame duration is supported");
+        } else if (this.frameDuration != frameDuration) {
             this.frameDuration = frameDuration;
             currentViewData.addProperty("duration", frameDuration);
         }

playground/misc/misc-3-release-notes.md

@@ -6,9 +6,11 @@ The CodinGame SDK is regularly updated and improved. This document lets you know
 
 ### 🐞 Bug fix
 
+- Included missing `addAgent` polymorphism – custom nickname with default avatar.
 - Improved display of player output in local test page.
 - Better handling of errors from initializing modules
 - Unused `title` property no longer mandatory in `config.ini`
+- `setFrameDuration()` now throws an exception on non-positive values.
 
 ## 3.3.1
 

runner/src/main/java/com/codingame/gameengine/runner/MultiplayerGameRunner.java

@@ -106,6 +106,32 @@ public void addAgent(Class<?> playerClass, String nickname, String avatarUrl) {
     public void addAgent(String commandLine, String nickname, String avatarUrl) {
         addAgent(new CommandLinePlayerAgent(commandLine), nickname, avatarUrl);
     }
+    
+    /**
+     * Adds an AI to the next game to run, with the specified nickname.
+     * 
+     * @param playerClass
+     *            the Java class of an AI for your game.
+     * @param nickname
+     *            the player's nickname
+     */
+    public void addAgent(Class<?> playerClass, String nickname) {
+        addAgent(new JavaPlayerAgent(playerClass.getName()), nickname, null);
+    }
+
+    /**
+     * Adds an AI to the next game to run, with the specified nickname.
+     * <p>
+     * The given command will be executed with <code>Runtime.getRuntime().exec()</code>.
+     * 
+     * @param commandLine
+     *            the system command line to run the AI.
+     * @param nickname
+     *            the player's nickname
+     */
+    public void addAgent(String commandLine, String nickname) {
+        addAgent(new CommandLinePlayerAgent(commandLine), nickname, null);
+    }
 
     @Override
     protected void buildInitCommand(Command initCommand) {