霸业API及函数手册

baye.data.g_FightMap[]数据项

baye.data.g_FightPath[]数据项

baye.data.g_FgtAtkRng[]数据项

baye.data.g_TileId数据项

baye.data.g_EneTmpProv数据项

baye.data.g_MapWid数据项

baye.data.g_MapHgt数据项

baye.data.g_FightMapData[]数据项

baye.data.g_screenWidth数据项

baye.data.g_screenHeight数据项

baye.data.g_FlipDrawing数据项

baye.data.g_disablePushMessage数据项

baye.data.g_MenuTouchComfirm数据项

baye.data.g_FoucsX数据项

baye.data.g_FoucsY数据项

baye.data.g_MapSX数据项

baye.data.g_MapSY数据项

baye.data.g_PathSX数据项

baye.data.g_PathSY数据项

baye.data.g_PUseSX数据项

baye.data.g_PUseSY数据项

baye.data.g_BakUpX数据项

baye.data.g_BakUpY数据项

baye.data.g_CityX数据项

baye.data.g_CityY数据项

baye.data.g_FgtOver数据项

baye.data.g_FgtWeather数据项

baye.data.g_FgtBoutCnt数据项

baye.data.g_MainGenIdx数据项

baye.data.g_LookEnemy数据项

baye.data.g_LookMovie数据项

baye.data.g_MoveSpeed数据项

baye.data.g_FgtParam.Mode数据项

baye.data.g_FgtParam.Way数据项

baye.data.g_FgtParam.MapId数据项

baye.data.g_FgtParam.CityIndex数据项

baye.data.g_FgtParam.MProvender数据项

baye.data.g_FgtParam.EProvender数据项

baye.data.g_FgtParam.GenArray[20]数据项

baye.data.g_FgtParam数据对象（含子项）

子项一览（点名称看单条说明）：

baye.data.g_GenPos[?].x数据项

baye.data.g_GenPos[?].y数据项

baye.data.g_GenPos[?].hp数据项

baye.data.g_GenPos[?].mp数据项

baye.data.g_GenPos[?].move数据项

baye.data.g_GenPos[?].active数据项

baye.data.g_GenPos[?].state数据项

baye.data.g_GenPos[20]数据对象（含子项）

子项一览（点名称看单条说明）：

baye.data.g_GenAtt[?].canny数据项

baye.data.g_GenAtt[?].ter数据项

baye.data.g_GenAtt[?].bile数据项

baye.data.g_GenAtt[?].armsType数据项

baye.data.g_GenAtt[?].at数据项

baye.data.g_GenAtt[?].df数据项

baye.data.g_GenAtt[?].generalIndex数据项

baye.data.g_GenAtt[2]数据对象（含子项）

子项一览（点名称看单条说明）：

baye.data.g_AutoUpdateMapXY数据项

baye.data.g_PlayerKing数据项

baye.data.g_YearDate数据项

baye.data.g_MonthDate数据项

baye.data.g_PIdx数据项

baye.data.g_Persons[?].OldBelong数据项

baye.data.g_Persons[?].Belong数据项

baye.data.g_Persons[?].Level数据项

baye.data.g_Persons[?].Force数据项

baye.data.g_Persons[?].IQ数据项

baye.data.g_Persons[?].Devotion数据项

baye.data.g_Persons[?].Character数据项

baye.data.g_Persons[?].Experience数据项

baye.data.g_Persons[?].Thew数据项

baye.data.g_Persons[?].ArmsType数据项

baye.data.g_Persons[?].Arms数据项

baye.data.g_Persons[?].Equip[2]数据项

baye.data.g_Persons[?].Age数据项

baye.data.g_Persons[250]数据对象（含子项）

子项一览（点名称看单条说明）：

baye.data.g_Cities[?].State数据项

baye.data.g_Cities[?].Belong数据项

baye.data.g_Cities[?].SatrapId数据项

baye.data.g_Cities[?].FarmingLimit数据项

baye.data.g_Cities[?].Farming数据项

baye.data.g_Cities[?].CommerceLimit数据项

baye.data.g_Cities[?].Commerce数据项

