Skip to content

stormchaser3000/NodeBoxEditor

 
 

Repository files navigation

Node Box Editor

Use this editor to make nodeboxes for nodes in Minetest.

Version: 0.6.4

To do list and bug tracker is here: https://github.com/rubenwardy/NodeBoxEditor/issues?state=open

License

Created by rubenwardy.

GPL 3.0 or later.

https://www.gnu.org/licenses/gpl-3.0.txt

Contributors:

  • Kaeza: small linux based fixes, and the start of the CMAKELISTS.txt (now modified)
  • Traxie21: small changed textures for node.
  • jmf: Fixed small compile bug fixes.
  • ShadowNinja: Unlimited node boxes, code style, refactoring and small fixes.

Building

# download source and go to the root folder
$ sudo apt-get install build-essential libirrlicht-dev cmake libpng12-dev libbz2-dev libjpeg8-dev libgl1-mesa-dev
$ cmake .
# replace 2 with the number of cores you have + 1
$ make -j2

# to run
./bin/nodeboxeditor
# or double click the run_editor.sh file

Using the editor

What actions you can take are limited by which mode / tool you are in.

Editor

  • Use WASD to move the perspective view.
  • Use the options under view to pick which viewport to show.
  • Use the mode icon on the top left of the screen to change modes / tools.
    • Click the icon to pop out a list of modes / tools.
    • Click an icon to select the corresponding mode.
  • Press N to enter the node tool.
  • Press B to enter the node box tool.

Menu

  • File
    • Open Project - discard the current project and open a new one.
    • Save Project - save the current project.
    • Export - export the project to Lua, or other formats supported.
    • Exit - exit the editor.
  • Editor
    • Limiting - toggle whether node boxes can go outside of node boundaries.
    • Snapping - toggle whether node boxes will snap to a 16 pixel grid.
  • View - use these options to change the viewport (tiled, or make a viewport fullscreen).
  • Project - options unique to an tool.
  • Help
    • About - see program's version, and credits.

Node Box Tool

In this mode / tool, you can edit the contents of a node. Icon: A blue cube with a chunk taken out of it.

  • Click + on the sidebar to add a node box. (or press insert)
  • Click an item in the listbox to select a node box. (or press up/down)
  • Click - on the sidebar to remove the selected node box. (or press delete)
  • Size the node box using the handles in the orthographic viewports.
  • Scale the node box by pressing control, and using the handles in the orthographic viewports.
  • Position the node box by pressing shift, and using the handles in the orthographic viewports.
  • Enter properties for a node box in the text boxes on the side bar.
    • Click update to apply your changes.
    • Click revert to discard your changes, and get the current properties.

Node Tool

In this mode / tool, you can create multiple nodes and manage them. Icon: A yellow cube.

  • Click + on the sidebar to add a node. (or press insert)
  • Click an item in the listbox to select a node. (or press up/down)
  • Click - on the sidebar to remove the selected node. (or press delete)

Saving and Exporting

The editor can currently save and export to several formats.

  • Node Box Editor file (nbe) - The file unique to this editor. General save / open format.
  • Lua file (lua) - Exports code which could be installed as a mod. Use when you want to run in Minetest.
  • Minetest Classic (cpp) - Exports code to be used in Minetest Classic. Use when you want to run in Minetest Classic.

About

An editor for the Minetest Lua Api

Resources

Stars

Watchers

Forks

Packages

No packages published