战国 Mod 开发文档

工具表

各发行版暴露给模型的工具清单。

每个发行版实际暴露给模型的工具。模型看到的工具表就是这里这份。

native 发行版

工具归属只读说明
buildnative:buildings否在本国地块入队建造:site 传地名或 "x y" 坐标串,或直接传两个整数 x、y。立即预付全部材料并锁价,回合末统一开工(每地块同时只开一项),完工在结算内完成,从下一周期开始生产。与 queue_build 等价(单条入队);取消未开工用 cancel_build_order 全退。造价、门槛查 building_catalog,全部收益查 building_economics。
cancel_build_ordernative:buildings否取消construction_queue中的未开工建筑id,预付材料全额退回。已开工条目拒绝此操作,须用demolish按50%拆除;城堡从最高一级取消。
demolishnative:buildings否按id拆除本国建筑或取消待建:未开工待建全额退回且不占本格本期施工额度;已开工退回实际材料50%(可含半单位),完工0%。城堡从最高一级拆起;拆除最后市政厅可能导致亡国。编号查building_sites或construction_queue。
economynative:economy-queries否经济命令:action 选动作,其余参数按该动作需要。行情用 query(panel=market),库存与报表用 query(panel=econ/report)。经济行动
end_turnnative:government否结束本国行动。AI 的 summary 只用一两句概括本回合实际执行的结果与关键待结算事项;详细行动已有回执,不重复国策、逐格清单或下回合战略。AI 必须先有有效国策;正式绑定的真人可省略 summary、无需国策。结束后,未回应的已收到外交提议与未表态的联盟投票在回合末按行动轮换次序统一自动处理(拒绝/反对),与谁先结束行动无关。
intelligencenative:intelligence否对外通信与谍报:action 选动作,其余参数按该动作需要。各国 id 用 query(panel=foreign) 查,结果在 intel 面板。对外通信与谍报
militarynative:army否军队命令:action 选动作,其余参数按该动作需要。征召材料、军队编号、路径与战斗信息用 query 查(army/unit_catalog/reachable/battle)。军队行动
plannative:government否提交持久国策:写未来多回合的经济、军事、情报与外交战略,明确目标、优先级、资源约束和调整条件,依据事实而非编造。不是本回合流水账。到期或战略变化时修订,已有有效国策无需反复提交。
querynative:query是只读查询统一入口:panel 选面板,其余参数、必填项和说明见对应分支。已有资料无需重复查询;唯一按单格查询的是 tile。
queue_buildnative:buildings否将建筑加入本国地块正式队列,立即按当时造价预付全部材料并锁价,回合末统一开工(每地块同时只开一项,未开工的排到以后各期末且不再扣款)。预占建筑及资源位,每格每期仍只动工一次。未开工取消全退,已开工拆除50%,完工0%。与 build 等价(单条入队);查询construction_queue,取消用cancel_build_order。
relationsnative:diplomacy否外交命令:action 选动作,其余参数按该动作需要。当前联盟、条约、战争、提议编号与投票用 query(panel=foreign) 查。外交行动

experimental 发行版