baye.data.g_Cities[?].PeopleDevotion数据项

baye.data.g_Cities[?].AvoidCalamity数据项

baye.data.g_Cities[?].PopulationLimit数据项

baye.data.g_Cities[?].Population数据项

baye.data.g_Cities[?].Money数据项

baye.data.g_Cities[?].Food数据项

baye.data.g_Cities[?].MothballArms数据项

baye.data.g_Cities[?].PersonQueue数据项

baye.data.g_Cities[?].Persons数据项

baye.data.g_Cities[?].ToolQueue数据项

baye.data.g_Cities[?].Tools数据项

baye.data.g_Cities[38]数据对象（含子项）

子项一览（点名称看单条说明）：

baye.data.g_PersonsQueue[PERSON_MAX]数据项

baye.data.g_GoodsQueue[GOODS_MAX]数据项

baye.data.g_CityPos数据项

baye.data.g_Tools[?].idx数据项

baye.data.g_Tools[?].useflag数据项

baye.data.g_Tools[?].atRange[30]数据项

baye.data.g_Tools[?].changeAttackRange数据项

baye.data.g_Tools[?].at数据项

baye.data.g_Tools[?].iq数据项

baye.data.g_Tools[?].move数据项

baye.data.g_Tools[?].arm数据项

baye.data.g_Tools[]数据对象（含子项）

子项一览（点名称看单条说明）：

baye.data.g_Skills[?].aim数据项

baye.data.g_Skills[?].state数据项

baye.data.g_Skills[?].power数据项

baye.data.g_Skills[?].destroy数据项

baye.data.g_Skills[?].useMp数据项

baye.data.g_Skills[?].weather[5]数据项

baye.data.g_Skills[?].eland[8]数据项

baye.data.g_Skills[?].oland[8]数据项

baye.data.g_Skills[?].earm[6]数据项

baye.data.g_Skills[]数据对象（含子项）

子项一览（点名称看单条说明）：

baye.data.g_engineConfig.fixCityOffset数据项

baye.data.g_engineConfig.fixThewOverFlow数据项

baye.data.g_engineConfig.fixFoodOverFlow数据项

baye.data.g_engineConfig.fixOverFlow16数据项

baye.data.g_engineConfig.fixConsumeMoney数据项

baye.data.g_engineConfig.fixFightMoveOutRange数据项

baye.data.g_engineConfig.fixAlienateComsumeThew数据项

baye.data.g_engineConfig.enableToolAttackRange数据项

baye.data.g_engineConfig.enable16bitConsumeMoney数据项

baye.data.g_engineConfig.enableScript数据项

baye.data.g_engineConfig.disableSL数据项

baye.data.g_engineConfig.aiLevelUpSpeed数据项

baye.data.g_engineConfig.disableAgeGrow数据项

baye.data.g_engineConfig.ratioOfFoodToArmsPerMouth数据项

baye.data.g_engineConfig.ratioOfFoodToArmsPerDay数据项

baye.data.g_engineConfig.armsPerDevotion数据项

baye.data.g_engineConfig.armsPerMoney数据项

baye.data.g_engineConfig.maxLevel数据项

baye.data.g_engineConfig.responseNoteOfBettle数据项

baye.data.g_engineConfig.aiDefenceMode数据项

baye.data.g_engineConfig.aiAttackMethod数据项

baye.data.g_engineConfig.batlleDisableWeatherChange数据项

baye.data.g_engineConfig.mainMenuButtonRects[16]数据项

baye.data.g_engineConfig.periodMenuButtonRects[16]数据项

baye.data.g_engineConfig.saveFaceListAnchor[2]数据项

baye.data.g_engineConfig数据对象（含子项）

子项一览（点名称看单条说明）：

baye.hooks.aiFightCommand钩子函数

输入参数

输出参数

baye.hooks.getSkillIds钩子函数

输入参数

输出参数

返回值无

baye.hooks.calcAttackRange钩子函数

输入参数

输出参数

baye.hooks.showSkill钩子函数

输入参数

输出参数

baye.hooks.giveTool钩子函数

输入参数

输出参数

