Scripting: Difference between revisions

From Citizens Wiki

No edit summary
No edit summary
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Scripting Repository ==
== NOTICE ==
http://scripts.citizensnpcs.com - submit user scripts (including Denizen scripts) here.


<span style="font-family:natalya-alternate-one; font-size:300%; margin-right:-7px; margin-left:-10px;">This page refers to the legacy Javascript scripting which is no longer fully supported. The main scripting support available in modern Citizens is through [https://denizenscript.com/ Denizen].</span>
== Scripting Support in Citizens2 ==
== Scripting Support in Citizens2 ==
Citizens2 includes support for various scripting languages including Lua, Javascript and Python.
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.
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 (https://github.com/krka/kahlua2) and more.


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'.  
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'.  
Line 13: Line 17:


When the script file is loaded by Citizens, it will call the method 'onLoad(NPC)' - anything can be performed at this time, although the NPC will not necessarily be spawned. If the method 'run(NPC)' exists it will also be called every tick by Citizens.
When the script file is loaded by Citizens, it will call the method 'onLoad(NPC)' - anything can be performed at this time, although the NPC will not necessarily be spawned. If the method 'run(NPC)' exists it will also be called every tick by Citizens.
    function leftClick(event) {
        event.getClicker().sendMessage("hello from Javascript scripting!");
    }
    function onLoad(npc) {
        events.on(Java.type('net.citizensnpcs.api.event.NPCLeftClickEvent').class, leftClick);
    }


== Scripting Gotchas and Tips ==
== Scripting Gotchas and Tips ==

Latest revision as of 19:16, 3 September 2021

NOTICE

This page refers to the legacy Javascript scripting which is no longer fully supported. The main scripting support available in modern Citizens is through Denizen.



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 (https://github.com/krka/kahlua2) and more.

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. Scripts can be added to an NPC via the /npc script --add [scripts] command, where scripts is a list of files inside the plugins/Citizens/scripts folder to use. Scripts are differentiated by their extension -- make sure it is correct!

When the script file is loaded by Citizens, it will call the method 'onLoad(NPC)' - anything can be performed at this time, although the NPC will not necessarily be spawned. If the method 'run(NPC)' exists it will also be called every tick by Citizens.

   function leftClick(event) {
       event.getClicker().sendMessage("hello from Javascript scripting!");
   }
   function onLoad(npc) {
       events.on(Java.type('net.citizensnpcs.api.event.NPCLeftClickEvent').class, leftClick);
   }

Scripting Gotchas and Tips

Javascript (Nashorn)

Javascript (Rhino)

  • 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.
  • Rhino 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.