Try it with the Online Editor!
Check out the changelog for a list of new features!
Latest Compatible Minecraft Version: 1.12
Note: I called it Script because it has a syntax similar to JavaScript.
Learn how to write in Minecraft Script in the Wiki.
mcs
has been tested with node and as a standalone (web) script. Though it should also support CommonJS (node, browserify) and AMD (RequireJS).
Installation via npm
:
$ npm install mcs
> var mcs = require('mcs');
> mcs('function hello { say hello world; }');
Alternatively you can install mcs globally so that it may be run from the command line.
$ npm install mcs -g
$ mcs ./input.mcs ./output/
Add to your html
<script src="https://unpkg.com/mcs"></script>
Download mcs.min.js
Add to your html
<script src="path/to/mcs.min.js"></script>
var input = 'function hello { say hello world; }'
var result = mcs(input)
// result = { "_namespace": { "_type": "namespace", "hello": { "_type": "function", "value": "say hello world\n" } } }
mcs()
takes one required argument, the input (string to convert), and returns a JSON object with namespaces, groups, and functions (you can differentiate them using _type).
$ mcs [input] [output (optional)]
Using mcs
in the CLI takes one require argument, the input
file (.mcs file), and outputs to the (optional) output
directory. If no output directory is given, ./
is used.
Check out the current todo list here.
- Create an issue and describe your idea
- Fork it
- Checkout this repository
- Install the dependencies
npm install
oryarn
- Edit the files in
/src
- Test your changes with
# Use your own input/output
$ npm run build
$ node index.js [input] [output]
# Alternatively:
# Use test/new_syntax.mcs as input, and test/output/ as output
$ npm run test
# Build the source files AND use test/new_syntax.mcs as input, and test/output/ as output
$ npm run bnt
# Autocompile/build whenever you change the src files (instead of npm run build)
$ gulp
- You can also test your changes on the web by copying the
dist/mcs.min.js
file after building - Once done, create a pull request
Made by Pandawan.
Thanks to @coolsa for contributing.
Thanks to Andrew Mast and Chris Smith for helping out and providing feedback!
Please see the LICENSE file
mcs
is not affiliated with Minecraft or Mojang AB.