baye.hooks.takeOffTool钩子函数

输入参数

输出参数

baye.hooks.didOpenNewGame钩子函数

baye.hooks.didLoadGame钩子函数

baye.hooks.willSaveGame钩子函数

baye.hooks.tacticStage1钩子函数

引擎的运行，最顶层分为如下几个阶段循环运行：

• 判断统一或全军覆灭
• 更新每个城池的太守
• 玩家策略中 (玩家操作下各种命令，策略结束后继续后续步骤)
• 电脑策略中
• 执行命令（包括市政和军备等命令）
• 执行数据更新策略（如粮草收获等）

现脚本系统在此间插入了5个钩子点：

• 判断统一或全军覆灭
• 更新每个城池的太守
• 调用tacticStage1
• 玩家策略中 (玩家操作下各种命令，策略结束后继续后续步骤)
• 调用tacticStage2
• 电脑策略中
• 调用tacticStage3
• 执行命令（包括市政和军备等命令）
• 调用tacticStage4
• 执行数据更新策略（如粮草收获等）
• 调用tacticStage5

baye.hooks.tacticStage2钩子函数

baye.hooks.tacticStage3钩子函数

baye.hooks.tacticStage4钩子函数

baye.hooks.tacticStage5钩子函数

baye.hooks.willAddOrder钩子函数

输入参数

输出参数无

返回值

baye.hooks.willExecuteOrder钩子函数

输入参数

输出参数无

返回值

baye.hooks.enterBattle钩子函数

baye.hooks.battleStage1钩子函数

baye.hooks.battleStage2钩子函数

baye.hooks.battleStage3钩子函数

baye.hooks.battleStage4钩子函数

baye.hooks.battleStage5钩子函数

baye.hooks.exitBattle钩子函数

baye.hooks.cityMakeCommand钩子函数

输入参数

输出参数无

返回值

baye.hooks.willGiveTool钩子函数

输入参数

输出参数无

返回值

baye.hooks.willTakeOffTool钩子函数

输入参数

输出参数无

返回值

baye.hooks.countAttackHurt钩子函数

输入参数无, 攻防双方数据已存储于全局变量 baye.data.g_GenAtt[] 中

输出参数

返回值

baye.hooks.countSkillHurt钩子函数

输入参数攻防双方数据已存储于全局变量 baye.data.g_GenAtt[] 中

输出参数

返回值

baye.hooks.battleBuildAttackAttriutes钩子函数

输入参数

输出参数将结果存储于存储于全局变量 baye.data.g_GenAtt[context.index] 中

返回值

baye.hooks.battleDrivePersonState钩子函数

输入参数

输出参数无

返回值0 有变化, 1 无变化

baye.hooks.getMaxArms钩子函数

输入参数

输出参数

返回值

baye.hooks.getToolPropertyValue钩子函数

输入参数

输出参数

返回值无

baye.hooks.getToolPropertyTitle钩子函数

输入参数

输出参数

返回值无

相关全局配置

baye.hooks.getPersonPropertyValue钩子函数

输入参数

输出参数

返回值无

baye.hooks.getPersonPropertyTitle钩子函数

输入参数

输出参数

返回值无

相关全局配置

baye.hooks.getCityPropertyDisplay钩子函数

输入参数

输出参数

返回值无

相关全局配置

baye.hooks.getFighterInfo钩子函数

输入参数

输出参数

返回值

baye.hooks.getTerrainInfo钩子函数

输入参数

输出参数

返回值

baye.hooks.showAbout钩子函数

返回值

baye.hooks.willShowPKAnimation钩子函数

返回值

baye.hooks.didShowPKAnimation钩子函数

baye.hooks.showMiniMap钩子函数

返回值

baye.hooks.showMainHelp钩子函数

返回值

baye.hooks.didShowFightStateBar钩子函数

baye.hooks.didRefreshFightStateBar钩子函数

baye.hooks.didShowFightSituation钩子函数

baye.hooks.didRefreshFightSituation钩子函数

baye.hooks.loadFightMap钩子函数

返回值

示例

