Skip to content

getenu/enu

Repository files navigation

Enu

3D live coding, implemented in Nim.

Enu Screenshot

Enu lets you build and explore worlds using a familiar block-building interface and a Logo inspired API. It aspires to make 3D development more accessible, and will eventually be usable to create sandalone games.

Enu isn't ready for public testing, but it's getting close. MacOS, PC and Linux version of Enu 0.1 should be ready on Friday, Nov. 6th 2020.

Demo

See the Enu 0.1 demo video:

Enu 0.1 Demo

Outdated Demos

Examples

Draw a square:

forward 10
right 10
back 10
left 10

or:

4.times:
  forward 10
  turn_right()

Square Example Create a twisting tower:

var
  length = 20
  height = 50

height.times:
  left length / 2
  back length / 2
  4.times:
    forward length
    turn_right()
  forward length / 2
  right length / 2
  turn_right 5
  up()

Tower Example

Draw randomly:

up 10
forward 10
(50..100).times:
  forward 2..5
  turn_right -180..180
  up 0..2

Random Example

Set the color to blue randomly with a 1 in 50 chance. Otherwise set it to white:

if 1 in 50:
  color = blue
else:
  color = white

or as a one-liner:

color = if 1 in 50: blue else: white

Random Color Example

Move forward 10 times, cycling through colors:

for i in 0..9:
  next_color()
  forward()

or:

10.times:
  color = cycle(red, black, blue)
  forward()

Color Cycle Example

Install

Download from https://github.com/dsrw/enu/releases. The Windows version isn't signed, and UAC will warn that it's untrusted. This will be fixed in a future release.

Linux isn't currently supported. It should be possible to build and run, but there will be breaking bugs and missing features. This will be addressed soon.

The world format will change in a future release. Worlds created in 0.1 won't be supported in future versions.

Build

$ nimble prereqs
$ nimble build
$ nimble edit

When Godot has finished importing assets, you can launch Enu with the play button, F5, or with nimble start.

Notes

Enu requires a custom Godot version, which lives in vendor/godot. This will be fetched and built as part of nimble prereqs.

See https://docs.godotengine.org/en/3.2/development/compiling/index.html

Usage

Keyboard/Mouse

  • ESC - toggle mouse capture and to dismiss editor windows. Reloads script changes.
  • W, A, S, D - move around when mouse is captured.
  • Space - jump. Double jump to toggle flying. Hold to go up while flying.
  • Shift - run.
  • C - go down while flying.
  • ~ - toggle the console.
  • F - toggle fullscreen.
  • 1 - enter edit mode.
  • 2 - 9 - change active action.
  • Mouse Wheel Up/Down - change active action.
  • Ctrl - reload script changes. Hold to temporarily capture the mouse and move, so you can change your view without having to switch away from what you're doing.
  • Cmd+P / Ctrl+P - Pause the current script.
  • Left Click - Place a block/object or open the code for the currently selected object.
  • Right Click - Remove a block/object.

XBox / Playstation Controller

  • Left Stick - move.
  • Right Stick - change view.
  • A / X - jump. Double jump to toggle flying. Hold to go up while flying.
  • B / ◯ - go down while flying. Dismiss code editor.
  • Y / △ - toggle edit mode.
  • L1 / R1 - change active action.
  • L2 - place a block/object or open the code for the currently selected object.
  • R2 - remove a block/object.
  • L3 - run.

Enu currently includes 5 block types/colors, and 1 object model (a robot). This will be greatly expanded in the future.

Config

The Enu data directory lives in ~/Library/Application Support/Enu on Mac, and %AppData%\Enu on Windows. config.json has a few configurable options:

downscale: Increase to render at a lower resolution to improve performance. Should be an integer.

font_size: The font size. DPI is currently ignored, so hidpi screens will require a higher number.

dock_icon_size: Size of the icons in the dock. DPI is currently ignored, so hidpi screens will require a higher number.

world: The world/project to load. Change this to create a new world.

show_stats: Show FPS and other stats.

Tasks

v0.1.1

  • Validate under Linux
  • Linux install task

About

A Logo-like 3D environment, implemented in Nim

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages