[Open Source] Map Editor 1.3.1

King Arthur's Gold - Map Editor
------------------------------------------​

An easy-to-use yet powerful Editor to create and edit Maps.
(The Editor requires Java.)

Features:

Extensible!

Every Block, Item and Vehicle currently in the game is in the editor. If this is not enough, you can simply add Blocks, Items and Vehicles to it by changing one file.​

Automatable!

Use given scripts to cover dirt with grass, to generate gold or to place bedrock at the bottom of the map. Or create your own script with simple JavaScript.​

Simple!

Work with 3 different types of symmetry (None, Normal, Team) to create maps fast and easy. Change pen sizes and import maps.​

Cross-Platform, Portable and light!

Works on every OS with Java installed. Does not need to be installed and is lightweight.​

And it grows!

As still in development Open Sourced, the Editor grows could grow and is extending.​

About:

The Editor is for everybody who wanted to create their own maps in an easy and fast way as it has never been possible before!

It doesn't matter if you are just a player who wants to play alone or with some friends or run a huge array of servers and want to provide your users fresh, new maps; Everybody can build, export and use maps in a simple and fast way as it has never been possible before!
​

Spoiler: Screenshots

Select blocks and change your brush's size with quick-access at the Sidebar, which can be hidden and shown with a simple click.
Place blocks, items and entities where you want and use scripts to simplify and automate your process. Scripts can be used to enable one of the three Symmetry-types, to generate gold veins, place grass over every dirtblock or to mirror the whole map. Or you could just make your own script...


See the result; Simply check one box and see the map the way it will look exported or use it as high-performance-mode. Importing and modifying maps is also no problem.

How?

Simply download the .zip file and extract it somewhere. It contains a textfile holding the version, a textfile containing a link to the original thread and, sure, the .jar file you'll need.
To run the Editor, right-click the "Map Editor.jar" and choose "Open With" and then "Java(TM)".
Another way is to open the cmd/terminal, navigate to the folder which contains the Editor and execute this code: "java -jar Map Editor.jar".
​

You said scripting?!

Yeah! With a little knowledge of programming, preferably in JavaScript, you can make your own scripts to make your life a bit easier.

Spoiler: Making a simple script

How to start:

1. Open the "Map Editor.jar" with your favorite Zipping-Program.
2. Navigate to "data/scripts/" in the .jar.
3. Create a new file. (I will use 'Limiter.js')
4. Open the file "load.ps" and append "Limiter.js" to the first line. (Important: Don't use linebreaks here! It has to be exactly one line.)
It should look like this: "scripts = {"AutoGrass.js", ... , "Limiter.js"}"​

The actual script:

Notes:

Every script has to contain:

a. A variable 'name' [e.g. 'var name = "Limit";' ]
b. A function 'start' [e.g. 'function start() { ... }' ]
c. A function 'execute'
d. A function 'foreach' with parameters: (x, y, name)

| The 'name' is the string that will be shown on the button.
| 'start' executes once, when the script is loaded.
| 'execute' is called everytime the user clicks the button "Execute script"
| 'foreach' is called for every single block on the map in order [Upper -> Down][Left -> Right]. Just as you would read a text. The arguments x, y and name hold the 2-Dimensional position on the grid and the name of the block in lowercase. [e.g. "dirt", "grass", "keg", ...]
PRO TIPP: To give maximal performance, call "self.disableForeach();" in the function start if you don't need the function 'foreach'.​

Let's begin!

Code:

var name = "Limiter";

function start() {
    self.enableForeach(); // Not necessary
}

function execute() {

}

function foreach(x, y, name) {
    if (name == "dirt") {
        if (nameAt(x, y +1) == "dirt") {
            Editor.set(x, y-1, "bedrock");
        }
    }
}

// Additional, useful method(s):

function nameAt(x, y) {
    return Editor.blocks[x][y].tile.name;
}
function possiblePlacement(x, y) {
    if (x < 0 || y < 0) {
        return false;
    }
    if (x > Editor.blocks.length || y > Editor.blocks[1].length) {
        return false;
    }
    return true;
}

This script should place one block of bedrock below every dirt block, if the block below the dirt block is also a dirt block.

For debugging, the keycombination SPACE+R (Reload scripts) is important. Also, if you want error-logs, run the editor with the terminal/cmd.

-- More scripts will follow soon --​

Important:

When exporting a map, a .png will be placed in the same folder as the MapEditor.jar.
For people with special characters (Russian, Chinese,...) in this path it will not work, so the map will be copied to your Clipboard. Open any image editing program (like Paint.NET), paste your Clipboard and save the image as 24-bit png file.​