baye.hooks.loadFightMap = function() {
    var city = baye.data.g_FgtParam.CityIndex;
    var name = baye.getCityName(city);

    console.log('城池序号:' + city);
    console.log('城池名称:' + name);
    console.log('进攻方向:' + baye.data.g_FgtParam.Way);

    switch (name) {
        case '汉中': {
            baye.data.g_MapWid = 17;
            baye.data.g_MapHgt = 18;
            baye.data.g_FightMapData = [
 1, 5, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
 1, 5, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
 1, 1, 3, 1, 1, 1, 1, 1, 5, 1, 1, 1, 1, 1, 1, 1, 1,
 1, 1, 1, 1, 2, 2, 2, 1, 1, 1, 1, 1, 1, 1, 1, 5, 1,
 1, 1, 1, 1, 2, 2, 2, 1, 1, 1, 4, 1, 1, 1, 1, 1, 1,
 1, 1, 1, 1, 2, 2, 2, 1, 1, 1, 1, 1, 1, 1, 2, 1, 1,
 1, 1, 1, 1, 2, 2, 2, 1, 1, 1, 1, 5, 1, 1, 1, 1, 1,
 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 2, 1,
 1, 1, 1, 1, 5, 1, 1, 1, 1, 1, 1, 1, 2, 2, 2, 2, 1,
 1, 1, 4, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 1, 1,
 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 5, 1, 5, 1, 2, 1, 1,
 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
 1, 1, 1, 1, 5, 1, 1, 1, 1, 1, 1, 1, 1,20,16,16,16,
 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,17,20,16,24,
 1, 1, 1, 1, 2, 2, 2, 1, 1, 1, 1, 1, 1,17,17,17,17,
 1, 1, 1, 1, 2, 2, 2, 1, 1, 1, 1, 1, 1,17,23,16,21,
 1, 1, 1, 1, 2, 2, 2, 1, 1, 1, 5, 1, 1,23,16,16,16,
            ];
            break;
        }
        default:
            return -1;
    }
    return 0;
};

baye.hooks.getPersonName钩子函数

输入参数

输出参数

返回值

baye.hooks.showStateChanged钩子函数

输入参数

输出参数

无

返回值

baye.hooks.drawGenerals钩子函数

输入参数

输出参数

无

返回值

baye.hooks.countMove钩子函数

输入参数

输出参数

无

返回值

示例

baye.hooks.countMove = function(c) {
    baye.data.g_GenPos[c.generalIndex].move = 2;
}

baye.hooks.countLandResistance钩子函数

输入参数

输出参数

返回值

示例

baye.hooks.countLandResistance = function(context) {
    // 0x80 0x81 0x82 0x83 ... 阻力依次递增
    // 输出46种地形对将领的阻力
    for (var i = 0; i < 46; i++) context.result[i] = 0x81;
}

baye.hooks.countMoveRange钩子函数

使用此钩子可完全自定义计算将领移动范围

此钩子可代替 [移动力钩子+阻力钩子] 实现更灵活的移动范围计算

输入参数

输出参数

返回值

示例

baye.hooks.countMoveRange = function(context) {
    for (var i = 0; i < 15*15; i++) {
        baye.data.g_FightPath[i] = 0x79;
    }
}

baye.hooks.fontImageForChar钩子函数

输入参数

输出参数

返回值

示例

baye.hooks.fontImageForChar = function(c) {

    // index为 assets/003_MAIN_SPE.assets/1 下图片序号

    var index = {
        0x82e0: 0, // 傕
        0x90aa: 1, // 惇
        0xb574: 2, // 祎
        0x8faa: 3, // 彧
        0xe041: 4, // 郃
        0xab64: 5, // 玠
        0xae8f: 6, // 畯
        0x85b1: 7, // 叡
    }[c.code];

    if (index != undefined) {
        c.index = index;
    }
};

baye.hooks.willOpenMenu钩子函数

输入参数

baye.hooks.willChangeMenuSelection钩子函数

输入参数

baye.hooks.willCloseMenu钩子函数

输入参数

baye.hooks.fightCountWinner钩子函数

baye.hooks.willShowCityInfo钩子函数

示例