工具归属只读说明
buildnative:buildings否在本国地块入队建造:site 传地名或 "x y" 坐标串,或直接传两个整数 x、y。立即预付全部材料并锁价,回合末统一开工(每地块同时只开一项),完工在结算内完成,从下一周期开始生产。与 queue_build 等价(单条入队);取消未开工用 cancel_build_order 全退。造价、门槛查 building_catalog,全部收益查 building_economics。
cancel_build_ordernative:buildings否取消construction_queue中的未开工建筑id,预付材料全额退回。已开工条目拒绝此操作,须用demolish按50%拆除;城堡从最高一级取消。
demolishnative:buildings否按id拆除本国建筑或取消待建:未开工待建全额退回且不占本格本期施工额度;已开工退回实际材料50%(可含半单位),完工0%。城堡从最高一级拆起;拆除最后市政厅可能导致亡国。编号查building_sites或construction_queue。
economynative:economy-queries否经济命令:action 选动作,其余参数按该动作需要。行情用 query(panel=market),库存与报表用 query(panel=econ/report)。经济行动
end_turnnative:government否结束本国行动。AI 的 summary 只用一两句概括本回合实际执行的结果与关键待结算事项;详细行动已有回执,不重复国策、逐格清单或下回合战略。AI 必须先有有效国策;正式绑定的真人可省略 summary、无需国策。结束后,未回应的已收到外交提议与未表态的联盟投票在回合末按行动轮换次序统一自动处理(拒绝/反对),与谁先结束行动无关。
explain_plannative:government否议会拒绝国策后说明原因和修正打算,text 为解释正文。解释后方可结束本期;解释不替代新版国策,不会触发本期第二次审核。
intelligencenative:intelligence否对外通信与谍报:action 选动作,其余参数按该动作需要。各国 id 用 query(panel=foreign) 查,结果在 intel 面板。对外通信与谍报
militarynative:army否军队命令:action 选动作,其余参数按该动作需要。征召材料、军队编号、路径与战斗信息用 query 查(army/unit_catalog/reachable/battle)。军队行动
plannative:government否提交持久国策:写未来多回合的经济、军事、情报与外交战略,明确目标、优先级、资源约束和调整条件,依据事实而非编造。不是本回合流水账。到期或战略变化时修订,已有有效国策无需反复提交。
querynative:query是只读查询统一入口:panel 选面板,其余参数、必填项和说明见对应分支。已有资料无需重复查询;唯一按单格查询的是 tile。
queue_buildnative:buildings否将建筑加入本国地块正式队列,立即按当时造价预付全部材料并锁价,回合末统一开工(每地块同时只开一项,未开工的排到以后各期末且不再扣款)。预占建筑及资源位,每格每期仍只动工一次。未开工取消全退,已开工拆除50%,完工0%。与 build 等价(单条入队);查询construction_queue,取消用cancel_build_order。
relationsnative:diplomacy否外交命令:action 选动作,其余参数按该动作需要。当前联盟、条约、战争、提议编号与投票用 query(panel=foreign) 查。外交行动
scriptexperimental:python否本国脚本:action=write 保存源码、patch 精确替换一处、check 免费查语法、status 查状态、run 执行。脚本在沙盒内用 api.call(capability, method, ...)/observe、inputs、print;每回合一次执行额度。

minigame 开发模式

工具归属只读说明
armymini:army是只读部队:列出本国与各国现役部队(编号、兵种、HP、所在格),本国部队排在前面。
attackmini:army否进攻:unit 是本国部队编号,x、y 是目标格。只能攻击交战国的地块,且目标格须与该部队相邻;守军被歼灭即占领该格。
buildmini:buildings否在本国地块上动工:x、y 是地块坐标,kind 是建筑种类(查 catalog)。只能建在本国地块上,材料不足会返回原因。
catalogmini:buildings是只读图鉴:建筑种类与造价产出、兵种属性、地形种类。建造与征兵前先查这里。
declare_warmini:diplomacy否向另一国宣战:target 是对方国家 id(查 nations)。只有交战国之间才能进攻对方地块,议和后方可再战。
diplomacymini:diplomacy是只读外交:当前与哪些国家交战。本作没有同盟、条约、提议与投票;wars 里 attackers 是宣战方,defenders 是被宣战方。
end_turnmini:government否结束本国行动。summary 只用一两句概括本回合实际做了什么,不要重复逐条流水账;细节已有回执。
governmentmini:government是只读回合状态:当前是第几期、本国本回合是否已经结束行动。
landmini:territory是只读本国地块:本国每块地的位置、地形与已建建筑。
make_peacemini:diplomacy否与另一国议和:target 是对方国家 id(查 nations)。议和立即生效。
move_armymini:army否调动本国部队:unit 是部队编号,x、y 是目标格,只能移到相邻格。
nationsmini:nations是只读各国:所有国家的 id、名称与是否存续。宣战、议和的 target 用这里的 id。
newsmini:intelligence是只读近讯:按时间倒序的事件流(亡国、宣战、占地等),只含公开事件与涉己事件。
recruitmini:army否在本国地块上征一个步兵:x、y 是地块坐标,该地块必须有兵营。征兵耗粮与金(查 catalog),资源不足会返回原因。
stockmini:resources是只读资源存量:返回本国当前的钱、粮、木各有多少。建造与征兵都从这些存量里扣。
viewmini:territory是只读地图:逐格列出全图地块(坐标、归属、地形、建筑)。本作没有视野限制,全图皆可见;进攻只能落在交战国的地块上。

