api ref updated for new modules.

This commit is contained in:
walterhiggins 2015-01-25 19:11:37 +00:00
parent 30c4667a2b
commit 7351c40003

View file

@ -384,6 +384,8 @@ Walter Higgins
* [Drone.rainbow() method](#dronerainbow-method)
* [Drone.spiral_stairs() method](#dronespiral_stairs-method)
* [Drone.temple() method](#dronetemple-method)
* [The at Module](#the-at-module)
* [at() function](#at-function)
* [Blocks Module](#blocks-module)
* [Examples](#examples)
* [Fireworks Module](#fireworks-module)
@ -401,6 +403,8 @@ Walter Higgins
* [Signs Module](#signs-module)
* [signs.menu() function](#signsmenu-function)
* [signs.getTargetedBy() function](#signsgettargetedby-function)
* [The slash Module](#the-slash-module)
* [The slash() function](#the-slash-function)
* [Sounds Module](#sounds-module)
* [Usage (Bukkit) :](#usage-bukkit-)
* [Teleport Module](#teleport-module)
@ -417,19 +421,19 @@ Walter Higgins
* [utils.getMousePos() function](#utilsgetmousepos-function)
* [utils.foreach() function](#utilsforeach-function)
* [utils.nicely() function](#utilsnicely-function)
* [utils.at() function](#utilsat-function)
* [utils.time( world ) function](#utilstime-world--function)
* [utils.time24( world ) function](#utilstime24-world--function)
* [utils.find() function](#utilsfind-function)
* [utils.serverAddress() function](#utilsserveraddress-function)
* [utils.watchFile() function](#utilswatchfile-function)
* [utils.watchDir() function](#utilswatchdir-function)
* [utils.unwatchFile() function](#utilsunwatchfile-function)
* [utils.unwatchDir() function](#utilsunwatchdir-function)
* [utils.array() function](#utilsarray-function)
* [utils.players() function](#utilsplayers-function)
* [utils.playerNames() function](#utilsplayernames-function)
* [utils.stat() function](#utilsstat-function)
* [The watcher Module](#the-watcher-module)
* [watcher.watchFile() function](#watcherwatchfile-function)
* [watcher.watchDir() function](#watcherwatchdir-function)
* [watcher.unwatchFile() function](#watcherunwatchfile-function)
* [watcher.unwatchDir() function](#watcherunwatchdir-function)
* [Example Plugin #1 - A simple extension to Minecraft.](#example-plugin-1---a-simple-extension-to-minecraft)
* [Usage:](#usage-3)
* [Example Plugin #2 - Making extensions available for all players.](#example-plugin-2---making-extensions-available-for-all-players)
@ -4454,6 +4458,50 @@ d.temple();
```
![temple example](img/templeex1.png)
## The at Module
The at module provides a single function `at()` which can be used to schedule
repeating (or non-repeating) tasks to be done at a particular time.
### at() function
The utils.at() function will perform a given task at a given time in the
(minecraft) day.
#### Parameters
* time24hr : The time in 24hr form - e.g. 9:30 in the morning is '09:30' while
9:30 pm is '21:30', midnight is '00:00' and midday is '12:00'
* callback : A javascript function which will be invoked at the given time.
* worlds : (optional) An array of worlds. Each world has its own clock. If no array of worlds is specified, all the server's worlds are used.
* repeat : (optional) true or false, default is true (repeat the task every day)
#### Example
To warn players when night is approaching:
```javascript
var utils = require('utils'),
at = require('at');
function warning(){
utils.players(function( player ) {
echo( player, 'The night is dark and full of terrors!' );
});
}
at('19:00', warning);
```
To run a task only once at the next given time:
```javascript
var utils = require('utils'),
at = require('at');
function wakeup(){
utils.players(function( player ) {
echo( player, "Wake Up Folks!" );
});
}
at('06:00', wakeup, null, false);
```
## Blocks Module
You hate having to lookup [Data Values][dv] when you use ScriptCraft's
@ -4883,6 +4931,39 @@ if ( !sign ) {
[buksign]: http://jd.bukkit.org/dev/apidocs/org/bukkit/block/Sign.html
## The slash Module
This module provides a single function which makes it easy to execute
minecraft commands via javascript.
### The slash() function
This function makes it easy to execute one or more minecraft commands.
#### Parameters
* commands : A String or Array of strings - each string is a command to be executed.
* sender: The player or server on whose behalf the commands should be executed.
#### Examples
Invoke the `/defaultgamemode creative` command (as server).
```javascript
var slash = require('slash');
slash('defaultgamemode creative', server);
```
Set the time of day to Midday and toggle downfall:
```javascript
var slash = require('slash');
slash([
'time set 6000',
'toggledownfall'
], server);
```
## Sounds Module
This module is a simple wrapper around the Bukkit Sound class and provides
@ -5197,42 +5278,6 @@ function and the start of the next `next()` function.
See the source code to utils.foreach for an example of how utils.nicely is used.
### utils.at() function
The utils.at() function will perform a given task at a given time in the
(minecraft) day.
#### Parameters
* time24hr : The time in 24hr form - e.g. 9:30 in the morning is '09:30' while
9:30 pm is '21:30', midnight is '00:00' and midday is '12:00'
* callback : A javascript function which will be invoked at the given time.
* worlds : (optional) An array of worlds. Each world has its own clock. If no array of worlds is specified, all the server's worlds are used.
* repeat : (optional) true or false, default is true (repeat the task every day)
#### Example
To warn players when night is approaching:
```javascript
var utils = require('utils');
function warning(){
utils.players(function( player ) {
echo( player, 'The night is dark and full of terrors!' );
});
}
utils.at('19:00', warning);
```
To run a task only once at the next given time:
```javascript
var utils = require('utils');
function wakeup(){
utils.players(function( player ) {
echo( player, "Wake Up Folks!" );
});
}
utils.at('06:00', wakeup, null, false);
```
### utils.time( world ) function
Returns the timeofday (in minecraft ticks) for the given world. This function is necessary because
@ -5276,73 +5321,6 @@ var utils = require('utils');
var serverAddress = utils.serverAddress();
console.log(serverAddress);
```
### utils.watchFile() function
Watches for changes to the given file or directory and calls the function provided
when the file changes.
#### Parameters
* File - the file to watch (can be a file or directory)
* Callback - The callback to invoke when the file has changed. The callback takes the
changed file as a parameter.
#### Example
```javascript
var utils = require('utils');
utils.watchFile( 'test.txt', function( file ) {
console.log( file + ' has changed');
});
```
### utils.watchDir() function
Watches for changes to the given directory and calls the function provided
when the directory changes. It works by calling watchFile/watchDir for each
file/subdirectory.
#### Parameters
* Dir - the file to watch (can be a file or directory)
* Callback - The callback to invoke when the directory has changed.
The callback takes the changed file as a parameter.
For each change inside the directory the callback will also
be called.
#### Example
```javascript
var utils = require('utils');
utils.watchDir( 'players/_ial', function( dir ) {
console.log( dir + ' has changed');
});
```
### utils.unwatchFile() function
Removes a file from the watch list.
#### Example
```javascript
var utils = require('utils');
utils.unwatchFile( 'test.txt');
```
### utils.unwatchDir() function
Removes a directory from the watch list and all files inside the directory
are also "unwatched"
#### Example
```javascript
var utils = require('utils');
utils.unwatchDir ('players/_ial');
```
Would cause also
```javascript
utils.unwatchFile (file);
```
for each file inside directory (and unwatchDir for each directory inside it)
### utils.array() function
Converts Java collection objects to type Javascript array so they can avail of
@ -5427,6 +5405,77 @@ This function also contains values for each possible stat so you can get at stat
var utils = require('utils');
var JUMPSTAT = utils.stat.JUMP; // Accessing the value
var jumpCount = player.getStat ( JUMPSTAT ); // canary-specific code
## The watcher Module
This module exposes functions for watching for changes to files or directories.
### watcher.watchFile() function
Watches for changes to the given file or directory and calls the function provided
when the file changes.
#### Parameters
* File - the file to watch (can be a file or directory)
* Callback - The callback to invoke when the file has changed. The callback takes the
changed file as a parameter.
#### Example
```javascript
var watcher = require('watcher');
watcher.watchFile( 'test.txt', function( file ) {
console.log( file + ' has changed');
});
```
### watcher.watchDir() function
Watches for changes to the given directory and calls the function provided
when the directory changes. It works by calling watchFile/watchDir for each
file/subdirectory.
#### Parameters
* Dir - the file to watch (can be a file or directory)
* Callback - The callback to invoke when the directory has changed.
The callback takes the changed file as a parameter.
For each change inside the directory the callback will also
be called.
#### Example
```javascript
var watcher = require('watcher');
watcher.watchDir( 'players/_ial', function( dir ) {
console.log( dir + ' has changed');
});
```
### watcher.unwatchFile() function
Removes a file from the watch list.
#### Example
```javascript
var watcher = require('watcher');
watcher.unwatchFile('test.txt');
```
### watcher.unwatchDir() function
Removes a directory from the watch list and all files inside the directory
are also "unwatched"
#### Example
```javascript
var watcher = require('watcher');
watcher.unwatchDir ('players/_ial');
```
Would cause also
```javascript
watcher.unwatchFile (file);
```
for each file inside directory (and unwatchDir for each directory inside it)
## Example Plugin #1 - A simple extension to Minecraft.
A simple minecraft plugin. The most basic module.