baye.hooks.willShowCityInfo = function(c) { console.log("city:" + c.city); }

baye.hooks.fightWillShowHelp钩子函数

返回值

baye.hooks.chooseGameEntry钩子函数

输入参数

无（源码调用点没有绑定任何 context 字段）。

输出参数

源码位置：src/gamEng.c · GamMainChose()。

baye.hooks.loadPeriod钩子函数

输入参数

无。

输出参数

源码位置：src/gamEng.c · GamMainChose()。

baye.hooks.chooseActor钩子函数

输入参数

无。注意君主队列是引擎局部数组，钩子里拿不到，要自己从 baye.data.g_Persons 里按 Belong 筛。

输出参数

返回值随后赋给 g_PlayerKing，也就是玩家扮演谁。源码位置：src/gamEng.c · GamMainChose()。

baye.hooks.choosingActorUpdate钩子函数

输入参数

输出参数

无返回值，引擎不读结果（纯观察型钩子）。源码位置：src/gamEng.c · GamGetKingInner() 里的 UPDATE_UI() 宏。

baye.hooks.didShowMainMap钩子函数

输入参数

无。

输出参数

无，引擎不读返回值。源码位置：src/cityedit.c · GetCitySetInner()。

baye.hooks.meetFight钩子函数

输入参数

输出参数

源码位置：src/citycmdd.c · BattleDrv()。

baye.hooks.tacticStageUser钩子函数

输入参数

无。

输出参数

源码位置：src/tactic.c · GameDevDrv()。

baye.hooks.mainSystemMenu钩子函数

输入参数

无。

输出参数

源码位置：src/tactic.c · FunctionMenu()。

baye.hooks.onMenuIdle钩子函数

输入参数

输出参数

无返回值。源码位置：src/PublicFun.c · PlcSplMenuInner()。

baye.hooks.fightStatusBarTouched钩子函数

输入参数

输出参数

源码位置：src/Fight.c · FgtGetFoucsInner()。

baye.hooks.fightChooseAction钩子函数

输入参数

输出参数

常量定义见 src/baye/fight.h。源码位置：src/Fight.c · FgtGetPCmd()。

baye.hooks.fightChooseSkill钩子函数

输入参数

输出参数

源码位置：src/Fight.c · FgtGetPCmd()。

baye.hooks.fightOpenMainMenu钩子函数

输入参数

无。

输出参数

源码位置：src/FightSub.c · FgtMainMenu()。

baye.hooks.canUseSkill钩子函数

输入参数

输出参数

源码位置：src/FgtPkAi.c · FgtJNChkAim()（原函数注释：「检测目标承受该技能的条件是否满足」）。

baye.hooks.drawMapUnit钩子函数

输入参数

输出参数

无返回值。源码位置：src/Fight.c · FgtShowMap()、FgtMapUnitShow()。

baye.hooks.drawOneGeneral钩子函数

输入参数

输出参数

无返回值。源码位置：src/Fight.c · FgtShowGen()。

baye.getPersonName(index)功能函数

输入参数

返回值

String：人物名称。序号越界时的行为未考证【推断】返回空串。

示例

console.log(baye.getPersonName(0));

baye.getToolName(index)功能函数

输入参数

返回值

String：道具名称。

示例

// 上游 demos.js:208
baye.say(c.personIndex, "全新[" + baye.getToolName(3) + "]已打造成功!");

baye.getSkillName(index)功能函数

输入参数

返回值

String：技能名称。

示例

var names = [];
names.push(baye.getSkillName(0), baye.getSkillName(1));
baye.centerChoose(40, 30, names, 0, function (ind) { console.log(names[ind]); });

baye.getCityName(index)功能函数

输入参数

返回值

String：城池名称。

示例

// 上游 printCity 里的写法
console.log(baye.getCityName(i));

baye.setCustomData(data)功能函数

输入参数

返回值

无。

示例

baye.setCustomData(JSON.stringify({ lib: "1.2.3.5", flag: 1 }));

baye.getCustomData()功能函数

输入参数

无。

返回值

