网易的ModAPI官方文档有review过吗？

小林一茶

新的2.0ModAPI-beta文档，就看了新增的前几条，一堆问题

• 第一条新增GetTopScreen和第四条重复
• SetLiquidBlock接口的备注，翻译翻译，什么叫"dimensionId需要是playerId对应玩家所在的维度；如果dimensionId是-1则默认使用playerId对应玩家所在的维度"。
  我直接通过playerId创建comp，dimension写-1不就用的玩家id了？我dimension不写玩家dimension，也没法用……
  上面dimension参数列表还特地标注了一个"必须"，下面又是默认-1。
• 新增的QueryLobbyUserItem/LobbyGetStorage/LobbySetStorageAndUserItem三个接口，相关使用教程没有，示例连导包都是错的，这示例，写文档那位自己有用吗？
• 参数说明callback写可选，我想问问不选的话，这接口咋给我结果？脑电波吗？我不传他能不报错吗？
  
  1. import mod.server.extraServerApi as <b>serverAPI</b>
     
  2. comp = <b>erverApi</b>.GetEngineCompFactory().CreateHttp(entityId)
     
  3. def cb(data):
     
  4. print "LobbyGetStorage", data
     
  5. playerId = "12345"
     
  6. keys = ["money"]
     
  7. comp.LobbyGetStorage(cb, playerId, keys)

  复制代码
  
  

下次更新文档能不能走点心，写个备注都写得的狗屁不通，一堆歧义

sevenstars

这是个暴躁的大佬，哈哈哈。官方文档的问题去开发者群找管理效率更高，我也提过不少建议。

方戨阙

别人的文档是详尽透彻，这个文档怕只是让人了解还附带引入“歧途”，也是是担心你学会怎么使用了吧。很多地方参数说明和没说明没区别，参数或者属性之间存在着关联关系也从不提及，得等开发者穷举bug之后才能学会正常使用