Scripting: Difference between revisions
No edit summary |
|||
| Line 23: | Line 23: | ||
importPackage(Packages.org.bukkit.inventory); | importPackage(Packages.org.bukkit.inventory); | ||
importPackage(Packages.net.citizensnpcs.api.ai.event); | importPackage(Packages.net.citizensnpcs.api.ai.event); | ||
importPackage(Packages.net.citizensnpcs.api.scripting); | |||
importPackage(java.util); | importPackage(java.util); | ||
function addGoals (goals, npc) { | function addGoals (goals, npc) { | ||
| Line 78: | Line 79: | ||
}; | }; | ||
var goal = new Goal(thiefGoal); | var goal = new Goal(thiefGoal); | ||
events.on(Packages.net.citizensnpcs.api.ai.event.NavigationCompleteEvent, function(event) { | events.on(Packages.net.citizensnpcs.api.ai.event.NavigationCompleteEvent, EventHandler(function(event) { | ||
if (event.getNPC() != goal.npc) | if (event.getNPC() != goal.npc) | ||
return; | return; | ||
goal.allowed = true; | goal.allowed = true; | ||
}); | })); | ||
goals.addGoal(1, goal); | goals.addGoal(1, goal); | ||
} | } | ||
Revision as of 15:34, 2 November 2012
Scripting Repository
http://scripts.citizensnpcs.com - submit user scripts (including Denizen scripts) here.
Scripting Support in Citizens2
Citizens2 includes support for various scripting languages including Lua, Javascript and Python.
Javascript support is built into Java; additional languages can be added in through installing things such as JRuby (http://jruby.org/), Jython (http://www.jython.org/), Kahlua (http://www.ohloh.net/p/kahlua) and more. These use the Java Scripting API to give common scripting support to Citizens.
The scripting API contains a few built in objects in the global namespace which aid in some tasks. Currently, the 'events' object allows registering event listeners for Bukkit events and a reference to the Citizens plugin object is available under 'plugin'.
Behaviours
Let's see an example of how to use scripts. Citizens builds in by default the 'Behaviour' trait - this lets you specify AI tasks via scripts. Behaviours can be added to the NPC via the /npc behaviour [behaviours] command, where behaviours is a list of files to use.
Scripts for behaviours should be placed in the plugins/Citizens/scripts/behaviours folder. Scripts are differentiated by their extension -- make sure it is correct!
When the script file is loaded by Citizens, it will call the method 'addGoals(Goals, NPC)'. Goals can be added via calling goals.addGoal(priority, goal), where goal implements the interface specified here -http://jd.citizensnpcs.com/net/citizensnpcs/api/ai/Goal.html.
An example of a behaviour file is given below - this implements a simple thief goal.
Code: Example done in Javascript |
Scripting Gotchas and Tips
Javascript
- Some code will expect the methods equals and hashcode to be implemented - a simple equals function should be used often.
- for.. in loops do not work with Java collections.
- The default Javascript-Java implementation cannot use abstract classes.
- You can implement Java interfaces by using new [interfacename](object), where object contains the methods implementing the interface.
- Use importPackage(Packages.name.space) or importClass(Packages.name.space.YourClass) to import other classes/packages. The Packages. prefix is not required if the class is in the java.util package.