String：之前存的内容；没存过返回 null（引擎返回指针 0 时 JS 直接给 null），所以先判空再 JSON.parse。

示例

var d = JSON.parse(baye.getCustomData() || "{}");

baye.alert(msg, then)功能函数

输入参数

返回值

无。要 Promise 写法用 baye.asyncAlert(msg)。

示例

// 上游 demos.js:174
baye.alert("没收失败!");

baye.say(personIndex, msg, then)功能函数

输入参数

返回值

无。要 Promise 写法用 baye.asyncSay(...)。

示例

// 上游 demos.js:173
baye.say(ctx.personIndex, "你算哪根葱?\n" + baye.getToolName(ctx.toolIndex) + "岂是你想拿走就拿走?", function () {
    baye.alert("没收失败!");
});

baye.delay(ticks, flag, then)功能函数

输入参数

返回值

无。要 Promise 写法用 baye.asyncDelay(...)。

示例

baye.delay(100, 1, function (key) { console.log("等满 1 秒或被按键，按键码：" + key); });

baye.playSPE(x, y, speid, index, flag, then)功能函数

输入参数

返回值

无。要 Promise 写法用 baye.asyncPlaySPE(...)。

示例

// 上游 demos.js:576：开场动画
baye.playSPE(0, 0, 3, 0, 0);

baye.choose(x, y, w, h, items, init, then)功能函数

输入参数

返回值

无。要 Promise 写法用 baye.asyncChoose(...)。

示例

// 上游 demos.js:251
var items = ["继续", "取消"];
baye.choose(4, 5, 40, 30, items, 1, function (ind) {
    console.log("Choosing: " + ind);
    return ind == 0 ? -1 : 0;
});

baye.centerChoose(w, h, items, init, then)功能函数

输入参数

返回值

无（内部转调 choose）。要 Promise 写法用 baye.asyncCenterChoose(...)。

示例

// 上游 examples.js:309
baye.centerChoose(100, 80, ["简单", "困难"], 0, function (idx) {
    if (idx == baye.None) { return 0; }   // 取消
    baye.loadPeriod(1);
});

baye.choosePerson(items, init, then)功能函数

输入参数

返回值

无。要 Promise 写法用 baye.asyncChoosePerson(...)。

示例

// 上游 demos.js:260 把回调值直接当人物编号用了
// ⇒ items 若不是从 0 开始连续编号，那样取名字会取错
var items = [0, 5, 12];
baye.choosePerson(items, 0, function (ind) {
    console.log(baye.getPersonName(items[ind]));
});

baye.chooseTool(items, init, then)功能函数

输入参数

返回值

无。要 Promise 写法用 baye.asyncChooseTool(...)。

示例

var items = [0, 3, 7];
baye.chooseTool(items, 0, function (ind) {
    console.log(baye.getToolName(items[ind]));
});

baye.getPersonByName(name)功能函数

输入参数

返回值

Object：g_Persons[i] 的引用；没找到是 undefined（不是 null），先判空再用。
配套：baye.getPersonIdByName(name) 同样查找，但返回下标 i（bridge.js:585）。

示例

var p = baye.getPersonByName("关羽");
if (p) { p.Force = 5; }

baye.getCityByName(name)功能函数

输入参数

返回值

Object：g_Cities[i] 的引用；没找到是 undefined。

示例

var c = baye.getCityByName("洛阳");
if (c) { c.Money += 1000; }

baye.getFighterIndexByName(name)功能函数

输入参数

返回值

U8：战场序号；没找到是 undefined。
配套：baye.getFighterPositionByName(name) = g_GenPos[该序号]，想直接拿坐标就用它（bridge.js:627）。

示例

var i = baye.getFighterIndexByName("关羽");
if (i != undefined) { console.log(baye.data.g_GenPos[i].x, baye.data.g_GenPos[i].y); }

baye.getPersonNameByID(id)功能函数

输入参数

返回值

String：要显示的名字。id 大于 255 或越界时的行为未考证【推断】。

示例

// 上游 printCity 里就是这么用的
var belong = baye.getPersonNameByID(city.Belong);

baye.putPersonInCity(city, person)功能函数

输入参数

