Scripting

Scripting 1.7.x, 1.8.0 编写1.7.x, 1.8.0脚本

Starting 1.8.8 scripting changed because I hooked it into the modding api.

1.8.8开始, 脚本编写发生了变化. 因为我用钩子把它拉进了api里

老版本JavaDoc

Javadoc

Languages

编写语言

By default java only supports javascript if you are on the latest version, but its possible to install other scripting languages by downloading their libraries and putting them in the mods folder. For example:

最新版Java默认只支持JavaScript. 但是一样可以加载其他的脚本语言通过下载他们的库并让Forge将其加载(Bukkit同理). 例如:

ECMAScript(more commenly know as javascript): Should be available if you are on the latest java version. (If you have java 8 and it’s not available, go to your java/jre/lib/ext folder and copy the nashorn.jar to the mods folder)
Python: Download the standalone jar from the Jython website and put it in the mods folder.
Lua: Download the luaj.zip from the Luaj website and put the lib/luaj-jse.jar into the mods folder. lua script example
Ruby: Download the jruby.zip from the JRuby website and put the lib/jruby.jar into the mods folder.
Php: Download the JavaBridge and php-script.jar from the php-java-bridge website and put them in the mods folder

• ECMAScript(一般叫做JavaScript): 最新版本的Java已经默认可用. 如果你安装了Jre1.8依旧不可用, 去"java/jre/lib/ext"目录复制"nashorn.jar"文件到你的"mods"文件夹
• Python: 从Jython官网下载库文件并将其放入"mods"文件夹.
• Lua: 从Luaj官网下载luaj.zip然后把压缩包里的"lib/luaj-jse.jar"放进"mods"文件夹. Lua示例
• Ruby: 从JRuby下载jruby.zip然后把压缩包里的"lib/jruby.jar"放进"mods"文件夹
• Php: 从java-bridge官网下载JavaBridge和php-script.jar然后把它们丢进"mods"文件夹

就不能放入官方库里吗= =

There are probably more scripting languages available. These are just some examples. You can usually find them by googling: java scriptengine

应该大部分的脚本语言都可用. 这只是一个简单的示例. 你可以在google上面搜到他们: java scriptengine 语言名称. 渣度你们直接来个: 语言名称的Java实现?

API

If there is any extra functionality you would like feel free to ask for it on the forums.

如果你想实现任何其他功能的话请在论坛告诉作者

这里有个梨子:

var clicked = 0; function interact(event){ clicked++; event.npc.say(clicked); }

function died(event){ clicked = 0; }

Hooks

下面的表格是从模组中用钩子拉出来的= =方便写脚本用.

功能	事件	说明
init	NpcEvent.InitEvent	当NPC被生成(创建或者复活)
tick	NpcEvent.UpdateEvent	当更新tick时(每10tick一循环. 建议操作在10tick内完成)
interact	NpcEvent.InteractEvent	当玩家与NPC互动
dialog	DialogEvent.OpenEvent	当玩家打开与NPC的对话框时
dialog_option	DialogEvent.OptionEvent	当玩家选择了对话选项或者关闭了对话框
damaged	NpcEvent.DamagedEvent	当NPC被攻击时. 可取消
died	NpcEvent.DiedEvent	当NPC被杀时
meleeAttack	NpcEvent.MeleeAttackEvent	当NPC将要进行攻击
rangedLaunched	NpcEvent.RangedLaunchedEvent	当NPC开火(发射东西吧)
target	NpcEvent.TargetEvent	当NPC选定目标时
targetLost	NpcEvent.TargetLostEvent	当NPC丢失目标时
kill	NpcEvent.KilledEntityEvent	当NPC杀掉了某个实体时
role	RoleEvent.*	被某些NPC角色调用
collide	NpcEvent.CollideEvent	当NPC与实体发生碰撞
timer	NpcEvent.TimerEvent	当计时器结束(ICustomNpc.getTimers())

译者自嗨

写这玩意真得有点编程基础. 如果你想在我这现学, 我告诉你没门= =

JavaScript的话这样调用钩子拉出来的东西 function 功能名(event) {你要执行的内容}

Lua: function 功能名()

主体

End

当然Python才是世界上最好的语言!

这玩意的正确食用方法是:

在游戏里的自定义NPC工具栏处找到编程魔杖 右键NPC就可以进行编程了

如果你有编写插件的基础你应该看着JavaDoc会很快上手的. 没有也没有关系, 可以慢慢学.

Python:

def interact(evt):
  evt.npc.say("Trychen要上天了")
  # 当玩家右键NPC时NPC会说:"Trychen要上天了"

在这段代码中, evt为当interact方法被调用时Custom Npcs传入的参数. 类型为NpcEvent

明白的人现在估计去翻JavaDocs了= =不明白的给我继续看

evt.npc是evt类型中获取npc类型的方法, 然后say又是npc中的方法. 这样一来你就调用到了这个让npc讲话的方法.

但是这个方法要求你扔个参数进去好让他知道他要讲什么, 所以你得扔个字符串进去. 双引号+里面的字符构成了字符串

然后你就顺利地传入了参数并让NPC说出了话

至于我怎么知道NpcEvent.npc的,

JavaDoc上面不是有吗!!!自己看看类中"Field Summary"下面的方法.= =

NpcEvent的Javadoc

你们一定看懂了对不对 ==