在“碳达峰”、“碳中和”提出的大背景下，应加快节能降耗脚步，进而实现二氧化碳减排目标。有两位玩家为了帮助A省减排，决定成立各自的捕碳小组。
初始时，二氧化碳对称地分布在地图上，选手对称分布在地图左上方和右下方。
随后，选手可控制捕碳员去收集二氧化碳，然后将收集到的二氧化碳运送回转化中心并产生收益；可控制种树员去种树，然后将树吸收的二氧化碳实时转化为收益。
当游戏进行了300回合或者场上只剩下一个选手时，游戏结束，此时具有最多收益的选手获胜。
- 地图大小为 15 x 15，地图的坐标原点为左下角，横轴为x轴，纵轴为y轴，且地图无边界。
- 游戏开始时，二氧化碳随机对称地分布在地图四周，且地图的每个单元格初始二氧化碳上限为50万吨，二氧化碳分布对选手不可见。
- 游戏开始时，每位选手拥有2个二氧化碳转化中心和80万现金。选手1的转化中心分布在地图左上方和右下方，选手2的转化中心对称分布在地图左下方和右上方，且分布位置固定。
- 游戏过程中，地图上每个单元格最多能容纳100万吨二氧化碳。如果当前单元格上没有捕碳员或种树员停留，也没有树或转化中心，则当前单元格的二氧化碳会以3%的速度再生，直至最大容量100万吨。
智能体角色，用来把捕碳员运输回来的二氧化碳，通过高压处理用于油气资源采集，每转化1万吨二氧化碳可获得1万收益。
转化中心可招募种树员和捕碳员共计10位，为其工作获得更多的收益。
| 动作 | 指令 | 花费（单位：万） |
|---|---|---|
| 招募捕碳员 | RECCOLLECTOR | 30 |
| 招募种树员 | RECPLANTOR | 30 |
智能体角色，被招募后以其所在组的转化中心为起始出发点，可进行上、下、左、右移动，可种树或抢树。
| 动作 | 指令 | 花费（单位：万） | 备注 |
|---|---|---|---|
| 向上移动 | UP | 0 | |
| 向下移动 | DOWN | 0 | |
| 向左移动 | LEFT | 0 | |
| 向右移动 | RIGHT | 0 | |
| 种树 | 无 | 20 | 该玩家无树的时候,首轮种树的价格 |
| 种树 | 无 | 20 + 5 * 1.235 ** n, n为本轮次所有玩家存活树的数量 | 该玩家拥有树的时候,种树价格 |
| 抢树 | 无 | 20 |
智能体角色，被招募后以其所在组的转化中心为起始出发点，可进行上、下、左、右移动，或捕碳。
| 动作 | 指令 | 花费（单位：万） |
|---|---|---|
| 向上移动 | UP | 0 |
| 向下移动 | DOWN | 0 |
| 向左移动 | LEFT | 0 |
| 向右移动 | RIGHT | 0 |
| 捕碳 | 无 | 0 |
非智能体角色，寿命为50回合，由种树员按一定金额种下（也可由对方种树员按一定金额抢夺）。
- 树被种下后，下一轮开始可阻止其周围4个单元格（四邻域,如下图黄色区域）CO2增长，并基于单元格中CO2按一定吸收率实时转化为收益。
- 树周围的8个单元格（八邻域，如下图蓝色区域）若有对方捕碳员经过，则以一定吸收率吸收捕碳员所携带的CO2，并实时转化为收益
| 角色 | 被吸收的对象 | 吸收率 | 吸收区域 | 收益 | 备注 |
|---|---|---|---|---|---|
| 树 | 单元格CO2 | 3.75% | 四邻域(黄色区域) | 直接收益 | 若单元格正在捕集,则不吸收该单元格 |
| 树 | 捕碳员携带的CO2 | 10% | 八邻域及树的位置(蓝色区域) | 直接收益 | 仅吸取敌方捕碳员携带的CO2 |
| 捕碳员 | 捕碳员所在单元格CO2 | 30% | 捕碳员停留的单元格上 | 运回转化中心获取收益 |
仅在智能体视野中的CO2，会被玩家观察到；视野之外为0 (observation.carbon字段)
| 角色 | 视野 | 备注 |
|---|---|---|
| 转化中心 | 无 | |
| 捕碳员 | 当前位置 | |
| 种树员 | 周围上下左右4单元格 | |
| 树 | 无 |
- 在游戏的每一回合，选手可以给转化中心下达招募捕碳员或种树员的指令，可以给捕碳员和种树员下达往左、往右、往上、往下的指令。
- 转化中心招募捕碳员或种树员人数总计上限为10位，捕碳员和种树员的人数分配由选手自行决定。
- 捕碳员和种树员的移动无边界，可穿透地图直接到达地图的另一边。
- 如果捕碳员没有接收到指令，那么他将停留在原地不动。如果当前停留位置含有二氧化碳，那么他将收集当前位置二氧化碳含量的30%，并将收集到的二氧化碳存储在自身上。每位捕碳员没有二氧化碳存储上限。
- 捕碳员身上的二氧化碳需要运送回转化中心转换成收益，当捕碳员到达转化中心时，二氧化碳会立马转换成收益，此时转换不需要花费现金。
- 如果种树员没有接收到指令，那么他将停留在原地不动。如果当前停留位置没有树和转化中心，并且选手的现金足够种树，那么他将在当前位置种一棵树。种下树后，当前位置的二氧化碳归零。每个种树员没有种树的数量上限。
- 树吸收二氧化碳无边界，可穿透地图吸收地图另一边的二氧化碳。
- 树吸收的二氧化碳转化收益，转化率为 1万吨二氧化碳:1万现金，树周围4个单元格（四邻域，如上图黄色区域）的二氧化碳不再增长。
- 若树周围4个单元格（四邻域，如上图蓝色区域）中有单元格正在被捕碳员捕集二氧化碳，则不吸收此单元格的二氧化碳增长量。
- 树消失后，单元格产生30万吨的二氧化碳，且单元格的二氧化碳从下一轮开始恢复正常增长。
- 当种树员停留在其他选手的树下时，若该名种树员归属玩家的现金足以支付抢树金额，则发生抢树行为。
- 当捕碳员停留在其他选手的树下时，仅仅为停留动作，无抢树行为。
- 当捕碳员或种树员停留在另一选手的转化中心时。若携带有CO2，则本轮次会被净化为另一选手的收益；否则，直接消失。
- 当捕碳员或种树员前往同一单元格，将会产生碰撞(碰撞不区分玩家类型)：
- 种树员与种树员：两者消失
- 种树员与捕碳员：种树员消失,捕碳员存活
- 捕碳员与捕碳员：仅携带CO2量最少的捕碳员存活，其余人员消失；如果携带CO2量最少的捕碳员为两名及以上，则全部消失，且所携带CO2由存活的捕碳员获得；如果没有存活的捕碳员，则掉落在当前单元格（上限100万吨）或被转化中心或树全量吸收，树吸收CO2所获得的收益归树的拥有组所得
- 多名捕碳员与多名种树员：按上述的条件计算。优先级为（携带CO2量少的捕碳员 > 携带CO2量多的捕碳员 > 种树员），每次碰撞计算，胜出者最多为1名。
- 在每一回合，选手能够获取整个地图的所有信息，包括二氧化碳的分布位置，所有捕碳员、种树员、树和转化中心的位置。
在游戏的每一回合，首先判断选手给出的指令是否有效，然后按照以下顺序解析同时发生的动作：
- 转化中心招募种树员/捕碳员，种树员/捕碳员移动
- 按游戏规则，进行碰撞计算
- 捕碳员回转化中心转化收益(不区分捕碳员的队伍类型). (若对方捕碳员无碳,则立即消失)
- 停留动作计算：种树员种树，捕碳员捕碳，种树员抢树
- 树净化4邻域CO2，净化8邻域内对方选手的捕碳员携带的CO2
- 未受影响的单元格CO2正常增长
- 当选手失去所有捕碳员、种树员、树，或者当前转化中心不足以招募捕碳员或种树员时，则会被淘汰。
- 选手给出动作指令的时间为1s，多余1s的时间会统计为超时时间，当超时时间总和大于60s时候，会直接被淘汰。
- 如果选手在中途就被淘汰，那么他的现金数会被赋予一个负数，淘汰时间越早则负数越小，只有完整地和环境交互300回合，才能使用转换成功的现金作为此局的结果。
- 游戏结束时，具有最多现金的选手获胜。
from zerosum_env import make
from zerosum_env.envs.carbon.helpers import *
# 构建环境
env = make("carbon")
# 构建指定参数的环境
# env = make("carbon", configuration={"episodeSteps":300, "size": 21, "randomSeed": 123456,})
# 查看环境的各项参数
config = env.configuration
# 确定地图选手数(只能是2)
num_agent = 2
# 获取自身初始观测状态并查看
obs = env.reset(num_agent)[0].observation
# 将obs转换为Board类从而更好获取信息
board = Board(obs, config)
# 查看当前地图
print("查看当前地图：首位表示格子中的CO2量，B0表示玩家0的转化中心(括号中为玩家金额)，C0-12表示玩家0的12号捕碳员(括号中为携带的CO2量)，"
"P0-1表示玩家0的1号种树员，T0表示玩家0的树 ")
print(board)
# 获取自身对象
me = board.current_player
# 获取自身初始的金额总数
print("获取自身初始的金额总数")
print(me.cash)
# 招募捕碳员
print("招募捕碳员")
for base in me.recrtCenters:
base.next_action = RecrtCenterAction.RECCOLLECTOR
board = board.next()
me = board.current_player
# 查看当前地图
print("查看招募捕碳员后的地图：首位表示格子中的CO2，R0表示玩家0的转化中心，C0表示玩家0的捕碳员，P0表示玩家0的种树员，T0表示玩家0的树")
print(board)
# 获取自身当前的金额总数
print("获取自身当前的金额总数")
print(me.cash)
# 获取自身当前的工人id列表
print("获取自身当前的工人id列表")
print(me.worker_ids)
# 获取自身当前的转化中心id列表
print("获取自身当前的转化中心id列表")
print(me.recrtCenter_ids)
# 获取自身当前的树id列表
print("获取自身当前的树id列表")
print(me.tree_ids)
# 获取自身捕碳员信息
print("获取自身捕碳员信息")
for worker in me.collectors:
print(f"ID: {worker.id}, 类型: {worker.occupation}, 携带的CO2: {worker.carbon}, 坐标: {worker.position}")
# 获取自身种树员信息
print("获取自身种树员信息")
for worker in me.planters:
print(f"ID: {worker.id}, 类型: {worker.occupation}, 携带的CO2: {worker.carbon}, 坐标: {worker.position}")
# 获取自身转化中心信息
print("获取自身转化中心信息")
for base in me.recrtCenters:
print(f"ID: {base.id}, 坐标: {base.position}")
# 获取自身树信息
print("获取自身树信息")
for tree in me.trees:
print(f"ID: {tree.id}, 坐标: {tree.position}, 年龄: {tree.age}")
# 获取所有种树员信息
print("获取所有种树员信息")
for planter in board.planters.values():
print(f"种树员ID: {planter.id}, 类型: {planter.occupation}, 携带的CO2: {planter.carbon}, 坐标: {planter.position}")
# 获取所有捕碳员信息
print("获取所有捕碳员信息")
for collector in board.collectors.values():
print(f"捕碳员ID: {collector.id}, 类型: {collector.occupation}, 携带的CO2: {collector.carbon}, 坐标: {collector.position}")
# 获取所有转化中心信息
print("获取转化中心信息")
for base in board.recrtCenters.values():
print(f"转化中心ID: {base.id}, 坐标: {base.position}, 玩家ID: {base.player_id}")
# 获取所有树信息
print("获取所有树信息")
for tree in board.trees.values():
print(f"ID: {tree.id}, 坐标: {tree.position}, 树龄： {tree.age}, 玩家ID: {tree.player_id}")
# 获取所有co2信息
print("获取所有co2信息")
sum_co2 = 0
for cell in board.cells.values():
print(f"坐标: {cell.position}, CO2: {cell.carbon}, 工人: {cell.worker}, 种树员:{cell.planter}, 捕碳员: {cell.collector}")
sum_co2 += cell.carbon
# 获取当前地图的co2总数
print("获取当前地图的co2总数")
print(sum_co2)
# 需要注意的是，以上通过position属性获取的位置，
# 均以地图左下角为原点, 与np.array的索引不同。from zerosum_env import make
from zerosum_env.envs.carbon.helpers import *
# 构建一个环境
env = make("carbon")
def my_agent(observation, configuration):
board = Board(observation, configuration)
me = board.current_player
# 给自身所有捕碳员下达往上移动的指令
for worker in me.collectors:
worker.next_action = WorkerAction.UP
# 给自身所有种树员下达往下移动的指令
for worker in me.planters:
worker.next_action = WorkerAction.DOWN
# 给自身所有捕碳员下达往左移动的指令
for worker in me.collectors:
worker.next_action = WorkerAction.LEFT
# 给自身所有种树员下达往右移动的指令
for worker in me.planters:
worker.next_action = WorkerAction.RIGHT
# 给自身转化中心下达招募捕碳员的指令
for base in me.recrtCenters:
base.next_action = RecrtCenterAction.RECCOLLECTOR
# 给自身转化中心下达招募种树员的指令
for base in me.recrtCenters:
base.next_action = RecrtCenterAction.RECPLANTOR
# 给环境返回指令
return me.next_actions
# 选取random agent作为对手
# run 函数将会运行300轮
env.run([my_agent, "random"])
# 渲染对战画面(打开jupyter notebook运行此命令才能看到渲染画面)
env.render(mode="ipython")
# 注意的是在提交代码的时候，选手也要将自己的智能体用上述 my_agent 函数的形式封装起来，
# 函数以 observation 和 configuration 作为输入，输出对自身每个工人和转化中心的指令，
# 具体请参考 baseline 中的 submission.py 文件总共有3种异常
- Timeout : 推理时间超出限制
- Error - 代码运行中报错
- Invalid - 非法指令
在构建环境的时候，应当将debug字段设置为True
from zerosum_env import make
def agent():
# 将id为'0-1'的工人指令设为非法字符串
return {"0-1": "bad"}
env = make("carbon", debug=True)
env.run([agent, "random"])
# print Invalid Action: 'bad' is not one of ['RECCOLLECTOR', 'RECPLANTOR', 'UP', 'DOWN', 'RIGHT', 'LEFT']
def agent():
import time
time.sleep(2)
return {}
env = make("carbon", debug=True)
env.run([agent, "random"])
# print Timeout: 输出Timeout信息，因为超过了推理时间限制
def agent():
return "Illegal action"
env = make("carbon", debug=True)
env.run([agent, "random"])
# 不会输出任何错误信息，没有对工人下达指令，因此工人和转化中心的动作为None,不会触发异常
from zerosum_env import evaluate
def agent():
return {}
# Which agents to run repeatedly. Same as env.run(agents)
agents = ["random", agent]
# How many times to run them.
num_episodes = 2
rewards, jsons, htmls, errors = evaluate("carbon", agents, num_episodes=num_episodes)
# 查看rewards可以看到每一局评估，每个选手最后的金额数量