Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/MoonlightOwl/holo

OpenComputers hologram editor
https://github.com/MoonlightOwl/holo

editor hologram lua minecraft opencomputers

Last synced: 2 months ago
JSON representation

OpenComputers hologram editor

Awesome Lists containing this project

README

        

# holo
Hologram editor written for mod OpenComputers (MineCraft).

This distribution includes two files / components.

### `holo.lua`
The editor itself. For correct work you will need:
* Screen - Tier 3
* GPU/APU - Tier 2+
* RAM - Tier 2+, x2
* Internet card (optional, required for installation from repository)
* Hologram projector (optional, required to preview models)

### `holo-view.lua`
The models viewer. You do not need the full editor installation to deploy your model to projector.
Only the viewer.

Command syntax:

```sh
holo-view filename[.3d/.3dx] [scale]
```

## Installation
Installation consists of two easy steps:

**1)** Obtain a HPM package manager copy.

If you already have one - you can skip this step. Otherwise you can use internet card and this command:

```sh
pastebin run vf6upeAN
```

**2)** Download `holo` package from [repository](https://hel.fomalhaut.me/#packages/holo):

```sh
hpm install holo
```

That's all. Now you can use `holo` and `holo-view` commands. The program files are downloaded and installed to `/usr/bin/` folder.

*NOTE*: you can specify package version when installing. For example:

```sh
hpm install [email protected]
```

## Hologram formats
The basic hologram format is `*.3d` file.

It is easier to parse, and uses around *19KiB* per model.

Since `0.7.0` version, the editor supports a new file format: `*.3dx`.
It features *x15* compression rate (thanks Zer0Galaxy for helping with this).

Both editor and viewer of new versions support the old `*.3d` format for backward compatibility.

## Changelog

### 0.7.1
* Refactored textboxes
* Localization table for viewer
* Bugfixes

### 0.7.0
* Tier 2 GPU support
* New `*.3dx` file format with insane compression rate
* Improved UI interaction
* Localization table
* Fixed old bugs, added a bunch of new ones

### 0.6.0
* Two new projection screens (side, front)
* "Ghost" layer, to facilitate modelling process
* Additional hotkeys

### 0.5.5
First viable version of editor

## Special thanks
I want to thank the following people for contributing to the project:

**Zer0Galaxy**, for awesome compression algorithm,

**NEO**, for help with building first version of the project,

and **everyone else** who provided me bug reports and great feedback.

I appreciate this.