3 releases

0.1.2 Mar 7, 2020
0.1.1 Mar 7, 2020
0.1.0 Mar 7, 2020

#5 in #mcfunction

MIT license

16KB
384 lines

Ribosome Crates.io Build Status

About

Ribosome is a command-line application that convert structure.nbt file into mcfunction file to help making multi-block detection system easier.

Installation

  1. Install Rustup (A Rust compiler that needed to compile this program)
  2. Open command line/terminal.
  3. Run command: cargo install ribosome
  4. The program is now installed and you can run it via: ribosome --help command.

Usage

  1. Run ribosome program with the configuration you need.
  2. The program will output file like this:
scoreboard players set #structure.pass ffi.ribosome 1
execute if score #structure.pass ffi.ribosome matches 1 unless block ~0 ~0 ~0 minecraft:cobblestone_stairs run scoreboard players set #structure.pass ffi.ribosome 0
  1. You can then run that function from anywhere in your datapack.
    In this example, #structure.pass ffi.ribosome will be set to 1 if the location you're running this command from; contain this structure. And will be 0 otherwise.

Configuration

This can be found when running ribosome --help as well.
Run the program with these arguments to enable these options.

  • Air Block (-v, --ignore-air)
    To ignore any air blocks inside structure file. (effectively turn air blocks into structure voids)
  • NBT Block (-n, --ignore-nbt)
    To ignore NBT data inside structure file completely.
  • Block State (-b, --ignore-block-state)
    To ignore Block State inside structure file completely.
  • Mode (-m <mode>, --mode <mode>)
    Select the origin of structure, default to corner.
    • corner, the origin of structure is in the north-west most corner of structure file.
    • center, the origin of structure is at exactly the center of structure in all axis.
    • center_top, similar to center but the y-axis will be the top most block instead.
    • center_bottom, similar to center but the y-axis will be the bottom most block instead.
  • Target (-t <name>, --target <name>)
    Change the scoreboard name of the outputed file, default to #structure.pass.
  • Objectuve (-o <name>, --objective <name>)
    Change the objective name of the outputed file, default to ffi.ribosome.

Dependencies

~3–11MB
~109K SLoC