changed api doc to API-Reference and tweaked Young Person's guide to use blocks variable

This commit is contained in:
walterhiggins 2013-12-17 21:42:25 +00:00
parent db51bdc57e
commit 4fb370bfea
2 changed files with 42 additions and 23 deletions

View file

@ -62,7 +62,7 @@
<target name="gendocs" depends="init" description="Generate API documentation">
<javac includeantruntime="false" srcdir="src/docs/java"/>
<java classname="jscript" failonerror="true" fork="true" output="docs/api.md">
<java classname="jscript" failonerror="true" fork="true" output="docs/API-Reference.md">
<classpath>
<pathelement path="src/docs/java"/>
</classpath>

View file

@ -136,8 +136,8 @@ execute this command...
Variables can be created and changed easily in Javascript. Along with
the variables you'll create in your in-game commands and scripts, there
are handy variables created for you by ScriptCraft. One such variable is
`self`, it contains information about the current player...
are handy "free" variables created for you by ScriptCraft. One such variable is
`self`, it contains information about the current player (that's you)...
/js echo ( self )
@ -224,7 +224,7 @@ called. You'll notice the above statement didn't actually do anything
... The current time is displayed. Congrats! You've just written your
first Javascript function - you're well on your way to becoming a
Minecraft Modder :-) There are many functions for working with Text,
Minecraft Modder. There are many functions for working with Text,
numbers and dates in Javascript...
/js Math.random()
@ -255,13 +255,19 @@ function. You must tell the function what material you want the shape to
be made of. For example, in the game, point the cross hairs at the
ground, then type the following and hit enter...
/js box("5")
/js box( blocks.oak )
... This will change the targeted block to wood. What's happened here is
the `box()` function has created a single new wooden block. The text
`"5"` is taken by Minecraft to mean Wood. You can see many more
materials and the number Minecraft uses for them by visiting the
[Minecraft Data Values][mcdv] site.
... This will change the targeted block to wood. What's happened here
is the `box()` function has created a single new wooden
block. `blocks` is another one of those "free" variables you get in
ScriptCraft, you can see a list of block materials by typing ...
/js blocks.
... then pressing the `TAB` key. Repeatedly pressing the `TAB` key
will cycle through all of the block materials. Alternatively, you can
see many more current materials and the numbers Minecraft uses for
them by visiting the [Minecraft Data Values][mcdv] site.
### Common Block Materials
@ -273,16 +279,25 @@ wood so the text "5:1" means Spruce, "5:2" means Birch and "5:3" means
Jungle wood. There are many different materials in the Minecraft world, the most
commonly used materials for building are:
* "4" - Cobblestone
* "5" - Wooden Planks
* "5:2" - Birch wood Planks (light wood)
* "98" - Stone bricks
* "45" - Red bricks
* "68" - Doors
* "102" - Glass panes (for windows)
* "4" - Cobblestone or `blocks.cobblestone`
* "5" - Wooden Planks or `blocks.oak`
* "5:2" - Birch wood Planks (light wood) or `blocks.birch`
* "98" - Stone bricks or `blocks.brick.stone`
* "45" - Red bricks or `blocks.brick.red`
* "68" - Sign or `blocks.sign`
* "102" - Glass panes (for windows) or `blocks.glass_pane`
For reference, here is a chart of all of the blocks (not items) in the Minecraft
world...
You can create a single wooden block using the numeric values or the `blocks` variable. For example...
/js box( "5" )
... and ...
/js box( blocks.oak )
... both do exactly the same thing but I personally prefer `/js box(
blocks.oak )` because it's easier to remember. For reference, here is
a chart of all of the blocks (not items) in the Minecraft world...
![Minecraft Data Values][img_dv]
@ -350,7 +365,7 @@ You can make a Drone move around before and after building by
*daisy-chaining* the building and movement functions together. In the
game, point at the ground then type the following...
/js up(1).box(5).fwd(3).box(5)
/js up(1).box( blocks.oak ).fwd(3).box( blocks.oak )
A series of 2 boxes is created 3 blocks apart.
@ -414,7 +429,9 @@ again when you quit the game and start it up again.
installed on every Windows machine) that is well suited for writing
code. If you don't already have it on your machine, you can [install
Notepad++ here][np]. I recommend using NotePad++ rather than plain old
Notepad because it understands Javascript.
Notepad because it understands Javascript. If you prefer coding on a
Macintosh, then [TextWrangler][twl] is a good programming editor which
also understands Javascript code.
### Your First Minecraft Mod!
@ -436,7 +453,8 @@ type...
/reload
... to reload all of the server plugins. Your mod has just been loaded. Try it out by typing this command...
... to reload all of the server plugins. Your mod has just been
loaded. Try it out by typing this command...
/js greet()
@ -936,6 +954,7 @@ different objects and methods available for use by ScriptCraft.
[soundapi]: http://jd.bukkit.org/beta/apidocs/org/bukkit/Sound.html
[ap]: http://walterhiggins.net/blog/ScriptCraft-1-Month-later
[api]: api.md
[twl]: http://www.barebones.com/products/textwrangler/
[img_echo_date]: img/ypgpm_echo_date.png
[img_3d_shapes]: img/ypgpm_3dshapes.jpg