AgentCraft

An adaptive settlement creation using a social agent simulation in Minecraft! This is my entry for the 2021 Generative Design in Minecraft competition (it placed 2nd). Video demos:

• Valley Settlement
• Mountain Settlement
• Supercut
• Misc
• Paper

How to Run

Tested on Minecraft 1.16.5, Python 3.9

Install Dependencies

Install the following packages with setup.py:

python3 setup.py install

or download the dependencies manually:

pip install bitarray numpy names nbt requests scipy wonderwords

Install Forge

Download and install Minecraft Forge for 1.16.5 here.

You need to own a copy of Minecraft (Java Version) and have it installed on your machine.

Get the Forge Mod Launcher (Download Recommended -> Installer) and install it (client install, but server should work, too). The latest version I tested is 1.16.5-36.1.0, but newer versions should work, too.

Open your Minecraft Launcher, the Forge Installation should have appeared there.

Open your mod folder. To do this open the Forge Installation you just installed and click the "Mods" button and then the "Open mods folder" button (You can skip this step by just navigating to %APPDATA%/.minecraft/mods).

Move .jar file from this repository into the mod folder.

Restart Minecraft and launch the Forge Installation again. The mod should now appear in the mod list under "Mods".

When you open a world the HTTP Server will be started automatically, and you should now be able to send HTTP requests to it.

After Forge and the Mod are set up, you can use the following command from this project's folder:

Usage

Options:
     -a X1,Y1,X2,Y2   |  Set the generator's build AREA in the running Minecraft world. Avoid spaces in between numbers.
     -t SECONDS       |  Set the TIME limit for the generator's execution. 
     -s STEPS         |  Set the number of TIME-STEPS the generator takes. 
     -f FRAMELENGTH   |  Set the duration of each frame of render.  seconds
     --norender       |  Disable per-frame rendering (for performance) 
     --nochronicle    |  Disable writing to chronicle
     --printchronicle |  Write the chronicle's output to console
     --leavesign      |  Render a sign at the center of the given area describing the location of the settlement.

Example:
     python3 run.py -a 0,0,200,200 -t 590 -s 2000 -f 0.4 --leavesign

Credits

Thank you:

• Max Kreminski, my academic advisor for this project
• Nevas Buildings for their permission to use and edit their beautiful buildings
• Nils Gawlik for their http server, which let's me communicate with a running Minecraft process
• Asiiah Song & Jim Whitehead for their TownSim generator, which largely inspired the road generation system
• Troy, Ryan, & Trent for their pathfinding code in their 2020 entry
• Blinkenlights for help structuring the project