返回值

U8：1 = 成功，0 = 失败（参数越界或城塞不下）。

示例

var p = baye.getPersonByName("关羽");
var from = baye.getCityByPerson(p);   // bridge.js:595，0xff = 不在任何城
baye.deletePersonInCity(from, p);
baye.putPersonInCity(3, p);

baye.putToolInCity(city, tool, hide)功能函数

输入参数

返回值

U8：【推断】插入位置 + 1，0 表示失败；上游示例里都没用返回值。

示例

// 上游 demos.js:207：打造出新道具
baye.putToolInCity(c.cityIndex, 3);

baye.deletePersonInCity(city, person)功能函数

输入参数

返回值

U8：1 = 删掉了，0 = 这座城里没有这个人。

示例

var p = baye.getPersonByName("关羽");
baye.deletePersonInCity(baye.getCityByPerson(p), p);

baye.deleteToolInCity(city, tool)功能函数

输入参数

返回值

U8：1 = 删掉了，0 = 参数越界或城里没这个道具。

示例

// 上游 demos.js:206：扣掉材料
baye.deleteToolInCity(c.cityIndex, c.toolIndex);

baye.getPersonByGeneralIndex(gIndex)功能函数

输入参数

返回值

Object：人物数据引用。该位置没排将领时（GenArray[gIndex] 为 0）会算成 g_Persons[-1] ⇒ 拿到 undefined，源码没做保护，用之前判空。
配套：baye.getTerrainByGeneralIndex(index) 返回该将领所在地形编号（bridge.js:689）。

示例

// 上游 demos.js:48
var person = baye.getPersonByGeneralIndex(context.generalIndex);

baye.drawText(x, y, text, scr)功能函数

输入参数

返回值

U16：本次消耗掉的字节数（按 GBK 算）；写到超出屏幕底部时返回 0 ⇒ 可以用来判断还能不能继续往下排。

示例

// 上游 demos.js:598
baye.drawText(0, 0, text);
// 多行：版本信息页
var t = "版本信息\n引擎:" + baye.data.g_engineVersion;
var used = baye.drawText(0, 0, t);

baye.drawImage(x, y, resid, resitem, picIndex, scr)功能函数

输入参数

返回值

无。

示例

// 上游 examples.js:603 / 622
baye.drawImage(x, y, baye.data.g_TileId, 0, pic, scr);
baye.drawImage(x, y, 4, 0, pic, 1);

baye.clearRect(left, top, right, bottom, scr)功能函数

输入参数

返回值

无。
配套：baye.clearScreen() 就是清 0,0 → g_screenWidth,g_screenHeight（bridge.js:755），整屏刷新直接用它。

示例

// 上游 examples.js:396
baye.clearRect(0, 0, 60, 30);
baye.drawText(0, 0, "字体预览");

baye.revertRect(left, top, right, bottom, scr)功能函数

输入参数

返回值

无。

示例

// 上游 examples.js:326：从 (x,y) 起盖 w×h 的格子，闭区间所以要 -1
baye.revertRect(x, y, x + w - 1, y + h - 1);

baye.drawLine(startX, startY, endX, endY)功能函数

输入参数

返回值

无。

示例

// 上游示例里没找到调用点，下面是最小用法
baye.drawLine(0, 0, 60, 30);

baye.drawRect(left, top, right, bottom, scr)功能函数

输入参数

返回值

无。

示例

// 上游 examples.js:574：给选中的格子描一圈
baye.drawRect(x, y, x + 35, y + 35, 1);
baye.drawText(x, y, "ITEM" + idx);

baye.drawDot(x, y, color)功能函数

输入参数

返回值

无。

示例

// 上游示例里没找到调用点
baye.data.g_paintColor = 170;
baye.drawDot(10, 10, 1);

baye.getNumber(min, max, then)功能函数

输入参数

返回值

无。要 Promise 写法用 baye.asyncGetNumber(...)。

示例

// 上游原例
baye.hooks.showMainHelp = function (context) {
    var min = 100;
    var max = 200;
    baye.getNumber(min, max, function (c) { console.log("选择了：" + c); });
}