woxels / Woxel

Native Linux / SDL2 Voxel Editor.

Home Page:https://Woxel.xyz

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

woxel header

screenshot

Woxel uses intuitive controls akin to Minetest and Minecraft, while providing a design experience similar to Goxel and Magicalvoxel. Woxel paves the way to transitioning Minecraft/Minetest players to 3D asset creators for games.

πŸ’¬ Join our discord! https://discord.gg/AH23bGNE2h
πŸ“± Follow us on Twitter! https://twitter.com/Woxels

Download

Input Mapping

πŸƒ Movement

  • W,A,S,D = Move around based on relative orientation to X and Y.
  • SPACE + L-SHIFT = Move up and down relative Z.
  • F = Toggle player fast speed on and off.
  • 1-7 = Change move speed for selected fast state.
  • P = Toggle pitch lock.

πŸ—οΈ Interaction

  • Left Click / R-SHIFT = Place node.
  • Right Click / R-CTRL = Delete node.
  • Q / Z / Middle Click / Mouse4 = Clone color of pointed node.
  • E / Mouse5 = Replace color of pointed node.
  • R = Toggle mirror brush.
  • V = Places voxel at current position.
  • Middle Scroll = Change selected color.
  • X + C / Slash + Quote = Scroll color of pointed node.

πŸ› οΈ Settings

  • F1 = Resets environment state back to default.
  • F2 = Toggle HUD visibility.
  • F3 = Save. (auto saves on exit, backup made if idle for 3 mins.)
  • F8 = Load. (will erase what you have done since the last save)
  • ESCAPE / TAB = Toggle menu.

πŸ–±οΈ Mouse locks when you click on the window, press ESCAPE / TAB to unlock the mouse.

😲 Arrow Keys can be used to move the view around. 🀯

βœ”οΈ Your state is automatically saved on exit.

Console Arguments

πŸ“‚πŸ–±οΈπŸŽ¨ Create or load a project, change project mouse sensitivity, or update a projects color palette

  • ./wox <project_name> <[OPTIONAL]mouse_sensitivity> <[OPTIONAL]path to color palette>
  • e.g; ./wox Untitled 0.003 /tmp/colors.txt
  • 1st, "Untitled", Name of project to open or create.
  • 2nd, "0.003", Mouse sensitivity.
  • 3rd, "/tmp/colors.txt", path to a color palette file, the file must contain a hex color on each new line, 32 colors maximum. e.g; "#00FFFF".
  • Find color palettes at; https://lospec.com/palette-list
  • You can use any palette upto 32 colors. But don't use #000000 (Black) in your color palette as it will terminate at that color.

πŸ“‚ Load *.wox.gz from file

  • ./wox loadgz <file_path>
  • e.g; ./wox loadgz /home/user/file.wox.gz

πŸ“‚ Export as mesh or voxels

  • ./wox export <project_name> <option: wox,txt,vv,ply> <export_path>
  • e.g; ./wox export txt /home/user/file.txt
  • e.g; ./wox export ply /home/user/file.ply

πŸ€” When exporting as ply you will want to merge vertices by distance in Blender or Cleaning and Repairing > Merge Close Vertices in MeshLab. πŸ‘

Compile

Run make or make test or cc main.c -Ofast -lm -lz -lSDL2 -lGLESv2 -lEGL -o wox

cc main.c -Ofast -lm -lz -lSDL2 -lGLESv2 -lEGL -o wox
./wox

Similar Software

Info

About

Native Linux / SDL2 Voxel Editor.

https://Woxel.xyz

License:MIT License


Languages

Language:C 99.7%Language:Makefile 0.3%