CyubE3dit
Quickstart guide

Installation

  1. Unpack the rar package to any folder with write permission.
  2. Doubleclick the executable.
  3. All settings and user data will be stored within the local Appdata user folder and will be preserved between updates.

User interface

The Application will start as fullscreen window loading all game blocks as well as all installed custom blocks and preparing proper textures to display them accordingly. This process can be observed via the progress bar at the bottom of the window, you will see all generated previews within the Viewport. The loading will be cached, so expect it to be only slow at the first start of the tool. Once this is done the Application will start to load chunks from the last World you left, or it will promt you to select the desired world of the worlds list.


The Main screen you will land on is probably the most basic one can imagine. Just a Viewport displaying your world, a menu bar with some properties and a Info Box overlay on the left top of the viewport.

Info Box

The Info Box is telling you various information depending on the current usage mode:

Viewport

The viewport is your main working area. Here you can navigate through the world and position your schematic toolbox. World movement is abolutely without any restrictions, so you will be able to freely move through walls and beyond world borders to investigate everything to your liking.

Keyboard shortcuts

While the Pick/Place tool is active:

Menu Bar

With the menu bar all necessary settings and tools are available at any time. The options are split into four groups:
  1. File
  2. World
  3. Visuals
  4. Help

File - Save Schematic Cube

Here you will have the possibility to select a portion of your world (up to 255x255x255 blocks) to be saved as schematic file (*.cySch).

The tool block will spawn in front of you, catching the camera rotation to keep it in the center of the viewport for your convenience. You can now click and drag the tool block to move it to the place you want to save. Resizing the toolblock is possible with holding shift while draging.

Once you found the final spot and size to save, hit enter and you will be able to select a destination to save the file to.

If you want to abort the process just hit "Escape" and the Toolbox will go away releasing your camera again.

File - Load Schematic

Here you will have the possibility to load a previously generates schematic file (*.cySch) into the currently active world. Once you chose the schematic from disc, it will spawn before your current position. It might spawn (partly) invisible behind walls depending on where you look at.

After spawn you will see the loaded cube surrounded by the toolbox cube, outlining the schematic size. To move the object you first have to move the Tool block by dragging. Once the toolblock sits at the desired position, hit enter to move the actual schematic content. You can do this as often as you need to find an appropriate spot. Nothing will be written to the world at any time during this process.

Once you found the final spot to insert the schematic, and want to write the changes to your world hit Ctrl+S. Now all changed chunks of the world will disappear and reload (if chunkloading is currently running, press "P" to pause/resume chunkloading)
To insert the same schematic again, just hit Ctrl+V after insertion is complete. This will spawn the schematic at exact the same location, you previously inserted it. You can now Shift-drag to easily append the second schematic to the first.

If you want to abort the process just hit "Escape" and the schematic preview as well as the Toolbox will go away.

File - Fill area with blocks

With this option you will be able to fill a selectable area with blocks of one type. Choose the type from the blocklist that appears and you will see a preview. The mechanics of the Toolbox behave likein COPY mode, but the Camera is not fixed to the toobox.

File - Copy chunkfiles to database and delete them

This option might come handy, if you have worlds created before CyubeVR Verion 39. In this case your world directories will be populated with lots of .chunk and .chunkmon files. Clicking this optio will clean all of them by moving the data into the new database format. Because this messes with a lot of data it is recommended that you do a backup of your world first, to make sure nothing important gets lost.

File - Chunk deletion

This option is mainly for people having worlds created with old worldgen versions where some recources might be missing. Here you can select an arbitrary pattern of chunks by adding as many markers as you wish. You can then choos, if you want to delete all marked, or all unmarked chunks to give the worldgen the possibility to re-create them with all current ressources included.

File - Do not share information about my mods directory

This option is checked by default, to exclude your local mods directory from uploading the custom blocks into the online database. If you want to share a schematic including unreleased custom blocks you micht want to uncheck this, so the other people at least get an idea how the blocks should look like.

World - Active world

This menu will present you a list of all worlds found within your cyubeVR save directory. You can switch worlds by simply clicking them. Be aware, that changing the world will always spawn you at the current player position of this world.

World - Set Playerposition

With this option you can override the in game player postition with the current player position. Can be very helpful to teleport over long distances, as movement in the editor is way faster than in the game. Be Aware though, as the editor does not have any collision detection it is easy to set the playerposition within solid structures, which can lead to undefined behaviour in game.


Visuals - Visible Chunkborders

This will draw black lines where chunks end, so you can always see the borders of chunks, nice for debugging. And to keep a feeling for dimensions.

Visuals - Narrow render Height

This option will limit all future loaded chunks to height between 50m and 125m (absolute Z-height) This option will be enhanced with a variable band to be able to cut the world at certain heights and see what's there. It also increases chunk drawing speed when there are huge mountains.

Visuals - Shadows

By default no shadows are rendered to the world, but if you'd like (and have enough performance) you can add simple, or even more ressource hungry shadows to your view.
The World will rebuild completely when changing this setting!

Visuals - Make World surface visible from inside blocks

This lenghty option will add more vertices to the world, so that you will see the world outer surface even when the camera is "inside" solid world portions, nice to investigate the cave system, but comes with a performance cost.

Visuals - Draw distance

Here you can set the chunk-count at which the chunkloader comes to rest and the distance, when far chunks are being deleted. Choose betweenhort, medium and far as you prefer. With the option to pause/resume the chunkloader at any time and keeping in mind, that the chunkloader will always spiralize around the current camera position this gives the possibility to load exactly the portions of the world you need.

Dynamic Block Database

In order to be able to view custom block information, even for blocks that are not present in the current installation, the tool automatically builds and updates a online custom block database.
This Database will hold the block information of all users that allow the application to communicate via a TCP connection on port 3306 (mysql).

The outcome is publicly available here:


Imprint -- No, I really do not use any cookies at all, no facebook, no instagram, no nothing. No need for stupid popups asking for permission.