Lux Design S1
1.0.0
夜晚是黑暗的，充滿了恐怖。兩支球隊必須與黑暗進行戰鬥，收集資源並在各個年齡段中前進。白天發現迫切需要收集和建立可以帶您度過即將到來的夜晚的資源。計劃和仔細擴展 - 任何未能產生足夠光線的城市都將被黑暗所消耗。
歡迎來到Lux AI挑戰賽第1季！
Lux AI挑戰賽是一場競爭，競爭對手設計代理商在1V1場景中針對其他競爭對手解決了多變量優化，資源收集和分配問題。除了優化外，成功的代理商還必須能夠分析對手並製定適當的政策以獲得優勢。
要開始，請轉到我們的入門部分。比賽將持續到2021年12月6日，提交時間為UTC，在比賽頁面上的UTC下午11:59：https：//www.kaggle.com/c/lux-ai-2021
多虧了我們的讚助商Quartco，J Ventures和Qaimera，我們今年還有10,000美元的獎金以及許多其他非貨幣獎品！有關更多信息，請參見https://www.lux-ai.org/sponsors-2021
確保在https://discord.gg/awjt3uacgn上加入我們的社區不和諧，與其他競爭對手一起聊天，策略和學習！我們將在Kaggle論壇和Discord上發佈公告。
這是由Lux AI挑戰團隊使用Dimensions軟件包構建的。
第1季的規格可以在此處找到：https：//lux-ai.org/specs-2021。這些詳細說明了遊戲的工作原理以及您的代理商必須遵守什麼規則。
您將需要Node.js版本12或更高版本。請參閱此處的安裝說明，您只需下載推薦版本即可。
下一個部分詳細介紹了推薦的設置，以開發和競爭您的機器人。對於希望使用Python和Jupyter筆記本 / Kaggle交互式筆記本的用戶，請隨時跳過本節並關注教程筆記本
打開命令行，並使用
npm install -g @lux-ai/2021-challenge@latest
您可能會忽略任何出現的警告，這些警告是無害的。要從命令行（CLI）運行匹配項，只需運行
lux-ai-2021 path/to/botfile path/to/otherbotfile
比賽將使用一些記錄和存儲錯誤日誌以及新的errorlogs文件夾中的重播並replays夾進行運行。存儲在錯誤記錄中的日誌將包括所有錯誤輸出以及您的代理商打印到標準錯誤的所有內容。您可以使用我們的可視化器觀看重播文件夾中存儲的重播。要查看本地重播，請在此處遵循說明https://github.com/lux-ai-challenge/luxviewer2021/
有關CLI的命令的完整列表，請運行
lux-ai-2021 --help
或轉到下一節以查看有關如何使用命令行工具的更多說明，包括生成狀態重播和運行本地排行榜進行評估。您也可以使用此存儲庫中的cli.sh文件在Docker中運行所有這些，請參見此處的說明。
每種編程語言都有一個入門套件，您可以在此處找到一般API文檔：https：//github.com/lux-ai-challenge/lux-design-2021/tree/master/master/kits
此存儲庫中的套件文件夾可容納您可以使用的所有可用入門套件，以開始競爭和構建AI代理，並向您展示如何使用您的選擇的語言開始並與該機器人進行匹配。我們強烈建議您在下面的鏈接中仔細閱讀您首選語言的文檔
還有許多社區提供的工具來幫助人們建造更好的機器人，隨時檢查這些工具並使用適合您需求的任何東西
想使用另一種語言，但不支持嗎？隨意向我們的問題建議使用該語言，甚至更好，為社區創建一個入門套件，以便使用該儲存庫。有關此信息的更多信息，請參見我們的貢獻。
要及時了解競爭和引擎的更改和更新，請注意論壇或不和諧的公告。請參閱https://github.com/lux-ai-challenge/lux-design-2021/blob/master/changelog.md，以獲取完整的更改日誌。
CLI工具有幾個選項。例如，一個選項是種子，設置100種子，簡單地運行
lux-ai-2021 --seed=100 path/to/botfile path/to/otherbotfile
它將使用種子100進行比賽。
您可以告訴CLI工具是存儲代理日誌還是通過--storeLogs, --storeReplay進行匹配。將這些布爾選項設置為這樣
# to set to true
lux-ai-2021 --statefulReplay
# to set to false
lux-ai-2021 --storeLogs=false
默認情況下，該工具將生成最小的，基於操作的重型，大小較小且可在可視化器中工作，但它沒有狀態信息，例如在每個回合中地圖上的資源。要生成狀態重播，請將--statefulReplay選項設置為true。要將基於動作的重播轉換為狀態重錄，請將--convertToStateful選項設置為TRUE，然後將文件傳遞到轉換。
選擇通過設置--out=path/to/file.json存儲重播文件的位置
您還可以通過設置數字--loglevel=x從0到4更改記錄級別。默認值為2，它將打印為終端所有遊戲警告和錯誤。
您可以運行自己的本地排行榜 /錦標賽以一次評估多個機器人
lux-ai-2021 --rankSystem="trueskill" --tournament path/to/agent1 path/to/agent2 path/to/agent3 path/to/agent4 ...
這將運行由Trueskill排名的排行榜，並將結果打印為您的控制台的表。代理商與具有相似評分的對手匹配。建議添加--storeReplay=false --storeLogs=false因為讓此運行很長時間會產生大量的重播和日誌文件。
有關更多選擇，請參見lux-ai-2021 --help 。
該工具與lux-ai-2021完全匹配，但在Ubuntu 18.04上運行，這是競爭服務器使用的目標系統。確保首先安裝Docker
然後，要使用Lux-ai-2021 CLI工具，只需致電bash cli.sh ，它將接受相同的參數。在第一次運行中，它將構建Docker映像並在後台運行一個容器。未來的運行將會更快。此外，這使用綁定安裝座，因此您可以在計算機上本地編輯文件，它們將反映在Docker容器中，反之亦然。
該工具的唯一警告是，它無法訪問當前工作目錄（ pwd命令的輸出）之上的目錄中的文件。
此外，此工具將不會在您的計算機上繼承同一安裝的Python軟件包。要添加軟件包，請從此存儲庫中將Dockerfile下載到與cli.sh文件相同的目錄中，然後將安裝命令添加到文件的底部
RUN pip3 install <package_name>
更改Dockerfile後，運行bash cli.sh clean以清潔舊的Docker東西，然後像往常一樣使用cli.sh
這是我們社區建立的所有社區工具的列表！
請參閱有關貢獻的指南
第1季的原始設計由Bovard和Stone構想
ISA的UI/UX設計
在大衛的平衡測試幫助下
我們要感謝今年的3個贊助商，Quontco，J Ventures和Qaimera，允許我們為競爭對手提供獎金和激動人心的機會！有關它們的更多信息，請在此處查看：https：//www.lux-ai.org/sponsors-2021
如果您在工作中使用Lux AI第1季環境，請引用此存儲庫
@software{Lux_AI_Challenge_S1,
author = {Doerschuk-Tiberi, Bovard and Tao, Stone},
month = {7},
title = {{Lux AI Challenge Season 1}},
url = {https://github.com/Lux-AI-Challenge/Lux-Design-2021},
version = {1.0.0},
year = {2021}
}
