allenai · MarcCote · Jul 13, 2025 · Jul 13, 2025 · Jul 13, 2025 · Jul 13, 2025
diff --git a/README.md b/README.md
@@ -132,6 +132,26 @@ The tasks are listed in the table below along with their number of variations. E
 |  10-1 |                   mendelian-genetics-known-plant |  120 |
 |  10-2 |                 mendelian-genetics-unknown-plant |  480 |
 
+## Simplifications
+ScienceWorld supports a number of simplifications that can be applied to the environment to make it easier for agents to learn. These simplifications can be applied by passing the `--simplifications-preset` argument to the command line interface, or by passing the `simplifications` argument to the Python API.
+
+The available simplifications are:
+- `teleportAction`: Allows agents to instantly move to any location in the environment.
+- `openDoors`: All doors in the environment are open by default.
+- `selfWateringFlowerPots`: Automatically waters all flower pots in the environment.
+- `noElectricalAction`: Disables electrical actions, making it easier for agents to learn tasks that do not require electrical actions.
+- `openContainers`: All containers in the environment are open by default.
+
+The `--simplifications-preset` argument can be set to `easy` to apply the following simplifications:
+- `teleportAction`
+- `openDoors`
+- `selfWateringFlowerPots`
+- `noElectricalAction` (for non-connectivity tasks)
+
+> [!WARNING]
+> The `easy` preset differs from what is described in the paper (see Appendix B.5). The `openContainers` is not included in that preset and should manually be added if desired.
+
+
 # Baseline Agents
 **DRRN:** https://github.com/cognitiveailab/drrn-scienceworld
 
@@ -140,3 +160,29 @@ The tasks are listed in the table below along with their number of variations. E
 **CALM:** https://github.com/cognitiveailab/calm-scienceworld
 
 **Behavior Cloning and Decision Transformer:** https://github.com/cognitiveailab/t5-scienceworld
+
+
+
+# Developers
+
+To compile the ScienceWorld JAR file, follow these steps:
+
+### Prerequisites
+You will need to have `Java 1.8+` SDK installed on your system (shipped with most linux distributions). E.g. on Ubuntu, you can install it with:
+
+    sudo apt-get install openjdk-21-jdk
+
+Then, install sbt (Scala Build Tool) by running:
+```bash
+    echo "deb https://repo.scala-sbt.org/scalasbt/debian all main" | sudo tee /etc/apt/sources.list.d/sbt.list
+    echo "deb https://repo.scala-sbt.org/scalasbt/debian /" | sudo tee /etc/apt/sources.list.d/sbt_old.list
+    curl -sL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x2EE0EA64E40A89B84B2DF73499E82A75642AC823" | sudo tee /etc/apt/trusted.gpg.d/sbt.asc
+    sudo apt-get update
+    sudo apt-get install sbt
+```
+
+### Building the JAR
+Once you have `sbt` installed, you can compile the ScienceWorld JAR file by running:
+```bash
+./simulator/package.sh
+```
diff --git a/examples/human.py b/examples/human.py
@@ -191,8 +191,11 @@ def parse_args():
                         help="Number of episodes to play. Default: %(default)s")
 
     simplification_group = parser.add_argument_group('Game simplifications')
-    simplification_group.add_argument("--simplifications-preset", choices=['easy'],
-                                      help="Choose a preset among: 'easy' (apply all possible simplifications).")
+    simplification_group.add_argument(
+        "--simplifications-preset", choices=['easy'],
+        help="Choose a preset among:\n"
+             "'easy' (teleportAction,openDoors,selfWateringFlowerPots,noElectricalAction)."
+    )
     simplification_group.add_argument("--teleport", action="store_true",
                                       help="Lets agents instantly move to any location.")
     simplification_group.add_argument("--self-watering-plants", action="store_true",

diff --git a/examples/random_agent.py b/examples/random_agent.py
@@ -182,8 +182,11 @@ def parse_args():
                         help="Maximum number of episodes per transcript file. Default: %(default)s")
 
     simplification_group = parser.add_argument_group('Game simplifications')
-    simplification_group.add_argument("--simplifications-preset", choices=['easy'],
-                                      help="Choose a preset among: 'easy' (apply all possible simplifications).")
+    simplification_group.add_argument(
+        "--simplifications-preset", choices=['easy'],
+        help="Choose a preset among:\n"
+             "'easy' (teleportAction,openDoors,selfWateringFlowerPots,noElectricalAction)."
+    )
     simplification_group.add_argument("--teleport", action="store_true",
                                       help="Lets agents instantly move to any location.")
     simplification_group.add_argument("--self-watering-plants", action="store_true",

diff --git a/scienceworld/scienceworld.jar b/scienceworld/scienceworld.jar
diff --git a/setup.py b/setup.py
@@ -40,6 +40,7 @@
     install_requires=open('requirements.txt').readlines(),
     extras_require={
         'webserver': open('requirements.txt').readlines() + ['pywebio'],
+        'dev': open('requirements-dev.txt').readlines(),
     },
     classifiers=[
         "Programming Language :: Python :: 3",

diff --git a/simulator/build.sbt b/simulator/build.sbt
@@ -1,6 +1,6 @@
 name := "scienceworld-scala"
 
-version := "1.2.2"
+version := "1.2.3"
 
 scalaVersion := "2.12.9"
 

diff --git a/simulator/src/main/scala/scienceworld/runtime/SimplifierProcessor.scala b/simulator/src/main/scala/scienceworld/runtime/SimplifierProcessor.scala
@@ -54,7 +54,7 @@ class SimplificationOpenContainers extends Simplification(label = SIMPLIFICATION
     val allObjs = universe.getContainedObjectsAndPortalsRecursive(includeHidden = true, includePortalConnections = true)
     for (obj <- allObjs) {
       obj match {
-        case x:Portal => {
+        case x:EnvObject => {
           if ((x.propContainer.isDefined) && (x.propContainer.get.isContainer) && (x.propContainer.get.isClosable)) {    // If an object is a container that's closable
             x.propContainer.get.isOpen = true                                    // Open it
           }