stock 发行版(模拟炒股)

工具归属只读说明
bankstock:portfolio否银行:action=borrow 借钱、repay 还钱。借钱要算利息,也会放大强制平仓的风险。
computestock:compute否用游戏现金租计算资源:action=buy/release,kind=pool/slot。只在本回合有效,下回合归零重买;研究槽按次收费,不用购买。
compute_statusstock:compute是本账户算力池、交易槽、共享额度用量、研究次数与剩余次数,以及各档价格。
day_reportstock:market是上一交易日的执行回执:自己委托各状态笔数(成交/部分成交后到期/撤单)、成交笔数、买入卖出股数与金额、手续费。用来核对策略是否按预期执行。
end_turnstock:clock否结束本回合行动,提交一句小结(这回合做了什么、打算做什么)。结算在所有玩家都结束以后统一进行。
intelstock:intelligence否商业谍报:action=steal 获取对方现金/贷款/持仓快照,action=source 随机偷取对方策略源码片段;target=其他玩家id,各自按公布价格付费。
intel_statusstock:intelligence是公开玩家名单、快照与源码偷取价格及自己已购买的报告,含获取时间。
marketstock:market是当前行情:每只股票的现价、昨收、涨跌、ma5/ma10/ma20 均线、动量、已实现波动率、盘口深度十档、可借券余额、退市复核日,以及每只股票已公布的消息(市场快讯/公司快讯/财报/公司事件,含现金流变化百分比与个性变化)和公开财报日程(next_report_round 与当日 report_tick)。股票池是动态的:api.call("stock:market","pool") 查询当前名单、下一只新股(名称/行业/发行价/挂牌回合)和退市警示名单。
poolstock:market是动态股票池:当前交易名单、下一只新股(名称/行业/发行价/挂牌回合)与退市警示名单(股票及复核回合)。新股挂牌和退市摘牌都会先公开公告。
portfoliostock:portfolio是自己的账户:现金、负债、每只持仓的数量与成本、当前市值与浮盈亏、总财富与收益率、授信额度、追保线、已付利息、最近的净值曲线与强平记录。
roundstock:clock是回合日历与窗口额度:第几个回合、今天开市还是休市、离下次开盘还有几回合、共同tick、交易时刻与盘前规划动作的已用额度。
scriptstock:python否计算槽:write保存、patch修订(均自动检查并返回结果)、read免费读取自己当前源码、status查结果;slot为1~4或research。自动交易槽仅在交易日执行,休市不执行;定义def on_tick():则按sleep间隔回调,state是独立持久JSON字典。沙盒Python子集:无f-string/lambda/set/try/class/import;排序用 def 具名函数作 key=,字符串用+拼接。api.call("stock:clock","sleep",ticks=N)只安排下次回调,回调应返回,不写while等待。run仅手动运行已解锁的research槽,用于分析和回测,只读不下单。交易日全体结束后沿20000共同tick自动运行,委托最早下一tick生效,成交立即可见。沙盒是Python子集:无try/except、class、import、with、lambda、f-string;内置函数与方法清单见规则「Python 策略与研究槽」,写之前先核对。
script_readstock:python是免费读取自己指定槽的完整当前源码和版本;slot 为 1~4 或 research,默认 1。
script_statusstock:python是本国脚本状态:最近一次执行的回合及结果(打印输出、报错类型与行列)、源码版本与预算;include_source=true 查看源码